Skip to main content
Qargo

Gegevensimport: geldigheidsgegevens importeren

Een uitgebreide handleiding voor het importeren van geldigheidsgegevens. Met dit proces worden de vervaldatums van documenten en certificaten van chauffeurs en voertuigen in bulk bijgewerkt.

Inhoudsopgave
  1. 📖 Belangrijke termen
  2. ✅ Essentiële vereisten voor de import van geldigheid
  3. 🛠️ Gegevensimport stap voor stap
  4. Stap 1: sjabloon downloaden
  5. Stap 2: het Excel-sjabloon invullen
  6. Stap 3: aanleveren voor upload
  7. 📝 Details van het sjabloon voor de import van geldigheid
  8. 🔎 Veelvoorkomende fouten bij de import van geldigheid oplossen
  9. ✨ Goede praktijken voor de import van geldigheid
  10. ➡️ Volgende stappen
  11. 📈 Toepassingen van de import van geldigheid

De import van geldigheidsgegevens dient om de vervaldatums van documenten en certificaten van chauffeurs en voertuigen in bulk bij te werken. Deze import is bedoeld om bestaande records bij te werken, niet om nieuwe aan te maken. Zo is snel en efficiënt te garanderen dat alle documentatie van resources, zoals rijbewijzen en keuringsbewijzen van voertuigen, in het systeem actueel is.


📖 Belangrijke termen

Voor de duidelijkheid worden in deze handleiding de volgende termen gebruikt.

  • Geldigheid: de periode waarin een document of certificaat actief en wettelijk bindend is.
  • Resource: een term voor een chauffeur of een voertuig.
  • Resourcetype: het specifieke type document waarvan de geldigheid wordt bijgewerkt (bv. rijbewijs, ADR-certificaat, voertuigkeuring).

✅ Essentiële vereisten voor de import van geldigheid

Voor het importeren van geldigheidsgegevens moet met de volgende vereisten en waarschuwingen rekening worden gehouden om de integriteit van de gegevens te garanderen.

  • Vereiste voor resources: het record van de chauffeur of het voertuig moet al in Qargo bestaan. Deze import dient alleen om documenten van bestaande resources bij te werken en kan niet worden gebruikt om nieuwe resources aan te maken.
  • Vereiste voor resourcetypes: het resourcetype moet vóór de import al in de instellingen van het Qargo-platform zijn gedefinieerd.
  • Verplichte velden: de externe ID van de resource, het documenttype en de datum Geldig tot zijn verplichte velden voor elk record.
  • Datumformaat: het datumformaat in het sjabloon moet correct zijn en overeenkomen met de vereisten van het platform.

🛠️ Gegevensimport stap voor stap

Stap 1: sjabloon downloaden

Voor het uploaden van geldigheidsgegevens is een specifiek spreadsheetsjabloon beschikbaar. Om de gegevens te kunnen bewerken en uploaden, is een kopie van het sjabloon nodig:

  1. Klikken op de link: Sjabloon voor de import van geldigheidsgegevens
  2. Zodra het sjabloon geopend is, naar Bestand gaan en Downloaden selecteren
  3. Het sjabloon (in .xlsx- of .csv-formaat) op de computer opslaan en beginnen met het invoeren van de bedrijfsgegevens.

Stap 2: het Excel-sjabloon invullen

Het sjabloon openen en met de vereiste gegevens invullen. Het sjabloon bevat kolomkoppen die overeenkomen met de velden in Qargo.

  • Verplichte velden: alle verplichte velden invullen (een volledige lijst van de verplichte velden staat in de volgende sectie van dit artikel). Een import mislukt als deze velden leeg blijven.
  • Opmaak: goed letten op het opgegeven gegevensformaat (bv. datums, getallen, tekst).

Stap 3: aanleveren voor upload

  1. Tijdens de onboarding: rechtstreeks samenwerken met de onboardingmanager om de initiële bedrijfsgegevens te uploaden. De onboardingmanager begeleidt het proces en zorgt voor een geslaagde import.
  2. Na de onboarding: voor alle toekomstige updates en imports van gegevens contact opnemen met de accountmanager. De accountmanager helpt bij het uploaden en biedt doorlopende support.

