Skip to main content
Qargo

Gegevensimport: voertuiggegevens importeren

Een uitgebreide gids voor het importeren van voertuiggegevens. Zo kunnen voertuigen van zowel de organisatie als haar onderaannemers in bulk worden aangemaakt. Dit is een cruciale stap om het wagenpark klaar te maken voor toewijzing.

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

Door voertuiggegevens te importeren, kunnen voertuigen in bulk worden aangemaakt. Die voertuigen kunnen tot het eigen bedrijf of tot een onderaannemer behoren. Dit is een cruciale stap om Qargo klaar te maken voor het toewijzen van opdrachten en het beheer van het wagenpark. Dit artikel beschrijft de specifieke vereisten, goede praktijken en veelvoorkomende problemen bij het importeren van voertuiggegevens.


📖 Belangrijke termen

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

  • Voertuig: een vrachtwagen, tractor, trailer, chassis, bestelwagen of elk ander type voertuig dat voor transport wordt gebruikt.
  • Nummerplaat: de unieke identificatie van een voertuig. Dit wordt ook wel kenteken genoemd.
  • Onderaannemer: een bedrijf dat transportdiensten levert aan de organisatie.
  • Code: een unieke identificatie van een voertuig uit een extern systeem. Hiermee kunnen gegevens nauwkeurig worden bijgewerkt.

✅ Belangrijke importvereisten voor voertuigen

Voordat voertuiggegevens worden geïmporteerd, moet met de volgende vereisten en waarschuwingen rekening worden gehouden om de integriteit van de gegevens te garanderen.

  • Onderaannemer als voorwaarde: voordat een voertuig van een onderaannemer kan worden geïmporteerd, moet het bedrijfsrecord van die onderaannemer al in Qargo bestaan. De import mislukt als de opgegeven onderaannemer niet kan worden gevonden.
  • Unieke identificatie: Qargo herkent bestaande voertuigen aan hun unieke Nummerplaat.
  • Verplichte velden: Naam en Voertuigtype (bv. Tractor, Bestelwagen, Vrachtwagen) zijn verplichte velden. Een import mislukt als deze velden leeg blijven.

🛠️ Gegevensimport stap voor stap

Stap 1: sjabloon downloaden

Er is een specifiek spreadsheetsjabloon beschikbaar om voertuiggegevens te uploaden. Om de gegevens te kunnen bewerken en uploaden, moet een kopie van het sjabloon worden gedownload:

  1. Klikken op de link: Sjabloon voor de import van voertuiggegevens
  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: 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 het volgende deel 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 uploadproces en biedt doorlopende support.

📝 Details van het sjabloon voor de voertuigimport

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

Kolomnaam Verplicht/optioneel Opmerkingen Voorbeeld
vehicle_type Verplicht TRACTOR/VAN/RIGID/TRAILER TRAILER
name Verplicht Naam van het voertuig zoals weergegeven in Qargo 12BLT2 of VAN2
code Optioneel
note Optioneel
manufacturer Optioneel Exagon
model Optioneel B12
vin_number Optioneel
license_plate Optioneel 12BLT2
axle_configuration Optioneel Bv. 4 x 2 = 4 is het aantal wielen van de trailer en 2 het aantal aangedreven wielen (tractor/trekkende eenheid).\
De asconfiguratie moet correct worden ingevoerd voor een nauwkeurige tolberekening in sommige landen, zoals Frankrijk. 4 x 2
roof type Optioneel CLOSED, OPEN of FLATBED CLOSED
fuel_type Optioneel DIESEL, BIOFUELS, LPG, ELECTRIC, HYBRID_ELECTRIC DIESEL
emission_class Optioneel EURO_3
subcontractor_company Optioneel
co3_object_id Optioneel
co3_active Optioneel TRUE of FALSE
verizon_connect_object_id Optioneel
verizon_connect_active Optioneel TRUE of FALSE
transics_object_id Optioneel
transics_active Optioneel TRUE of FALSE
trimble_object_id Optioneel
trimble_active Optioneel TRUE of FALSE
webfleet_object_id Optioneel
webfleet_active Optioneel TRUE of FALSE
samsara_object_id Optioneel
samsara_active Optioneel TRUE of FALSE
generic_object_id Optioneel
generic_active Optioneel TRUE of FALSE
generic_integration_code Optioneel
archived Optioneel TRUE of null
tare_weight Optioneel Kilogram 1.0
gross_weight Optioneel Ton 1
capacity_weight Optioneel 1
capacity_volume Optioneel m³ 1.000
capacity_ldm Optioneel 1
capacity_pallet_spaces Optioneel 1
capacity_length Optioneel Meter 1.000
capacity_width Optioneel Meter 1.000
capacity_height Optioneel Meter 1.000
exterior_height Optioneel Meter 1.000
exterior_width Optioneel Meter 1.000
exterior_length Optioneel Meter 1.000
validity_start_timestamp Optioneel JJ/MM/DD 2020/01/20
validity_end_timestamp Optioneel JJ/MM/DD 2026/01/20
validity_description Optioneel
custom_fields__example Optioneel Om waarden van aangepaste velden te importeren. Opmerking: het formaat gebruikt een dubbele underscore (__) om het voorvoegsel custom_fields te verbinden met de unieke veld-ID

