---
title: "sales_order_amendment"
url: "https://wiki.merchant.mercanto.ch/fr/article/sales-order-amendment"
language: "fr"
last_updated: "2026-01-20T14:40:03.729Z"
---

# sales_order_amendment

Exemple de fichier dans [gitlab](https://gitlab.com/mercanto/iocanto-spec/-/blob/master/examples/sales_order_amendment.iocanto.json).

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