---
title: "Importation de données : importer des données de commande"
description: "Guide complet de l'importation de commandes dans Qargo."
url: https://help.qargo.com/fr/articles/418636-importation-de-donnees-importer-des-donnees-de-commande
locale: fr
updated: 2026-07-15
---

# Importation de données : importer des données de commande

Guide complet de l'importation des données de commande. Cette importation permet de créer des commandes en masse, aussi bien pour les tenants sandbox que pour les tenants en production. Elle sert à la reprise de données, à l'intégration de systèmes et aux tests. Cet article présente les exigences spécifiques, les bonnes pratiques et les problèmes courants.

* * *

### 📖 Terminologie clé {#h_dbe58ea455}

-   **Commande :** demande de mission de transport ou de service.
-   **ID externe :** identifiant unique d'une commande provenant d'un système externe.
-   **Arrêt :** emplacement ou point précis d'une tournée où une tâche est effectuée.
-   **Produit :** article ou marchandise spécifique transporté.
-   **Service :** type de service fourni (par ex. transport).


* * *

### ✅ Exigences essentielles pour l'importation de commandes {#h_08a69ce9bb}

Avant d'importer des données de commande, les exigences et avertissements suivants doivent être pris en compte pour garantir l'intégrité des données.

-   **Prérequis d'autorisation utilisateur :** la fonctionnalité d'importation manuelle des données de commande est restreinte. Seuls les utilisateurs disposant des droits **Superadmin** peuvent effectuer l'importation de commande.
-   **Prérequis pour les entreprises :** tous les clients concernés par la commande doivent déjà exister dans Qargo.
-   **Prérequis pour les produits :** tous les produits inclus dans la commande doivent déjà exister dans le catalogue de produits.
-   **Identification unique :** le **numéro de commande** ou l'**ID externe** sert d'identifiant unique de la commande.
-   **Format de date et d'heure :** tous les champs de date et d'heure doivent respecter le format indiqué dans le modèle afin d'éviter l'échec de l'importation (AA/MM/JJ).

**Règles de validation :** les champs numériques ne doivent contenir que des valeurs positives (sauf certains champs comme `absolute_min_temperature_value` et `absolute_max_temperature_value`). Les champs de date doivent respecter le format `YYYY-MM-DD`. Les champs de liste déroulante doivent correspondre aux valeurs prédéfinies. Par ailleurs, les importations sont limitées à 100 lignes par fichier.

* * *

### 🛠️ Processus d'importation de commandes étape par étape {#h_d69f998df1}

Suivre les étapes ci-dessous pour importer correctement des données de commande.

### Étape 1 : confirmer la fonctionnalité d'importation (ou vérifier son statut d'activation) {#h_c875e93445}

L'activation de la fonctionnalité d'importation manuelle des données doit être confirmée auprès du **responsable de compte**.

### Étape 2 : télécharger le modèle {#h_9c3e87bf5a}

Un modèle de tableur spécifique est disponible pour téléverser les données de commande. **Pour pouvoir modifier et téléverser les données, il faut télécharger une copie du modèle :**

