Implementers: 5 EDI 214-segmenten om vast te leggen en te mappen
Praktische referentie voor EDI-implementers: leg de vijf 214-segmenten vast, decodeer AT7-statuscodes, map zendingstatussen naar je TMS en volg een...
Implementers: 5 EDI 214-segmenten om vast te leggen en te mappen
Een EDI 214 is het ANSI X12-bericht voor de status van een vervoerderszending: vervoerders sturen het om gebeurteniscodes (AT7), datums, tijden en locaties voor een zending te rapporteren. Het bevat de identificatoren die een ontvangend systeem nodig heeft om de update aan de juiste lading te koppelen, en de AT7-codes sturen de praktische uitkomsten aan die ertoe doen: realtime inzicht, herberekening van de ETA, leveringsbevestiging en een nette factuurafstemming.
TL;DR:
- De meeste statusupdates van vervoerders worden geactiveerd op belangrijke momenten zoals ophalen, aankomst op de terminal, een wijziging in de ETA en uiteindelijke aflevering, met uitzonderingsgebeurtenissen zoals weigeringen of annuleringen wanneer dat nodig is.
- Het correct koppelen van zendingidentificatoren zoals de SCAC en het waybill-nummer is cruciaal voor betrouwbare datakoppeling, waarbij elk AT7-event doorgaans apart wordt vastgelegd voor gedetailleerde tracking.
- Richt je op veelvoorkomende gebeurteniscodes zoals AF voor ophalen, X4 en AR voor transitmijlpalen, en D1 voor aflevering, terwijl uitzonderingscodes zoals A7 en CA handmatige controle triggeren.
- De batchfrequentie van verzendingen heeft grote invloed op realtime inzicht, waarbij eventgestuurde updates nauwkeurigere ETA- en statusinformatie opleveren voor operationele beslissingen.
- Het parseren en implementeren van 214-data vereist het valideren van codelijsten, het bijhouden van ruwe gebeurtenishistorie en het zorgen voor idempotentie om dubbele records te voorkomen.
Inhoudsopgave
Wat is de EDI 214 en wanneer sturen vervoerders die?
De 214 valt binnen de ASC X12 EDI-standaard als het Transportation Carrier Shipment Status Message, bedoeld om zendinggebeurtenissen, datums, tijden, locaties, routing en vervoermiddelen terug te rapporteren aan degene die de lading heeft aangeboden. Het is de helft van een gesprek van de vervoerder dat begint met een tender en eindigt met een factuur.
Een vervoerder verstuurt een 214 doorgaans op verschillende natuurlijke checkpoints in het leven van een zending:
- Ophalen voltooid op de origin
- Aankomst bij een tussenliggende terminal of rail ramp
- Een wijziging in de verwachte leverdatum
- Uiteindelijke aflevering op de bestemming
- Een uitzondering: weigering, schade, vertraging, annulering
De 214 staat niet op zichzelf. Het sluit een loop af die meestal begint met een EDI 204 load tender, waarbij de shipper de lading aanbiedt en de vervoerder die accepteert. De 214 rapporteert vervolgens wat er onderweg met die lading gebeurt, en zodra levering is bevestigd, wordt de cyclus doorgaans afgesloten met een 210-factuur, die door het leverings-event van de 214 helpt valideren. Sla de 214 over en je factureert op vertrouwen in plaats van op bewijs.
De versie is belangrijker dan veel integrators verwachten. De segmentenset en zelfs de betekenis van bepaalde qualifiers verschuiven tussen X12-releases, en versie 4010 wordt nog steeds veel gebruikt in documentatie van vervoerders, terwijl 4020 en latere versies velden toevoegen die sommige handelspartners vereisen. Controleer de versie in de implementatiegids van je partner voordat je een parser bouwt, niet nadat die bestanden begint te weigeren.
De 214 lezen: segmenten en velden die het waard zijn om vast te leggen
Elke 214 begint en eindigt met de standaard X12-envelope: ISA (interchange), GS (functionele groep) en ST (transaction set header) bovenaan, met bijbehorende trailers onderaan. Deze kaderen het bericht af en identificeren afzender en ontvanger, maar de zendingdetails zitten daarbinnen.
- B10 is het ankersegment. Het bevat de zendingidentificatoren, waybill- of pro-nummer en vaak een referentie naar een purchase order, en het is het segment waarop de meeste ontvangende systemen hun matchlogica als eerste baseren.
- N1/N3/N4-loops bevatten partij- en adresinformatie, zoals shipper, consignee of terminalgegevens. Behandel deze als aanvullend; de identifiers in B10 zijn betrouwbaarder voor matching dan vrije adrestekst.
- LX/AT7 is het werkpaard. De LX-loop nummert elk status-event, en het AT7-segment bevat de gebeurteniscode, redencode, datum en tijd, waardoor de meeste parslogica zich op dit paar concentreert.
- AT8 voegt gewicht- en hoeveelheidsgegevens toe die gekoppeld zijn aan het event, nuttig voor het afstemmen van wat is opgehaald met wat is aangeboden.
- MS1/MS2/MS3-segmenten (waar aanwezig) bevatten routing-, equipment- en locatiegegevens, handig voor intermodale of railbewegingen waarbij het vervoermiddel zelf ertoe doet.
Voor matching en opslag indexeer je op de SCAC (Standard Carrier Alpha Code) plus de B10-referentienummers, met de PO als secundaire sleutel. Sla elke AT7-regel op als een afzonderlijk eventrecord in plaats van alles samen te voegen, omdat een enkele zending een dozijn of meer statusupdates kan genereren voordat zij haar bestemming bereikt.
AT7-gebeurteniscodes ontcijferen: wat ze betekenen en hoe je erop handelt
Het AT7-segment bevat de feitelijke status, en het veld dat het belangrijkst is, is Data Element 1650, de gebeurteniscode. Sommige AT701-waarden geven aan dat de zending is afgeleverd, terwijl andere alleen voortgang onderweg markeren, dus je parslogica moet onderscheid maken tussen die twee categorieën in plaats van elke code gelijk te behandelen.
Een handvol codes dekt het grootste deel van het verkeer in de praktijk:
| Code |
Betekenis |
Typische trigger |
| AF |
Werkelijk opgehaald |
Chauffeur haalt de lading op bij het beginpunt |
| AB |
Afspraak gepland |
Leverings- of ophaalafspraak vastgelegd |
| X4 |
Aangekomen op terminal |
Lading bereikt een cross-dock of rail ramp |
| AR |
Aangekomen op bestemming |
Vrachtwagen bereikt het uiteindelijke afleverpunt |
| D1 |
Afgeleverd |
Lading overgedragen, POD volgt doorgaans |
| AG |
Geschatte levering |
ETA-update, nog geen fysiek event |
| I1 |
In-gate (intermodaal) |
Container komt een rail- of havenfaciliteit binnen |
| A7 |
Geweigerd door ontvanger |
Levering geprobeerd maar geweigerd |
| CA |
Geannuleerd |
Zending na tender geannuleerd |
| NS |
Geen status beschikbaar |
Plaatsaanduiding of data niet beschikbaar |
Bouw je statusmachine rond drie buckets in plaats van elf afzonderlijke takken:
- In-transitcodes (AF, X4, AR, AB, AG) updaten locatie en ETA zonder de zending te sluiten.
- Terminalcodes (D1) sluiten de zending af en moeten POD-opvraging en facturatie-workflows triggeren.
- Uitzonderingscodes (A7, CA, NS) hebben een mens in de loop nodig, geen automatische statuswijziging.
Vervoerders sturen soms codes buiten je geaccepteerde lijst, vooral tijdens onboarding. Laat niet het hele bestand falen. Log de onbekende code, houd de zending in haar laatst bekende status en geef een waarschuwing voor handmatige controle in plaats van het event stil te laten vallen of de betekenis te gokken.
Waar 214-koppelingen in de praktijk stuklopen
De meeste 214-fouten zijn terug te voeren op een handvol terugkerende oorzaken in plaats van exotische randgevallen. Referentiemismatches staan bovenaan: een B10- of PO-referentie van de vervoerder komt niet overeen met wat op de oorspronkelijke 204-tender is verzonden, vaak door formatverschillen zoals voorloopnullen of inconsistente SCAC-codes. Verschillen in gewicht en eenheden, tijdzoneafhandeling en inconsistente datumformaten tussen handelspartners veroorzaken de rest.
Batchfrequentie is een stiller probleem. Een vervoerder die 214’s maar één keer per dag batched, geeft je een accurate historie maar weinig realtime inzicht, terwijl eventgestuurde verzending, per statuswijziging, juist live ETA-tracking ondersteunt. Stuur waar mogelijk aan op eventgestuurde verzending wanneer het systeem van een partner dat ondersteunt.
Een praktische validatie- en testvolgorde:
- Controleer of de interchange- en versiequalifiers in ISA/GS overeenkomen met wat het partnerprofiel verwacht.
- Handhaaf verplichte veldcontroles op B10, SCAC en minstens één AT7-regel voordat je een bestand accepteert.
- Houd een geaccepteerde codelijst per vervoerder bij en markeer alles daarbuiten in plaats van direct af te wijzen.
- Wissel 997-functional acknowledgements uit en verifieer die als onderdeel van onboarding, niet als nagedachte.
- Simuleer uitzonderingsscenario’s (weigering, annulering, vertraagde ETA) vóór livegang, niet nadat de eerste echte situatie zich aandient.
Pro Tip: Vraag nieuwe vervoerders om drie of vier voorbeeld-214-bestanden met pickup, onderweg en aflevering voordat je ook maar één regel mappingcode schrijft. Echte bestanden laten formatquirks zien die specificatiedocumenten nooit noemen.
214-gebeurtenissen mappen naar je TMS, WMS of ERP
Sla 214-events op als een append-only log in plaats van één enkel zendingrecord te overschrijven. De huidige status afleiden uit het meest recente event bewaart de volledige historie en maakt afstemming en geschilafhandeling veel eenvoudiger dan later een tijdlijn reconstrueren.
Een bruikbare mapping tussen AT7-codes en interne statussen ziet er als volgt uit:
- AF → “Opgehaald” (start de in-transit-timer)
- X4/AR → “Onderweg” met bijgewerkte locatie
- AG → ETA-veld updaten, planning- en ontvangstteams informeren, geen statuswijziging
- D1 → “Afgeleverd”, triggert POD-opvraging en sluit de rit af
- A7/CA → “Uitzondering”, doorgestuurd naar een menselijke queue in plaats van automatisch gesloten
ETA-updates verdienen hun eigen afhandelingspad. Wanneer een AG-event binnenkomt, werk dan direct het schema bij en stuur een melding naar de ontvangstteams, omdat een verouderde ETA slechter is dan helemaal geen ETA voor dockplanning.
Bescherm tegen duplicaten. Vervoerders versturen soms hetzelfde event opnieuw na een verbindingsretry, dus baseer je idempotentiecontrole op de combinatie van B10-referentie, AT7-code en eventtimestamp voordat je een nieuw record schrijft. Bewaar de ruwe gebeurtenishistorie zolang je factuurgeschilperiode dat vereist en archiveer daarna in plaats van te verwijderen.
Perspectief van de auteur: wat echt telt als je dit opschaalt
Zorg eerst dat de matchesleutels kloppen. SCAC plus waybill of pro-nummer brengt je door 90% van de zendingen; adresparsing en vrije velden zijn verrijking, geen fundament. Ik zie liever dat een team een beperkte set gebeurteniscodes schoon verwerkt dan dat het op dag één probeert elke mogelijke AT7-waarde af te handelen en vastloopt op de uitzonderingen. Breid de dekking uit zodra elke vervoerder stabiel blijkt, en gebruik 214-events tegenover de 210-factuur om geschillen met bewijs op te lossen in plaats van met telefoontjes.
— Vytautas
214-data in een systeem krijgen dat het ook echt gebruikt
Een 214 correct parseren is maar de helft van het werk. Het moeilijkere deel is het omzetten van AT7-events in iets waar je operationele team dezelfde dag nog mee werkt: een ETA die de trackinglink van een klant bijwerkt, een leverings-event dat een POD vrijgeeft, een statuswijziging die een lading markeert als klaar om te factureren. Logivo verwerkt EDI-feeds inclusief 214-statusupdates en mapt die naar zendingstatussen waar je team al mee werkt, naast live chauffeurstracking en POD-capture die de cirkel sluit wanneer een D1-event binnenkomt.
Omdat dit platform draait op gebruiksgebaseerde prijsstelling in plaats van een langlopend contract, kun je je eigen mappingregels valideren tegen echt vervoerdersverkeer tijdens een begeleide proefperiode van 30 dagen voordat één enkele lading wordt gefactureerd. Als het afstemmen van 214-events tegen facturen je de meeste administratieve tijd kost, dan is dat de workflow die het testen waard is. Kijk eens naar Logivo’s transportmanagementplatform en zie hoe jouw eigen EDI-feed daarin werkt.
Bronnen
- 214 | X12
- 214 - Transportation carrier shipment status (version 4010) - IBM Documentation
- EDI 214 Shipment Status Message | Understand the Transportation Carrier Shipment Status
FAQ
Wat betekenen de redencodes van EDI 214?
Redencodes staan naast de AT7-gebeurteniscode en leggen uit waarom een status is opgetreden, zoals een oorzaak van vertraging of een reden voor weigering; de exacte codereeksen worden meestal per handelspartnerafspraak vastgelegd en zijn niet universeel vast.
Wat is een EDI 214-document?
Het is het ANSI X12-bericht voor de status van een vervoerderszending, een elektronisch bestand dat vervoerders sturen om gebeurtenissen zoals ophalen, voortgang onderweg, levering of uitzonderingen voor een specifieke zending te rapporteren.
Wat is het verschil tussen EDI 204 en EDI 214?
De EDI 204 is de load tender die een shipper stuurt om een zending aan een vervoerder aan te bieden; de 214 is de reactie van de vervoerder die rapporteert wat er daadwerkelijk met die lading gebeurt zodra die onderweg is.
Wat zijn alle EDI-codes?
Er bestaat geen enkele universele lijst; AT7-gebeurteniscodes verschillen enigszins per vervoerder en sector, hoewel veelvoorkomende codes zoals AF (ophalen), D1 (afgeleverd) en CA (geannuleerd) in de meeste implementaties voorkomen.
Hoe hangt EDI 214-tracking samen met facturatie?
Een leverings-event (D1) op de 214 geeft de ontvanger het bewijs dat nodig is om de daaropvolgende 210-factuur te valideren, en daarom verkort het koppelen van 214-historie aan facturen factuurgeschillen aanzienlijk.
Aanbevolen