Kundenkontakte
Stammdaten zur Erkennung und des Abgleichs von Kundenkontakten oder Ansprechpersonen am Dokument.
Bei Anfragen und Bestellungen kann der Kanal eine zweite Kontaktliste verwenden: die internen Kontakte, also Ihre eigenen Mitarbeitenden, die Kunden auf dem Dokument als Ansprechperson angeben (z. B. aus dem Innendienst). Beide Listen haben dieselbe Struktur. 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 | contact_id | Pflichtfeld | Primäre Kontaktnummer |
| 2 | first_name | Empfohlen | Vorname. Workist erkennt Kontakte vor allem über den Namen. |
| 3 | last_name | Empfohlen | Nachname |
| 4 | phone | Optional | Festnetznummer |
| 5 | mobile_phone | Optional | Mobilfunknummer |
| 6 | email | Optional | E-Mail-Adresse |
| 7 | partition_id | Optional | client_id1 des Kunden, zu dem der Kontakt gehört. Damit wählt Workist nur unter den Kontakten dieses Kunden aus, was die Erkennungsrate deutlich erhöht. Kontakte ohne partition_id bietet Workist bei allen Kunden an. |
| 8 | 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. |
Die Importkonfiguration zeigt partition_id, first_name und last_name immer als Zeilen mit * an. Der Import prüft diese Spalten nicht; ohne partition_id gilt der Kontakt für alle Kunden.
Format
Nicht benötigte Spalten können im Datenexport weggelassen werden.
Beispieldateiname: contact_list.csv
contact_id;first_name;last_name;phone;mobile_phone;email;partition_id
C001;Max;Mustermann;0123/456789-89;+49 151 23456789;max.mustermann@muster.de;K001
C002;Erika;Beispiel;0321/689371-56;+49 160 7654321;erika.beispiel@beispiel.de;K002
C003;Hans;Test;;;hans.test@test.de;K003
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.