---
title: "Orderimport: orderroutering op basis van sjablonen – wat, waarom en hoe"
description: "Inkomende orders automatisch aan sjablonen koppelen. Behandelt de configuratie van sjabloonmatching, het afhandelen van mislukte imports en het oplossen van een verkeerde adreskeuze."
url: https://help.qargo.com/nl/articles/681640-orderimport-orderroutering-op-basis-van-sjablonen-wat-waarom-en-hoe
locale: nl
updated: 2026-05-28
---

# Orderimport: orderroutering op basis van sjablonen – wat, waarom en hoe

## Samenvatting {#h_2cffefddb9}

-   **Wat**: een nieuwe laag voor sjabloonmatching in _Orderimport_ die een inkomende EDI- of API-order automatisch aan een _ordersjabloon_ koppelt. De order neemt de volledige planningsstructuur van het sjabloon over (route met meerdere stops, intermodale trajecten, opsplitsingen, toewijzingen aan onderaannemers, prijsberekening).
-   **Waarom**: EDI-/API-orders kwamen voorheen binnen als eenvoudige records van ophaling naar levering. Dispatchers moesten de planningsstructuur voor elke geïmporteerde order handmatig opnieuw opbouwen, ook als dezelfde route dagelijks reed. Import op basis van sjablonen neemt dat repetitieve werk weg.
-   **Hoe**: een _orderimportmaster_ wordt zo geconfigureerd dat sjabloonmatching verplicht is (_alleen Qargo admin_). Wanneer een order binnenkomt, koppelt Qargo die aan een sjabloon op basis van klant, transportdienst en stoplocaties. De structuur van het gekoppelde sjabloon wordt op de nieuwe order toegepast. Als er geen match is, mislukt de import met een foutmelding en kan een dispatcher het juiste sjabloon handmatig toewijzen.

## Vereisten {#h_22bfd4bb2e}

-   Er moet minstens één _ordersjabloon_ bestaan dat correct met de verwachte routestructuur is geconfigureerd.
-   Op de stops van het sjabloon moeten locatie-aliassen ingesteld zijn, zodat inkomende locatiereferenties gematcht kunnen worden.
-   De functie _Orderimport_ moet voor de tenant ingeschakeld zijn.
-   De configuratie van sjabloonmatching is alleen beschikbaar voor _Qargo admins_ (of _super admins_ als de feature flag _Transformatiemapping aanmaken_ ingeschakeld is).

## Toepassingen {#h_931939885c}

-   Een intermodale operator ontvangt dagelijks EDI-orders voor dezelfde veerbootroutes. Sjabloonmatching past automatisch de juiste vertrek-, overslag- en leveringsstops toe, zodat dispatchers de route niet telkens opnieuw hoeven op te bouwen.
-   Een transportbedrijf importeert API-orders voor terugkerende transportroutes van klanten. De importmaster is ingesteld om op zowel ophaal- als leveringslocaties te matchen, zodat het juiste sjabloon (inclusief toewijzingen aan onderaannemers) wordt geselecteerd.
-   Een importorder komt binnen met een onbekende locatie-alias. De import mislukt en een dispatcher gebruikt de actie **Sjabloon selecteren** om het juiste sjabloon toe te wijzen en de import handmatig te voltooien.

## Terminologie {#h_55015855fa}

| **Term** | **Definitie** |
| --- | --- |
| _Orderimportmaster_ | Een geconfigureerde importbron in **Configuratie > Orderimport** die bepaalt hoe inkomende orders worden verwerkt. |
| _Ordersjabloon_ | Een vooraf geconfigureerde order in Qargo met een volledige routestructuur: stops, transportdienst, toewijzingen aan onderaannemers en prijsberekening. |
| _Sjabloonmatching_ | Het proces waarbij een inkomende importorder automatisch aan een _ordersjabloon_ wordt gekoppeld op basis van klant, transportdienst en stoplocaties. |
| _Locatie-alias_ | Een alternatieve naam voor een locatie, die gebruikt wordt om inkomende locatiereferenties aan Qargo-locaties in het sjabloon te koppelen. |
| _Sjabloon selecteren_ | Een handmatige actie op een mislukte importregel waarmee een dispatcher een sjabloon kan toewijzen en de import opnieuw kan proberen. |

* * *

## Sjabloonmatching configureren op een orderimportmaster {#h_9c4e4a47c8}

1.  **Navigeren** naar **Configuratie > Orderimports**
2.  De relevante _orderimportmaster_ **openen** of een nieuwe aanmaken.
3.  De toggle **Sjabloonmatching** **inschakelen**. Wanneer die ingeschakeld is, moeten alle orders die via deze importbron binnenkomen aan een sjabloon gekoppeld worden; uitschakelen per order is niet mogelijk.
4.  De instelling **Matchen op** **selecteren**:

    -   _Ophaling en levering_: het sjabloon wordt gematcht op zowel ophaal- als leveringslocaties (strengste matching).
    -   _Alleen ophaling_: alleen gematcht op de ophaallocatie.
    -   _Alleen levering_: alleen gematcht op de leveringslocatie.
