shopping_lists-.csv

Template-Datei zum Herunterladen, hier klicken.
Ausgefüllte Beispiel-Datei zum Herunterladen, hier klicken.

Beschreibung

Mit shopping_list-.csv übermittelt ein Lieferant seinen Kunden vordefinierte Bestelllisten: zum Beispiel eine Vorlage für die wöchentliche Stammbestellung, ein vordefiniertes Teilsortiment für eine bestimmte Filiale, oder eine persönliche Merkliste, die der Kunde später selbst weiterpflegen darf.

shopping_list-.csv enthält nur den „Listenkopf“ (Name = name, Beschreibung = description, welche Kunden die Liste sehen = customer_keys, ob sie bearbeitbar ist = readonly).

Die eigentlichen Artikelpositionen der Liste werden separat in shopping_list_items-.csv definiert und über den gemeinsamen Schlüssel shopping_list_key mit dem passenden Listenkopf verknüpft. Eine Bestellliste besteht also immer aus zwei zusammengehörenden Dateien, die im selben Importvorgang eingespielt werden sollten. Ein shopping_list_key, der in shopping_list_items-.csv verwendet wird, muss zwingend zuvor (oder im selben Import) auch in shopping_list-.csv als Listenkopf angelegt worden sein, sonst können die Positionen keiner Liste zugeordnet werden.

Abhängigkeiten zu anderen Datentypen:

shopping_list-.csv muss gemeinsam mit der dazugehörigen shopping_list_items-.csv importiert werden.
Die in customer_keys angegebenen Kundennummern müssen als gültige, aktive Kundenbeziehungen in merchant_relationships-.csv existieren.
Die Artikel der Liste (siehe shopping_list_items-.csv) müssen als aktive skus in products-.csv / products_packaging-.csv vorhanden sein.

Verfügbare Spalten

Feld (* = Pflicht)	Beschreibung
`import_type` * String (enum)	Definiert, ob dieser Datensatz erstellt/aktualisiert oder gelöscht werden soll. Zulässige Werte: `create_update` oder `delete`
`customer_keys` * Array (String)	Kommaseparierte Liste von Kundennummern.
`shopping_list_key` * String (100)	Eindeutiger Identifikator der Bestellliste aus Sicht des Lieferanten.
`name` * String (100)	Name der Bestellliste die dem Kunden in Mercanto angezeigt wird.
`readonly` boolean (0, 1)	Bestimmt ob ein Kunde die Bestellliste in Mercanto bearbeiten kann oder nicht. `1` = Kann nicht bearbeitet werden `0` = Kann bearbeitet werden default = `1`
`description` String (1000)	Beschreibung der Bestellliste, die dem Kunden in Mercanto angezeigt wird.

Typischer Anwendungsfall: Ein Lieferant möchte, dass die Filialen einer Kette immer dieselbe „Grundausstattung“ mit einem Klick nachbestellen können. Dazu wird eine schreibgeschützte (readonly = 1) Liste „Standardsortiment Bäckerei“ angelegt und allen betroffenen customer_keys zugewiesen.