---
title: "Clients (Robaws)"
description: "Customers"
language: it
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/it/datamodels/robaws/Robaws.Clients.Clients
original: https://documentation.invantive.eu/en/datamodels/robaws/Robaws.Clients.Clients
updated: 2026-11-18T23:42:47Z
license: https://documentation.invantive.eu/it/
---

# Clienti: Clienti Robaws

`insert` `update` `delete` `REST`

- Catalogo: `Robaws`
- Schema: `Clients`
- Chiavi primarie: `id`
- Etichetta: Clienti

Cerca

È possibile recuperare e modificare i dati utilizzando `insert`, `update` e `delete`.

## Codice sorgente dell'API

- Punto finale: `/api/v2/clients`
- Operazione: `get /api/v2/clients`

## Caratteristiche prestazionali

| Characteristic | Value |
|---|---:|
| Latenza media di accesso (ms) | 102 |
| Righe di scansione completa al minuto | 24,036 |
| Numero di righe di Query al minuto | 765 |
| Scrittura di righe al minuto | 539 |

Il risultato può essere memorizzato nella memoria cache sul client.

## Parametri

| Name | Tipo di dati | Required | Default | Documentation |
|---|---|:---:|---|---|
| `email` | `` | [ ] |  |  |
| `logicId` | `` | [ ] |  |  |
| `searchText` | `` | [ ] |  |  |
| `sort` | `` | [ ] |  |  |
| `updatedFrom` | `` | [ ] |  |  |
| `vatIdNumber` | `` | [ ] |  |  |
| `withArchived` | `` | [ ] |  |  |

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `Clients`. Ogni colonna ha un tipo di dati SQL. Un nuovo valore non nullo deve essere fornito per ogni colonna richiesta in ogni momento durante l'inserimento e l'aggiornamento.