🔎 Veelvoorkomende fouten bij de voertuigimport oplossen

Dit deel behandelt specifieke fouten die zich bij de import van voertuiggegevens kunnen voordoen.

  • Record van onderaannemer niet gevonden: dit is de meest voorkomende fout bij voertuigen van onderaannemers. De fout treedt op als de Naam onderaannemer in het sjabloon niet exact overeenkomt met een bestaand bedrijf in Qargo. De onderaannemer moet in het systeem bestaan voordat de voertuigen ervan kunnen worden geïmporteerd.

  • Ontbrekende verplichte velden: de import mislukt voor elke rij waarin de Voertuignaam of het Type leeg is.

  • Naam van het werkblad: het werkblad in het Excel-sjabloon moet exact ‘Import’ heten. Elke andere naam veroorzaakt een fout bij het uploaden van het bestand.

  • Ongeldig voertuigtype: controleren of het ingevoerde voertuigtype (bv. ‘TRAILER’) een geldige optie is in het Qargo-platform.

  • Hoofdlettergevoelige kolomkoppen: kolomkoppen moeten met de juiste hoofdletters en kleine letters worden ingevoerd (bv. vat_number, niet VAT_number). Bij een verkeerd gebruik van hoofdletters worden de gegevens in die kolom zonder melding genegeerd en niet geïmporteerd, omdat het systeem de kop niet herkent.

  • Fouten door een apostrof vooraan: gegevens in een cel mogen niet met een apostrof (’) beginnen. Als een apostrof wordt gebruikt, herkent het systeem de waarde niet en kan er een fout optreden. Deze regel geldt alleen niet als het artikel uitdrukkelijk aangeeft dat voor een specifiek veld een apostrof moet worden gebruikt.

  • Aangepaste velden: de kolomnaam moet de conventie custom_field__[ID] volgen (de dubbele underscore niet vergeten om het voorvoegsel custom_field te verbinden met de unieke veld-ID). De specifieke ID is te vinden in de instellingen organisatie van Qargo. Op de kopieerknop naast het aangepaste veld klikken om de ID ervan te kopiëren:


✨ Goede praktijken voor het importeren van voertuigen

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

  • Zorgen dat de gegevens van onderaannemers volledig zijn: voordat voertuigen van onderaannemers worden geïmporteerd, controleren of alle betrokken onderaannemers al met succes als bedrijven in het systeem zijn geïmporteerd.
  • Gegevens consistent houden: goed letten op de velden Bedrijf onderaannemer en Nummerplaat. Elke spelfout of afwijking in hoofdletters zorgt ervoor dat de koppeling mislukt.
  • Het veld Code gebruiken: hoewel het veld Code optioneel is, wordt het gebruik ervan sterk aangeraden. Het biedt een betrouwbare manier om voertuigrecords bij te werken en voorkomt conflicten.

➡️ Volgende stappen

Zodra de voertuigen met succes zijn geïmporteerd, kunnen ze in combinaties aan chauffeurs worden gekoppeld en in orders worden gebruikt. De logische volgende stappen zijn:

  • Chauffeurs importeren: indien nodig kunnen nu interne chauffeurs of chauffeurs van onderaannemers worden geïmporteerd.
  • Combinaties configureren: voertuigen kunnen in bulk aan chauffeurs worden gekoppeld door combinaties aan te maken.

📈 Toepassingen van de voertuigimport

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

  • Initiële opzet van het wagenpark: de belangrijkste toepassing is een Qargo-tenant vullen met een volledig wagenpark, zowel eigen voertuigen als voertuigen van vaste onderaannemers.
  • Onboarding van een nieuw wagenpark: wanneer een nieuwe bedrijfseenheid of een nieuw wagenpark wordt overgenomen, kunnen de voertuiggegevens ervan in bulk aan Qargo worden toegevoegd.