Import de données : importer les données de validité
Guide complet de l'import des données de validité. Ce processus met à jour en masse les dates d'expiration des documents et certificats des chauffeurs et des véhicules.
Table des matières
- 📖 Terminologie clé
- ✅ Exigences essentielles pour l’import des validités
- 🛠️ Processus d’import de 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 validités
- 🔎 Résolution des erreurs fréquentes lors de l’import des validités
- ✨ Bonnes pratiques pour l’import des validités
- ➡️ Étapes suivantes
- 📈 Cas d’usage de l’import des validités
L’import des données de validité permet de mettre à jour en masse les dates d’expiration des documents et certificats affectés aux chauffeurs et aux véhicules. Cet import sert à mettre à jour des enregistrements existants, et non à en créer de nouveaux. Il permet de s’assurer rapidement et efficacement que toute la documentation des ressources, comme les permis de conduire et les certificats de contrôle technique des véhicules, est à jour dans le système.
📖 Terminologie clé
Les termes suivants sont définis pour faciliter la lecture de ce guide.
- Validité : période pendant laquelle un document ou un certificat est en vigueur et juridiquement contraignant.
- Ressource : terme désignant un chauffeur ou un véhicule.
- Type de ressource : type précis de document dont la validité est mise à jour (par ex. permis de conduire, certificat ADR, contrôle technique).
✅ Exigences essentielles pour l’import des validités
Avant d’importer des données de validité, les exigences et avertissements suivants doivent être pris en compte pour garantir l’intégrité des données.
- Prérequis pour la ressource : le dossier du chauffeur ou du véhicule doit déjà exister dans Qargo. Cet import sert uniquement à mettre à jour les documents de ressources existantes. Il ne permet pas de créer de nouvelles ressources.
- Prérequis pour le type de ressource : le Type de ressource doit être défini dans les paramètres de la plateforme Qargo avant toute tentative d’import.
- Champs obligatoires : l’ID externe de la ressource, le Type de document et la date Valable jusqu’au sont des champs obligatoires pour chaque enregistrement.
- Format de date : le format de date utilisé dans le modèle doit être correct et conforme aux exigences de la plateforme.
🛠️ Processus d’import de données étape par étape
Étape 1 : télécharger le modèle
Un modèle de feuille de calcul spécifique est disponible pour téléverser les données de validité. 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 validité
- 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.
- Mise en forme : une attention particulière doit être portée au format de données spécifié (par ex. dates, nombres, texte).
Étape 3 : soumettre pour téléversement
- Pendant la mise en route : travailler directement avec le responsable de la mise en route pour téléverser les données métier initiales. Ce responsable guide l’entreprise tout au long du processus et veille à la réussite de l’import.
- Après la mise en route : pour toutes les futures mises à jour et tous les futurs imports de données, contacter le gestionnaire de compte. Le gestionnaire de compte accompagne le processus de téléversement et fournit une assistance continue.
📝 Détail du modèle d’import des validités
Le tableau suivant explique en détail, champ par champ, le modèle Excel d’import des validités, avec les formats de données, les champs obligatoires et les bonnes pratiques pour remplir chaque colonne.
| Nom de colonne | Obligatoire/facultatif | Remarques | Exemple |
|---|---|---|---|
| resource_name | Obligatoire | Nom du chauffeur | |
| resource_type | Obligatoire | Chauffeur, sous-traitant, type de véhicule, conteneur, etc. | |
| description | |||
| category | Obligatoire | Document ou indisponibilité | |
| subcategory | Obligatoire | Type de document spécifique | Driver_Driving_License |
| start_timestamp | Obligatoire | Année/Mois/Jour | 2016/09/20 |
| end_timestamp | Obligatoire | Année/Mois/Jour | 2026/09/20 |
| legal_end_timestamp | Obligatoire | Année/Mois/Jour | 2026/09/20 |
🔎 Résolution des erreurs fréquentes lors de l’import des validités
Cette section traite des erreurs spécifiques qui peuvent survenir lors de l’import des données de validité.
- Ressource introuvable : il s’agit de l’erreur la plus fréquente. Elle se produit lorsque la Ressource indiquée dans le modèle ne correspond pas exactement à un chauffeur ou à un véhicule existant dans Qargo.
- Type de ressource introuvable : l’import échoue si le Type de ressource indiqué dans le modèle n’a pas été défini au préalable dans les paramètres de la plateforme Qargo.
- 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.
- Format de date non valide : ce problème peut faire échouer l’import. Il est important de saisir la date Valable jusqu’au dans un format correct et cohérent (Année/Mois/Jour).
- En-têtes de colonnes sensibles à la casse : les en-têtes de colonnes doivent respecter la casse exacte (par ex.
vat_number, et nonVAT_number). Avec une casse incorrecte, 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 d’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. Il n’est dérogé à cette règle que si l’article indique explicitement d’utiliser une apostrophe pour un champ spécifique.
✨ Bonnes pratiques pour l’import des validités
Pour un import fluide et précis, tenir compte des bonnes pratiques suivantes.
- Terminer d’abord les prérequis : il est essentiel de s’assurer que tous les chauffeurs et véhicules ont déjà été importés avec succès dans le système avant de mettre à jour leurs données de validité.
- Garantir la cohérence des données : veiller à l’orthographe et aux majuscules de la Ressource et du Type de ressource.
➡️ Étapes suivantes
Une fois les données de validité importées avec succès, les dates d’expiration des documents et certificats sont mises à jour dans le système. Le tableau de bord Qargo et les profils des ressources offrent alors une vue claire des prochaines dates d’expiration, ce qui permet une gestion proactive des documents.
📈 Cas d’usage de l’import des validités
L’import des données de validité est un outil précieux pour plusieurs processus métier clés.
- Renouvellements annuels : le principal cas d’usage consiste à mettre à jour en masse un grand nombre de documents qui expirent régulièrement, comme les certificats de contrôle technique des véhicules ou les licences de transport routier.
- Mises à jour des permis de conduire : cette méthode simplifie la mise à jour des périodes de validité de tous les chauffeurs dont le permis a été renouvelé.