5.  De configuratie **opslaan**.

:::callout{tone="info"}
🧰 Sjabloonmatching kan alleen door _Qargo admins_ worden geconfigureerd (of door _super admins_ met de feature flag _Transformatiemapping aanmaken_). Voor meer hulp contact opnemen met de accountmanager van Qargo.
:::

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

* * *

## Hoe sjabloonmatching werkt bij import {#h_f2c4730662}

Wanneer een order binnenkomt via een importmaster waarop sjablonen ingeschakeld zijn:

1.  Qargo vergelijkt de klant, de transportdienst en de stoplocatie of stoplocaties van de inkomende order met alle beschikbare _ordersjablonen_.
2.  Het aantal zendingen in het sjabloon moet exact overeenkomen met de inkomende order.
3.  Stoplocaties worden gematcht via _locatie-aliassen_: de inkomende locatiereferentie moet overeenkomen met een alias op de stops van het sjabloon.
4.  Stops voor _opbouw_ en _afbouw_ worden niet meegenomen in de matching; alleen ophaal- en leveringslocaties worden gebruikt.
5.  Als een passend sjabloon gevonden wordt, wordt de order aangemaakt met de structuur van het sjabloon, waarbij de importgegevens (datums, hoeveelheden, referenties) daarbovenop worden toegepast.
6.  Als er geen passend sjabloon gevonden wordt, mislukt de import.

## Mislukte sjabloonimports afhandelen {#h_7ce6b31364}

Mislukte imports verschijnen in de lijst _Orderimport_ met een foutstatus.

1.  **Orders > Orderimports** **openen** om de lijst te bekijken.
2.  De mislukte regel **identificeren**: die toont een foutstatus die aangeeft dat er geen sjabloon gevonden is.
3.  De actie **Sjabloon selecteren** op de regel **selecteren**.
4.  Het juiste sjabloon **kiezen** in de keuzelijst.
5.  **Bevestigen**: de order wordt aangemaakt op basis van het geselecteerde sjabloon, met de importgegevens daarbovenop toegepast.

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

:::callout{tone="note"}
‼️ Als de import mislukte door een onbekende locatie-alias, moet de alias eerst handmatig aan de betreffende locatie in het sjabloon worden toegevoegd voordat het sjabloon gematcht kan worden.
:::

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

## Verkeerde adreskeuze oplossen {#h_bd19e66f16}

Een verkeerde adreskeuze bij imports of bij AI/OCR-matching kan de operations verstoren. De onderstaande secties beschrijven de veelvoorkomende oorzaken, de stappen om ze op te lossen en maatregelen om herhaling te voorkomen.

### Veelvoorkomende oorzaken {#h_0d5751ea1e}

-   **Configuratie van importaliassen.** Een verkeerde importalias op een locatie kan ervoor zorgen dat Qargo het ene adres door een ander vervangt wanneer een bepaalde naam of alias in het importbestand voorkomt. Als een locatie bijvoorbeeld een alias zoals "Karlsgarde" heeft, kan Qargo deze naam aan het verkeerde adres koppelen.
-   **Fouten bij AI/OCR-matching.** Bij het importeren van gegevens uit documenten zoals PDF's kan het AI/OCR-systeem de verkeerde locatie voorstellen als de locatiegegevens in Qargo niet goed overeenkomen met de bewoordingen op het document. Verschillen in belangrijke velden zoals locatienaam, adres of weergavenaam kunnen tot verkeerde matches leiden.

### Problemen met aliassen oplossen {#h_9ed9d87e08}

Om problemen door een verkeerde importalias op te lossen:

1\. **Navigeren** naar de instellingen van de locatie.\
2\. Het locatierecord in Qargo dat verkeerd geselecteerd wordt **openen**.\
3\. De sectie **Import/export-aliassen** in het locatieprofiel **zoeken**.\
4\. De alias **bewerken** via het potloodicoon om die te corrigeren, of de alias volledig verwijderen als die verkeerde matches veroorzaakt.

:::callout{tone="note"}
📚 Door een verkeerde alias te verwijderen of te corrigeren, worden adressen bij toekomstige imports toegewezen op basis van de aangeleverde gegevens, zonder vervanging.
:::

* * *

## Nauwkeurigheid van AI/OCR-matching verbeteren {#h_7c53ea2041}

Om het AI/OCR-systeem te helpen de juiste locatie te selecteren:

