Skip to main content
Qargo

Gegevensimport: wat, waarom, hoe

Een uitgebreide handleiding voor het importeren van bedrijfsgegevens in Qargo met kant-en-klare sjablonen, met het algemene proces en de essentiële vereisten voor een vlotte configuratie.

Inhoudsopgave
  1. Veelvoorkomende foutmeldingen bij gegevensimport in Qargo oplossen

Bestaande bedrijfsgegevens in Qargo importeren zorgt ervoor dat een account snel en nauwkeurig wordt ingericht. In plaats van elk bedrijf, elke chauffeur of elk voertuig handmatig aan te maken, kunnen organisaties de beschikbare Excel-sjablonen gebruiken om informatie in bulk te uploaden. Dit artikel beschrijft het volledige proces, van het voorbereiden van de gegevens tot het oplossen van veelvoorkomende problemen.


📖 Belangrijke begrippen

Voor de duidelijkheid worden hieronder enkele belangrijke begrippen uit dit artikel toegelicht.

  • Qargo-tenant: een specifieke, afgeschermde omgeving van het Qargo-platform waarin de gegevens van een bedrijf worden opgeslagen en beheerd.
  • Sandbox-tenant: een testomgeving voor een Qargo-tenant. Hier kan veilig worden geëxperimenteerd, kunnen werkprocessen worden getest en kunnen gegevens worden geïmporteerd zonder gevolgen voor de live operationele omgeving.
  • Boekhoudcode: een unieke identificatiecode uit een boekhoudsysteem waarmee een klant in Qargo wordt gekoppeld aan de overeenkomstige gegevens in de boekhoudsoftware.
  • Onderaannemer: een extern bedrijf of een externe persoon die transporttaken uitvoert. In Qargo kunnen de chauffeurs en voertuigen van onderaannemers op dezelfde manier worden beheerd als die van de eigen organisatie.
  • Resource: een term voor een chauffeur, een voertuig of een combinatie van beide.

✅ Essentiële importvereisten en waarschuwingen

Voordat een import start, moeten deze essentiële vereisten worden nagekeken. Als ze niet worden nageleefd, kan dat tot fouten en dubbele gegevens leiden.

  1. Bedrijven importeren is een voorwaarde voor contactpersonen: bedrijven moeten verplicht eerst worden geïmporteerd. Het importsjabloon voor contactpersonen vereist een geldige bedrijfsnaam en boekhoudcode om elke contactpersoon aan een specifiek bedrijf te koppelen.

  2. Eerst de onderaannemers: om een chauffeur of voertuig van een onderaannemer te importeren, moet die onderaannemer eerst als bedrijf in Qargo zijn aangemaakt. De importsjablonen voor chauffeurs en voertuigen vereisen een geldige naam van de onderaannemer om de resource te koppelen.

  3. De boekhoudcode is cruciaal: Qargo gebruikt de boekhoudcode om bestaande klanten te herkennen en bij te werken. Als een klant opnieuw wordt geïmporteerd met dezelfde naam maar met een andere of ontbrekende boekhoudcode, maakt Qargo een dubbele klant aan. Dit probleem komt vaak voor bij de overstap van het ene boekhoudsysteem naar het andere.

    • Tip: tijdens de initiële configuratie is het aan te raden testklanten te gebruiken. Zodra de boekhoudcodes definitief zijn, moet de volledige, opgeschoonde klantendatabase voor de livegang worden geïmporteerd om dubbele gegevens te vermijden.

🛠️ Stapsgewijs importproces voor gegevens

Met de volgende stappen kunnen gegevens met succes worden geïmporteerd.

Stap 1: het juiste sjabloon downloaden