1.  Cliquer sur le lien : [Modèle d'importation des données de commande](https://docs.google.com/spreadsheets/d/1o8Uh96ckVH2n5kzeI1a6OkdQl6HNglxhpjWAT1CNWlA/edit?usp=sharing)
2.  Une fois le modèle ouvert, aller dans **Fichier** et sélectionner **Télécharger**
3.  Enregistrer le modèle **(au format .xlsx ou .csv)** sur l'ordinateur et commencer à saisir les données de l'entreprise.

![](https://help.qargo.com/media/1c7401d4e9fb-image.png)

:::callout{tone="info"}
📚 Toujours utiliser un **modèle vierge** téléchargé directement depuis cet article ou fourni par l'équipe Qargo. La réutilisation d'un ancien modèle peut entraîner des erreurs d'importation.
:::

### Étape 3 : compléter le modèle Excel {#h_6b4b08c13a}

Ouvrir le modèle et le compléter avec les données requises. Le modèle contient des en-têtes de colonnes qui correspondent aux champs de Qargo.

-   **Champs obligatoires :** pour créer une commande de base, s'assurer que les champs suivants sont présents : `transport_service`, `customer_code`, `order_reference_number` (unique pour chaque ligne), `pickup_date`, `delivery_date`, `pickup address` (adresse complète ou ses composants) avec `pickup_name`, et `delivery address` (adresse complète ou ses composants) avec `delivery_name`.
-   **Mise en forme :** une attention particulière doit être portée au format de données indiqué (par ex. dates, nombres, texte).

-   **Nommage des champs personnalisés :** en cas d'utilisation de champs personnalisés, s'assurer que les en-têtes de colonnes respectent la convention de nommage avec deux traits de soulignement (par ex. `order_custom_field__FIELD_ID`).

:::callout{tone="info"}
📚 **Fonction** **de préremplissage :** si elle est activée dans la configuration de l'importation de commande (sous **Client** et **Service de transport**), toute commande créée via l'importation ou l'API externe applique les valeurs par défaut des commandes et préremplit les valeurs de la nouvelle commande.
:::

## Personnalisation du modèle avec des champs personnalisés {#h_207c319e21}

Les mappages de champs personnalisés permettent d'importer des données dans des champs adaptés aux exigences spécifiques d'un client. Ces champs doivent être créés et nommés correctement avant de configurer le mappage. Dans les fichiers d'importation, la convention de nommage des champs personnalisés utilise deux traits de soulignement dans le nom de colonne (par ex. `custom_fields__example`).

1.  **Créer le champ personnalisé dans Qargo :** aller dans `Configuration > Additional fields` pour créer un nouveau champ personnalisé. Noter le `field ID` attribué.
2.  **Ajouter le champ personnalisé au modèle :** ajouter une colonne nommée au format `order_custom_field__FIELD_ID` (par ex. `order_custom_field__invoicegroup`).
3.  **Conseils de mise en forme :** veiller à une correspondance exacte des en-têtes de colonnes, éviter les données précédées d'une apostrophe et respecter la convention de nommage de la feuille « Import ».
4.  **Tester la configuration** : importer un fichier de test pour le client concerné afin de vérifier que les données alimentent correctement le champ personnalisé.

## Limites et points d'attention {#h_b0b7f5ba97}

-   **Configuration propre à chaque client** : les mappages de champs personnalisés sont configurés pour des clients spécifiques. En cas d'importation de données pour un autre client, le champ personnalisé ne sera pas renseigné.
-   **Modifications du mappage** : si le même mappage de champ personnalisé est nécessaire pour d'autres clients, il faut demander une mise à jour du mappage ou le configurer séparément pour chaque client.

### Étape 4 : téléverser le fichier {#h_c161d41d1c}

Pour téléverser le fichier complété, aller dans le module **Commandes**, sélectionner l'onglet **Importations de commandes** et cliquer sur **Importer depuis un fichier**.

![](https://help.qargo.com/media/af5502f9ff12-image.png)

La source de l'importation doit être sélectionnée. Lorsque la source est un téléversement manuel du modèle, sélectionner l'intégration source **Manuel**.

![](https://help.qargo.com/media/bd3420653f1f-image.png)

Le document peut ensuite être téléversé. En cas d'erreurs, un message détaillant les problèmes s'affiche et le système propose des solutions possibles.

![](https://help.qargo.com/media/059f54767e23-image.png)

### Étape 5 : **vérifier et finaliser** {#h_2d5dea7b74}

Corriger les erreurs de validation signalées par le système et finaliser l'importation en créant la ou les commandes.

![](https://help.qargo.com/media/082702ebcd4a-image.png)

* * *

### 📝 Détails du modèle d'importation de commandes {#h_19f6df64d9}

Cette section explique en détail, champ par champ, le modèle Excel d'importation de commandes : formats de données, champs obligatoires et bonnes pratiques pour compléter chaque colonne.

| **Nom de colonne** | **Obligatoire/facultatif** | **Remarques** | **Exemple** |
| --- | --- | --- | --- |
| transport\_service | Facultatif | Service de transport configuré dans Qargo | Transport 2 |
| customer\_code | Facultatif | Code client utilisé dans l'application. Doit correspondre exactement au **Code client** d'une fiche client déjà importée dans Qargo. Utilisé avec le **Nom affiché** pour garantir l'unicité de la commande. | 2322 |
| customer\_name | Facultatif | Doit correspondre exactement au **Nom affiché** d'une fiche client déjà importée dans Qargo. Utilisé avec le **Code client** pour garantir l'unicité de la commande. | Qargo |
| customer\_reference\_number | Facultatif | Numéro de référence pour le suivi interne du client. | CUST-REF-001 |
| order\_reference\_number | Obligatoire | Numéro de référence général de la commande. |  |
| order\_requested\_price | Facultatif | La valeur doit être une représentation numérique du prix ; la devise est celle configurée pour le tenant. | 50 |
| order\_service\_level\_code | Facultatif | Code unique identifiant le niveau de service. | EXP-01 |
| pickup\_date | Facultatif | AA/MM/JJ | 2026/01/20 |
| pickup\_time\_start | Facultatif | HH:MM:SS | 12:00:00 |
| pickup\_time\_end | Facultatif | HH:MM:SS | 13:00:00 |
| pickup\_name | Facultatif |  |  |
| pickup\_full\_address | Facultatif | Adresse principale complète de l'emplacement d'enlèvement. | 123 Transport Way, London, E16 2NZ |
| pickup\_address\_line\_1 | Facultatif |  |  |
| pickup\_address\_line\_2 | Facultatif |  |  |
| pickup\_postcode | Facultatif |  |  |
| pickup\_city | Facultatif |  | London |
| pickup\_country | Facultatif |  | GB |
| pickup\_notes | Facultatif |  |  |
| pickup\_reference\_number | Facultatif |  |  |
| delivery\_name | Facultatif |  |  |
| delivery\_date | Facultatif | Année/Mois/Jour | 2016/09/20 |
| delivery\_time\_start | Facultatif | HH:MM:SS | 13:00:00 |
| delivery\_time\_end | Facultatif | HH:MM:SS | 13:00:00 |
| delivery\_full\_address | Facultatif | Adresse principale complète de l'emplacement de livraison. | 123 Transport Way, London, E16 2NZ |
| delivery\_address\_line\_1 | Facultatif |  |  |
| delivery\_address\_line\_2 | Facultatif |  |  |
| delivery\_postcode | Facultatif |  |  |
| delivery\_city | Facultatif |  | Brussels |
| delivery\_country | Facultatif |  | BE |
| delivery\_notes | Facultatif |  |  |
| delivery\_reference\_number | Facultatif |  |  |
| absolute\_min\_temperature\_value | Facultatif | Température la plus basse que le produit peut supporter. |  |
| absolute\_max\_temperature\_value | Facultatif | Température la plus élevée que le produit peut supporter. |  |
| volume\_lt | Facultatif |  |  |
| quantity | Facultatif |  |  |
| weight\_kg | Facultatif |  |  |
| goods\_description | Facultatif |  |  |
| pallet\_spaces | Facultatif | Nombre de places palettes standard occupées par le produit. |  |
| loading\_meters | Facultatif |  |  |
| adr\_un\_number | Facultatif |  |  |
| packaging\_type | Facultatif |  |  |
| packaging\_size | Facultatif |  |  |
| product\_name | Facultatif | Nom du produit affiché dans Qargo | Aardappelen |

* * *

### 🔎 Résolution des erreurs courantes d'importation de commandes {#h_0ac6ccfc06}

Cette section traite des erreurs spécifiques qui peuvent survenir lors de l'importation de données de commande.

-   **Entreprise introuvable :** pour qu'une commande soit identifiée de manière unique et gérée dans Qargo, la combinaison de l'**ID externe** et du **Nom du client** doit être unique.
-   **Emplacement introuvable :** une erreur fréquente survient lorsque l'adresse de l'emplacement d'un arrêt ne correspond à aucun emplacement existant dans le système.
-   **Produit introuvable :** si le nom d'un produit dans la commande ne correspond à aucun produit du catalogue, l'importation échoue.
-   **Format de date ou d'heure incorrect :** un format de date ou d'heure incorrect est un problème fréquent lors des importations de commandes et entraîne l'échec de l'importation.
-   **Champs d'adresse :** le champ **Pays** exige un code à deux lettres (par ex. **GB**, et non « UK »). Consulter cette [liste](https://www.iban.com/country-codes) pour les codes Alpha-2.
-   **En-têtes de colonnes sensibles à la casse :** les en-têtes de colonnes doivent respecter la casse exacte (par ex. `vat_number`, et non `VAT_number`). Avec une casse incorrecte, les données de la colonne sont ignorées sans avertissement et ne sont pas importées, car le système ne reconnaît pas l'en-tête.
-   **Erreurs dues à une apostrophe initiale :** les données d'une cellule ne peuvent pas commencer par une apostrophe ('). Dans ce cas, le système ne reconnaît pas la valeur et une erreur peut se produire. **Cette règle ne s'applique pas uniquement si l'article indique explicitement qu'une apostrophe doit être utilisée pour un champ spécifique.**\- **Champs personnalisés non renseignés :** vérifier que le mappage du champ est correct pour son niveau d'entité (par ex. niveau arrêt, niveau commande, niveau expédition). Par exemple, les champs de niveau expédition nécessitent le format d'en-tête `consignment_custom_field__[FIELD_ID]`. De même, s'assurer que les en-têtes de colonnes respectent la spécification (par ex. `order_custom_field__[FIELD_ID]` avec deux traits de soulignement).
-   **Correspondance du format de fichier :** une incohérence entre le type d'importation sélectionné et le format du fichier téléversé (par ex. téléverser un fichier XLSX alors que le système est configuré en CSV) peut faire échouer l'importation sans message d'erreur précis. S'assurer que le format du fichier correspond aux paramètres de configuration du système pour éviter ces problèmes.

-   **Valeur importée non renseignée :** si le champ personnalisé n'est pas renseigné lors de l'importation, vérifier que :

    -   le fichier d'importation utilise la bonne convention de nommage pour le champ personnalisé ;
    -   l'importation est effectuée pour le client pour lequel le mappage a été configuré.
-   **Test avec le mauvais client :** en cas de test ou d'importation pour un autre client, le mappage ne s'applique pas. Vérifier que le fichier de test correspond au bon client.

-   **Identifiants de commande uniques :** chaque ligne doit avoir une valeur unique dans la colonne `order_reference_number` pour éviter les erreurs d'importation.
-   **Service de transport obligatoire :** chaque ligne doit indiquer le type de service de transport ; une valeur manquante entraîne des erreurs ou bloque l'importation.

* * *

### ✨ Bonnes pratiques pour l'importation de commandes {#h_0a5739f98e}

Pour une importation fluide et précise, appliquer les bonnes pratiques suivantes.

-   **Importer d'abord les prérequis :** avant d'importer des commandes, il est essentiel de s'assurer que toutes les entreprises, tous les emplacements et tous les produits associés ont déjà été importés avec succès dans le système.
-   **Tester avec un petit lot :** il est recommandé de tester d'abord le processus d'importation avec un petit échantillon de 5–10 commandes, afin de vérifier que les données sont correctement mises en forme avant une importation complète.


* * *

### ➡️ Étapes suivantes {#h_8d8f5ceb04}

Une fois importées avec succès, les commandes sont disponibles dans le module Commandes. Elles peuvent ensuite être planifiées, affectées à des chauffeurs et dispatchées dans le cadre des opérations de transport.

* * *

### 📈 Cas d'usage de l'importation de commandes {#h_a78f7b03c9}

L'importation de commandes est un outil utile pour plusieurs processus métier clés.

-   **Tests en sandbox :** le principal cas d'usage consiste à créer rapidement un grand volume de données de test dans un tenant sandbox, afin de faciliter la formation, de tester des flux de travail et de présenter les capacités de la plateforme sans affecter un environnement de production.
-   **Migration de système :** dans certains cas, une importation ponctuelle peut servir à migrer des commandes historiques ou en attente depuis un ancien système.


## Articles connexes

- [Importation de données : importer les données produits](https://help.qargo.com/fr/articles/410133-importation-de-donnees-importer-les-donnees-produits.md)
- [Import de données – Importer des données de conteneurs](https://help.qargo.com/fr/articles/410131-import-de-donnees-importer-des-donnees-de-conteneurs.md)
- [Import de données : importer des données de contact](https://help.qargo.com/fr/articles/410121-import-de-donnees-importer-des-donnees-de-contact.md)
- [Import de données : importer les données des entreprises](https://help.qargo.com/fr/articles/410118-import-de-donnees-importer-les-donnees-des-entreprises.md)
- [Import de données : importer les données des chauffeurs](https://help.qargo.com/fr/articles/410123-import-de-donnees-importer-les-donnees-des-chauffeurs.md)
