Import de données – Importer des données de conteneurs
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.
Table des matières
- 📖 Terminologie clé
- ✅ Exigences essentielles pour l’import des conteneurs
- 🛠️ Processus d’import des données étape par étape
- Étape 1 : télécharger le modèle
- Étape 2 : compléter le modèle Excel
- Étape 3 : soumettre pour téléversement
- 📝 Détails du modèle d’import des conteneurs
- 🔎 Résolution des erreurs courantes d’import des conteneurs
- ✨ Bonnes pratiques pour l’import des conteneurs
- ➡️ Étapes suivantes
- 📈 Cas d’usage de l’import des 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é
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
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
Étape 1 : télécharger le modèle
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 :
- Cliquer sur le lien : Modèle d’import des données de conteneurs
- Une fois le modèle ouvert, aller dans Fichier et sélectionner Télécharger
- Enregistrer le modèle (au format .xlsx ou .csv) sur l’ordinateur et commencer à saisir les données de l’entreprise.

Étape 2 : compléter le modèle Excel
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
- 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.
- 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
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
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
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 nonVAT_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 :

✨ Bonnes pratiques pour l’import des conteneurs
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
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
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.
