Orderimport: orderroutering op basis van sjablonen – wat, waarom en hoe
Inkomende orders automatisch aan sjablonen koppelen. Behandelt de configuratie van sjabloonmatching, het afhandelen van mislukte imports en het oplossen van een verkeerde adreskeuze.
Inhoudsopgave
Samenvatting
- 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
- 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
- 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
| 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
-
Navigeren naar Configuratie > Orderimports
-
De relevante orderimportmaster openen of een nieuwe aanmaken.
-
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.
-
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.
-
De configuratie opslaan.

Hoe sjabloonmatching werkt bij import
Wanneer een order binnenkomt via een importmaster waarop sjablonen ingeschakeld zijn:
- Qargo vergelijkt de klant, de transportdienst en de stoplocatie of stoplocaties van de inkomende order met alle beschikbare ordersjablonen.
- Het aantal zendingen in het sjabloon moet exact overeenkomen met de inkomende order.
- Stoplocaties worden gematcht via locatie-aliassen: de inkomende locatiereferentie moet overeenkomen met een alias op de stops van het sjabloon.
- Stops voor opbouw en afbouw worden niet meegenomen in de matching; alleen ophaal- en leveringslocaties worden gebruikt.
- 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.
- Als er geen passend sjabloon gevonden wordt, mislukt de import.
Mislukte sjabloonimports afhandelen
Mislukte imports verschijnen in de lijst Orderimport met een foutstatus.
- Orders > Orderimports openen om de lijst te bekijken.
- De mislukte regel identificeren: die toont een foutstatus die aangeeft dat er geen sjabloon gevonden is.
- De actie Sjabloon selecteren op de regel selecteren.
- Het juiste sjabloon kiezen in de keuzelijst.
- Bevestigen: de order wordt aangemaakt op basis van het geselecteerde sjabloon, met de importgegevens daarbovenop toegepast.


Verkeerde adreskeuze oplossen
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
- 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
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.
Nauwkeurigheid van AI/OCR-matching verbeteren
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
- 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
- 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
| 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 |
