# Kunden- und Lieferantenstammdaten

Stammdaten zur Erkennung von Kunden oder Lieferanten. Bei Auftragsbestätigungen (OC) und Rechnungen wird der Geschäftspartner in der Regel als Kunde geführt, bei Lieferscheinen kann er je nach Anwendungsfall als Kunde oder als Lieferant auftreten. Bei der Ausgabe wird in der Regel nur die `client_id1` zurückgegeben. Die anderen Informationen helfen der KI, den richtigen Kunden bzw. Lieferanten zu identifizieren.

Eine Liste dieses Typs kann im Kanal auch als Empfängerliste (Feld **Empfänger-Lookup-ID**) dienen. Damit erkennt Workist bei Auftragsbestätigungen und Lieferscheinen den Käufer bzw. Empfänger. Welche Liste welcher Dokumenttyp nutzt, steht unter [Welcher Dokumenttyp welche Liste nutzt](/docs/master-data.md#listen-pro-dokumenttyp).

## Spaltenbeschreibung

> **Pflichtfeld:** Ohne diese Spalte kann Workist den Datensatz nicht verwenden. **Empfohlen:** verbessert die Erkennung deutlich. Der Import selbst prüft keine Spalten: Fehlt eine Spalte, bleibt das Feld leer.

| # | Feldname | Status | Beschreibung |
|---|----------|--------|--------------|
| 1 | `client_id1` | <span class="status-required">Pflichtfeld</span> | Primäre Kunden- bzw. Lieferantennummer. Diese Nummer gibt Workist in der Ausgabe zurück. |
| 2 | `client_id2` | <span class="status-optional">Optional</span> | Sekundäre Kunden- bzw. Lieferantennummer |
| 3 | `client_id3` | <span class="status-optional">Optional</span> | Tertiäre Kunden- bzw. Lieferantennummer |
| 4 | `company_name` | <span class="status-recommended">Empfohlen</span> | Name des Kunden bzw. Lieferanten |
| 5 | `address1` | <span class="status-recommended">Empfohlen</span> | Straße und Hausnummer in einer Spalte (z. B. Musterstraße 1) |
| 6 | `street_name` | <span class="status-optional">Optional</span> | Straßenname, wenn Straße und Hausnummer getrennt vorliegen. Alternative zu `address1`. |
| 7 | `street_number` | <span class="status-optional">Optional</span> | Hausnummer, wenn getrennt von `street_name` |
| 8 | `address2` | <span class="status-optional">Optional</span> | Weitere Adresszeile |
| 9 | `zip_code` | <span class="status-recommended">Empfohlen</span> | Postleitzahl |
| 10 | `city` | <span class="status-recommended">Empfohlen</span> | Stadt |
| 11 | `country_subdivision` | <span class="status-optional">Optional</span> | Bundesland bzw. Region |
| 12 | `country` | <span class="status-recommended">Empfohlen</span> | Land. Ländernamen und drei- oder einstellige Ländercodes wandelt Workist in den zweistelligen ISO-Code um (z. B. `Deutschland` → `DE`). Nicht erkannte Werte bleiben leer. |
| 13 | `po_box` | <span class="status-optional">Optional</span> | Postfach |
| 14 | `misc` | <span class="status-optional">Optional</span> | Zusätzliche Informationen zur Adresse |
| 15 | `client_type` | <span class="status-optional">Optional</span> | Kategorie oder Typ des Kunden bzw. Lieferanten |
| 16 | `client_contact_person1` | <span class="status-optional">Optional</span> | Kontaktperson als einzelnes Textfeld. Bei mehreren Kontakten pro Kunde liefern Sie besser eine eigene [Kontaktliste](/docs/master-data/customer-contacts.md). |
| 17 | `domain` | <span class="status-optional">Optional</span> | Internetdomäne des Kunden, z. B. `muster.de`. Workist schreibt sie klein; Freemail-Domains wie `gmail.com` verwirft Workist beim Import. |
| 18 | `iln` | <span class="status-optional">Optional</span> | Internationale Lokationsnummer (GLN/ILN) |
| 19 | `vat` | <span class="status-optional">Optional</span> | Umsatzsteuer-Identifikationsnummer |
| 20 | `iban` | <span class="status-optional">Optional</span> | IBAN des Kunden bzw. Lieferanten |
| 21 | `swift` | <span class="status-optional">Optional</span> | BIC des Kunden bzw. Lieferanten |
| 22 | `locale_numeric` | <span class="status-optional">Optional</span> | Zahlenformat auf den Dokumenten dieses Kunden: `de` (1.234,56) oder `en` (1,234.56). Hilft Workist, Mengen und Preise richtig zu lesen. |
| 23 | `locale` | <span class="status-optional">Optional</span> | Sprache und Region der Dokumente dieses Kunden, z. B. `de_DE`. Workist liest damit Datumsangaben und nutzt sie als Zahlenformat, wenn `locale_numeric` leer ist. |
| 24 | `internal_note` | <span class="status-optional">Optional</span> | Interne Anmerkungen oder Notizen |
| 25 | `partition_id` | <span class="status-optional">Optional</span> | In der Kundenliste in der Regel leer lassen. |
| 26 | `extra_data` | <span class="status-optional">Optional</span> | Zusätzliche Angaben als JSON-Objekt, z. B. `{"Marke": "Muster"}`. Workist speichert sie mit dem Datensatz und zeigt sie im Datenexplorer an. Für die Erkennung nutzt Workist sie standardmäßig nicht. |

## Format

> Nicht benötigte Spalten können im Datenexport weggelassen werden.

Beispieldateiname: `client_list.csv`

```csv
client_id1;client_id2;company_name;address1;zip_code;city;country
K001;10001;Muster GmbH;Musterstraße 1;12345;Berlin;DE
K002;10002;Beispiel AG;Beispielweg 5;20099;Hamburg;DE
K003;;Test & Co. KG;Testplatz 3;80331;München;DE
```

Das Beispiel verwendet `;` als Trennzeichen. Stellen Sie das Trennzeichen in der [Importkonfiguration](/docs/master-data/transformer-configuration.md) ein; ohne Angabe erwartet Workist ein Komma.

Per API übermitteln Sie dieselben Spalten als CSV-Datei oder als JSON. Endpunkt: [Swagger](https://api.workist.com/v1/swagger/#/Master%20Data/clients_imports_create), Grundlagen: [Benutzung der Stammdaten-API](/docs/api-documentation/master-data-api.md).