---
title: "sales_order (Export)"
url: "https://wiki.merchant.mercanto.ch/fr/article/sales-order-export"
language: "fr"
last_updated: "2025-12-17T08:57:21.806Z"
---
# sales_order (Export)
Exemple de fichier dans [gitlab](https://gitlab.com/mercanto/iocanto-spec/-/blob/master/examples/sales_order.iocanto.json).
## Description
Ce type de données est généré lorsqu’un client passe une commande. Une commande est créée dans Mercanto et transmise au fournisseur sous forme de fichier `JSON`.
## Champs disponibles
| **Champ**
(\* = Obligatoire) | **Description** |
| --- | --- |
| `customer_key` \*
*String (100)* | Identifiant unique du client/de l’unité commerciale du point de vue du fournisseur. |
| `order_reference` \*
*String (32)* | Numéro de commande. |
| `order_date` \*
*String (DD.MM.YYYY)* | Date à laquelle la commande a été passée. |
| `timestamp` \*
*String (DD.MM.YYYY HH:MM:SS/Timezone)* | Date et heure auxquelles la commande a été créée, au format RFC 3339 (section 5.6), par exemple `2025-12-12T07:45:00Z`. |
| `language_code` \*
*String (enum)* | Langue utilisée par le client lors de la création de la commande.
Valeurs autorisées : `de_CH`, `fr_CH`, `it_CH`, `en_GB` |
| `delivery_method`
*String (100)* | Option de livraison de la commande. |
| `recipient_email`
*String (100)* | Adresse e-mail du client ayant passé la commande. |
| `customer_reference_text`
*String (100)* | Référence client indiquée par celui-ci. |
| `order_information_text`
*String (255)* | Commentaire de commande saisi par le client. |
| `line_items/item_id` \*
*String (255)* | ID de la position dans la commande. |
| `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 (quantité × prix). |
| `line_items/tax_rate` \*
*String (100)* | Taux de TVA de l’article. |
| `line_items/ base_price_quantity` \*
*Number (1, 10000000)* | Quantité d’unités de base utilisée pour l’affichage du prix de base. |
| `line_items/ packaging_base_ quantity` \*
*Number (1, 99999)* | Quantité d’unités de base définie sur l’article. |
| `line_items/ base_packaging_code` \*
*String (enum)* | Unité d’emballage de base.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#unitedemballage](https://my.mercanto.ch/fr/valeurs-definies#unitedemballage) |
| `line_items/ measurement_quantity` \*
*Number (1, 99999)* | Quantité d’unité de mesure de base définie sur l’article. |
| `line_items/ base_measurement_code` \*
*String (enum)* | Code de l’unité de mesure de base.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#unite](https://my.mercanto.ch/fr/valeurs-definies#unite) |
| `line_items/ base_quantity` \*
*Number (0, 99999)* | Quantité d’unités de base définie sur l’article. |
| `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](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/quantity` \*
*Number (0, 10000000)* | Quantité commandée. |
| `delivery_date` \*
*String (DD.MM.YYYY)* | Date de livraison prévue de l’article. |
| `customer_notice_text`
*String (100)* | Commentaire ajouté par le client concernant un article. |
| `on_demand_storage_ contract_number`
*String (100)* | Numéro de contrat pour les articles à prélèvement différé. |
| `additional_fields/ measurement_amount_ per_item`
*Number (0, 9999999)* | La valeur qui définit la quantité par pièce.
Exemple :
\- Quantité = 2
\- `measurement_amount_ per_item` = 0.5kg
\- Totale = 1 kg |
| `additional_fields/ measurement_total_ amount`
*Number (0, 9999999)* | La valeur qui définit la quantité totale multipliée par `measurement_amount_per_item`. |