---
title: "Clients (Robaws)"
description: "Customers"
language: de
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/de/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/de/
---

# Clients: Robaws Customers

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

- Katalog: `Robaws`
- Schema: `Clients`
- Primärschlüssel: `id`
- Bezeichnung: Kunden

Suchen

Mit `insert`, `update` und `delete` können Daten abgerufen und geändert werden.

## API-Quelle

- Endpunkt: `/api/v2/clients`
- Operation: `get /api/v2/clients`

## Leistungsmerkmale

| Characteristic | Value |
|---|---:|
| Durchschnittliche Zugriffsverzögerung (ms) | 102 |
| Anzahl der Vollscan-Zeilen pro Minute | 24,036 |
| Anzahl der Query-Zeilen pro Minute | 765 |
| Zeilen pro Minute schreiben | 539 |

Das Ergebnis kann auf dem Client im Cache zwischengespeichert werden.

## Parameter

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

## Tabellenspalten

Die Spalten der Tabelle `Clients` sind unten aufgeführt. Jede Spalte hat einen SQL-Datentyp. Beim Einfügen und Aktualisieren muss für jede erforderliche Spalte jederzeit ein neuer Wert angegeben werden der nicht Null ist.

| Name | Datentyp | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `address_addressLine1` | `varchar2` | Adresszeile 1 | [ ] | Filter auf der Plattform, beschreibbar, `address.addressLine1` |  |
| `address_addressLine2` | `varchar2` | Adresszeile 2 | [ ] | Filter auf der Plattform, beschreibbar, `address.addressLine2` |  |
| `address_city` | `varchar2` | City | [ ] | Filter auf der Plattform, beschreibbar, `address.city` |  |
| `address_country` | `varchar2` | Country | [ ] | Filter auf der Plattform, beschreibbar, `address.country` |  |
| `address_latitude` | `double` | Adresse Breitengrad | [ ] | Filter auf der Plattform, beschreibbar, `address.latitude` |  |
| `address_longitude` | `double` | Adresse Längengrad | [ ] | Filter auf der Plattform, beschreibbar, `address.longitude` |  |
| `address_postalCode` | `varchar2` | Adresse Postleitzahl | [ ] | Filter auf der Plattform, beschreibbar, `address.postalCode` |  |
| `archivedAt` | `datetime` | Archiviert am | [ ] | Filter auf der Plattform, beschreibbar, `archivedAt` |  |
| `assignedUserId` | `varchar2` | Zugewiesene Benutzer-ID | [ ] | Filter auf der Plattform, beschreibbar, `assignedUserId` |  |
| `belgianCompanyNumber` | `varchar2` | Belgische Unternehmensnummer | [ ] | Filter auf der Plattform, beschreibbar, `belgianCompanyNumber` |  |
| `clientSince` | `datetime` | Kunde seit | [ ] | Filter auf der Plattform, beschreibbar, `clientSince` |  |
| `contactMedium` | `varchar2` | Kontakt Medium | [ ] | Filter auf der Plattform, beschreibbar, `contactMedium` |  |
| `counterAccountCode` | `int32` | Kassenkontocode | [ ] | Filter auf der Plattform, beschreibbar, `counterAccountCode` |  |
| `createdAt` | `datetime` | Erstellt bei | [ ] | Filter auf der Plattform, beschreibbar, `createdAt` |  |
| `creditLimit` | `decimal` | Kreditlimit | [ ] | Filter auf der Plattform, beschreibbar, `creditLimit` |  |
| `creditStatus` | `varchar2` | Bonität | [ ] | Filter auf der Plattform, beschreibbar, `creditStatus` |  |
| `currency` | `varchar2` | Currency | [ ] | Filter auf der Plattform, beschreibbar, `currency` |  |
| `deletedAt` | `datetime` | Gelöscht am | [ ] | Filter auf der Plattform, beschreibbar, `deletedAt` |  |
| `email` | `varchar2` | Email | [ ] | Filter auf der Plattform, beschreibbar, `email` |  |
| `externalId` | `varchar2` | Externe ID | [ ] | Filter auf der Plattform, beschreibbar, `externalId` |  |
| `extraFields` | `varchar2` | Zusätzliche Felder | [ ] | writable | Der JSON-Text des verschachtelten Objekts. |
| `fax` | `varchar2` | Fax | [ ] | Filter auf der Plattform, beschreibbar, `fax` |  |
| `followUpDate` | `datetime` | Termin für die Nachuntersuchung | [ ] | Filter auf der Plattform, beschreibbar, `followUpDate` |  |
| `gaccount_isActive` | `char` | Das G-Konto ist aktiv | [ ] | Filter auf der Plattform, beschreibbar, `gaccount.isActive` |  |
| `generalLedgerAccountId` | `varchar2` | Hauptbuch-Konten-ID | [ ] | Filter auf der Plattform, beschreibbar, `generalLedgerAccountId` |  |
| `globalLocationNumber` | `varchar2` | Globale Standortnummer | [ ] | Filter auf der Plattform, beschreibbar, `globalLocationNumber` |  |
| `gsm` | `varchar2` | Mobile | [ ] | Filter auf der Plattform, beschreibbar, `gsm` |  |
| `id` | `varchar2` | ID | [ ] | Filter auf der Plattform, beschreibbar, `id` |  |
| `invoiceAddress_addressLine1` | `varchar2` | Rechnungsadresse, Zeile 1 | [ ] | Filter auf der Plattform, beschreibbar, `invoiceAddress.addressLine1` |  |
| `invoiceAddress_addressLine2` | `varchar2` | Rechnungsadresse, Zeile 2 | [ ] | Filter auf der Plattform, beschreibbar, `invoiceAddress.addressLine2` |  |
| `invoiceAddress_city` | `varchar2` | Rechnungsadresse – Ort | [ ] | Filter auf der Plattform, beschreibbar, `invoiceAddress.city` |  |
| `invoiceAddress_country` | `varchar2` | Land der Rechnungsadresse | [ ] | Filter auf der Plattform, beschreibbar, `invoiceAddress.country` |  |
| `invoiceAddress_latitude` | `double` | Rechnungsadresse Breitengrad | [ ] | Filter auf der Plattform, beschreibbar, `invoiceAddress.latitude` |  |
| `invoiceAddress_longitude` | `double` | Rechnungsadresse – Längengrad | [ ] | Filter auf der Plattform, beschreibbar, `invoiceAddress.longitude` |  |
| `invoiceAddress_postalCode` | `varchar2` | Rechnungsadresse Postleitzahl | [ ] | Filter auf der Plattform, beschreibbar, `invoiceAddress.postalCode` |  |
| `invoiceEmail` | `varchar2` | Rechnungs-E-Mail | [ ] | Filter auf der Plattform, beschreibbar, `invoiceEmail` |  |
| `invoiceRemarks` | `varchar2` | Anmerkungen zur Rechnung | [ ] | Filter auf der Plattform, beschreibbar, `invoiceRemarks` |  |
| `kvk` | `varchar2` | Wirtschaftskammer | [ ] | Filter auf der Plattform, beschreibbar, `kvk` |  |
| `language` | `varchar2` | Language | [ ] | Filter auf der Plattform, beschreibbar, `language` |  |
| `legalFormId` | `varchar2` | Rechtsform-ID | [ ] | Filter auf der Plattform, beschreibbar, `legalFormId` |  |
| `leitwegId` | `varchar2` | Leitweg-ID | [ ] | Filter auf der Plattform, beschreibbar, `leitwegId` |  |
| `lockedAt` | `datetime` | Gesperrt bei | [ ] | Filter auf der Plattform, beschreibbar, `lockedAt` |  |
| `name` | `varchar2` | Name | [ ] | Filter auf der Plattform, beschreibbar, `name` |  |
| `onPeppolNetwork` | `char` | Im Peppol-Netzwerk | [ ] | Filter auf der Plattform, beschreibbar, `onPeppolNetwork` |  |
| `paymentConditionId` | `varchar2` | Zahlungsbedingungen-ID | [ ] | Filter auf der Plattform, beschreibbar, `paymentConditionId` |  |
| `preferredPeppolParticipantId` | `varchar2` | Bevorzugte Peppol-Teilnehmer-ID | [ ] | Filter auf der Plattform, beschreibbar, `preferredPeppolParticipantId` |  |
| `priceGroupId` | `varchar2` | Preisgruppen-ID | [ ] | Filter auf der Plattform, beschreibbar, `priceGroupId` |  |
| `status` | `varchar2` | Status | [ ] | Filter auf der Plattform, beschreibbar, `status` |  |
| `statusDetails_color` | `varchar2` | Statusdetails Farbe | [ ] | Filter auf der Plattform, beschreibbar, `statusDetails.color` |  |
| `statusDetails_name` | `varchar2` | Status Details Name | [ ] | Filter auf der Plattform, beschreibbar, `statusDetails.name` |  |
| `steuernummer` | `varchar2` | Deutsche Steuernummer | [ ] | Filter auf der Plattform, beschreibbar, `steuernummer` |  |
| `tel` | `varchar2` | Phone | [ ] | Filter auf der Plattform, beschreibbar, `tel` |  |
| `title` | `varchar2` | Title | [ ] | Filter auf der Plattform, beschreibbar, `title` |  |
| `updatedAt` | `datetime` | Aktualisiert am | [ ] | Filter auf der Plattform, beschreibbar, `updatedAt` |  |
| `useInvoiceAddress` | `char` | Rechnungsadresse verwenden | [ ] | Filter auf der Plattform, beschreibbar, `useInvoiceAddress` |  |
| `vatIdNumber` | `varchar2` | Umsatzsteuer-Identifikationsnummer | [ ] | Filter auf der Plattform, beschreibbar, `vatIdNumber` |  |
| `vatTariffId` | `varchar2` | Umsatzsteuer-Identifikationsnummer | [ ] | Filter auf der Plattform, beschreibbar, `vatTariffId` |  |
| `website` | `varchar2` | Website | [ ] | Filter auf der Plattform, beschreibbar, `website` |  |
| `withRespectTo` | `varchar2` | In Bezug auf | [ ] | Filter auf der Plattform, beschreibbar, `withRespectTo` |  |

