(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 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.
Workist braucht mindestens immer eine Artikelliste!
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
Falls Einheiten-Konvertierung in Workist realisiert werden soll, müssen die order_units und sales_units übermittelt werden. Siehe: Einheitenkonvertierung
Allgemeine und kundenspezifische Liste
- Allgemeine Liste: alle Artikel, ohne
partition_id.article_id2undarticle_id3sind weitere Nummern, unter denen Workist den Artikel findet. - Kundenspezifische Liste: eine Zeile pro Kunde und Artikel.
partition_identhält dieclient_id1des Kunden,article_id1Ihre Artikelnummer undarticle_id2die Artikelnummer, die dieser Kunde auf seinen Dokumenten verwendet. Workist findet den Artikel dann über die Nummer des Kunden und gibt Ihrearticle_id1aus. Die Nummer des Kunden zeigt Workist an der Position als externe Artikelnummer an. - Zeilen mit
partition_idgelten nur für diesen Kunden; anders als bei anderen Listen bietet Workist sie keinem anderen Kunden an (siehe Zuordnung zu Kunden).
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).
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. |
| 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
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 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.