Implementerere: 5 EDI 214-segmenter å fange opp og mappe
Praktisk referanse for EDI-implementerere: fang opp de fem 214-segmentene, dekod AT7-statuskoder, map shipment states inn i TMS-en din, og følg en...
Implementerere: 5 EDI 214-segmenter å fange opp og mappe
En EDI 214 er ANSI X12s transportørmelding for forsendelsesstatus: transportører sender den for å rapportere hendelseskoder (AT7), datoer, tider og lokasjoner knyttet til en forsendelse. Den inneholder identifikatorene et mottakssystem trenger for å matche oppdateringen med riktig last, og AT7-kodene driver de praktiske resultatene som betyr noe: sanntidsinnsyn, justering av ETA, leveringsbekreftelse og ryddig fakturakontroll.
TL;DR:
- De fleste oppdateringer om forsendelsesstatus utløses ved nøkkelpunkter som henting, ankomst til terminal, endring i ETA og endelig levering, med unntakshendelser som avvisning eller kansellering når det er nødvendig.
- Riktig matching av forsendelsesidentifikatorer som SCAC og fraktseddelnummer er avgjørende for pålitelig dataintegrasjon, og hver AT7-hendelse registreres vanligvis separat for detaljert sporing.
- Fokuser på vanlige hendelseskoder som AF for henting, X4 og AR for transittmiljøer, og D1 for levering, mens unntakskoder som A7 og CA behandles som triggere for manuell gjennomgang.
- Batch-frekvens for overføring påvirker sanntidsinnsyn betydelig, og hendelsesstyrte oppdateringer gir mer nøyaktig ETA og statusinformasjon for driftsbeslutninger.
- Effektiv parsing og implementering av 214-data krever validering av kodelister, vedlikehold av rå hendelseshistorikk og sikring av idempotens for å unngå duplikatposter.
Innholdsfortegnelse
Hva er EDI 214, og når sender transportører den?
214-en ligger i ASC X12 EDI-standarden som Transportation Carrier Shipment Status Message, og er bygget for å rapportere forsendelseshendelser, datoer, tider, lokasjoner, ruteinformasjon og transportmiddel tilbake til den som tildelte lasten. Det er transportørens del av en samtale som starter med en tender og ender med en faktura.
En transportør sender vanligvis en 214 ved flere naturlige kontrollpunkter i en forsendelses livsløp:
- Henting fullført ved opprinnelsesstedet
- Ankomst til en mellomterminal eller jernbanerampe
- Endring i estimert leveringstid
- Endelig levering ved destinasjon
- Et unntak: avvisning, skade, forsinkelse, kansellering
214-en fungerer ikke alene. Den fullfører en løkke som vanligvis starter med en EDI 204 lastetender, der avsenderen tilbyr lasten og transportøren aksepterer den. 214-en rapporterer deretter hva som faktisk skjer med lasten underveis, og når leveringen er bekreftet, avsluttes syklusen vanligvis med en 210-faktura, som leveringshendelsen i 214-en hjelper med å validere. Uten 214 står du igjen med fakturering basert på tillit i stedet for bevis.
Versjon er viktigere enn mange integratører forventer. Segmentsettet og til og med betydningen av enkelte kvalifikatorer endrer seg mellom X12-utgivelser, og versjon 4010 er fortsatt mye referert til i transportørdokumentasjon, selv om 4020 og senere versjoner legger til felter noen handelspartnere krever. Bekreft versjonen i partnerens implementeringsguide før du bygger en parser, ikke etter at den begynner å avvise filer.
Lesing av 214: segmenter og felter som er verdt å fange opp
Hver 214 åpner og avslutter med standard X12-konvolutt: ISA (interchange), GS (functional group) og ST (transaction set header) øverst, med tilsvarende trailers nederst. Disse rammer inn meldingen og identifiserer avsender og mottaker, men forsendelsesdetaljene ligger inni.
- B10 er ankergsegmentet. Det inneholder forsendelsesidentifikatorene, waybill- eller pro-nummeret, og ofte en referanse til purchase order, og det er segmentet de fleste mottakssystemer bruker først for matching.
- N1/N3/N4-looper inneholder part- og adresseinformasjon, avsender, mottaker eller terminaldetaljer. Behandle disse som supplerende; identifikatorene i B10 er mer pålitelige for matching enn fritekstadresse.
- LX/AT7 er arbeidshesten. LX-loopen nummererer hver statushendelse, og AT7-segmentet inneholder hendelseskode, årsakskode, dato og klokkeslett, som er grunnen til at det meste av parserlogikken sentrerer rundt denne kombinasjonen.
- AT8 legger til vekt- og mengdedata knyttet til hendelsen, nyttig for å avstemme hva som ble hentet mot det som ble tildelt.
- MS1/MS2/MS3-segmenter (der de finnes) inneholder rute-, utstyrs- og lokasjonsdetaljer, nyttige for intermodal- eller jernbanetransporter der selve transportmiddelet betyr noe.
For matching og lagring bør du indeksere på SCAC (Standard Carrier Alpha Code) pluss B10-referansene, med PO som sekundær nøkkel. Lagre hver AT7-linje som en egen hendelsespost i stedet for å slå dem sammen, fordi én enkelt forsendelse kan generere et tosifret antall statusoppdateringer før den når destinasjonen.
Tolkning av AT7-hendelseskoder: hva de betyr, og hvordan du skal reagere
AT7-segmentet er der selve statusen ligger, og feltet som betyr mest er Data Element 1650, hendelseskoden. Noen AT701-verdier signaliserer at forsendelsen er levert, mens andre bare markerer progresjon underveis, så parserlogikken må skille mellom disse to kategoriene i stedet for å behandle alle koder som like.
Et håndfull koder dekker det meste av reell trafikk:
| Kode |
Betydning |
Typisk utløser |
| AF |
Faktisk henting |
Fører henter lasten ved opprinnelsesstedet |
| AB |
Avtale planlagt |
Leverings- eller henteavtale satt opp |
| X4 |
Ankommet terminal |
Last når en cross-dock eller rampe |
| AR |
Ankommet destinasjon |
Lastebil når det endelige leveringsstedet |
| D1 |
Levert |
Last overlevert, POD følger vanligvis etter |
| AG |
Estimert levering |
ETA-oppdatering, ingen fysisk hendelse ennå |
| I1 |
In-gate (intermodal) |
Container går inn i et jernbane- eller havneanlegg |
| A7 |
Avvist av mottaker |
Levering forsøkt, men avvist |
| CA |
Kansellert |
Forsendelse kansellert etter tender |
| NS |
Ingen status tilgjengelig |
Plassholder eller data ikke tilgjengelig |
Bygg tilstandsmaskinen rundt tre grupper i stedet for elleve separate grener:
- Underveis-koder (AF, X4, AR, AB, AG) oppdaterer lokasjon og ETA uten å lukke forsendelsen.
- Terminalkoder (D1) lukker forsendelsen og bør utløse arbeidsflyter for innhenting av POD og fakturering.
- Unntakskoder (A7, CA, NS) trenger et menneske i loopen, ikke en automatisk tilstandsendring.
Transportører sender av og til koder utenfor den godkjente listen din, spesielt under onboarding. Ikke la hele filen feile. Loggfør den ukjente koden, hold forsendelsen i siste kjente status, og opprett et varsel for manuell gjennomgang i stedet for å droppe hendelsen stille eller gjette på betydningen.
Hvor 214-integrasjoner faktisk bryter sammen
De fleste 214-feil kan spores tilbake til noen få gjengangere snarere enn sjeldne spesialtilfeller. Referanseavvik topper listen: en transportørs B10- eller PO-referanse stemmer ikke med det som ble sendt på den opprinnelige 204-tenderen, ofte på grunn av formateringsforskjeller som ledende nuller eller inkonsistente SCAC-koder. Avvik i vekt og enheter, tidssonehåndtering og ulike datoformater mellom handelspartnere står for resten.
Batch-frekvens er et roligere problem. En transportør som batcher 214-er én gang daglig gir deg riktig historikk, men dårlig sanntidsinnsyn, mens hendelsesstyrt overføring, sendt hver gang statusen endres, er det som faktisk støtter live ETA-sporing. Press på for hendelsesstyrt sending der partnerens system støtter det.
En praktisk sekvens for validering og testing:
- Bekreft at interchange- og versjonskvalifikatorene i ISA/GS samsvarer med det partnerprofilen forventer.
- Håndhev kontroll av obligatoriske felt på B10, SCAC og minst én AT7-linje før en fil aksepteres.
- Vedlikehold en godkjent kodeliste per transportør og marker alt utenfor denne i stedet for å avvise alt umiddelbart.
- Utveksle og verifisere 997 functional acknowledgements som en del av onboarding, ikke som en ettertanke.
- Simuler unntaksscenarier (avvisning, kansellering, forsinket ETA) før go-live, ikke etter at den første virkelige hendelsen kommer.
Pro Tips: Be nye transportører om tre eller fire eksempel-214-filer som dekker henting, underveis og levering før du skriver en eneste linje med mappingskode. Virkelige filer avslører formateringsdetaljer som spesifikasjonsdokumenter aldri nevner.
Map 214-hendelser inn i TMS, WMS eller ERP
Lagre 214-hendelser som en append-only logg i stedet for å overskrive én enkelt forsendelsespost. Å avlede gjeldende status fra den nyeste hendelsen bevarer hele historikken og gjør avstemming og tvisteløsning langt enklere enn å prøve å rekonstruere en tidslinje i etterkant.
En praktisk mapping mellom AT7-koder og interne tilstander ser slik ut:
- AF → «Hentet» (starter underveis-klokken)
- X4/AR → «Underveis» med oppdatert lokasjon
- AG → ETA-felt oppdateres, planleggings- og mottaksteam varsles, ingen endring i tilstand
- D1 → «Levert», utløser innhenting av POD og lukker transportetappen
- A7/CA → «Unntak», rutes til en menneskelig kø i stedet for automatisk lukking
ETA-oppdateringer fortjener sin egen håndteringssti. Når en AG-hendelse kommer inn, oppdater planen og send et varsel til mottaksteamene umiddelbart, siden en utdatert ETA er verre enn ingen ETA i det hele tatt for dokkplanlegging.
Beskytt mot duplikater. Transportører sender av og til samme hendelse på nytt etter en tilkoblingsfeil, så bruk kombinasjonen av B10-referanse, AT7-kode og hendelsestidspunkt som idempotensnøkkel før du skriver en ny post. Behold rå hendelseshistorikk så lenge fakturatvist-vinduet krever det, og arkiver deretter i stedet for å slette.
Forfatterens perspektiv: det som faktisk betyr noe når du skalerer dette
Få matchingnøklene riktig først. SCAC pluss waybill- eller pro-nummer vil dekke 90 % av forsendelsene; adresseparsing og frie felt er berikelse, ikke fundament. Jeg ville heller sett et team ta imot et smalt sett med hendelseskoder på en ryddig måte enn å prøve å håndtere alle mulige AT7-verdier dag én og knekke på unntakene. Utvid dekningen etter hvert som hver transportør viser seg stabil, og bruk 214-hendelser mot 210-fakturaen for å løse tvister med bevis i stedet for telefoner.
— Vytautas
Få 214-data inn i et system som faktisk bruker dem
Å parse en 214 riktig er bare halve jobben. Den vanskeligere delen er å gjøre AT7-hendelser om til noe driftsteamet faktisk handler på samme dag, en ETA som oppdaterer kundens sporingslenke, en leveringshendelse som frigjør en POD, en statusendring som markerer en last klar for fakturering. Logivo leser inn EDI-feeds inkludert 214-statusoppdateringer og mapper dem til forsendelsesstatusene teamet ditt allerede jobber etter, sammen med live førersporing og POD-registrering som lukker løkken når en D1-hendelse kommer inn.
Fordi denne plattformen bruker forbruksbasert prising i stedet for en lang kontrakt, kan du validere egne mappingsregler mot reell transportørtrafikk i en veiledet 30-dagers prøveperiode før én eneste last faktureres. Hvis avstemming av 214-hendelser mot fakturaer er det som tar mest administrasjonstid, er det arbeidsflyten som er verdt å teste først. Ta en titt på Logivos transportstyringsplattform og se hvordan din egen EDI-feed oppfører seg i den.
Kilder
- 214 | X12
- 214 - Transportation carrier shipment status (version 4010) - IBM Documentation
- EDI 214 Shipment Status Message | Understand the Transportation Carrier Shipment Status
FAQ
Hva betyr EDI 214-årsakskodene?
Årsakskoder står ved siden av AT7-hendelseskoden og forklarer hvorfor en status oppstod, som en årsak til forsinkelse eller en grunn til avvisning; de eksakte kode-settene er vanligvis definert per handelspartneravtale, ikke universelt fastsatt.
Hva er et EDI 214-dokument?
Det er ANSI X12s transportørmelding for forsendelsesstatus, en elektronisk fil transportører sender for å rapportere hendelser som henting, progresjon underveis, levering eller unntak knyttet til en bestemt forsendelse.
Hva er forskjellen mellom EDI 204 og EDI 214?
EDI 204 er lastetenderen en avsender sender for å tilby en forsendelse til en transportør; 214 er transportørens svar som rapporterer hva som faktisk skjer med lasten når den er i bevegelse.
Hva er alle EDI-kodene?
Det finnes ingen enkelt universell liste; AT7-hendelseskoder varierer noe mellom transportører og bransjesegmenter, selv om vanlige koder som AF (henting), D1 (levert) og CA (kansellert) forekommer i de fleste implementeringer.
Hvordan kobles EDI 214-sporing til fakturering?
En leveringshendelse (D1) i 214-en gir mottakeren dokumentasjonen som trengs for å validere den påfølgende 210-fakturaen, og det er derfor matching av 214-historikk mot fakturaer forkorter fakturatvister betydelig.
Anbefalt