Voor elk type gegevens dat moet worden geïmporteerd, is een specifiek Excel-sjabloon beschikbaar. De sjablonen zijn hier te vinden:
Sjabloon gegevensimport bedrijven
Sjabloon gegevensimport contactpersonen.xlsx
Sjabloon gegevensimport chauffeurs.xlsx
Sjabloon gegevensimport voertuigen.xlsx
Sjabloon gegevensimport containers.xlsx
Sjabloon gegevensimport producten.xlsx
Sjabloon gegevensimport geldigheden.xlsx
Sjabloon gegevensimport locaties Doc.xlsx

Stap 2: het Excel-sjabloon invullen

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

  • Verplichte velden: alle verplichte velden invullen (die staan in de artikels die in de sectie “Gedetailleerde importartikels” van dit artikel worden vermeld). Een import mislukt als deze velden leeg blijven.
  • Opmaak: goed letten op de opgegeven gegevensopmaak (bv. datums, getallen, tekst).

Stap 3: indienen om te uploaden

  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 gegevensupdates en imports contact opnemen met de accountmanager. De accountmanager helpt bij het uploadproces en biedt doorlopende support.

🔎 Veelvoorkomende fouten oplossen

Bij een eerste importpoging komen vaak fouten voor. Die zijn doorgaans eenvoudig op te lossen.

  1. Spreadsheet met foutenlog: de spreadsheet met het foutenlog geeft een duidelijk overzicht van de problemen. Er kan bijvoorbeeld “Voer een geldige URL in” of “Bedrijf moet een type hebben” staan.
  2. Corrigeren en opnieuw uploaden: het oorspronkelijke Excel-bestand openen, de gevonden fouten corrigeren en het bestand opslaan. Daarna kan het gecorrigeerde bestand opnieuw worden geüpload. Qargo voert de validatie opnieuw uit en de import gaat verder.
  3. Hoofdlettergevoelige kolomkoppen: kolomkoppen moeten met de juiste hoofdletters en kleine letters worden ingevoerd (bv. vat_number, niet VAT_number). Bij verkeerd hoofdlettergebruik worden de gegevens in die kolom zonder melding genegeerd en niet geïmporteerd, omdat het systeem de kolomkop niet herkent.
  4. Fouten door een apostrof vooraan: gegevens in een cel mogen niet met een apostrof (’) beginnen. Als er toch een apostrof staat, herkent het systeem de waarde niet en kan er een fout optreden. Deze regel geldt alleen niet als het artikel uitdrukkelijk vermeldt dat voor een specifiek veld een apostrof moet worden gebruikt.

Veelvoorkomende foutmeldingen bij gegevensimport in Qargo oplossen

Bij het importeren van gegevens in Qargo kunnen de volgende foutmeldingen in verband met de configuratie verschijnen:

  1. Fout “Onbekende klant”: deze fout treedt op wanneer de klantnaam in het importbestand niet overeenkomt met een bestaande klant in Qargo. Oplossing: de klantnaam in het bestand controleren, nagaan of de klant al in Qargo is geconfigureerd en eventuele afwijkingen corrigeren voordat het bestand opnieuw wordt geüpload.
  2. Fout “Onbekende transportdienst”: deze fout geeft aan dat de transportdienst in het importbestand niet in Qargo is ingesteld. Oplossing: de naam van de transportdienst controleren en corrigeren of de transportdienst aan Qargo toevoegen, en daarna opnieuw uploaden.
  3. Fout “Onbekende locatie”: deze fout treedt op wanneer een locatie in het importbestand niet in de configuratie van Qargo bestaat. Oplossing: de locatienaam controleren en corrigeren of de locatie in Qargo aanmaken voordat het bestand opnieuw wordt geüpload.

Samenvatting: deze fouten ontstaan door verschillen tussen het importbestand en de configuratie in Qargo. De gegevens altijd afstemmen op de configuratie in Qargo en de foutmeldingen gebruiken als leidraad om verschillen efficiënt op te lossen.


🔗 Gedetailleerde importartikels

Voor meer gedetailleerde informatie over een specifiek type gegevens op de onderstaande links klikken. Elk artikel bevat een gedetailleerd overzicht van de velden in het sjabloon, de specifieke vereisten en de beste werkwijzen.

  • Bedrijven importeren

