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_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 
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_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.