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.

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	Pflichtfeld	Primäre Kunden- bzw. Lieferantennummer. Diese Nummer gibt Workist in der Ausgabe zurück.
2	client_id2	Optional	Sekundäre Kunden- bzw. Lieferantennummer
3	client_id3	Optional	Tertiäre Kunden- bzw. Lieferantennummer
4	company_name	Empfohlen	Name des Kunden bzw. Lieferanten
5	address1	Empfohlen	Straße und Hausnummer in einer Spalte (z. B. Musterstraße 1)
6	street_name	Optional	Straßenname, wenn Straße und Hausnummer getrennt vorliegen. Alternative zu address1.
7	street_number	Optional	Hausnummer, wenn getrennt von street_name
8	address2	Optional	Weitere Adresszeile
9	zip_code	Empfohlen	Postleitzahl
10	city	Empfohlen	Stadt
11	country_subdivision	Optional	Bundesland bzw. Region
12	country	Empfohlen	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	Optional	Postfach
14	misc	Optional	Zusätzliche Informationen zur Adresse
15	client_type	Optional	Kategorie oder Typ des Kunden bzw. Lieferanten
16	client_contact_person1	Optional	Kontaktperson als einzelnes Textfeld. Bei mehreren Kontakten pro Kunde liefern Sie besser eine eigene Kontaktliste.
17	domain	Optional	Internetdomäne des Kunden, z. B. muster.de. Workist schreibt sie klein; Freemail-Domains wie gmail.com verwirft Workist beim Import.
18	iln	Optional	Internationale Lokationsnummer (GLN/ILN)
19	vat	Optional	Umsatzsteuer-Identifikationsnummer
20	iban	Optional	IBAN des Kunden bzw. Lieferanten
21	swift	Optional	BIC des Kunden bzw. Lieferanten
22	locale_numeric	Optional	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	Optional	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	Optional	Interne Anmerkungen oder Notizen
25	partition_id	Optional	In der Kundenliste in der Regel leer lassen.
26	extra_data	Optional	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

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 ein; ohne Angabe erwartet Workist ein Komma.

Per API übermitteln Sie dieselben Spalten als CSV-Datei oder als JSON. Endpunkt: Swagger, Grundlagen: Benutzung der Stammdaten-API.