Een uitgebreide handleiding voor het importeren van bedrijfsgegevens. Dit is de basisstap om een Qargo-tenant te vullen met klanten, leveranciers en onderaannemers.

Artikel gegevensimport bedrijven

  • Contactpersonen importeren

Een uitgebreide handleiding voor het importeren van gegevens van contactpersonen. Daarmee worden personen gekoppeld aan bedrijven die al in het systeem staan, zodat de database voor communicatie nauwkeurig is.

Artikel gegevensimport contactpersonen

  • Chauffeurs importeren

Een uitgebreide handleiding voor het importeren van chauffeursgegevens. Daarmee kunnen zowel eigen chauffeurs als chauffeurs van onderaannemers in bulk worden aangemaakt. Dit is een cruciale stap om het Qargo-systeem voor te bereiden op het dispatchen.

Artikel gegevensimport chauffeurs

  • Voertuigen importeren

Een uitgebreide handleiding voor het importeren van voertuiggegevens. Daarmee kunnen voertuigen van zowel de eigen organisatie als van onderaannemers in bulk worden aangemaakt. Dit is een cruciale stap om de vloot voor te bereiden op toewijzing.

Artikel gegevensimport voertuigen

  • Containers importeren

Een uitgebreide handleiding voor het importeren van containergegevens. Met dit proces kunnen containers van zowel de eigen organisatie als van onderaannemers in bulk worden aangemaakt, zodat er een direct beschikbare catalogus is voor het aanmaken van orders.

Artikel gegevensimport containers

  • Producten importeren

Een uitgebreide handleiding voor het importeren van productgegevens. Met dit proces wordt de productcatalogus in bulk gevuld. Dat vereenvoudigt het aanmaken van orders en zorgt voor consistente omschrijvingen en meeteenheden.

Artikel gegevensimport producten

  • 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.

Artikel gegevensimport geldigheden

  • Ordergegevens importeren

Een uitgebreide handleiding voor het importeren van ordergegevens. Met deze import kunnen orders in bulk worden aangemaakt voor zowel sandbox- als live tenants. Dat is handig voor het inladen van gegevens, systeemintegratie en testdoeleinden.

Artikel gegevensimport orders

  • Locatiegegevens importeren

Een uitgebreide handleiding voor het importeren van locatiegegevens. Daarmee kunnen locaties in bulk worden geïmporteerd, samen met aliassen voor externe integraties en configuraties voor het vooraf invullen van stops.

Artikel gegevensimport locaties


Kolomnaam Verplicht/optioneel Opmerkingen Voorbeeld
Vehicle_name Verplicht Naam zoals gebruikt in vehicle_import 12BLT2
Driver_name Verplicht Naam zoals gebruikt in driver Steve Johnson
always_on_planning Verplicht Om elke dag op het planbord te worden weergegeven TRUE

❓ Veelgestelde vragen

Op de knop hieronder klikken om het artikel met veelgestelde vragen over gegevensimport te openen.

Veelgestelde vragen over gegevensimport


📝 Toepassingen

Gegevensimport vereenvoudigt de onboarding en het gegevensbeheer. Hieronder staan enkele veelvoorkomende situaties waarin gegevensimport bijzonder nuttig is:

  • Initiële configuratie: tijdens de onboarding kunnen alle bestaande bedrijfsgegevens in één keer worden geïmporteerd om de Qargo-tenant klaar te maken voor gebruik.
  • Werkprocessen testen: voor de livegang kan een voorbeeldset met gegevens in de sandbox-tenant worden geïmporteerd om nieuwe functies te testen of een team op te leiden. Zo ontstaat een risicovrije omgeving om vertrouwd te raken met het platform.
  • Regelmatige updates: gegevens van resources zoals voertuigen of containers kunnen periodiek worden geïmporteerd wanneer een vloot groeit of verandert.