# Liefer- und Rechnungsempfänger

Stammdaten zur Erkennung von Adressen. Bei Workist meinen wir mit Adressen immer Liefer- und Rechnungsadressen. Für beide Adressarten verwenden wir in Workist die gleiche Datenstruktur.

In der Regel benötigt Workist **2 separate Dateien**, falls sowohl Liefer- als auch Rechnungsadressen übergeben werden sollen. Im [Master Data Hub](/docs/master-data/master-data-hub.md) sind das zwei Listen vom Typ **Adressen**; welche Rolle eine Liste spielt, legt das Feld im Kanal fest (**Lieferadressen-Lookup-ID** bzw. **Rechnungsadressen-Lookup-ID**).

:::warning
Auch wenn Kundendaten in vielen Systemen als eine Art von Adressen behandelt werden, gilt in Workist für Kunden ein eigenes Format! Siehe [Kundenstammdaten](/docs/master-data/customers.md).
:::

## 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 | `partition_id` | <span class="status-optional">Optional</span> | `client_id1` des Kunden, zu dem die Adresse gehört. Begrenzt die Auswahl auf die Adressen dieses Kunden und erhöht die Erkennungsrate deutlich. Adressen ohne `partition_id` bietet Workist bei allen Kunden an. |
| 2 | `address_id1` | <span class="status-required">Pflichtfeld</span> | Primäre Adressnummer. Diese Nummer gibt Workist in der Ausgabe zurück. |
| 3 | `address_id2` | <span class="status-optional">Optional</span> | Sekundäre Adressnummer (z. B. GLN) |
| 4 | `address_id3` | <span class="status-optional">Optional</span> | Tertiäre Adressnummer |
| 5 | `name` | <span class="status-recommended">Empfohlen</span> | Erste Adresszeile (z. B. Muster GmbH) |
| 6 | `address1` | <span class="status-recommended">Empfohlen</span> | Straße und Hausnummer (z. B. Musterstraße 1) |
| 7 | `street_name` | <span class="status-optional">Optional</span> | Straßenname, wenn Straße und Hausnummer getrennt vorliegen. Alternative zu `address1`. |
| 8 | `street_number` | <span class="status-optional">Optional</span> | Hausnummer, wenn getrennt von `street_name` |
| 9 | `address2` | <span class="status-optional">Optional</span> | Weitere Adresszeile |
| 10 | `zip_code` | <span class="status-recommended">Empfohlen</span> | Postleitzahl |
| 11 | `city` | <span class="status-recommended">Empfohlen</span> | Stadt |
| 12 | `country_subdivision` | <span class="status-optional">Optional</span> | Bundesland bzw. Region |
| 13 | `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. |
| 14 | `po_box` | <span class="status-optional">Optional</span> | Postfach für die Zustellung |
| 15 | `misc` | <span class="status-optional">Optional</span> | Sonstige Informationen zur Adresse (in manchen Systemen auch Abladestelle genannt, z. B. Tor 4) |
| 16 | `contact_person` | <span class="status-optional">Optional</span> | Kontaktperson für die Adresse (z. B. z. H. Muster Person) |
| 17 | `phone` | <span class="status-optional">Optional</span> | Telefonnummer, die mit der Adresse verbunden ist |
| 18 | `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: `address_list.csv`

```csv
partition_id;address_id1;name;address1;zip_code;city;country;misc
K001;A001;Muster GmbH - Lager;Lagerstraße 10;12345;Berlin;DE;Tor 2
K001;A002;Muster GmbH - Büro;Musterstraße 1;12345;Berlin;DE;
K002;A003;Beispiel AG;Beispielweg 5;20099;Hamburg;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/addresses_imports_create), Grundlagen: [Benutzung der Stammdaten-API](/docs/api-documentation/master-data-api.md).