# 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](/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 | `contact_id` | <span class="status-required">Pflichtfeld</span> | Primäre Kontaktnummer |
| 2 | `first_name` | <span class="status-recommended">Empfohlen</span> | Vorname. Workist erkennt Kontakte vor allem über den Namen. |
| 3 | `last_name` | <span class="status-recommended">Empfohlen</span> | Nachname |
| 4 | `phone` | <span class="status-optional">Optional</span> | Festnetznummer |
| 5 | `mobile_phone` | <span class="status-optional">Optional</span> | Mobilfunknummer |
| 6 | `email` | <span class="status-optional">Optional</span> | E-Mail-Adresse |
| 7 | `partition_id` | <span class="status-optional">Optional</span> | `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` | <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. |

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`

```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](/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/contacts_imports_create), Grundlagen: [Benutzung der Stammdaten-API](/docs/api-documentation/master-data-api.md).