sales_order (Export)
Exemple de fichier dans gitlab.
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_methodString (100) | Option de livraison de la commande. |
recipient_emailString (100) | Adresse e-mail du client ayant passé la commande. |
customer_reference_textString (100) | Référence client indiquée par celui-ci. |
order_information_textString (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 |
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 |
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 et 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_textString (100) | Commentaire ajouté par le client concernant un article. |
on_demand_storage_ contract_numberString (100) | Numéro de contrat pour les articles à prélèvement différé. |
additional_fields/ measurement_amount_ per_itemNumber (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_ amountNumber (0, 9999999) | La valeur qui définit la quantité totale multipliée par measurement_amount_per_item. |