| Name | Tipo di dati | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `address_addressLine1` | `varchar2` | Indirizzo 1 | [ ] | filtri sulla piattaforma, modificabili, `address.addressLine1` |  |
| `address_addressLine2` | `varchar2` | Indirizzo 2 | [ ] | filtri sulla piattaforma, modificabili, `address.addressLine2` |  |
| `address_city` | `varchar2` | City | [ ] | filtri sulla piattaforma, modificabili, `address.city` |  |
| `address_country` | `varchar2` | Country | [ ] | filtri sulla piattaforma, modificabili, `address.country` |  |
| `address_latitude` | `double` | Indirizzo Latitudine | [ ] | filtri sulla piattaforma, modificabili, `address.latitude` |  |
| `address_longitude` | `double` | Longitudine dell'indirizzo | [ ] | filtri sulla piattaforma, modificabili, `address.longitude` |  |
| `address_postalCode` | `varchar2` | Indirizzo Codice postale | [ ] | filtri sulla piattaforma, modificabili, `address.postalCode` |  |
| `archivedAt` | `datetime` | Archiviato in | [ ] | filtri sulla piattaforma, modificabili, `archivedAt` |  |
| `assignedUserId` | `varchar2` | ID utente assegnato | [ ] | filtri sulla piattaforma, modificabili, `assignedUserId` |  |
| `belgianCompanyNumber` | `varchar2` | Numero di registrazione della società belga | [ ] | filtri sulla piattaforma, modificabili, `belgianCompanyNumber` |  |
| `clientSince` | `datetime` | Cliente dal | [ ] | filtri sulla piattaforma, modificabili, `clientSince` |  |
| `contactMedium` | `varchar2` | Contatta Medium | [ ] | filtri sulla piattaforma, modificabili, `contactMedium` |  |
| `counterAccountCode` | `int32` | Codice conto di contropartita | [ ] | filtri sulla piattaforma, modificabili, `counterAccountCode` |  |
| `createdAt` | `datetime` | Creato il | [ ] | filtri sulla piattaforma, modificabili, `createdAt` |  |
| `creditLimit` | `decimal` | Limite di credito | [ ] | filtri sulla piattaforma, modificabili, `creditLimit` |  |
| `creditStatus` | `varchar2` | Situazione creditizia | [ ] | filtri sulla piattaforma, modificabili, `creditStatus` |  |
| `currency` | `varchar2` | Currency | [ ] | filtri sulla piattaforma, modificabili, `currency` |  |
| `deletedAt` | `datetime` | Eliminato alle | [ ] | filtri sulla piattaforma, modificabili, `deletedAt` |  |
| `email` | `varchar2` | Email | [ ] | filtri sulla piattaforma, modificabili, `email` |  |
| `externalId` | `varchar2` | ID esterno | [ ] | filtri sulla piattaforma, modificabili, `externalId` |  |
| `extraFields` | `varchar2` | Campi aggiuntivi | [ ] | writable | Il testo JSON dell'oggetto annidato. |
| `fax` | `varchar2` | Fax | [ ] | filtri sulla piattaforma, modificabili, `fax` |  |
| `followUpDate` | `datetime` | Data di follow-up | [ ] | filtri sulla piattaforma, modificabili, `followUpDate` |  |
| `gaccount_isActive` | `char` | L'account G è attivo | [ ] | filtri sulla piattaforma, modificabili, `gaccount.isActive` |  |
| `generalLedgerAccountId` | `varchar2` | ID conto della contabilità generale | [ ] | filtri sulla piattaforma, modificabili, `generalLedgerAccountId` |  |
| `globalLocationNumber` | `varchar2` | Numero di localizzazione globale | [ ] | filtri sulla piattaforma, modificabili, `globalLocationNumber` |  |
| `gsm` | `varchar2` | Mobile | [ ] | filtri sulla piattaforma, modificabili, `gsm` |  |
| `id` | `varchar2` | ID | [ ] | filtri sulla piattaforma, modificabili, `id` |  |
| `invoiceAddress_addressLine1` | `varchar2` | Riga 1 dell'indirizzo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoiceAddress.addressLine1` |  |
| `invoiceAddress_addressLine2` | `varchar2` | Riga 2 dell'indirizzo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoiceAddress.addressLine2` |  |
| `invoiceAddress_city` | `varchar2` | Città dell'indirizzo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoiceAddress.city` |  |
| `invoiceAddress_country` | `varchar2` | Paese dell'indirizzo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoiceAddress.country` |  |
| `invoiceAddress_latitude` | `double` | Indirizzo di fatturazione Latitude | [ ] | filtri sulla piattaforma, modificabili, `invoiceAddress.latitude` |  |
| `invoiceAddress_longitude` | `double` | Longitudine dell'indirizzo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoiceAddress.longitude` |  |
| `invoiceAddress_postalCode` | `varchar2` | Codice postale dell'indirizzo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoiceAddress.postalCode` |  |
| `invoiceEmail` | `varchar2` | E-mail con la fattura | [ ] | filtri sulla piattaforma, modificabili, `invoiceEmail` |  |
| `invoiceRemarks` | `varchar2` | Note sulla fattura | [ ] | filtri sulla piattaforma, modificabili, `invoiceRemarks` |  |
| `kvk` | `varchar2` | Camera di Commercio | [ ] | filtri sulla piattaforma, modificabili, `kvk` |  |
| `language` | `varchar2` | Language | [ ] | filtri sulla piattaforma, modificabili, `language` |  |
| `legalFormId` | `varchar2` | Codice identificativo della forma giuridica | [ ] | filtri sulla piattaforma, modificabili, `legalFormId` |  |
| `leitwegId` | `varchar2` | Codice Leitweg | [ ] | filtri sulla piattaforma, modificabili, `leitwegId` |  |
| `lockedAt` | `datetime` | Bloccato su | [ ] | filtri sulla piattaforma, modificabili, `lockedAt` |  |
| `name` | `varchar2` | Name | [ ] | filtri sulla piattaforma, modificabili, `name` |  |
| `onPeppolNetwork` | `char` | Sulla rete Peppol | [ ] | filtri sulla piattaforma, modificabili, `onPeppolNetwork` |  |
| `paymentConditionId` | `varchar2` | ID delle condizioni di pagamento | [ ] | filtri sulla piattaforma, modificabili, `paymentConditionId` |  |
| `preferredPeppolParticipantId` | `varchar2` | ID partecipante Peppol preferito | [ ] | filtri sulla piattaforma, modificabili, `preferredPeppolParticipantId` |  |
| `priceGroupId` | `varchar2` | ID gruppo di prezzi | [ ] | filtri sulla piattaforma, modificabili, `priceGroupId` |  |
| `status` | `varchar2` | Status | [ ] | filtri sulla piattaforma, modificabili, `status` |  |
| `statusDetails_color` | `varchar2` | Dettagli stato Colore | [ ] | filtri sulla piattaforma, modificabili, `statusDetails.color` |  |
| `statusDetails_name` | `varchar2` | Stato Dettagli Nome | [ ] | filtri sulla piattaforma, modificabili, `statusDetails.name` |  |
| `steuernummer` | `varchar2` | Codice fiscale tedesco | [ ] | filtri sulla piattaforma, modificabili, `steuernummer` |  |
| `tel` | `varchar2` | Phone | [ ] | filtri sulla piattaforma, modificabili, `tel` |  |
| `title` | `varchar2` | Title | [ ] | filtri sulla piattaforma, modificabili, `title` |  |
| `updatedAt` | `datetime` | Aggiornato il | [ ] | filtri sulla piattaforma, modificabili, `updatedAt` |  |
| `useInvoiceAddress` | `char` | Utilizza l'indirizzo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `useInvoiceAddress` |  |
| `vatIdNumber` | `varchar2` | Partita IVA | [ ] | filtri sulla piattaforma, modificabili, `vatIdNumber` |  |
| `vatTariffId` | `varchar2` | Codice tariffario IVA | [ ] | filtri sulla piattaforma, modificabili, `vatTariffId` |  |
| `website` | `varchar2` | Website | [ ] | filtri sulla piattaforma, modificabili, `website` |  |
| `withRespectTo` | `varchar2` | In merito a | [ ] | filtri sulla piattaforma, modificabili, `withRespectTo` |  |

