sales_order_amendment

Beispiel-Datei in gitlab.

Beschreibung

Ein Lieferant hat die Möglichkeit zu einer erfolgten Lieferung eine Lieferbestätigung an Mercanto zu übermitteln. Die Datenstruktur orientiert sich dabei auf Positionsebene stark am Datentyp sales_order.

Es gilt:

Auf Kopfebene müssen Liefermethode (delivery_method), Kundennummer (customer_key) und Lieferdatum (delivery_date) mitgegeben werden
Pro Position (line_items) muss die UID (item_id) von Mercanto mitgegeben werden.
Ist keine UID verfügbar (Artikel wurden vom Lieferanten hinzugefügt) so soll gleichermassen eine UID mitgegeben werden, welche der Lieferant erzeugt.
Alle relevanten Preisangaben und die Bestellnummer (order_reference) von Mercanto sind erforderlich.

Verfügbare Felder

Feld (* = Pflicht)	Beschreibung
`customer_key` * String (100)	Eindeutige Kennung des Kunden/der Geschäftseinheit aus Sicht des Lieferanten.
`delivery_date` * String (DD.MM.YYYY)	Gewünschtes Lieferdatum dieses Artikels.
`delivery_method` * String (100)	Lieferoption der Bestellung.
`timestamp` * String (date-time)	Datum und Zeit an dem die Lieferbestätigung erstellt wurde, formatiert nach RFC 3339 (section 5.6), bspw. `2025-12-12T07:45:00Z`.
`line_items/item_id` String (255)	ID der Position innerhalb der Bestellung.
`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/` `base_packaging_code` String (enum)	Definiert die Basis-Verpackungseinheit des Artikels. Entweder dieses Feld oder `base_measurement_code` muss befüllt sein. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verpackungseinheit
`line_items/` `base_measurement_code` String (enum)	Definiert die Basis-Masseinheit des Artikels. Entweder dieses Feld oder `base_packaging_code` muss befüllt sein. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#einheit
`line_items/quantity` * Number (0, 10000000)	Bestellte Menge.
`line_items/base_quantity` Number (0, 99999)	Anzahl, in der der Artikel verkauft wird, wenn Einheit = `base_packaging_code` ist. Entweder dieses Feld oder `measurement_quantity` muss befüllt sein
`line_items/` `measurement_quantity` Number (0, 99999)	Anzahl, in der der Artikel verkauft wird, wenn Einheit = `base_measurement_code` ist. Entweder dieses Feld oder `base_quantity` muss befüllt sein
`line_items/` `packaging_base_quantity` Number (0, 99999)	Anzahl der Basiseinheit innerhalb der Bestellung, wenn Basis-Verpackungseinheit `base_packaging_code` verwendet wird.
`line_items/` `base_price_quantity` * Number (1, 10000000)	Menge der Basiseinheit für die Anzeige des Basispreises.
`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/delete` boolean (true, false)	Definiert, ob der Eintrag gelöscht werden soll. default = `false`
`line_items/` `order_reference` * String (255)	Bestellnummer von Mercanto.
`line_items/` `supplier_order_reference` * String (100)	Bestellnummer des Lieferanten.
`line_items/order_date` String (DD.MM.YYYY)	Datum an welchem die Bestellung aufgegeben wurde.
`line_items/` `additional_fields/ measurement_amount_per_item` Number (0, 10000000)	Nur relevant für Ware die als "x Stück à y kg" verkauft wird. Definiert das "à y kg".
`line_items/` `additional_fields/ measurement_total_amount` Number (0, 10000000)	Nur relevant für Ware die als "x Stück à y kg" verkauft wird. Definiert das "total kg".