---
title: "Gegevensimport: ordergegevens importeren"
description: "Een uitgebreide handleiding voor het importeren van orders in Qargo."
url: https://help.qargo.com/nl/articles/418636-gegevensimport-ordergegevens-importeren
locale: nl
updated: 2026-07-15
---

# Gegevensimport: 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 laden van gegevens, systeemintegratie en testdoeleinden. Dit artikel beschrijft de specifieke vereisten, best practices en veelvoorkomende problemen.

* * *

### 📖 Belangrijke termen {#h_dbe58ea455}

-   **Order:** Een aanvraag voor een opdracht of service.
-   **Externe ID:** Een unieke identificatie van een order uit een extern systeem.
-   **Stop:** Een specifieke locatie of een specifiek punt in een traject waar een taak wordt uitgevoerd.
-   **Product:** Een specifiek item of een specifieke goederensoort die wordt vervoerd.
-   **Service:** Het type service dat wordt geleverd (bv. transport).


* * *

### ✅ Belangrijke importvereisten voor orders {#h_08a69ce9bb}

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

-   **Vereiste gebruikersrechten:** De functie voor de handmatige import van ordergegevens is beperkt. Alleen gebruikers met **Superadmin**-rechten kunnen de orderimport uitvoeren.
-   **Vereiste bedrijven:** Alle klanten die bij de order horen, moeten al in Qargo bestaan.
-   **Vereiste producten:** Alle producten in de order moeten al in de productcatalogus bestaan.
-   **Unieke identificatie:** Het **ordernummer** of de **externe ID** dient als unieke identificatie van de order.
-   **Datum- en tijdnotatie:** Alle datum- en tijdvelden moeten de juiste notatie hebben zoals in het sjabloon aangegeven, om een mislukte import te voorkomen (YY/MM/DD).

**Validatieregels:** Numerieke velden mogen alleen positieve waarden bevatten (met uitzondering van velden zoals `absolute_min_temperature_value` en `absolute_max_temperature_value`). Datumvelden moeten de notatie `YYYY-MM-DD` volgen. Keuzelijstvelden moeten overeenkomen met vooraf gedefinieerde waarden. Bovendien is een import beperkt tot 100 regels per bestand.

* * *

### 🛠️ Stapsgewijs importproces voor orders {#h_d69f998df1}

Om ordergegevens met succes te importeren, moeten de volgende stappen worden gevolgd.

### Stap 1: importfunctie bevestigen (of activeringsstatus controleren) {#h_c875e93445}

Bij de **accountmanager** moet worden bevestigd dat de functie voor handmatige gegevensimport is geactiveerd.

### Stap 2: sjabloon downloaden {#h_9c3e87bf5a}