## Chiavi

| Key | Column | Si riferisce a | Kind | Description |
|---|---|---|---|---|
| `Clients_assignedUserId_txt` | `assignedUserId` | [Users](Robaws.Users.Users)`.id` | Textual | La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento. |
| `Clients_legalFormId_txt` | `legalFormId` | [LegalForms](Robaws.LegalForms.LegalForms)`.id` | Textual | La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento. |
| `Clients_paymentConditionId_fk` | `paymentConditionId` | [PaymentConditions](Robaws.PaymentConditions.PaymentConditions)`.id` | Key |  |
| `Clients_priceGroupId_txt` | `priceGroupId` | [PriceGroups](Robaws.PriceGroups.PriceGroups)`.id` | Textual | La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento. |
| `Clients_vatTariffId_fk` | `vatTariffId` | [VatTariffs](Robaws.VatTariffs.VatTariffs)`.id` | Key |  |

## Riferito da

- [DeliveryNotes](Robaws.DeliveryNotes.DeliveryNotes) `clientId` (Key)
- [Installations](Robaws.Installations.Installations) `assignedClientId` (Testuale)
- [Materials](Robaws.Materials.Materials) `assignedClientId` (Chiave)
- [Offers](Robaws.Offers.Offers) `clientId` (Testuale)
- [Offerte](Robaws.Offers.Offers) `endClientId` (Chiave)
- [PlanningItems](Robaws.PlanningItems.PlanningItems) `clientId` (Key)
- [PlanningItems](Robaws.PlanningItems.PlanningItems) `endClientId` (Key)
- [Projects](Robaws.Projects.Projects) `clientId` (Testuale)
- [Projects](Robaws.Projects.Projects) `endClientId` (Testuale)
- [SalesInvoices](Robaws.SalesInvoices.SalesInvoices) `clientId` (Testuale)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `clientId` (Testuale)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `endClientId` (Key)
- [Settlements](Robaws.Settlements.Settlements) `clientId` (Testuale)
- [Settlements](Robaws.Settlements.Settlements) `endClientId` (Chiave)
- [StockChanges](Robaws.StockChanges.StockChanges) `toClientId` (Testuale)
- [Subscriptions](Robaws.Subscriptions.Subscriptions) `clientId` (Testuale)
- [Abbonamenti](Robaws.Subscriptions.Subscriptions) `endClientId` (Chiave)
- [TimeRegistrations](Robaws.TimeRegistrations.TimeRegistrations) `clientId` (Testuale)
- [Transports](Robaws.Transports.Transports) `clientId` (Chiave)
- [WorkOrders](Robaws.WorkOrders.WorkOrders) `clientId` (Testuale)
- [WorkOrders](Robaws.WorkOrders.WorkOrders) `endClientId` (Key)

## Esempi di Query

```sql
select cnt.address_city city
,      count(*) client_count
from   Robaws.Clients.Clients cnt
group
by     cnt.address_city
```

```sql
select inv.logicId
,      inv.date
,      inv.expireDate
,      inv.openTotal
,      cnt.name client_name
from   Robaws.SalesInvoices.SalesInvoices inv
join   Robaws.Clients.Clients cnt
on     cnt.id = inv.clientId
where  inv.openTotal > 0
```

```sql
select prj.logicId
,      prj.date
,      prj.siteAddress_city site_city
,      cnt.name client_name
from   Robaws.Projects.Projects prj
join   Robaws.Clients.Clients cnt
on     cnt.id = prj.clientId
where  prj.archivedAt is null
```


## Note di rilascio

Cosa è cambiato, versione per versione, nelle tabelle, nelle colonne, negli attributi e nelle funzionalità del driver:

- [ROBAWS](/it/release-notes/drivers?driver=robaws)
