sales_order (Export)

Beispiel-Datei in gitlab.

Beschreibung

Dieser Datentyp wird nach erfolgter Bestellung durch einen Kunden seitens Mercanto erstellt und als Datei im JSON-Format an den Lieferanten übermittelt.

Verfügbare Felder

Feld (* = Pflicht)	Beschreibung
`customer_key` * String (100)	Eindeutige Kennung des Kunden/der Geschäftseinheit aus Sicht des Lieferanten.
`order_reference` * String (32)	Bestellnummer.
`order_date` * String (DD.MM.YYYY)	Datum an welchem die Bestellung aufgegeben wurde.
`timestamp` * String (DD.MM.YYYY/ HH:MM:SS/Timezone)	Datum und Zeit an dem Bestellung erstellt wurde, formatiert nach RFC 3339 (section 5.6), bspw. `2025-12-12T07:45:00Z`.
`language_code` * String (enum)	Eingestellte Sprache des Kunden bei Bestellaufgabe. Zulässige Werte: `de_CH`, `fr_CH`, `it_CH`, `en_GB`
`delivery_method` * String (100)	Lieferoption der Bestellung.
`recipient_email` * String (100)	E-Mail-Adresse des bestellenden Kunden.
`customer_reference_text` String (100)	Vom Kunden hinterlegte Bestellreferenz.
`order_information_text` String (255)	Vom Kunden hinterlegter Bestellhinweis.
`line_items/item_id` * String (255)	ID der Position innerhalb der Bestellung.
`line_items/base_price` * Integer (0, 10000000000)	Basispreis des Artikels.
`line_items/price` * Integer (0, 10000000000)	Preis des Artikels.
`line_items/net_amount` * Integer (0, 10000000000)	Netto-Bestellwert des Artikels (Menge x Preis).
`line_items/tax_rate` * String (100)	Mehrwertsteuersatz des Artikels.
`line_items/` `base_price_quantity` * Number (1, 10000000)	Menge der Basiseinheit für die Anzeige des Basispreises.
`line_items/` `packaging_base` `_quantity` * Number (0, 99999)	Anzahl der Basiseinheit die auf dem Artikel hinterlegt ist.
`line_items/` `base_packaging_code` * String (enum)	Verkaufseinheit des Arikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verpackungseinheit
`line_items/` `measurement_quantity` * Number (0, 99999)	Anzahl der Basiseinheit die auf dem Artikel hinterlegt ist.
`line_items/` `base_measurement_code` * String (enum)	Verkaufseinheit des Arikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#einheit
`line_items/` `base_quantity` * Number (0, 99999)	Anzahl der Basiseinheit die auf dem Artikel hinterlegt ist.
`line_items/` `concrete_sku` * String (255)	Stock keeping unit des Artikels (Artikelnummer). Zulässige Zeichen: Zahlen `0-9`, Buchstaben `A-Z a-z`, Bindestriche `–`, Unterstriche `_`, Klammern `()`, Punkte `.`.
`line_items/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
`line_items/quantity` * Number (0, 10000000)	Bestellte Menge.
`delivery_date` * String (DD.MM.YYYY)	Gewünschtes Lieferdatum dieses Artikels.
`customer_notice_text` String (100)	Vom Kunden hinterlegter Artikelkommentar.
`on_demand_storage` `_contract_reference` String (100)	Vertragsnummer bei Abruf-Artikeln.
`additional_fields/` `measurement_amount` `_per_item` Number (0, 999999)	Der Wert, der die Menge pro Stück definiert. Beispiel: Produkt wird in 1 kg verkauft: - Menge = 2 - `measurement_amount_per_item` = 0.5kg - Insgesamt 1 kg
`additional_fields/ measurement_total_amount` Number (0, 999999)	Der Wert, der die Gesamtmenge multipliziert mit `measurement_amount_per_item` definiert.