---
title: "Import de données – Importer des données de conteneurs"
description: "Guide complet de l'import des données de conteneurs. Ce processus permet de créer en masse les conteneurs de l'organisation et de ses sous-traitants, et fournit un catalogue directement disponible pour la création de commandes."
url: https://help.qargo.com/fr/articles/410131-import-de-donnees-importer-des-donnees-de-conteneurs
locale: fr
updated: 2026-08-07
---

# Import de données – Importer des données de conteneurs

L'import des données de conteneurs permet de créer en masse des conteneurs, qui peuvent appartenir à l'entreprise elle-même ou à un sous-traitant. Cette étape est essentielle pour les organisations qui gèrent leur propre parc de conteneurs. Elle fournit en effet une base de données directement disponible pour la création de commandes. Cet article présente les exigences spécifiques, les bonnes pratiques et les problèmes courants liés à l'import des données de conteneurs.

* * *

## 📖 Terminologie clé {#h_bb93f4d3d4}

Pour plus de clarté, les termes suivants sont définis pour l'ensemble de ce guide.

-   **Conteneur :** unité de transport et de stockage réutilisable.
-   **N° du conteneur :** identifiant unique d'un conteneur.
-   **Sous-traitant :** entreprise qui possède ou exploite un conteneur.
-   **Code :** identifiant unique d'un conteneur provenant d'un système externe, qui permet de garantir des mises à jour de données exactes.


* * *

## ✅ Exigences essentielles pour l'import des conteneurs {#h_a8dc0ba2c5}

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

-   **Prérequis pour les sous-traitants :** avant de pouvoir importer un conteneur appartenant à un sous-traitant, la fiche entreprise de ce sous-traitant **doit** déjà exister dans Qargo. L'import échoue si le sous-traitant indiqué est introuvable.
-   **Identification unique :** Qargo identifie les conteneurs existants grâce à leur **N° du conteneur** unique.
-   **Champ obligatoire :** le **Nom** du conteneur est un champ obligatoire. L'import échoue si ce champ est laissé vide.


* * *

## 🛠️ Processus d'import des données étape par étape {#h_0320dd7921}

## Étape 1 : télécharger le modèle {#h_256dbde572}

Un modèle de tableur spécifique est disponible pour téléverser les données de conteneurs. **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'import des données de conteneurs](https://docs.google.com/spreadsheets/d/18iCOvgK_GFgtOPK6h02Vb1Dq7hKqKnwretYO5j4nrC0/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/035e09bc7dbc-image.png)

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

## Étape 2 : compléter le modèle Excel {#h_2cf9e27d5d}

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 :** veiller à compléter tous les champs obligatoires (la liste complète des champs obligatoires figure dans la section suivante de cet article). L'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 téléversement {#h_33834aab0f}

1.  **Pendant l'onboarding :** travailler directement avec le **responsable onboarding** pour téléverser les données métier initiales. Ce contact accompagne tout au long 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 **chargé de compte**. Ce contact aide au téléversement et assure une assistance continue.


* * *

## 📝 Détails du modèle d'import des conteneurs {#h_723b086936}

Le tableau suivant explique en détail, champ par champ, le modèle Excel d'import des conteneurs. Il précise les formats de données, les champs obligatoires et les bonnes pratiques pour compléter chaque colonne.

| **Nom de la colonne** | **Obligatoire/facultatif** | **Remarques** | **Exemple** |
| --- | --- | --- | --- |
| name | Obligatoire | Nom du conteneur affiché dans Qargo |  |
| code | Facultatif |  |  |
| manufacturer | Facultatif |  | Exagon |
| container\_number | Facultatif |  | 1212 |
| standard\_size | Facultatif |  | Feet\_25 |
| note | Facultatif |  |  |
| subcontractor\_company | Facultatif |  |  |
| gross\_weight | Facultatif | Tonnes | 1 |
| tare\_weight | Facultatif | Kilogrammes | 1.0 |
| capacity\_volume | Facultatif | m³ | 1.000 |
| capacity\_weight | Facultatif |  | 1 |
| exterior\_length | Facultatif | Mètres | 1.000 |
| exterior\_width | Facultatif | Mètres | 1.000 |
| exterior\_height | Facultatif | Mètres | 1.000 |
| custom\_fields\_\_example | Facultatif | Pour importer des valeurs de champs personnalisés. Remarque : le format utilise un double tiret bas (`__`) pour relier le préfixe **custom\_fields** à l'ID unique du champ |  |

