Ce document décrit le format du fichier CSV utilisé pour les bons de commande..
Le fichier doit être encodé en UTF-8 et au format CSV (séparé par des virgules ",").
Un fichier d'exemple se trouve en pièce jointe de cet article.
Structure générale du fichier CSV
Le fichier est organisé par sections, chacune occupant des lignes fixes. Les lignes vides sont réservées à un usage futur et sont être présentes même si elles ne contiennent pas de données.
Attention certains champs sont multiligne.
1. En-tête de commande
Numéro de ligne | Champ | Description | Obligatoire | Exemple |
1 | Identifiant commande | Identifiant unique interne de la commande | Oui | 1d30b046-328e-4bda-b102-a06d26599065 |
2 | Numéro de commande | Numéro de commande visible par l'utilisateur | Oui | PO-74E4-00007 |
3 | Date de livraison souhaitée | Date prévue pour la livraison au format ISO8601 | Oui | 2025-01-31 |
4 | Identifiant site | Identifiant unique du site | Oui | de1d7b1f-4ec0-4b6e-83d1-b33f6aabba81 |
5 | Site | Nom du site | Oui | Paris |
6 | Référence client | Code client du site auprès du fournisseur | Non | 123456 |
2. Adresse de livraison
Cette section décrit les informations d'adresse sur plusieurs lignes. Les lignes vides doivent être conservées si une information est absente.
Numéro de ligne | Champ | Obligatoire | Exemple |
11 | Adresse principale | Non | 32 Boulevard de Strasbourg |
12 | Ligne supplémentaire 1 | Non | CS30108 |
13 | Code postal | Non | 75010 |
14 | Ville | Non | Paris |
15 | Pays | Non | France |
16 | Numéro de téléphone | Non | +33123456789 |
17 | Autre / champ multiligne | Non | Accès porte sur le côté: 1234 |
3. Remarque
Numéro de ligne | Champ | Obligatoire | Exemple |
21 | Remarque sur la commande / champ multiligne | Non | Livraison entre 10h et 11h |
4. Articles commandés
Les articles sont listés à partir de la ligne 25 (ligne pour les en-têtes) avec les colonnes suivantes :
Colonne | Obligatoire | Exemple |
Article | Oui | Coca Cola |
Référence | Non | 123456 |
Quantité | Oui | 2.0 |
Conditionnement | Oui | PACK |