## Tasten

| Key | Column | Bezieht sich auf | Kind | Description |
|---|---|---|---|---|
| `Clients_assignedUserId_txt` | `assignedUserId` | [Users](Robaws.Users.Users)`.id` | Textual | Die referenzierte Zeile, solange Robaws sie noch auflistet: Eine gelöschte oder bereinigte Zeile wird nicht mehr aufgelistet, und ein Dokument kann weiterhin auf sie verweisen. |
| `Clients_legalFormId_txt` | `legalFormId` | [LegalForms](Robaws.LegalForms.LegalForms)`.id` | Textual | Die referenzierte Zeile, solange Robaws sie noch auflistet: Eine gelöschte oder bereinigte Zeile wird nicht mehr aufgelistet, und ein Dokument kann weiterhin auf sie verweisen. |
| `Clients_paymentConditionId_fk` | `paymentConditionId` | [PaymentConditions](Robaws.PaymentConditions.PaymentConditions)`.id` | Key |  |
| `Clients_priceGroupId_txt` | `priceGroupId` | [PriceGroups](Robaws.PriceGroups.PriceGroups)`.id` | Textual | Die referenzierte Zeile, solange Robaws sie noch auflistet: Eine gelöschte oder bereinigte Zeile wird nicht mehr aufgelistet, und ein Dokument kann weiterhin auf sie verweisen. |
| `Clients_vatTariffId_fk` | `vatTariffId` | [VatTariffs](Robaws.VatTariffs.VatTariffs)`.id` | Key |  |