### Taille standard : valeurs acceptées {#h_b0b8beeb1c}

La colonne `standard_size` accepte les valeurs suivantes. Le format doit correspondre exactement (le champ n'est pas sensible à la casse, mais le modèle de tiret bas et de majuscules ci-dessous est recommandé) :

| **Valeur** | **Taille** |
| --- | --- |
| `Feet_20` | 20 ft |
| `Feet_23` | 23 ft |
| `Feet_24` | 24 ft |
| `Feet_25` | 25 ft |
| `Feet_26` | 26 ft |
| `Feet_30` | 30 ft |
| `Feet_35` | 35 ft |
| `Feet_40` | 40 ft |

* * *

## 🔎 Résolution des erreurs courantes d'import des conteneurs {#h_7279833172}

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

-   **Fiche sous-traitant introuvable :** c'est l'erreur la plus fréquente pour les conteneurs appartenant à un sous-traitant. Elle se produit lorsque le nom de l'**entreprise sous-traitante** indiqué dans le modèle ne correspond pas exactement à une entreprise existante dans Qargo. Le sous-traitant doit exister dans le système avant que ses conteneurs puissent être importés.
-   **Nom de la feuille :** la feuille du fichier modèle Excel doit s'appeler exactement **« Import »**. Tout autre nom provoque une erreur lors du téléversement du fichier.
-   **Champ obligatoire manquant :** l'import échoue pour toute ligne dont le nom du **conteneur** est laissé vide.
-   **En-têtes de colonnes sensibles à la casse :** les en-têtes de colonnes doivent être saisis avec la bonne casse (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.
-   **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 si l'article indique explicitement d'utiliser une apostrophe pour un champ précis.**
-   **Champs personnalisés :** le nom de la colonne doit respecter la convention **custom\_field\_\_\[ID\]** (ne pas oublier de conserver le double tiret bas qui relie le préfixe **custom\_field** à l'ID unique du champ), l'ID précis étant récupéré dans les paramètres de l'organisation Qargo. Cliquer sur le bouton de copie à côté du champ personnalisé pour copier son ID :

    ![](https://help.qargo.com/media/a6013003827e-796a5c17-3b5e-4a0d-9642-08cfd8176cd4.png)


* * *

## ✨ Bonnes pratiques pour l'import des conteneurs {#h_90ca1ae879}

Pour garantir un import fluide et exact, il est conseillé de suivre les bonnes pratiques suivantes.

-   **S'assurer que les données des sous-traitants sont complètes :** avant d'importer les conteneurs des sous-traitants, vérifier que tous les sous-traitants concernés ont déjà été importés avec succès dans le système en tant qu'entreprises.
-   **Garantir la cohérence des données :** prêter une attention particulière à l'orthographe et aux majuscules des **noms des sous-traitants** et des **N° du conteneur**. Toute incohérence empêche la liaison.
-   **Utiliser le code du conteneur :** bien que facultative, l'utilisation du champ **Code** des conteneurs est vivement recommandée. Elle offre un moyen fiable de mettre à jour les fiches des conteneurs et évite les conflits liés aux numéros en double.

* * *

## ➡️ Étapes suivantes {#h_122fb131d9}

Une fois les conteneurs importés avec succès, ils peuvent être utilisés pour la création de commandes. Les étapes suivantes logiques sont notamment :

-   **Importer des produits :** si nécessaire, les produits utilisés pour la création de commandes peuvent être importés en masse.
-   **Importer des commandes :** un échantillon de commandes de test peut être importé pour alimenter un environnement sandbox.


* * *

## 📈 Cas d'usage de l'import des conteneurs {#h_0d31aa2d5e}

L'import des données de conteneurs est un outil précieux pour plusieurs processus métier clés.

-   **Configuration initiale du parc :** le principal cas d'usage consiste à alimenter un tenant Qargo avec l'ensemble d'un parc de conteneurs, qu'il s'agisse des conteneurs détenus en propre ou de ceux des sous-traitants réguliers.
-   **Intégration d'un nouveau parc :** lors de l'acquisition d'une nouvelle unité commerciale ou d'un nouveau parc de conteneurs, leurs détails peuvent être ajoutés en masse dans Qargo.


## Articles connexes

- [Import de données – Importer les données des véhicules](https://help.qargo.com/fr/articles/410124-import-de-donnees-importer-les-donnees-des-vehicules.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)
- [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 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)
- [Importation de données : importer les données produits](https://help.qargo.com/fr/articles/410133-importation-de-donnees-importer-les-donnees-produits.md)
