---
title: "Gegevensimport: bedrijfsgegevens importeren"
description: "Een uitgebreide handleiding voor het importeren van bedrijfsgegevens, de basisstap om een Qargo-tenant te vullen met klanten, leveranciers en onderaannemers."
url: https://help.qargo.com/nl/articles/410118-gegevensimport-bedrijfsgegevens-importeren
locale: nl
updated: 2025-12-12
---

# Gegevensimport: bedrijfsgegevens importeren

Het importeren van bedrijfsgegevens is een basisstap om een Qargo-tenant te vullen. Met dit proces kunnen klanten, leveranciers en onderaannemers in bulk worden aangemaakt. Het is ook een voorwaarde voor het importeren van contacten en resources van onderaannemers. Dit artikel beschrijft de specifieke vereisten en best practices voor een geslaagde import van bedrijfsgegevens.

* * *

## 📖 Belangrijke begrippen {#h_099c8bbb74}

Voor de duidelijkheid worden de volgende begrippen in deze handleiding gedefinieerd.

-   **Bedrijf:** Overkoepelende term voor elke zakelijke entiteit die in Qargo wordt beheerd, waaronder klanten, leveranciers en onderaannemers.
-   **Klant:** Een bedrijf dat diensten ontvangt en daarvoor wordt gefactureerd.
-   **Onderaannemer:** Een bedrijf dat transportdiensten levert aan een Qargo-gebruiker.
-   **Boekhoudcode:** Een unieke identificatie uit een extern boekhoudsysteem. Hiermee wordt een bedrijf in Qargo gekoppeld aan de overeenkomstige vermelding in het andere systeem. Dit veld is cruciaal voor de synchronisatie van gegevens.
-   **Actief/inactief:** De status van een bedrijf in Qargo. Een 'inactief' bedrijf blijft in de database staan, maar kan niet worden gebruikt in nieuwe orders of opdrachten.


* * *

## ✅ Belangrijke importvereisten voor bedrijven {#h_d44c7252a9}

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

-   **Boekhoudcode voor updates:** De **boekhoudcode** is de unieke identificatie waarmee Qargo een bestaand bedrijf herkent en bijwerkt. Als een bedrijf opnieuw wordt geïmporteerd zonder boekhoudcode of met een andere boekhoudcode, wordt een dubbele vermelding aangemaakt. Het is essentieel dat de boekhoudcodes voor een bepaald bedrijf bij alle imports gelijk blijven.
-   **Voorwaarde voor contacten:** Een bedrijfsrecord moet in Qargo bestaan voordat er een contact aan kan worden gekoppeld. Het importsjabloon voor contacten vereist een geldige bedrijfsnaam en boekhoudcode.
-   **Onderaannemers:** Voordat resources zoals chauffeurs of voertuigen voor een onderaannemer kunnen worden geïmporteerd, moet de onderaannemer eerst als bedrijf in Qargo worden aangemaakt.


* * *

## 🛠️ Stapsgewijs importproces {#h_294b187890}

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

## Stap 1: sjabloon downloaden {#h_aab2bf3d01}