## Verwiesen von

- [DeliveryNotes](Robaws.DeliveryNotes.DeliveryNotes) `clientId` (Key)
- [Installationen](Robaws.Installations.Installations) `assignedClientId` (Textuell)
- [Materialien](Robaws.Materials.Materials) `assignedClientId` (Schlüssel)
- [Angebote](Robaws.Offers.Offers) `clientId` (Textuell)
- [Angebote](Robaws.Offers.Offers) `endClientId` (Schlüssel)
- [PlanningItems](Robaws.PlanningItems.PlanningItems) `clientId` (Key)
- [PlanningItems](Robaws.PlanningItems.PlanningItems) `endClientId` (Key)
- [Projekte](Robaws.Projects.Projects) `clientId` (Textuell)
- [Projekte](Robaws.Projects.Projects) `endClientId` (Textuell)
- [SalesInvoices](Robaws.SalesInvoices.SalesInvoices) `clientId` (Text)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `clientId` (Text)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `endClientId` (Key)
- [Abrechnungen](Robaws.Settlements.Settlements) `clientId` (Textuell)
- [Abrechnungen](Robaws.Settlements.Settlements) `endClientId` (Schlüssel)
- [StockChanges](Robaws.StockChanges.StockChanges) `toClientId` (Text)
- [Abonnements](Robaws.Subscriptions.Subscriptions) `clientId` (Textuell)
- [Abonnements](Robaws.Subscriptions.Subscriptions) `endClientId` (Schlüssel)
- [TimeRegistrations](Robaws.TimeRegistrations.TimeRegistrations) `clientId` (Text)
- [Transporte](Robaws.Transports.Transports) `clientId` (Schlüssel)
- [WorkOrders](Robaws.WorkOrders.WorkOrders) `clientId` (Text)
- [WorkOrders](Robaws.WorkOrders.WorkOrders) `endClientId` (Key)

## Beispiel-Queries

```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
```


## Anmerkungen zu dieser Version

Was hat sich in den Tabellen, Spalten, Attributen und Funktionen des Treibers mit jeder neuen Version geändert:

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