---
title: "Import de données : importer les données des chauffeurs"
description: "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."
url: https://help.qargo.com/fr/articles/410123-import-de-donnees-importer-les-donnees-des-chauffeurs
locale: fr
updated: 2025-12-12
---

# Import de données : importer les données 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é {#h_9a1ad56651}

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 {#h_b0d321235e}

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 {#h_aeb4d4151d}

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

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 :**

1.  Cliquer sur le lien : [Modèle d'import des données des chauffeurs](https://docs.google.com/spreadsheets/d/1tYtM6ZtL08gecubOpcVx2kHeO6u-1Hl6l5KkeOKtgPQ/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/d3c27d457891-image.png)

:::callout{tone="info"}
📚 Toujours utiliser un **modèle vierge** téléchargé directement ici 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_8292b64868}

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 {#h_6247b2c91e}

1.  **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.
2.  **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 {#h_19376bf01f}

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](mailto: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 {#h_035d34b395}

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 non `VAT_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 :

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

-   **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 :

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

* * *

## ✨ Bonnes pratiques pour l'import des chauffeurs {#h_f96cba1ae8}

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 {#h_0edeb1150f}

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 {#h_533ed52661}

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.


## Articles connexes

- [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 véhicules](https://help.qargo.com/fr/articles/410124-import-de-donnees-importer-les-donnees-des-vehicules.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 contacts d'emplacement](https://help.qargo.com/fr/articles/494334-import-de-donnees-importer-des-donnees-de-contacts-d-emplacement.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)
