sales_order_amendment

Exemple de fichier dans gitlab.

Description

Un fournisseur a la possibilité d’envoyer à Mercanto une confirmation de livraison une fois qu’une commande a été livrée.
La structure du fichier s’oriente fortement sur le type de données sales_order, mais au niveau des positions.

Il s’applique que :

Au niveau de l'en-tête, la méthode de livraison (delivery_method), le numéro client (customer_key) et la date de livraison (delivery_date) doivent être fournis.
Pour chaque position (line_items), un UID (item_id) doit être fourni — cet UID doit être identique à celui transmis par Mercanto. En cas d’ajout d’articles par le fournisseur, un UID unique doit être généré.
Tous les prix nécessaires ainsi que le numéro de commande Mercanto (order_reference) doivent être fournis.

Champs disponibles

Champ (* = Obligatoire)	Description
`customer_key` * String (100)	Identifiant unique du client/de l’unité commerciale du point de vue du fournisseur.
`delivery_date` * String (DD.MM.YYYY)	Date de livraison prévue pour l’article.
`delivery_method` * String (100)	Option de livraison de la commande.
`timestamp` String (date-time)	Date et heure auxquelles la confirmation de livraison a été créée, au format RFC 3339 (section 5.6), par exemple `2025-12-12T07:45:00Z`.
`line_items/item_id` * String (100)	ID de la position à l’intérieur de la commande.
`line_items/ concrete_sku` * String (255)	Unité de gestion des stocks de l’article (numéro d’article). Caractères autorisés : chiffres `0-9`, lettres `A-Z a-z`, tirets `–`, traits de soulignement `_`, parenthèses `()`, points `.`.
`line_items/packaging` * String (enum)	Unité de vente de l’article. Valeurs autorisées :https://my.mercanto.ch/fr/valeurs-definies#unitedemballage et https://my.mercanto.ch/fr/valeurs-definies#unite
`line_items/ base_packaging_code` String (enum)	Code de l’unité d’emballage de base. Ce champ ou `base_measurement_code` doit être rempli. Valeurs autorisées : https://my.mercanto.ch/fr/valeurs-definies#unitedemballage
`line_items/ base_measurement_code` String (enum)	Code de l’unité de mesure de base. Ce champ ou `base_packaging_code` doit être rempli. Valeurs autorisées : https://my.mercanto.ch/fr/valeurs-definies#unite
`line_items/quantity` * Number (0, 10000000)	Quantité commandée.
`line_items/base_quantity` Number (0, 99999)	Quantité dans laquelle l’article est vendu si l’unité = `base_packaging_code`. Ce champ ou `measurement_quantity` doit être rempli.
`line_items/ measurement_quantity` Number (0, 99999)	Quantité dans laquelle l’article est vendu si l’unité = `base_measurement_code`. Ce champ ou `base_quantity` doit être rempli.
`line_items/ packaging_base_quantity` String (enum)	Quantité d’unités de base dans l’emballage. Valeurs autorisées : https://my.mercanto.ch/fr/valeurs-definies#unitedemballage et https://my.mercanto.ch/fr/valeurs-definies#unite
`line_items/ base_price_quantity` * Number (1, 10000000)	Quantité en unités de base pour l’affichage du prix de base.
`line_items/base_price` * Integer (0, 10000000000)	Prix de base de l’article.
`line_items/price` * Integer (0, 10000000000)	Prix de l’article.
`line_items/net_amount` * Integer (0, 10000000000)	Valeur nette de la commande pour cet article (quantité × prix).
`line_items/tax_rate` * String (100)	Taux de TVA applicable.
`line_items/delete` boolean (true, false)	Indique si la position doit être supprimée. défaut = `false`
`line_items/ order_reference` * String (255)	Numéro de commande Mercanto.
`line_items/ supplier_order_ reference` * String (100)	Numéro de commande du fournisseur.
`line_items/order_date` String (DD.MM.YYYY)	Date à laquelle la commande a été passée.
`line_items/ additional_fields/ measurement_amount_ per_item` Number (0, 10000000)	Pour les articles vendus « x pièces à y kg ». Définit la valeur « à y kg ».
`line_items/ additional_fields/ measurement_total_amount` Number (0, 10000000)	Pour les articles vendus « x pièces à y kg ». Définit la valeur « total kg ».