---
title: "Gegevensimport: wat, waarom, hoe"
description: "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."
url: https://help.qargo.com/nl/articles/169976-gegevensimport-wat-waarom-hoe
locale: nl
updated: 2026-06-08
---

# Gegevensimport: wat, waarom, hoe

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 {#h_38142e5f9b}

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 {#h_b997776770}

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 {#h_0c4aef0c7a}

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

### Stap 1: het juiste sjabloon downloaden {#h_906d3ca1bb}

Voor elk type gegevens dat moet worden geïmporteerd, is een specifiek Excel-sjabloon beschikbaar. De sjablonen zijn hier te vinden:\
[Sjabloon gegevensimport bedrijven](https://docs.google.com/spreadsheets/d/1rvyBW586ny40Ttqrk6Fk3QtLKZyHCoOoTAQ_xYojnDw/edit?usp=sharing)\
[Sjabloon gegevensimport contactpersonen.xlsx](https://docs.google.com/spreadsheets/d/15907ITZJPI-0yiFeqXq-7GIGyOzFAHckibeEkCPPsJI/edit?usp=sharing)\
[Sjabloon gegevensimport chauffeurs.xlsx](https://docs.google.com/spreadsheets/d/1tYtM6ZtL08gecubOpcVx2kHeO6u-1Hl6l5KkeOKtgPQ/edit?usp=sharing)\
[Sjabloon gegevensimport voertuigen.xlsx](https://docs.google.com/spreadsheets/d/1yba-Jx7i8ZYdzJyrPERF3ml6ZblR-j7reHnWVsV1Wgk/edit?usp=sharing)\
[Sjabloon gegevensimport containers.xlsx](https://docs.google.com/spreadsheets/d/18iCOvgK_GFgtOPK6h02Vb1Dq7hKqKnwretYO5j4nrC0/edit?usp=sharing)\
[Sjabloon gegevensimport producten.xlsx](https://docs.google.com/spreadsheets/d/1NFJZceH7FvUJWY6wSIzEROVpBGBiucTbcS-aoWyNlfk/edit?usp=sharing)\
[Sjabloon gegevensimport geldigheden.xlsx](https://docs.google.com/spreadsheets/d/1P8RJ6d3Sg2iNAYmTQb8Tsz2S2h_XYDq78izoMEau75g/edit?usp=sharing)\
[Sjabloon gegevensimport locaties Doc.xlsx](https://docs.google.com/spreadsheets/d/1NQKMJ5fgt1Xwq4mqfDmu-qa1zLS-QVl86T-vW2zTzgE/edit?usp=sharing)

:::callout{tone="info"}
📚 Altijd een **leeg sjabloon** gebruiken dat rechtstreeks uit dit artikel is gedownload of door het Qargo-team is bezorgd. Een oud sjabloon hergebruiken kan tot importfouten leiden.
:::

### Stap 2: het Excel-sjabloon invullen {#h_3286d54ec3}

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 {#h_46a501626c}

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 {#h_109040edd5}

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 {#h_63d675646e}

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 {#h_606fecdf47}

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.

::button[Artikel gegevensimport bedrijven]{href="/en/articles/410118-data-import-importing-company-data"}

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

::button[Artikel gegevensimport contactpersonen]{href="/en/articles/410121-data-import-importing-contact-data"}

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

::button[Artikel gegevensimport chauffeurs]{href="/en/articles/410123-data-import-importing-driver-data"}

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

::button[Artikel gegevensimport voertuigen]{href="/en/articles/410124-data-import-importing-vehicle-data"}

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

::button[Artikel gegevensimport containers]{href="/en/articles/410131-data-import-importing-container-data"}

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

::button[Artikel gegevensimport producten]{href="/en/articles/410133-data-import-importing-product-data"}

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

::button[Artikel gegevensimport geldigheden]{href="/en/articles/410135-data-import-importing-validity-data"}

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

::button[Artikel gegevensimport orders]{href="/en/articles/418636-data-import-importing-order-data"}

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

::button[Artikel gegevensimport locaties]{href="/en/articles/413082-data-import-importing-location-data"}

* * *

:::callout{tone="info"}
📚 Onboardingmanagers en accountmanagers kunnen helpen bij het aanmaken van combinaties. Ter voorbereiding de volgende gegevens bezorgen voor de chauffeurs en voertuigen die moeten worden gecombineerd:
:::

| **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 {#h_32c64fbd37}

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

::button[Veelgestelde vragen over gegevensimport]{href="/en/articles/410168-data-import-data-import-faq-s"}

* * *

### 📝 Toepassingen {#h_84e1670317}

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.


## Gerelateerde artikelen

- [Gegevensimport: contactlocatiegegevens importeren](https://help.qargo.com/nl/articles/494334-gegevensimport-contactlocatiegegevens-importeren.md)
- [INTEGRATIES - Qargo API - wat, waarom en hoe](https://help.qargo.com/nl/articles/865547-integraties-qargo-api-wat-waarom-en-hoe.md)
- [Facturen - Aankoopfactuur verwerken via Peppol](https://help.qargo.com/nl/articles/523845-facturen-aankoopfactuur-verwerken-via-peppol.md)
- [Klantenportaal: orders in bulk aanmaken vanuit een Excel- of CSV-bestand](https://help.qargo.com/nl/articles/879687-klantenportaal-orders-in-bulk-aanmaken-vanuit-een-excel-of-csv-bestand.md)
- [Configuratie – Regels gebruiken om velden automatisch toe te wijzen.](https://help.qargo.com/nl/articles/545498-configuratie-regels-gebruiken-om-velden-automatisch-toe-te-wijzen.md)
