Import de données : importer les données des chauffeurs
Guide complet de l'import des données des chauffeurs, qui permet de créer en masse des chauffeurs internes et des chauffeurs de sous-traitants. Cette étape est essentielle pour préparer le système Qargo à dispatcher.
Table des matières
- 📖 Terminologie clé
- ✅ Exigences essentielles pour l’import des chauffeurs
- 🛠️ 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étail du modèle d’import des chauffeurs
- 🔎 Résoudre les erreurs fréquentes d’import des chauffeurs
- ✨ Bonnes pratiques pour l’import des chauffeurs
- ➡️ Étapes suivantes
- 📈 Cas d’usage de l’import des chauffeurs
L’import des données des chauffeurs permet de créer des chauffeurs en masse, qu’il s’agisse de chauffeurs internes ou de chauffeurs de sous-traitants. Cette étape est essentielle pour préparer le système Qargo à dispatcher et à gérer les commandes. Cet article présente les exigences spécifiques, les bonnes pratiques et les problèmes fréquents liés à l’import des données des chauffeurs.
📖 Terminologie clé
Pour plus de clarté, les termes suivants sont définis pour l’ensemble de ce guide.
- Chauffeur : personne qui conduit un véhicule pour des missions de transport.
- Chauffeur interne : chauffeur directement employé par l’entreprise.
- Chauffeur de sous-traitant : chauffeur employé par un sous-traitant.
- Nom du sous-traitant : nom de l’entreprise à laquelle le chauffeur est lié. Il doit correspondre exactement à une entreprise déjà présente dans le système Qargo.
✅ Exigences essentielles pour l’import des chauffeurs
Avant d’importer les données des chauffeurs, il faut tenir compte des exigences et avertissements suivants pour garantir l’intégrité des données.
- Prérequis pour les sous-traitants : avant de pouvoir importer un chauffeur appartenant à un sous-traitant, la fiche entreprise du sous-traitant doit déjà exister dans le système Qargo. L’import échoue si le sous-traitant indiqué est introuvable.
- Champs obligatoires : le Nom complet est un champ obligatoire. Qargo identifie les chauffeurs existants principalement par leur Nom complet. 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 des chauffeurs. 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 des chauffeurs
- 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 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 (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’intégration : travailler directement avec le responsable de l’intégration pour téléverser les données initiales de l’entreprise. Cette personne accompagne tout le processus et veille à la réussite de l’import.
- Après l’intégration : pour toutes les mises à jour et tous les imports de données ultérieurs, contacter le gestionnaire de compte. Celui-ci accompagne le processus de téléversement et fournit une assistance continue.
📝 Détail du modèle d’import des chauffeurs
Voici une explication détaillée, champ par champ, du modèle Excel d’import des chauffeurs, avec les formats de données, les champs obligatoires et les bonnes pratiques pour compléter chaque colonne.
| Nom de colonne | Obligatoire/facultatif | Remarques | Exemple |
|---|---|---|---|
| name | Obligatoire | Nom du chauffeur affiché dans Qargo | Steve Johnson |
| code | Facultatif | Code unique | 12 |
| first_name | Obligatoire | Steve | |
| last_name | Obligatoire | Johnson | |
| phone_number | Facultatif | +334717727 | |
| date_of_birth | Facultatif | 27/12/1991 | |
| email_address | Obligatoire si l’application chauffeur est utilisée. | steve.johnson@qargo.io | |
| note | Facultatif | ||
| subcontractor_company | Facultatif | ||
| archived | Facultatif | TRUE ou null | |
| locale | Facultatif | Langue du chauffeur | en |
| custom_fields__example | Facultatif | Pour importer des valeurs de champs personnalisés. Remarque : le format utilise un double trait de soulignement (__) pour relier le préfixe custom_fields à |
|
| absence_planner_object_id | Facultatif | TRUE ou FALSE | |
| absence_planner_active | Facultatif | ||
| generic_object_id | Facultatif | ||
| generic_active | Facultatif | TRUE ou FALSE | |
| generic_integration_code | Facultatif | ||
| sage_hrm_object_id | Facultatif | ||
| sage_hrm_active | Facultatif | TRUE ou FALSE |
🔎 Résoudre les erreurs fréquentes d’import des chauffeurs
Cette section traite des erreurs spécifiques qui peuvent survenir lors de l’import des données des chauffeurs.
- Fiche du sous-traitant introuvable : c’est l’erreur la plus fréquente pour les chauffeurs de sous-traitants. Elle se produit lorsque le Nom du sous-traitant 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 chauffeurs puissent être importés.
- Chauffeurs en double : si deux chauffeurs ont exactement le même Nom complet, cela peut provoquer des conflits.
- 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.
- 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). Une casse incorrecte fait que 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 liées à une apostrophe en début de cellule : 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 spécifique.
- Format du numéro de téléphone : le numéro de téléphone doit comporter l’indicatif du pays suivi du numéro, sans espaces (par ex. +3212345678). Dans Excel/Google Sheets, le format de la colonne doit être Texte et, dans la barre de formule, il faut ajouter un ’ avant l’indicatif du pays et le numéro de téléphone (c.-à-d. ‘+3212345678) pour que le numéro de téléphone s’affiche correctement**.** Voir l’exemple ci-dessous :

- Champs personnalisés : le nom de colonne doit respecter la convention custom_field__[ID] (ne pas oublier de conserver le double trait de soulignement pour relier le préfixe custom_field à l’ID unique du champ), l’ID spécifique é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 chauffeurs
Pour un import fluide et exact, il est conseillé de suivre les bonnes pratiques ci-dessous.
- S’assurer que les données des sous-traitants sont complètes : avant d’importer des chauffeurs de 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.
- Assurer la cohérence des données : porter une attention particulière aux champs Nom du sous-traitant et Code. Toute faute d’orthographe ou différence de majuscules fait échouer la liaison.
- Utiliser le champ Code : bien qu’il soit facultatif, l’utilisation du champ Code est vivement recommandée. Il permet de mettre à jour de manière fiable les fiches des chauffeurs et évite les conflits liés aux noms en double.
➡️ Étapes suivantes
Une fois les chauffeurs importés avec succès, ils peuvent être affectés à des véhicules et à des combinaisons. Les étapes suivantes logiques sont les suivantes :
- Importer les véhicules : la flotte peut être constituée en important les véhicules appartenant à l’entreprise ou à ses sous-traitants.
- Configurer les combinaisons : les chauffeurs peuvent être liés en masse à des véhicules en créant des combinaisons.
📈 Cas d’usage de l’import des chauffeurs
L’import des données des chauffeurs est un outil précieux pour plusieurs processus métier clés.
- Configuration initiale de la flotte : le principal cas d’usage consiste à alimenter un tenant Qargo avec l’ensemble d’une flotte de chauffeurs, y compris les employés internes et les chauffeurs réguliers des sous-traitants.
- Intégration d’une nouvelle flotte : lors de l’acquisition d’une nouvelle unité commerciale ou d’une nouvelle flotte de chauffeurs, leurs informations peuvent être ajoutées en masse dans le système Qargo.
