---
title: "Import de données – Importer les données des véhicules"
description: "Guide complet de l'import des données des véhicules, qui permet de créer en masse les véhicules de l'organisation et de ses sous-traitants. Cette étape est essentielle pour préparer la flotte à l'affectation."
url: https://help.qargo.com/fr/articles/410124-import-de-donnees-importer-les-donnees-des-vehicules
locale: fr
updated: 2026-04-28
---

# Import de données – Importer les données des véhicules

L'import des données des véhicules permet de créer des véhicules en masse, qu'ils appartiennent à l'entreprise elle-même ou à un sous-traitant. Cette étape est essentielle pour préparer le système Qargo à l'affectation des missions de transport et à la gestion de la flotte. Cet article présente les exigences spécifiques, les bonnes pratiques et les problèmes courants liés à l'import des données des véhicules.

* * *

## 📖 Terminologie clé {#h_a9468b26c5}

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

-   **Véhicule :** camion, tracteur, remorque, châssis, fourgon ou tout autre type de véhicule utilisé pour le transport.
-   **Plaque d'immatriculation :** identifiant unique d'un véhicule.
-   **Sous-traitant :** entreprise qui fournit des services de transport à l'organisation.
-   **Code :** identifiant unique d'un véhicule provenant d'un système externe, qui permet de garantir l'exactitude des mises à jour des données.


* * *

## ✅ Exigences essentielles pour l'import des véhicules {#h_ca526c2a01}

Avant d'importer les données des véhicules, 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 véhicule appartenant à un sous-traitant, la fiche entreprise de ce sous-traitant **doit** déjà exister dans le système Qargo. L'import échoue si le sous-traitant indiqué est introuvable.
-   **Identification unique :** Qargo identifie les véhicules existants grâce à leur **Plaque d'immatriculation** unique.
-   **Champs obligatoires :** le **Nom** et le **Type** **de véhicule** (par ex. tracteur, fourgon, porteur) sont des champs obligatoires. L'import échoue s'ils sont laissés vides.


* * *

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

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