Er is een specifiek spreadsheetsjabloon beschikbaar om bedrijfsgegevens 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 import van bedrijfsgegevens](https://docs.google.com/spreadsheets/d/1rvyBW586ny40Ttqrk6Fk3QtLKZyHCoOoTAQ_xYojnDw/edit?usp=sharing)
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.

![](https://help.qargo.com/media/28688048a9c9-image.png)

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

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

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 (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 {#h_855bb48c81}

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 importsjabloon voor bedrijven {#h_591bc426f6}

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

| Kolomnaam | Verplicht/optioneel | Opmerkingen | Voorbeeld |
| --- | --- | --- | --- |
| name | Verplicht | Klantnaam die in de applicatie wordt gebruikt | Qargo |
| vat\_number | Optioneel | Btw-nummer van de klant (er wordt geen specifiek formaat afgedwongen) | BE1234567890 |
| accounting\_code | Verplicht | Unieke ID | 134 |
| legal\_name | Verplicht | Juridische naam van de klant voor officiële documenten | Qargo Tech NV |
| iban\_code | Optioneel |  |  |
| bic\_code | Optioneel |  |  |
| is\_customer | Verplicht | Bij TRUE wordt het bedrijf als klant aangemaakt | TRUE of null |
| is\_subcontractor | Verplicht | Bij TRUE wordt het bedrijf als onderaannemer aangemaakt | TRUE of null |
| archived | Optioneel | Om gearchiveerde klanten (niet meer in gebruik) te importeren | TRUE of null |
| customer\_status | Optioneel |  |  |
| subcontractor\_status | Optioneel |  |  |
| note | Optioneel | Extra tekstuele informatie over de klant. Meestal is dit nuttige informatie die niet onder een van de andere hier beschreven categorieën valt. |  |
| website | Optioneel | Website van de klanten | [www.qargo.io](http://www.qargo.io) |
| payment\_term | Optioneel | Af te leiden uit de standaard payment\_term voor klanten |  |
| subcontractor\_payment\_term | Optioneel | Af te leiden uit de standaard payment\_term voor onderaannemers |  |
| currency | Optioneel |  | EUR |
| tax\_type | Optioneel | Af te leiden uit de standaard tax\_type. Tax\_type wordt standaard automatisch geselecteerd op basis van vat\_number. |  |
| locale | Optioneel |  |  |
| address | Verplicht | straat + huisnummer + eventueel busnummer | Gaston Crommenlaan 4 |
| address\_second\_line | Optioneel |  |  |
| city | Verplicht |  | Gent |
| postal\_code | Verplicht |  | 9050 |
| country | Verplicht | Het veld **Land** vereist een code van twee letters (bv. **GB**, niet "UK"). Deze [lijst](https://www.iban.com/country-codes) bevat de Alpha-2-codes. | BE |
| state | Optioneel |  |  |
| factoring\_code | Optioneel |  |  |
| contacts\_\_name | Contactenimport gebruiken | Contactenimport gebruiken | Contactenimport gebruiken |
| contacts\_\_email | Contactenimport gebruiken | Contactenimport gebruiken | Contactenimport gebruiken |
| contacts\_\_phone | Contactenimport gebruiken | Contactenimport gebruiken | Contactenimport gebruiken |
| extra\_fields\_billing\_frequency | Optioneel |  |  |
| custom\_fields\_\_example | Optioneel | Om waarden van aangepaste velden te importeren. Opmerking: het formaat gebruikt een dubbele underscore (`__`) om het voorvoegsel **custom\_fields** aan de unieke veld-ID te koppelen |  |
| has\_customer\_portal\_access | Optioneel |  |  |
| has\_subcontractor\_portal\_access | Optioneel |  |  |
| extra\_fields\_\_credit\_limit\_invoiced | Optioneel |  |  |

* * *

## 🔎 Veelvoorkomende fouten bij de import van bedrijven oplossen {#h_0ed5a0ca4c}

Dit deel behandelt specifieke fouten die bij de import van bedrijfsgegevens kunnen optreden.

-   **Ontbrekende of onjuiste boekhoudcodes**: Dit is de meest voorkomende oorzaak van dubbele bedrijven. Het systeem gebruikt voor updates uitsluitend de boekhoudcode. Een ontbrekende of gewijzigde code leidt tot het aanmaken van een nieuw record.
-   **Ongeldig gegevensformaat**: Controleren of alle velden het vereiste formaat volgen. Landcodes moeten bijvoorbeeld geldig en correct ingevoerd zijn. Een beschrijvende lijst van de fouten en hun locatie wordt toegevoegd in de eerste kolom van het Excel-blad.
-   **Ongebruikelijke tekens**: Niet-herkende speciale tekens in een bedrijfsnaam of adres kunnen een import doen mislukken. Het is belangrijk de gegevens op zulke tekens te controleren.
-   **Indeling als klant/onderaannemer:** Een bedrijf moet als klant of als onderaannemer worden ingedeeld door de overeenkomstige kolom op "True" te zetten. Een bedrijf kan alleen beide zijn als de instelling organisatie **Aparte onderaannemer/klant afdwingen** uitgeschakeld is.
-   **Valuta:** Dit veld leeg laten voor tenants met één valuta. Voor tenants met meerdere valuta's moet het veld een specifieke code bevatten (bv. **GBP**, **EUR**) die overeenkomt met de valuta-instellingen van de organisatie.
-   **Adresvelden:** Het veld **Land** vereist een code van twee letters (bv. **GB**, niet "UK"). Deze [lijst](https://www.iban.com/country-codes) bevat de Alpha-2-codes.
-   **Bladnaam:** Het blad in het Excel-sjabloon moet exact **'Import'** heten. Elke andere naam veroorzaakt een fout bij het uploaden van het bestand.
-   **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 kolomkop 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 die het voorvoegsel **custom\_field** aan de unieke veld-ID koppelt, niet vergeten), met de specifieke ID uit de instellingen organisatie in Qargo. Op de kopieerknop naast het aangepaste veld klikken om de ID ervan te kopiëren:

![](https://help.qargo.com/media/813deeaf4846-4bf5e087-5b9e-47e2-8ec0-8e150ae4f65e.png)

* * *

**✨ Best practices voor het importeren van bedrijven**\
Voor een vlotte en nauwkeurige import worden de volgende best practices aanbevolen.

-   **Gegevens opschonen**: Voor het begin van het importproces is het belangrijk de brongegevens te controleren op nauwkeurigheid en consistentie. Dit omvat het controleren op dubbele records of inconsistenties in bedrijfsnamen.
-   **Beginnen met een kleine batch**: Het is aan te raden het importproces eerst te testen met een kleine steekproef van 5–10 bedrijven. Zo kan worden gecontroleerd of de gegevens correct zijn opgemaakt voordat een volledige database wordt geüpload.
-   **Altijd een nieuw sjabloon gebruiken**: Voor elke import altijd een leeg sjabloon gebruiken dat rechtstreeks van het Qargo-platform is gedownload. Een oud sjabloon hergebruiken kan tot importfouten leiden.


* * *

**➡️ Volgende stappen**\
Zodra de bedrijven met succes zijn geïmporteerd, is de basis gelegd voor het verder vullen van gegevens. De logische volgende stappen zijn:

-   **Contacten importeren**: Contacten kunnen nu worden geïmporteerd en correct aan de overeenkomstige bedrijven worden gekoppeld.
-   **Resources van onderaannemers importeren**: Indien nodig kunnen de chauffeurs en voertuigen van onderaannemers nu worden geïmporteerd en aan de aangemaakte bedrijfsrecords worden gekoppeld.


* * *

## 📈 Toepassingen van de import van bedrijven {#h_f64cc0a50b}

De import van bedrijven is een waardevol hulpmiddel voor verschillende belangrijke bedrijfsprocessen:

-   **Initiële inrichting van de tenant:** De belangrijkste toepassing is het importeren van de volledige klanten- en onderaannemersdatabase van een organisatie tijdens de initiële inrichting van een Qargo-tenant. Zo verloopt de overstap snel.
-   **Migratie van het boekhoudsysteem:** Bij de overstap van het ene boekhoudsysteem naar het andere kan een opgeschoonde, volledige database van bedrijven worden geïmporteerd om de consistentie te waarborgen en dubbele gegevens te voorkomen.
-   **Een nieuwe afdeling toevoegen:** Wanneer een nieuwe bedrijfseenheid of afdeling wordt opgestart, kunnen de bijbehorende klanten en leveranciers in één keer worden geïmporteerd om het Qargo-systeem met de nieuwe gegevens te vullen.

:::callout{tone="info"}
📚 Bij gebruik van meerdere Facturerende Entiteiten zijn extra aangepaste velden nodig. Voor meer informatie contact opnemen met de accountmanager.
:::


## Gerelateerde artikelen

- [Gegevensimport: contactgegevens importeren](https://help.qargo.com/nl/articles/410121-gegevensimport-contactgegevens-importeren.md)
- [Gegevensimport: chauffeursgegevens importeren](https://help.qargo.com/nl/articles/410123-gegevensimport-chauffeursgegevens-importeren.md)
- [Gegevensimport – Containergegevens importeren](https://help.qargo.com/nl/articles/410131-gegevensimport-containergegevens-importeren.md)
- [Gegevensimport: contactlocatiegegevens importeren](https://help.qargo.com/nl/articles/494334-gegevensimport-contactlocatiegegevens-importeren.md)
- [Gegevensimport: voertuiggegevens importeren](https://help.qargo.com/nl/articles/410124-gegevensimport-voertuiggegevens-importeren.md)