1\. Ervoor zorgen dat de locatiegegevens in Qargo zo nauw mogelijk overeenkomen met de bewoordingen op het brondocument.\
2\. Belangrijke velden (locatienaam, adres en weergavenaam) afstemmen op de terminologie van het document.\
3\. Consistente en precieze naamgevingsconventies gebruiken voor gelijkaardige locaties, zodat de AI een duidelijkere context heeft om tussen opties te onderscheiden.

### Preventieve maatregelen {#h_3c61a5c91a}

-   Locatie-aliassen regelmatig controleren en bijwerken, zodat ze de bedoelde mappings correct weergeven.
-   Naamgevingsconventies voor locaties en adressen in Qargo standaardiseren om verschillen tussen importgegevens en Qargo-records te beperken.
-   Imports testen met voorbeeldgegevens om te controleren of de juiste adressen geselecteerd worden, voordat een nieuwe importconfiguratie wordt uitgerold.

* * *

## Beperkingen {#h_3b8a062241}

-   **Matching altijd actief.** Zodra sjabloonmatching voor een importmaster ingeschakeld is, moeten alle inkomende orders via die bron aan een sjabloon gekoppeld worden. Via die bron kan geen order zonder sjabloon worden aangemaakt.
-   **Geen toepassing achteraf.** Sjablonen kunnen niet worden toegepast op orders die al zonder sjabloon geïmporteerd zijn.
-   **Strikt aantal zendingen.** Het sjabloon moet exact hetzelfde aantal zendingen hebben als de inkomende importorder.
-   **Handmatige locatie-aliassen.** Locatie-aliassen moeten handmatig op de stops van het sjabloon worden aangemaakt; aliassen worden niet automatisch gegenereerd.
-   **Geen optimalisatie op basis van regels.** Als een route voorwaardelijke extra stops of dynamische opsplitsingen vereist (bv. emballagestops, opsplitsingen op basis van locatie), moeten die al in het sjabloon bestaan. Sjabloonmatching voegt stops niet dynamisch toe en wijzigt ze niet.
-   **Imports via het klantenportaal.** Portaalgebruikers kunnen geen sjabloon selecteren; portaalorders doorlopen dezelfde automatische matching als EDI-/API-orders.

* * *

## Probleemoplossing {#h_07e1b0c026}

| **Probleem** | **Waarschijnlijke oorzaak** | **Oplossing** |
| --- | --- | --- |
| Import mislukt met de foutmelding "geen sjabloon gevonden" | Geen enkel sjabloon komt overeen met de klant, transportdienst of stoplocaties van de inkomende order | Controleren of er een sjabloon voor deze route bestaat en of de locatie-aliassen correct op de stops van het sjabloon geconfigureerd zijn |
| Import mislukt ondanks een passend sjabloon | Het aantal zendingen in het sjabloon verschilt van dat in de inkomende order | Ervoor zorgen dat het sjabloon hetzelfde aantal zendingen heeft als de importorder |
| Actie **Sjabloon selecteren** is niet beschikbaar | Sjabloonmatching is niet ingeschakeld op de importmaster | **Sjabloonmatching gebruiken** inschakelen in de configuratie van de importmaster |
| Sjabloon wordt gevonden, maar de verkeerde route wordt toegepast | Verkeerde alias op een stop | De locatie-aliassen op het gematchte sjabloon controleren en corrigeren |
| Verkeerd adres geselecteerd bij import | Er is een verkeerde importalias op de locatie geconfigureerd | De alias in de sectie **Aliassen** van de locatie controleren en corrigeren; zie _Verkeerde adreskeuze oplossen_ hierboven |
| AI/OCR stelt de verkeerde locatie voor op basis van een document | De locatiegegevens in Qargo komen niet goed overeen met de bewoordingen op het brondocument | De locatienaam, het adres of de weergavenaam in Qargo afstemmen op de terminologie van het document |


## Gerelateerde artikelen

- [Gegevensimport: locatiegegevens importeren](https://help.qargo.com/nl/articles/413082-gegevensimport-locatiegegevens-importeren.md)
- [Klantenportaal: orders aanmaken vanuit sjablonen](https://help.qargo.com/nl/articles/685597-klantenportaal-orders-aanmaken-vanuit-sjablonen.md)
- [Integraties: orders importeren in Qargo](https://help.qargo.com/nl/articles/450378-integraties-orders-importeren-in-qargo.md)
- [Gegevensimport: ordergegevens importeren](https://help.qargo.com/nl/articles/418636-gegevensimport-ordergegevens-importeren.md)
- [Intermodaal: rollen van koper en verkoper in Qargo begrijpen](https://help.qargo.com/nl/articles/531968-intermodaal-rollen-van-koper-en-verkoper-in-qargo-begrijpen.md)