📝 Details van het sjabloon voor de import van geldigheid

De volgende tabel geeft per veld een gedetailleerde uitleg van het Excel-sjabloon voor de import van geldigheid, met gegevensformaten, verplichte velden en goede praktijken voor het invullen van elke kolom.

Kolomnaam Verplicht/optioneel Opmerkingen Voorbeeld
resource_name Verplicht Naam van de chauffeur
resource_type Verplicht Chauffeur, onderaannemer, voertuigtype, container, enz.
description
category Verplicht Document of onbeschikbaarheid
subcategory Verplicht Specifiek type document Driver_Driving_License
start_timestamp Verplicht Jaar/maand/dag 2016/09/20
end_timestamp Verplicht Jaar/maand/dag 2026/09/20
legal_end_timestamp Verplicht Jaar/maand/dag 2026/09/20

🔎 Veelvoorkomende fouten bij de import van geldigheid oplossen

Deze sectie behandelt specifieke fouten die bij de import van geldigheidsgegevens kunnen optreden.

  • Resource niet gevonden: dit is de meest voorkomende fout. Die treedt op als de resource in het sjabloon niet exact overeenkomt met een bestaande chauffeur of een bestaand voertuig in Qargo.
  • Resourcetype niet gevonden: de import mislukt als het opgegeven resourcetype in het sjabloon niet vooraf in de instellingen van het Qargo-platform is gedefinieerd.
  • Naam van het tabblad: het tabblad in het Excel-sjabloon moet exact ‘Import’ heten. Elke andere naam veroorzaakt een fout bij het uploaden van het bestand.
  • Ongeldig datumformaat: dit kan de import doen mislukken. Het is belangrijk dat de datum Geldig tot in een correct en consistent formaat wordt ingevoerd (jaar/maand/dag).
  • Hoofdlettergevoelige kolomkoppen: kolomkoppen moeten met de juiste hoofdletters en kleine letters worden ingevoerd (bv. vat_number, niet VAT_number). Bij verkeerd gebruik van hoofdletters worden de gegevens in die kolom zonder melding genegeerd en niet geïmporteerd, omdat het systeem de kolomkop niet herkent.
  • Fouten door een apostrof aan het begin: gegevens in een cel mogen niet met een apostrof (’) beginnen. Bij gebruik van een apostrof herkent het systeem de waarde niet en kan er een fout optreden. Deze regel vervalt alleen als het artikel uitdrukkelijk aangeeft dat voor een specifiek veld een apostrof moet worden gebruikt.

✨ Goede praktijken voor de import van geldigheid

Voor een vlotte en nauwkeurige import zijn de volgende goede praktijken aan te raden.

  • Eerst de vereisten voltooien: het is essentieel dat alle chauffeurs en voertuigen al met succes in het systeem zijn geïmporteerd voordat hun geldigheidsgegevens worden bijgewerkt.
  • Gegevens consistent houden: goed letten op de spelling en het gebruik van hoofdletters bij resource en resourcetype.

➡️ Volgende stappen

Zodra de geldigheidsgegevens met succes zijn geïmporteerd, worden de vervaldatums van documenten en certificaten in het systeem bijgewerkt. Het Qargo-dashboard en de profielen van de resources geven dan een duidelijk overzicht van de komende vervaldatums, wat een proactief documentbeheer mogelijk maakt.


📈 Toepassingen van de import van geldigheid

Het importeren van geldigheidsgegevens is een zeer waardevol hulpmiddel voor verschillende belangrijke bedrijfsprocessen.

  • Jaarlijkse vernieuwingen: de belangrijkste toepassing is het in bulk bijwerken van een groot aantal documenten die regelmatig vervallen, zoals keuringsbewijzen van voertuigen of wegvergunningen.
  • Updates van rijbewijzen: dit biedt een eenvoudige manier om de geldigheidsperiodes bij te werken voor alle chauffeurs van wie het rijbewijs is vernieuwd.