Un modèle de tableur spécifique est disponible pour téléverser les données des véhicules. **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 véhicules](https://docs.google.com/spreadsheets/d/1yba-Jx7i8ZYdzJyrPERF3ml6ZblR-j7reHnWVsV1Wgk/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/de35f0f15581-image.png)

:::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_2b39b03fe8}

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 : envoyer les données pour le téléversement {#h_320a9dd39d}

1.  **Pendant l'intégration :** travailler directement avec le **responsable de l'intégration** pour téléverser les premières données 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 **chargé de compte**. Cette personne aide au téléversement et apporte une assistance continue.


* * *

## 📝 Détail du modèle d'import des véhicules {#h_586278d525}

Le tableau suivant explique en détail, champ par champ, le modèle Excel d'import des véhicules, notamment 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** |
| --- | --- | --- | --- |
| vehicle\_type | Obligatoire | TRACTOR/VAN/RIGID/TRAILER | TRAILER |
| name | Obligatoire | Nom du véhicule affiché dans Qargo | 12BLT2 ou VAN2 |
| code | Facultatif |  |  |
| note | Facultatif |  |  |
| manufacturer | Facultatif |  | Exagon |
| model | Facultatif |  | B12 |
| vin\_number | Facultatif |  |  |
| license\_plate | Facultatif |  | 12BLT2 |
| axle\_configuration | Facultatif | Par ex. 4 x 2 : 4 correspond aux roues de la remorque et 2 aux roues motrices (tracteur/unité motrice).\
La configuration des essieux doit être saisie correctement pour un calcul précis des péages dans certains pays, comme la France. | 4 x 2 |
| roof type | Facultatif | CLOSED, OPEN ou FLATBED | CLOSED |
| fuel\_type | Facultatif | DIESEL, BIOFUELS, LPG, ELECTRIC, HYBRID\_ELECTRIC | DIESEL |
| emission\_class | Facultatif |  | EURO\_3 |
| subcontractor\_company | Facultatif |  |  |
| co3\_object\_id | Facultatif |  |  |
| co3\_active | Facultatif |  | TRUE ou FALSE |
| verizon\_connect\_object\_id | Facultatif |  |  |
| verizon\_connect\_active | Facultatif |  | TRUE ou FALSE |
| transics\_object\_id | Facultatif |  |  |
| transics\_active | Facultatif |  | TRUE ou FALSE |
| trimble\_object\_id | Facultatif |  |  |
| trimble\_active | Facultatif |  | TRUE ou FALSE |
| webfleet\_object\_id | Facultatif |  |  |
| webfleet\_active | Facultatif |  | TRUE ou FALSE |
| samsara\_object\_id | Facultatif |  |  |
| samsara\_active | Facultatif |  | TRUE ou FALSE |
| generic\_object\_id | Facultatif |  |  |
| generic\_active | Facultatif |  | TRUE ou FALSE |
| generic\_integration\_code | Facultatif |  |  |
| archived | Facultatif |  | TRUE ou null |
| tare\_weight | Facultatif | Kilogrammes | 1,0 |
| gross\_weight | Facultatif | Tonnes | 1 |
| capacity\_weight | Facultatif |  | 1 |
| capacity\_volume | Facultatif | m³ | 1,000 |
| capacity\_ldm | Facultatif |  | 1 |
| capacity\_pallet\_spaces | Facultatif |  | 1 |
| capacity\_length | Facultatif | Mètres | 1,000 |
| capacity\_width | Facultatif | Mètres | 1,000 |
| capacity\_height | Facultatif | Mètres | 1,000 |
| exterior\_height | Facultatif | Mètres | 1,000 |
| exterior\_width | Facultatif | Mètres | 1,000 |
| exterior\_length | Facultatif | Mètres | 1,000 |
| validity\_start\_timestamp | Facultatif | AA/MM/JJ | 2020/01/20 |
| validity\_end\_timestamp | Facultatif | AA/MM/JJ | 2026/01/20 |
| validity\_description | Facultatif |  |  |
| 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 |  |

* * *

## 🔎 Résolution des erreurs courantes lors de l'import des véhicules {#h_9c482ad863}

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

-   **Fiche du sous-traitant introuvable :** il s'agit de l'erreur la plus fréquente pour les véhicules des 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 véhicules puissent être importés.
-   **Champs obligatoires manquants :** l'import échoue pour toute ligne dont le **Nom du véhicule** ou le **Type** est laissé vide.
-   **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.
-   **Type de véhicule non valide :** vérifier que le type de véhicule saisi (par ex. « TRAILER ») est une option valide dans la plateforme Qargo.
-   **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 dues à 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 d'utiliser une apostrophe pour un champ donné.**
-   **Champs personnalisés :** le nom de la colonne doit respecter la convention **custom\_field\_\_\[ID\]** (sans oublier le double tiret bas qui relie le préfixe **custom\_field** à l'ID unique du champ), l'ID étant récupéré dans les paramètres de l'organisation dans 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 véhicules {#h_465c7c8620}

Pour 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 véhicules 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 :** porter une attention particulière aux champs **Entreprise sous-traitante** et **Plaque d'immatriculation**. Toute faute d'orthographe ou différence de majuscules empêche l'établissement du lien.
-   **Utiliser le champ Code :** bien qu'il soit facultatif, l'utilisation du champ **Code** est vivement recommandée. Elle offre un moyen fiable de mettre à jour les fiches des véhicules et évite les conflits.


* * *

## ➡️ Étapes suivantes {#h_d571dd8dce}

Une fois les véhicules importés avec succès, ils peuvent être associés à des chauffeurs dans des combinaisons et utilisés dans des commandes. Les étapes suivantes logiques sont notamment :

-   **Importer les chauffeurs :** si nécessaire, les chauffeurs internes ou sous-traitants peuvent désormais être importés.
-   **Configurer les combinaisons :** les véhicules peuvent être associés en masse à des chauffeurs en créant des combinaisons.


* * *

## 📈 Cas d'usage de l'import des véhicules {#h_fc5c3e5aab}

L'import des données des véhicules 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 véhicules, y compris les véhicules en propre et ceux des sous-traitants réguliers.
-   **Intégration d'une nouvelle flotte :** lors de l'acquisition d'une nouvelle unité commerciale ou d'une nouvelle flotte, le détail de ses véhicules peut être ajouté en masse dans le système Qargo.

:::callout{tone="info"}
📚 En cas d'utilisation de plusieurs entités de facturation, des champs personnalisés supplémentaires sont nécessaires. Contacter le chargé de compte pour plus d'informations.
:::


## Articles connexes

- [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 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 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 de validité](https://help.qargo.com/fr/articles/410135-import-de-donnees-importer-les-donnees-de-validite.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)
