---
title: "Import de données : quoi, pourquoi, comment"
description: "Guide complet pour importer des données d'entreprise dans Qargo à l'aide de modèles prêts à l'emploi, avec le processus général et les exigences essentielles pour une mise en place sans accroc."
url: https://help.qargo.com/fr/articles/169976-import-de-donnees-quoi-pourquoi-comment
locale: fr
updated: 2026-06-08
---

# Import de données : quoi, pourquoi, comment

Importer les données existantes de l'entreprise dans Qargo permet de configurer un compte rapidement et avec précision. Plutôt que de créer manuellement chaque entreprise, chauffeur ou véhicule, les organisations peuvent utiliser les modèles Excel fournis pour téléverser les informations en masse. Cet article présente l'ensemble du processus, de la préparation des données à la résolution des problèmes courants.

* * *

### 📖 Terminologie clé {#h_38142e5f9b}

Pour plus de clarté, les termes clés de cet article sont définis ci-dessous.

-   **Tenant Qargo :** Instance spécifique et isolée de la plateforme Qargo, dans laquelle les données d'une entreprise sont stockées et gérées.
-   **Tenant sandbox :** Environnement de test d'un tenant Qargo. Cet espace sûr permet d'expérimenter, de tester des flux de travail et d'importer des données sans affecter l'environnement opérationnel réel.
-   **Code comptable :** Identifiant unique issu d'un logiciel de comptabilité. Il sert à lier un client dans Qargo à l'entrée correspondante dans le logiciel de comptabilité.
-   **Sous-traitant :** Entreprise ou personne tierce chargée d'effectuer des tâches de transport. Dans Qargo, les chauffeurs et les véhicules des sous-traitants peuvent être gérés comme ceux de l'organisation.
-   **Ressource :** Terme désignant un chauffeur, un véhicule ou une combinaison des deux.


* * *

### ✅ Exigences et avertissements essentiels pour l'import {#h_b997776770}

Avant de lancer un import, ces exigences essentielles doivent être vérifiées. Leur non-respect peut entraîner des erreurs et des doublons.

1.  **L'import des entreprises est un prérequis pour les contacts :** Il est **obligatoire** d'importer d'abord les entreprises. Le modèle d'import des contacts exige un nom d'entreprise et un code comptable valides pour lier chaque contact à une entreprise donnée.
2.  **Les sous-traitants d'abord :** Pour importer un chauffeur ou un véhicule appartenant à un sous-traitant, ce sous-traitant doit d'abord être créé comme entreprise dans Qargo. Les modèles d'import des chauffeurs et des véhicules exigent un nom de sous-traitant valide pour lier la ressource.
3.  **Le code comptable est essentiel :** Qargo utilise le **code comptable** pour identifier et mettre à jour les clients existants. Si un client est réimporté avec le même nom mais avec un code comptable différent ou manquant, Qargo crée un **doublon** de ce client. Ce problème est fréquent lors d'une migration d'un logiciel de comptabilité vers un autre.

    -   **Conseil :** Lors de la configuration initiale, il est conseillé d'utiliser des clients de test. Une fois les codes comptables finalisés, la base clients complète et nettoyée doit être importée **avant** la mise en production pour éviter les doublons.


* * *

### 🛠️ Processus d'import de données étape par étape {#h_0c4aef0c7a}

Suivre les étapes ci-dessous pour importer les données avec succès.

### Étape 1 : Télécharger le bon modèle {#h_906d3ca1bb}

