# Préparer les colonnes d'un fichier CSV (/docs/commandes/colonnes-csv)



Le **Guide d'import et référence des colonnes**, accessible depuis l'import CSV de l'application, contient le modèle téléchargeable et les identifiants utilisables dans votre organisation.

## Une ligne par article ou par commande [#une-ligne-par-article-ou-par-commande]

Avec une ligne par article, répétez le numéro pour regrouper les articles d'une même commande. Renseignez l'adresse et les totaux sur la première ligne du groupe. Ne donnez pas des adresses différentes à deux lignes de la même commande.

Avec une ligne par commande, utilisez un groupe de colonnes article ou plusieurs groupes pour représenter plusieurs articles.

| Informations | À renseigner                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------ |
| Commande     | Référence, date, devise, total, note éventuelle, motif d'export si nécessaire.                               |
| Livraison    | Nom complet, société éventuelle, rue, complément, code postal, ville, région/État, pays, téléphone et email. |
| Facturation  | Colonnes distinctes, explicitement associées à l'adresse de facturation.                                     |
| Article      | SKU, désignation, variante, quantité, prix unitaire ou total de ligne, poids unitaire.                       |
| Douane       | Code SH et pays d'origine des articles pour les envois concernés.                                            |

## Références, dates et nombres [#références-dates-et-nombres]

Une référence explicite est recommandée. Sans colonne de numéro, Sendelly peut générer des références à partir du fichier ; ce mécanisme ne remplace pas une numérotation métier stable.

Préférez des dates non ambiguës, par exemple **2026-09-01**. Sans date, la date d'import est utilisée. Pour les pays, utilisez les codes comme **FR** et **BE**, ou les noms français ou anglais reconnus. Vérifiez l'aperçu plutôt que de supposer qu'une abréviation inhabituelle sera comprise.

Précisez l'unité de poids dans l'en-tête ou dans les réglages de l'import. Le poids du colis peut compléter des articles sans poids ; il n'écrase pas les poids unitaires déjà renseignés. Vérifiez le total obtenu avant l'expédition.

## Plusieurs adresses de départ [#plusieurs-adresses-de-départ]

Le plus simple est de choisir **Expédier depuis** pour tout le fichier. Si les départs varient, utilisez soit un identifiant d'adresse Sendelly, soit un bloc expéditeur.

Le bloc expéditeur doit être complet : nom, rue, code postal, ville et pays. Il peut être rapproché d'une adresse existante ou en créer une. Un nom seul recherche une adresse enregistrée. Ne fournissez pas simultanément un bloc expéditeur et un identifiant d'adresse pour la même ligne.

## Fixer un contrat et un service [#fixer-un-contrat-et-un-service]

Les colonnes avancées **originAddressId**, **contractId** et **shippingProductCode** utilisent des valeurs Sendelly. Copiez-les depuis le guide intégré à l'application : un nom commercial de transporteur ne remplace pas son identifiant de contrat.

Le service doit correspondre au contrat. Un service donné sans contrat n'est pas suffisant. Les choix explicites du fichier priment sur les règles automatiques de la commande.

Un service relais ne dispense pas de sélectionner le relais avant la création de l'étiquette.

## Si une ligne est refusée [#si-une-ligne-est-refusée]

Vérifiez le champ indiqué : quantité positive, pays reconnu, adresse complète, référence non dupliquée ou contrat utilisable. Une ligne rejetée n'est pas une commande créée. Reprenez le [parcours d'import](/docs/commandes/importer-un-csv) pour vérifier le bilan.