Er is een specifiek spreadsheetsjabloon beschikbaar om ordergegevens 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 ordergegevens](https://docs.google.com/spreadsheets/d/1o8Uh96ckVH2n5kzeI1a6OkdQl6HNglxhpjWAT1CNWlA/edit?usp=sharing)
2.  Zodra het sjabloon geopend is, naar **Bestand** gaan en **Downloaden** selecteren
3.  Het sjabloon **(in .xlsx- of .csv-indeling)** op de computer opslaan en beginnen met het invoeren van de bedrijfsgegevens.

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

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

### Stap 3: Excel-sjabloon invullen {#h_6b4b08c13a}

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

-   **Verplichte velden:** Om een basisorder aan te maken, moeten de volgende velden aanwezig zijn: `transport_service`, `customer_code`, `order_reference_number` (uniek voor elke regel), `pickup_date`, `delivery_date`, `pickup address` (volledig adres of afzonderlijke onderdelen) met `pickup_name`, en `delivery address` (volledig adres of afzonderlijke onderdelen) met `delivery_name`.
-   **Opmaak:** Er moet goed worden gelet op de opgegeven gegevensnotatie (bv. datums, getallen, tekst).

-   **Naamgeving van aangepaste velden:** Bij het gebruik van aangepaste velden moeten de kolomkoppen de naamgevingsconventie met dubbele underscores volgen (bv. `order_custom_field__FIELD_ID`).

:::callout{tone="info"}
📚 **Vooraf** **invullen:** Indien ingeschakeld in de orderimportconfiguratie (onder **Klant** en **Transportdienst**), verwerkt elke order die via de import of de externe API wordt aangemaakt de standaardwaarden voor orders en worden waarden in de nieuwe order vooraf ingevuld.
:::

## Sjabloon aanpassen met aangepaste velden {#h_207c319e21}

Met mappings voor aangepaste velden kunnen gegevens worden geïmporteerd in velden die zijn afgestemd op specifieke klantvereisten. Deze velden moeten correct worden aangemaakt en benoemd voordat de mapping wordt geconfigureerd. De naamgevingsconventie voor aangepaste velden in importbestanden gebruikt twee underscores in de kolomnaam (bv. `custom_fields__example`).

1.  **Het aangepaste veld in Qargo aanmaken:** Naar `Configuration > Additional fields` gaan om een nieuw aangepast veld aan te maken. Het toegewezen `field ID` noteren.
2.  **Het aangepaste veld aan het sjabloon toevoegen:** Een kolom toevoegen met een naam in de notatie `order_custom_field__FIELD_ID` (bv. `order_custom_field__invoicegroup`).
3.  **Opmaaktips:** Zorgen voor een exacte overeenkomst van de kolomkoppen, gegevens met een apostrof als voorvoegsel vermijden en de naamgevingsconventie voor het tabblad 'Import' toepassen.
4.  **De configuratie testen**: Een testbestand voor de betreffende klant importeren om te controleren of de gegevens correct in het aangepaste veld terechtkomen.

## Beperkingen en aandachtspunten {#h_b0b7f5ba97}

-   **Klantspecifieke configuratie**: Mappings voor aangepaste velden worden voor specifieke klanten geconfigureerd. Bij het importeren van gegevens voor een andere klant wordt het aangepaste veld niet ingevuld.
-   **Wijzigingen in de mapping**: Is dezelfde mapping voor aangepaste velden nodig voor andere klanten, dan moet een update van de mapping worden aangevraagd of moet de mapping voor elke klant afzonderlijk worden geconfigureerd.

### Stap 4: bestand uploaden {#h_c161d41d1c}

Het voltooide bestand wordt geüpload door naar de module **Orders** te gaan, het tabblad **Orderimports** te selecteren en op **Importeren uit bestand** te klikken.

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

De bron van de import moet worden geselecteerd. Als de bron een handmatige upload van het sjabloon is, de bronintegratie **Handmatig** selecteren.

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

Daarna kan het document worden geüpload. Als er fouten zijn, verschijnt een bericht met de details van de problemen en stelt het systeem mogelijke oplossingen voor.

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

### Stap 5: **controleren en afronden** {#h_2d5dea7b74}

De validatiefouten die het systeem heeft gevonden oplossen en de import afronden door de order of orders aan te maken.

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

* * *

### 📝 Details van het sjabloon voor orderimport {#h_19f6df64d9}

Deze sectie geeft per veld een gedetailleerde uitleg van het Excel-sjabloon voor orderimport, met gegevensnotaties, verplichte velden en best practices voor het invullen van elke kolom.

| **Kolomnaam** | **Verplicht/optioneel** | **Opmerkingen** | **Voorbeeld** |
| --- | --- | --- | --- |
| transport\_service | Optioneel | Transportdienst die in Qargo is geconfigureerd | Transport 2 |
| customer\_code | Optioneel | Klantcode die in de applicatie wordt gebruikt. Moet exact overeenkomen met de **Klantcode** van een klantrecord dat al in Qargo is geïmporteerd. Wordt in combinatie met **Weergavenaam** gebruikt om de uniciteit van de order te garanderen. | 2322 |
| customer\_name | Optioneel | Moet exact overeenkomen met de **Weergavenaam** van een klantrecord dat al in Qargo is geïmporteerd. Wordt in combinatie met **Klantcode** gebruikt om de uniciteit van de order te garanderen. | Qargo |
| customer\_reference\_number | Optioneel | Een referentienummer voor de interne tracking van de klant. | CUST-REF-001 |
| order\_reference\_number | Verplicht | Een algemeen referentienummer voor de order. |  |
| order\_requested\_price | Optioneel | De waarde moet een numerieke weergave van de prijs zijn; de valuta is gebaseerd op de valuta die voor de tenant is geconfigureerd. | 50 |
| order\_service\_level\_code | Optioneel | Een unieke code die het serviceniveau identificeert. | EXP-01 |
| pickup\_date | Optioneel | YY/MM/DD | 2026/01/20 |
| pickup\_time\_start | Optioneel | HH:MM:SS | 12:00:00 |
| pickup\_time\_end | Optioneel | HH:MM:SS | 13:00:00 |
| pickup\_name | Optioneel |  |  |
| pickup\_full\_address | Optioneel | Het volledige primaire adres van de ophaallocatie. | 123 Transport Way, London, E16 2NZ |
| pickup\_address\_line\_1 | Optioneel |  |  |
| pickup\_address\_line\_2 | Optioneel |  |  |
| pickup\_postcode | Optioneel |  |  |
| pickup\_city | Optioneel |  | London |
| pickup\_country | Optioneel |  | GB |
| pickup\_notes | Optioneel |  |  |
| pickup\_reference\_number | Optioneel |  |  |
| delivery\_name | Optioneel |  |  |
| delivery\_date | Optioneel | Jaar/maand/dag | 2016/09/20 |
| delivery\_time\_start | Optioneel | HH:MM:SS | 13:00:00 |
| delivery\_time\_end | Optioneel | HH:MM:SS | 13:00:00 |
| delivery\_full\_address | Optioneel | Het volledige primaire adres van de leveringslocatie. | 123 Transport Way, London, E16 2NZ |
| delivery\_address\_line\_1 | Optioneel |  |  |
| delivery\_address\_line\_2 | Optioneel |  |  |
| delivery\_postcode | Optioneel |  |  |
| delivery\_city | Optioneel |  | Brussels |
| delivery\_country | Optioneel |  | BE |
| delivery\_notes | Optioneel |  |  |
| delivery\_reference\_number | Optioneel |  |  |
| absolute\_min\_temperature\_value | Optioneel | Laagste temperatuur die het product verdraagt. |  |
| absolute\_max\_temperature\_value | Optioneel | Hoogste temperatuur die het product verdraagt. |  |
| volume\_lt | Optioneel |  |  |
| quantity | Optioneel |  |  |
| weight\_kg | Optioneel |  |  |
| goods\_description | Optioneel |  |  |
| pallet\_spaces | Optioneel | Aantal standaardpalletplaatsen dat het product inneemt. |  |
| loading\_meters | Optioneel |  |  |
| adr\_un\_number | Optioneel |  |  |
| packaging\_type | Optioneel |  |  |
| packaging\_size | Optioneel |  |  |
| product\_name | Optioneel | Productnaam die in Qargo wordt weergegeven | Aardappelen |

* * *

### 🔎 Veelvoorkomende fouten bij orderimport oplossen {#h_0ac6ccfc06}

Deze sectie behandelt specifieke fouten die kunnen optreden bij het importeren van ordergegevens.

-   **Bedrijf niet gevonden:** Om een order in Qargo uniek te kunnen identificeren en beheren, moet de combinatie van **externe ID** en **klantnaam** uniek zijn.
-   **Locatie niet gevonden:** Een veelvoorkomende fout treedt op wanneer het locatieadres van een stop niet overeenkomt met een bestaande locatie in het systeem.
-   **Product niet gevonden:** Als de productnaam in de order niet overeenkomt met een product dat al in de catalogus staat, mislukt de import.
-   **Onjuiste datum-/tijdnotatie:** Een veelvoorkomend probleem bij orderimports is een onjuiste datum- of tijdnotatie, waardoor de import mislukt.
-   **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.
-   **Hoofdlettergevoelige kolomkoppen:** Kolomkoppen moeten met de juiste hoofdletters worden ingevoerd (bv. `vat_number`, niet `VAT_number`). Bij onjuist hoofdlettergebruik 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 worden niet ingevuld:** Controleren of de mapping van het veld correct is voor het entiteitsniveau (bv. stopniveau, orderniveau, zendingniveau). Velden op zendingniveau hebben bijvoorbeeld de kopnotatie `consignment_custom_field__[FIELD_ID]` nodig. Ook controleren of de kolomkoppen volgens de specificatie zijn opgemaakt (bv. `order_custom_field__[FIELD_ID]` met dubbele underscores).
-   **Afstemming van de bestandsindeling:** Een verschil tussen het geselecteerde importtype en de indeling van het geüploade bestand (bv. een XLSX-bestand uploaden terwijl het systeem op CSV is ingesteld) kan tot mislukte imports leiden zonder specifieke foutmeldingen. Om problemen te voorkomen, moet de bestandsindeling overeenkomen met de configuratie-instellingen van het systeem.

-   **Geïmporteerde waarde wordt niet ingevuld:** Als het aangepaste veld bij de import niet wordt ingevuld, controleren of:

    -   het importbestand de juiste naamgevingsconventie voor het aangepaste veld gebruikt.
    -   de import wordt uitgevoerd voor de klant waarvoor de mapping is geconfigureerd.
-   **Testen met de verkeerde klant:** Bij het testen of importeren voor een andere klant is de mapping niet van toepassing. Controleren of het testbestand bij de juiste klant hoort.

-   **Unieke orderidentificaties:** Elke regel moet een unieke waarde in de kolom `order_reference_number` hebben om importfouten te voorkomen.
-   **Transportdienst verplicht:** Elke regel moet het type transportdienst vermelden; een ontbrekende waarde leidt tot fouten of vastgelopen imports.

* * *

### ✨ Best practices voor het importeren van orders {#h_0a5739f98e}

Voor een vlotte en nauwkeurige import zijn de volgende best practices aan te raden.

-   **Eerst de vereiste gegevens importeren:** Voordat orders worden geïmporteerd, is het essentieel dat alle bijbehorende bedrijven, locaties en producten al met succes in het systeem zijn geïmporteerd.
-   **Testen met een kleine batch:** Het is aan te raden het importproces eerst te testen met een kleine steekproef van 5–10 orders om te controleren of de gegevens correct zijn opgemaakt, voordat een volledige import wordt uitgevoerd.


* * *

### ➡️ Volgende stappen {#h_8d8f5ceb04}

Zodra de orders met succes zijn geïmporteerd, zijn ze beschikbaar in de module Orders. Ze kunnen dan worden ingepland, aan chauffeurs worden toegewezen en worden gedispatcht als onderdeel van de transportoperations.

* * *

### 📈 Toepassingen van orderimport {#h_a78f7b03c9}

De orderimport is een waardevol hulpmiddel voor verschillende belangrijke bedrijfsprocessen.

-   **Testen in een sandbox:** De belangrijkste toepassing is snel een grote hoeveelheid testgegevens aanmaken in een sandbox-tenant om trainingen te ondersteunen, werkprocessen te testen en de mogelijkheden van het platform te demonstreren zonder een live-omgeving te beïnvloeden.
-   **Systeemmigratie:** In sommige gevallen kan een eenmalige import worden gebruikt om historische of openstaande orders uit een ouder systeem te migreren.


## Gerelateerde artikelen

- [Gegevensimport: productgegevens importeren](https://help.qargo.com/nl/articles/410133-gegevensimport-productgegevens-importeren.md)
- [Gegevensimport – Containergegevens importeren](https://help.qargo.com/nl/articles/410131-gegevensimport-containergegevens-importeren.md)
- [Gegevensimport: contactgegevens importeren](https://help.qargo.com/nl/articles/410121-gegevensimport-contactgegevens-importeren.md)
- [Gegevensimport: bedrijfsgegevens importeren](https://help.qargo.com/nl/articles/410118-gegevensimport-bedrijfsgegevens-importeren.md)
- [Gegevensimport: chauffeursgegevens importeren](https://help.qargo.com/nl/articles/410123-gegevensimport-chauffeursgegevens-importeren.md)
