sales_order.csv (Export)

Beispiel-Datei zum Herunterladen, hier klicken.

Beschreibung

sales_order.csv ist kein Import-, sondern ein Exportfile: Sobald ein Kunde im Webshop eine Bestellung auslöst, erstellt Mercanto automatisch eine solche Datei und stellt sie dem Lieferanten zur Verfügung. Der Lieferant liefert hier keine Daten, sondern erhält damit alle Informationen zur Bestellung in strukturierter Form – z. B. zur Weiterverarbeitung im eigenen ERP-System.

Wichtig zum Aufbau:

Jede Zeile entspricht einer bestellten Artikelposition, nicht einer ganzen Bestellung. Enthält eine Bestellung mehrere Artikel, erscheinen mehrere Zeilen mit derselben order_number.
Kopfangaben zur Bestellung (z. B. order_number, customer_key, order_date, delivery_method) wiederholen sich auf jeder zugehörigen Artikelzeile.
Positionsspezifische Angaben wie sku, quantity, price oder delivery_date gelten nur für die jeweilige Artikelzeile – so kann z. B. jede Position ein eigenes Lieferdatum haben.

Verfügbare Felder

Feld (* = Pflicht)	Beschreibung
`customer_key` * String (100)	Eindeutige Kennung des Kunden/der Geschäftseinheit aus Sicht des Lieferanten.
`order_number` * String (32)	Bestellnummer.
`order_date` * String (DD.MM.YYYY)	Datum an welchem die Bestellung aufgegeben wurde.
`order_comment` String (100)	Vom Kunden hinterlegter Bestellhinweis.
`order_reference` String (255)	Vom Kunden hinterlegte Bestellreferenz.
`delivery_method` * String (100)	Lieferoption der Bestellung.
`buyer_email` * String (100)	E-Mail-Adresse des bestellenden Kunden.
`language_code` * String (enum)	Eingestellte Sprache des Kunden bei Bestellaufgabe. Zulässige Werte: `de_CH`, `fr_CH`, `it_CH`, `en_GB`
`time_stamp` * String (DD.MM.YYYY/ HH:MM:SS/Timezone)	Zeitstempel an welchem die Bestellung aufgegeben wurde.
`sku` * String (255)	Artikelnummer.
`packaging` * String (enum)	Verkaufseinheit des Arikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verpackungseinheit und https://my.mercanto.ch/de/definierte-werte#einheit
`base_quantity` * Number (0, 99999)	Anzahl der Basiseinheit die auf dem Artikel hinterlegt ist.
`packaging_base` * String (enum)	Basiseinheit die auf dem Artikel hinterlegt ist. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verpackungseinheit und https://my.mercanto.ch/de/definierte-werte#einheit
`base_price` * Integer (0, 10000000000)	Basispreis des Artikels.
`base_price_quantity` * Number (1, 10000000)	Menge der Basiseinheit für die Anzeige des Basispreises.
`price` * Integer (0, 10000000000)	Preis des Artikels.
`quantity` * Number (0, 10000000)	Bestellte Menge.
`net_amount` * Integer (0, 10000000000)	Netto-Bestellwert des Artikels (Menge x Preis).
`tax_rate` * String (100)	Mehrwertsteuersatz des Artikels.
`delivery_date` * String (DD.MM.YYYY)	Gewünschtes Lieferdatum dieses Artikels.
`item_id` * String (255)	ID der Position innerhalb der Bestellung.
`article_comment` String (100)	Vom Kunden hinterlegter Artikelkommentar.
`on_demand_storage_` `contract_number` String (100)	Vertragsnummer bei Abruf-Artikeln.

Typischer Anwendungsfall: Ein Kunde bestellt zwei verschiedene Artikel in einer Bestellung. In sales_order.csv erscheinen dafür zwei Zeilen mit identischer order_number, aber unterschiedlichen Werten bei sku, item_id, quantity und price.