# (Kundenspezifische) Artikel Stammdaten zur Erkennung von Artikeln. Bei Workist unterscheiden wir zwischen einer *kundenspezifischen Artikelliste* und einer *allgemeinen Artikelliste*. Für beide Artikellisten verwenden wir in Workist die gleiche Datenstruktur. In der Regel benötigt Workist **2 separate Dateien**, falls sowohl eine allgemeine als auch eine kundenspezifische Artikelliste übergeben werden soll. Im [Master Data Hub](/docs/master-data/master-data-hub.md) sind das zwei Listen vom Typ **Artikel**; im Kanal gehört die allgemeine Liste in das Feld **Artikel-Lookup-ID**, die kundenspezifische in das Feld **Debitorenartikel-Lookup-ID**. :::warning **Workist braucht mindestens immer eine Artikelliste!** ::: :::info Bei Übergabe einer kundenspezifischen Artikelliste **zusätzlich zur allgemeinen Artikelliste** reichen in der Regel die folgenden Spalten: `partition_id`, `article_id1`, `article_id2`, (optional) `article_id3` ::: :::note Falls Einheiten-Konvertierung in Workist realisiert werden soll, müssen die `order_units` und `sales_units` übermittelt werden. Siehe: [Einheitenkonvertierung](/docs/master-data/unit-conversion.md) ::: ## Allgemeine und kundenspezifische Liste - **Allgemeine Liste:** alle Artikel, ohne `partition_id`. `article_id2` und `article_id3` sind weitere Nummern, unter denen Workist den Artikel findet. - **Kundenspezifische Liste:** eine Zeile pro Kunde und Artikel. `partition_id` enthält die `client_id1` des Kunden, `article_id1` Ihre Artikelnummer und `article_id2` die Artikelnummer, die dieser Kunde auf seinen Dokumenten verwendet. Workist findet den Artikel dann über die Nummer des Kunden und gibt Ihre `article_id1` aus. Die Nummer des Kunden zeigt Workist an der Position als externe Artikelnummer an. - Zeilen mit `partition_id` gelten nur für diesen Kunden; anders als bei anderen Listen bietet Workist sie keinem anderen Kunden an (siehe [Zuordnung zu Kunden](/docs/master-data.md#partition-id)). **Mehrere Vertriebsorganisationen:** Steht dieselbe `article_id1` mit verschiedenen `sales_organisation`-Werten in Ihren Artikellisten, als mehrere Zeilen oder in mehreren Artikellisten, bietet Workist an der Position die Vertriebsorganisationen zur Auswahl an. Bei Bestellungen markiert die Prüfung **Mehrere Vertriebsorganisationen** solche Positionen, damit eine Bearbeiter:in die passende wählt (siehe [Validierungsprüfungen](/docs/channel-configuration/document-processing/validation-checks.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` | Optional | Nur in der kundenspezifischen Liste: `client_id1` des Kunden, für den die Zeile gilt. In der allgemeinen Liste leer lassen. | | 2 | `article_id1` | Pflichtfeld | Ihre Artikelnummer. Diese Nummer gibt Workist in der Ausgabe zurück. In der kundenspezifischen Liste dieselbe Nummer wie in der allgemeinen Liste. | | 3 | `article_id2` | Optional | Allgemeine Liste: weitere Artikelnummer, unter der der Artikel gefunden werden soll. Kundenspezifische Liste: die Artikelnummer, die dieser Kunde verwendet. Workist zeigt sie an der Position als externe Artikelnummer an. | | 4 | `article_id3` | Optional | Weitere Artikelnummer, z. B. die EAN | | 5 | `description` | Pflichtfeld | Artikelbeschreibung. Workist erkennt Artikel auch über die Beschreibung, wenn auf dem Dokument keine Artikelnummer steht. In der kundenspezifischen Zusatzliste kann die Spalte leer bleiben. | | 6 | `article_status` | Optional | Status des Artikels, z. B. `gesperrt` oder `ausgelaufen`. Mit den Artikelstatus-Regeln des Kanals markiert Workist Positionen mit diesem Status zur Prüfung, siehe [Validierungsprüfungen](/docs/channel-configuration/document-processing/validation-checks.md). | | 7 | `gross_price` | Optional | Listenpreis des Artikels vor Abzügen oder Rabatten. Workist zeigt ihn an der Position als Information an. | | 8 | `order_units` | Empfohlen | Einheiten, in denen der Artikel bestellt werden kann, als Liste in einer Zelle, z. B. `["KAR","ST"]`. Steuert, welche Einheiten in der Workbench zur Auswahl stehen. Eine leere Zelle wird als `["ST"]` importiert. | | 9 | `sales_units` | Optional / Pflicht bei Konvertierung | Einheiten, in denen der Artikel verkauft wird, als Liste in einer Zelle. Erforderlich, wenn Workist Einheiten umrechnen soll: Bestellt ein Kunde in einer anderen Einheit, rechnet Workist die Menge in eine Verkaufseinheit um. | | 10 | `sales_organisation` | Optional | Vertriebsorganisation, die den Artikel verkauft. Steht dieselbe `article_id1` mit mehreren Vertriebsorganisationen in Ihren Artikellisten, bietet Workist an der Position eine Auswahl an. | | 11 | `variants` | Optional | Konfigurierbare Dimensionen des Artikels (z. B. Farbe, Größe), Format: `{'dimensions': [{'name': 'Farbe', 'values': ['rot', 'blau']}]}`. Wird nicht für die Erkennung verwendet, sondern als Information für nachgelagerte Systeme. | | 12 | `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. | Mehrere Bestell- oder Verkaufseinheiten geben Sie immer als Liste in **einer** Zelle an. Doppelte Zeilen mit unterschiedlichen Einheiten führt Workist nicht zusammen: Jede Zeile wird ein eigener Datensatz. ## Format > Nicht benötigte Spalten können im Datenexport weggelassen werden. Beispieldateiname: `article_list.csv` ```csv article_id1;article_id2;description;gross_price;order_units ART001;4001234;Schrauben M8x20 100er Pack;12.50;["Packung","Karton"] ART002;4005678;Dübel 8mm 50er Pack;5.90;["Packung"] ART003;4009999;Bohrmaschine XL Pro;149.99;["Stück"] ``` 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/articles_imports_create), Grundlagen: [Benutzung der Stammdaten-API](/docs/api-documentation/master-data-api.md).