Angebote

Stammdaten zum Validieren von Angebotsnummern. Workist kann Angebotsnummern erkennen und diese mit den bereitgestellten Stammdaten validieren. Angebote nutzt Workist bei Bestellungen: Es gleicht Bestellungen mit dem referenzierten Angebot ab, übernimmt den Kunden aus dem Angebot und füllt Bestellungen ohne Positionen aus dem Angebot vor. Wie das im Einzelnen funktioniert, beschreibt Abgleich mit Bestell- und Angebotsdaten.

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.

Kopfebene

#	Feldname	Status	Beschreibung
1	partition_id	Stark empfohlen	client_id1 des Kunden. Nicht verpflichtend, aber sehr stark empfohlen, damit nur die Angebote dieses Kunden ausgewählt werden können.
2	offer_number	Pflichtfeld	Angebotsnummer
3	valid_from	Optional	Gültig ab. Wird beim Abgleich nicht geprüft.
4	valid_until	Optional	Gültig bis. Wird beim Abgleich nicht geprüft: Auch abgelaufene Angebote werden gefunden.

Positionsebene

Workist kann Angebote auch auf Positionsebene matchen. Hierzu müssen die Kopffelder für jede Position wiederholt werden.

#	Feldname	Status	Beschreibung
1	position_number	Empfohlen	Positionsnummer im Angebot
2	article_id1	Empfohlen	Artikelnummer
3	article_id2	Optional	Alternative Artikelnummer 2
4	article_id3	Optional	Alternative Artikelnummer 3
5	article_description	Empfohlen	Artikelbeschreibung
6	quantity	Empfohlen	Menge
7	unit	Empfohlen	Einheit
8	extra_data	Optional	Zusätzliche Angaben als JSON-Objekt. Nur importierbar, wenn Ihre Datei bereits die Workist-Spaltennamen verwendet und die Importkonfiguration keine Spaltenzuordnung hat. Den Eintrag higher_level_position nutzt Workist, um Set-Bestandteile zu erkennen.

Abgelaufene Angebote

Da Workist die Gültigkeit beim Abgleich nicht prüft, liefern Sie nur Angebote, die noch gelten. Abgelaufene Angebote entfernen Sie aus Ihrem Export; mit dem nächsten Vollimport verschwinden sie aus Workist.

Mengen speichert Workist mit höchstens zwei Nachkommastellen; weitere Stellen werden gerundet.

Format

Nicht benötigte Spalten können im Datenexport weggelassen werden.

Beispieldateiname: offer_list.csv

partition_id;offer_number;valid_from;valid_until;position_number;article_id1;article_description;quantity;unit
K001;ANG-2024-001;2024-01-01;2024-12-31;1;ART001;Schrauben M8x20 100er Pack;500;Packung
K001;ANG-2024-001;2024-01-01;2024-12-31;2;ART002;Dübel 8mm 50er Pack;200;Packung
K002;ANG-2024-002;2024-01-01;2024-06-30;1;ART003;Bohrmaschine XL Pro;10;Stück

Das Beispiel verwendet ; als Trennzeichen. Stellen Sie das Trennzeichen in der Importkonfiguration ein; ohne Angabe erwartet Workist ein Komma.

Datumsangaben schreiben Sie als JJJJ-MM-TT oder mit dem Tag zuerst (31.12.2024), siehe Wie Workist Werte beim Import vereinheitlicht.

Per API übermitteln Sie dieselben Spalten als CSV-Datei oder als JSON. Endpunkt: Swagger, Grundlagen: Benutzung der Stammdaten-API.