Un modèle Excel spécifique est disponible pour chaque type de données à importer. Ces modèles sont disponibles ici :\
[Modèle d'import des données d'entreprise](https://docs.google.com/spreadsheets/d/1rvyBW586ny40Ttqrk6Fk3QtLKZyHCoOoTAQ_xYojnDw/edit?usp=sharing)\
[Modèle d'import des données de contact.xlsx](https://docs.google.com/spreadsheets/d/15907ITZJPI-0yiFeqXq-7GIGyOzFAHckibeEkCPPsJI/edit?usp=sharing)\
[Modèle d'import des données de chauffeur.xlsx](https://docs.google.com/spreadsheets/d/1tYtM6ZtL08gecubOpcVx2kHeO6u-1Hl6l5KkeOKtgPQ/edit?usp=sharing)\
[Modèle d'import des données de véhicule.xlsx](https://docs.google.com/spreadsheets/d/1yba-Jx7i8ZYdzJyrPERF3ml6ZblR-j7reHnWVsV1Wgk/edit?usp=sharing)\
[Modèle d'import des données de conteneur.xlsx](https://docs.google.com/spreadsheets/d/18iCOvgK_GFgtOPK6h02Vb1Dq7hKqKnwretYO5j4nrC0/edit?usp=sharing)\
[Modèle d'import des données de produit.xlsx](https://docs.google.com/spreadsheets/d/1NFJZceH7FvUJWY6wSIzEROVpBGBiucTbcS-aoWyNlfk/edit?usp=sharing)\
[Modèle d'import des données de validité.xlsx](https://docs.google.com/spreadsheets/d/1P8RJ6d3Sg2iNAYmTQb8Tsz2S2h_XYDq78izoMEau75g/edit?usp=sharing)\
[Document modèle d'import des données d'emplacement.xlsx](https://docs.google.com/spreadsheets/d/1NQKMJ5fgt1Xwq4mqfDmu-qa1zLS-QVl86T-vW2zTzgE/edit?usp=sharing)

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

### Étape 2 : Compléter le modèle Excel {#h_3286d54ec3}

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

-   **Champs obligatoires :** Veiller à compléter tous les champs obligatoires (ils sont indiqués dans les articles listés dans la section « Articles détaillés sur l'import » de cet article). Un import échoue si ces champs sont laissés vides.
-   **Format :** Une attention particulière doit être portée au format de données indiqué (par ex. dates, nombres, texte).


### Étape 3 : Soumettre pour le téléversement {#h_46a501626c}

1.  **Pendant l'onboarding :** Travailler directement avec le **responsable onboarding** pour téléverser les données initiales de l'entreprise. Le responsable onboarding accompagne l'ensemble du processus et veille à la réussite de l'import.
2.  **Après l'onboarding :** Pour toutes les mises à jour et tous les imports de données ultérieurs, contacter le **gestionnaire de compte**. Le gestionnaire de compte accompagne le processus de téléversement et fournit une assistance continue.


* * *

### 🔎 Résolution des erreurs courantes {#h_109040edd5}

Il est fréquent de rencontrer des erreurs lors de la première tentative d'import. Elles sont généralement simples à corriger.

1.  **Tableur du journal d'erreurs :** Le tableur contenant le journal d'erreurs présente clairement les problèmes. Par exemple, il peut indiquer « Enter a valid URL » ou « Company must have a type ».
2.  **Corriger et téléverser à nouveau :** Ouvrir le fichier Excel d'origine, corriger les erreurs identifiées et enregistrer le fichier. Le fichier corrigé peut ensuite être téléversé à nouveau. Qargo relance la validation et l'import se poursuit.
3.  **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 cette colonne sont ignorées sans avertissement et ne sont pas importées, car le système ne reconnaît pas l'en-tête.
4.  **Erreurs liées à une apostrophe initiale :** Les données d'une cellule ne peuvent pas commencer par une apostrophe ('). Si une apostrophe est utilisée, le système ne reconnaît pas la valeur et une erreur peut se produire. **Cette règle ne s'applique pas uniquement lorsque l'article indique explicitement qu'une apostrophe doit être utilisée pour un champ donné.**


## Résoudre les messages d'erreur courants lors de l'import de données dans Qargo {#h_63d675646e}

Lors de l'import de données dans Qargo, des messages d'erreur liés à la configuration peuvent apparaître, comme détaillé ci-dessous :

1.  **Erreur « Unknown Customer » :** Cette erreur se produit lorsque le nom du client dans le fichier d'import ne correspond à aucun client existant dans Qargo. **Résolution :** Vérifier le nom du client dans le fichier, s'assurer que le client est déjà configuré dans Qargo et corriger toute incohérence avant de téléverser à nouveau.
2.  **Erreur « Unknown Transport Service » :** Cette erreur indique que le service de transport mentionné dans le fichier d'import n'est pas configuré dans Qargo. **Résolution :** Vérifier et corriger le nom du service de transport ou l'ajouter dans Qargo, puis téléverser à nouveau.
3.  **Erreur « Unknown Location » :** Cette erreur se produit lorsqu'un emplacement du fichier d'import n'existe pas dans la configuration de Qargo. **Résolution :** Vérifier et corriger le nom de l'emplacement ou le créer dans Qargo avant de téléverser à nouveau.

**Résumé :** Ces erreurs proviennent d'écarts entre le fichier d'import et la configuration de Qargo. Toujours aligner les données sur la configuration de Qargo et s'appuyer sur les messages d'erreur pour corriger efficacement les écarts.

* * *

### 🔗 Articles détaillés sur l'import {#h_606fecdf47}

Pour des informations plus approfondies sur un type de données donné, cliquer sur les liens ci-dessous. Chaque article détaille les champs du modèle, les exigences spécifiques et les bonnes pratiques.

-   **Importer des entreprises**

Guide complet sur l'import des données d'entreprise. Cette étape fondamentale permet d'alimenter un tenant Qargo en clients, fournisseurs et sous-traitants.

::button[Article sur l'import des données d'entreprise]{href="/en/articles/410118-data-import-importing-company-data"}

-   **Importer des contacts**

Guide complet sur l'import des données de contact. Cet import lie des personnes à des entreprises déjà présentes dans le système, pour une base de données fiable pour la communication.

::button[Article sur l'import des données de contact]{href="/en/articles/410121-data-import-importing-contact-data"}

-   **Importer des chauffeurs**

Guide complet sur l'import des données de chauffeur. Cet import permet de créer en masse des chauffeurs internes et des chauffeurs de sous-traitants. Il s'agit d'une étape essentielle pour préparer le système Qargo au dispatch.

::button[Article sur l'import des données de chauffeur]{href="/en/articles/410123-data-import-importing-driver-data"}

-   **Importer des véhicules**

Guide complet sur l'import des données de véhicule. Cet import facilite la création en masse des véhicules appartenant à l'organisation et à ses sous-traitants. Il s'agit d'une étape essentielle pour préparer la flotte à l'affectation.

::button[Article sur l'import des données de véhicule]{href="/en/articles/410124-data-import-importing-vehicle-data"}

-   **Importer des conteneurs**

Guide complet sur l'import des données de conteneur. Ce processus facilite la création en masse des conteneurs appartenant à l'organisation et à ses sous-traitants, avec un catalogue directement disponible lors de la création de commandes.

::button[Article sur l'import des données de conteneur]{href="/en/articles/410131-data-import-importing-container-data"}

-   **Importer des produits**

Guide complet sur l'import des données de produit. Ce processus alimente en masse le catalogue de produits, ce qui simplifie la création de commandes et garantit la cohérence des descriptions et des unités de mesure.

::button[Article sur l'import des données de produit]{href="/en/articles/410133-data-import-importing-product-data"}

-   **Importer des données de validité**

Guide complet sur l'import des données de validité. Ce processus met à jour en masse les dates d'expiration des documents et des certificats des chauffeurs et des véhicules.

::button[Article sur l'import des données de validité]{href="/en/articles/410135-data-import-importing-validity-data"}

-   **Importer des données de commande**

Guide complet sur l'import des données de commande. Cet import facilite la création en masse de commandes dans les tenants sandbox et de production. Il est utile pour le chargement de données, l'intégration de systèmes et les tests.

::button[Article sur l'import des données de commande]{href="/en/articles/418636-data-import-importing-order-data"}

-   **Importer des données d'emplacement**

Guide complet sur l'import des données d'emplacement. Cet import facilite l'import en masse d'emplacements, avec des alias pour les intégrations externes et des configurations de préremplissage des arrêts.

::button[Article sur l'import des données d'emplacement]{href="/en/articles/413082-data-import-importing-location-data"}

* * *

:::callout{tone="info"}
📚 Les responsables onboarding et les gestionnaires de compte peuvent aider à créer des combinaisons. Pour faciliter la préparation, fournir les informations suivantes pour les chauffeurs et les véhicules à combiner :
:::

| **Nom de colonne** | **Obligatoire/facultatif** | **Remarques** | **Exemple** |
| --- | --- | --- | --- |
| Vehicle\_name | Obligatoire | Nom tel qu'utilisé dans vehicle\_import | 12BLT2 |
| Driver\_name | Obligatoire | Nom tel qu'utilisé pour le chauffeur | Steve Johnson |
| always\_on\_planning | Obligatoire | À afficher chaque jour sur le tableau de planification | TRUE |

* * *

### ❓ FAQ {#h_32c64fbd37}

Cliquer sur le bouton ci-dessous pour accéder à l'article FAQ sur l'import de données.

::button[FAQ sur l'import de données]{href="/en/articles/410168-data-import-data-import-faq-s"}

* * *

### 📝 Cas d'usage {#h_84e1670317}

L'import de données simplifie l'onboarding et la gestion des données. Voici quelques scénarios courants dans lesquels l'import de données est très utile :

-   **Configuration initiale :** Lors de l'onboarding, toutes les données existantes de l'entreprise peuvent être importées en une seule fois pour préparer le tenant Qargo à son utilisation.
-   **Test des flux de travail :** Avant la mise en production, un échantillon de données peut être importé dans le **tenant sandbox** pour tester de nouvelles fonctionnalités ou former une équipe. Cet environnement sans risque permet de se familiariser avec la plateforme.
-   **Mises à jour régulières :** Les données de ressources telles que les véhicules ou les conteneurs peuvent être importées périodiquement, au fur et à mesure que la flotte s'agrandit ou évolue.


## Articles connexes

- [Import de données : importer des données de contacts d'emplacement](https://help.qargo.com/fr/articles/494334-import-de-donnees-importer-des-donnees-de-contacts-d-emplacement.md)
- [Intégrations : API Qargo – quoi, pourquoi et comment](https://help.qargo.com/fr/articles/865547-integrations-api-qargo-quoi-pourquoi-et-comment.md)
- [Factures – Traiter une facture d'achat via Peppol](https://help.qargo.com/fr/articles/523845-factures-traiter-une-facture-dachat-via-peppol.md)
- [Portail client – Créer des commandes en masse à partir d'un fichier Excel ou CSV](https://help.qargo.com/fr/articles/879687-portail-client-creer-des-commandes-en-masse-a-partir-d-un-fichier-excel-ou-csv.md)
- [Configuration : utiliser des règles pour l'affectation automatique des champs.](https://help.qargo.com/fr/articles/545498-configuration-utiliser-des-regles-pour-l-affectation-automatique-des-champs.md)
