Skip to main content
HjemBlogVejledningerSådan forbinder du forsendelsessporingsdata med Oms: Ordremapping og synkroniseringsregler

Sådan forbinder du forsendelsessporingsdata med Oms: Ordremapping og synkroniseringsregler

17TRACK

For at forbinde forsendelsessporingsdata med et ordrehåndteringssystem (OMS) skal hver sporede pakke knyttes til en intern forsendelsespost og derefter forbindes med dens ordre og opfyldelseslinjer. Modtag sporingsopdateringer via udbyderens understøttede grænseflade, bevar de oprindelige hændelser, og anvend eksplicitte regler for dubletter, sene opdateringer, forsendelsesstatus og ordreafslutning. Brug ikke et sporingsnummer alene som ordreidentifikator, og lad ikke en enkelt leveringshændelse automatisk lukke en ordre med flere pakker.

Sådan forbinder du forsendelsessporingsdata med en OMS-ordre

Denne vejledning er beregnet til integrationsingeniører og e-handelsdriftsteams, der implementerer denne forbindelse. Det anbefalede design adskiller transportørens observationer fra forretningsbeslutninger: Sporingsdata beskriver en pakkes rejse, mens OMS afgør, hvad denne rejse betyder for ordreopfyldelse, kundekommunikation og ordreafslutning.

Definer, hvilket system der ejer hver post

Inden du bygger en API-forbindelse, skal du aftale ejerskabet med OMS-administratoren, opfyldelsesteamet og kundeserviceteamet. Ellers kan en teknisk vellykket integration stadig overskrive gyldige forretningsdata.

  • OMS: Ejer ordrer, ordrelinjer, krævede mængder, annulleringer og reglerne for ordreafslutning.
  • Opfyldelsessystem: Ejer de forsendelses- eller pakkeposter, som det opretter, herunder pakkeallokeringer og etikettilknytninger. Det kan være selve OMS eller et separat lagersystem.
  • Sporingsudbyder: Leverer sporingsobservationer og eventuelle udbyderdefinerede statusklassifikationer.
  • Integrationslag: Ejer krydsreferencer mellem identifikatorer, hændelsesbehandling, normalisering, genforsøgshåndtering og synkroniseringsrevisionsposter.

Betragt disse som anbefalede grænser, ikke som antagelser om din software. Dokumentér undtagelser. Hvis lageret for eksempel kan udskifte en forsendelsesetiket, skal integrationen have en eksplicit opdatering fra dette system i stedet for at gætte, at et nyt observeret nummer erstatter et gammelt.

Opbyg ordre-til-pakke-tilknytningen, før du synkroniserer statusser

En praktisk relation er ordre → opfyldelse → pakke → sporingstilknytning. Dit OMS kan bruge andre navne eller kombinere nogle af disse poster. Bevar relationerne, selv hvis databasestrukturen er anderledes.

En ordre kan have flere opfyldelser, og en opfyldelse kan indeholde flere pakker. En pakke kan også få en erstatningssporingstilknytning eller en tilknyttet last-mile-identifikator. Disse identifikatorer må ikke skabe yderligere bestilte mængder.

PostAnbefalede felterFormål
OrdreLejer- eller butiks-ID, uforanderligt OMS-ordre-IDAdskiller forhandlere og undgår afhængighed af viste ordrenumre.
OpfyldelseOpfyldelses-ID, ordre-ID, allokerede linje-ID'er og mængderIdentificerer, hvilke købte varer der opfyldes.
PakkeInternt pakke-ID, opfyldelses-ID, pakkeallokeringer, hvor de findesGiver en stabil identitet, der er uafhængig af sporingsetiketter.
SporingstilknytningTilknytnings-ID, pakke-ID, udbyderkonto, transportøridentifikator, sporingsnummer, aktiv periodeForbinder indgående sporingsobservationer med den korrekte pakke og tilknytningens livscyklus.

Match opdateringer via en gemt krydsreference

Når en forsendelse oprettes, skal du gemme dens interne ID'er, før du registrerer den til sporing. Gem ethvert udbyderudstedt sporingspost-ID, som returneres af den dokumenterede registreringsproces. Hvis udbyderen understøtter en forhandlerreference, skal du bruge en ugennemsigtig intern reference og bevare tilknytningen lokalt.

Ved indgående opdateringer skal du først finde det gemte udbyderpost-ID inden for den korrekte udbyderkonto og lejer. Hvis denne identifikator ikke er tilgængelig, skal du bruge den dokumenterede kombination af sporingsnummer, transportøridentitet, kontokontekst og tilknytningshistorik. Betragt dette som en opslagstrategi, ikke som en garanti for, at kombinationen er globalt entydig.

Match ikke via kundenavn, e-mailadresse eller et ikke-afgrænset vist ordrenummer. Bevar sporingsnumre som strenge, så foranstillede nuller bevares. Undgå at fjerne tegn eller ændre store og små bogstaver, medmindre den relevante transportørs eller udbyders kontrakt tillader denne normalisering.

Hvis et opslag ikke returnerer et match eller returnerer flere mulige match, skal opdateringen sættes i karantæne til undersøgelse. En uafklaret hændelse er sikrere end en sikker opdatering af den forkerte kundes ordre.

Håndter delte ordrer uden at opfinde pakkeallokeringer

Overvej en eksempelordre med tre enheder. Pakke A indeholder to enheder, og pakke B indeholder én. Levering af pakke A betyder, at to enheder har leveringsdokumentation; det betyder ikke, at hele ordren er leveret.

Hvis opfyldelsessystemet kun registrerer, at begge pakker tilhører samme opfyldelse, må du ikke opfinde allokeringer på enhedsniveau. Du kan stadig beregne, om alle nødvendige pakker er leveret, men rapportering af levering på vareniveau bør forblive utilgængelig eller udtrykkeligt usikker, indtil der findes allokeringsdata.

Forbind sporings-API'en via et robust indtagslag

Brug en pipeline, der holder udbyderkommunikation adskilt fra OMS-skrivninger:

Oprettelse af forsendelse → sporingsregistrering → indgående opdatering eller planlagt hentning → permanent hændelseslagring → tilknytning og normalisering → OMS-opdatering → afstemning

For en 17TRACK-implementering er produktsiden for Tracking API og den officielle API-dokumentation relevante udgangspunkter. Bekræft den relevante registreringsgrænseflade, transportøridentifikatorer, muligheder for levering af opdateringer, godkendelseskrav, statusdefinitioner og kontobegrænsninger, før du implementerer adapteren. Datamodellen i denne vejledning er en integrationsanbefaling, ikke en påstand om, at 17TRACK bruger disse feltnavne eller leverer en indbygget forbindelse til dit OMS.

Hvis den valgte udbyder understøtter webhooks, skal du godkende indgående anmodninger ved hjælp af den dokumenterede mekanisme og gemme accepterede meddelelser permanent, før du kvitterer for dem. Hold langsomt OMS-arbejde uden for anmodningsstien. Følg udbyderens faktiske kvitterings- og genforsøgskontrakt i stedet for at antage en bestemt svartekst eller timeout.

Hvis polling er påkrævet, skal du gemme hentningsfremskridt, hvor API'en understøtter det, kontrollere samtidighed og følge de dokumenterede hastighedsgrænser. Hverken modtagelse af en webhook eller en vellykket polling-anmodning beviser, at OMS blev opdateret; registrér resultaterne separat.

Definer synkroniseringsregler, der kan håndtere genforsøg og sene hændelser

1. Gør behandlingen idempotent

Behandling af den samme observation to gange må ikke duplikere en forsendelse, øge mængder to gange eller sende den samme kundemeddelelse igen. HTTP gør ikke en vilkårlig POST-operation idempotent; integrationen skal implementere beskyttelse mod dubletter. RFC 9110 forklarer idempotens for HTTP-metoder.

Brug et stabilt udbyderhændelses-ID, når et sådant er dokumenteret og tilgængeligt. Ellers skal du definere et fingeraftryk ud fra tilknytnings-ID'et og relevante hændelsesfelter, f.eks. hændelsestidspunkt, kildestatus og placering. Dokumentér muligheden for kollisioner eller ændrede hændelsesbeskrivelser. Bevar den rå observation, også når den ikke medfører en ny OMS-handling.

Beskyt hver bivirkning separat. En OMS-statusskrivning og en e-mailmeddelelse har for eksempel brug for hver deres dubletkontroller. Brug en transaktionel outbox eller en tilsvarende permanent arbejdsrecord, så et procesnedbrud ikke kan efterlade en accepteret hændelse uden en planlagt opdatering.

2. Gem hændelsestid og modtagelsestid separat

Tidspunktet for en hændelses forekomst og tidspunktet, hvor din integration modtog den, besvarer forskellige spørgsmål. Gem begge sammen med den oprindelige tidsstempelrepræsentation og enhver angivet tidszoneforskydning. Tildel ikke stiltiende lagerets tidszone til en hændelse, hvis tidszonen er ukendt.

En sent ankommet scanning under transport bør normalt berige historikken uden at erstatte en nyere leveret tilstand. Tidsstempler alene er dog utilstrækkelige: En udbyder kan udstede en korrektion, og hændelser kan have ufuldstændige tidsoplysninger. Brug dokumenterede sekvens- eller revisionsfelter, når de findes, samt en eksplicit korrektionspolitik.

3. Normalisér statusser uden at slette kildedetaljer

Opret et lille internt ordforråd, som OMS forstår, f.eks. afventer transportørens accept, under transport, ude til levering, leveret, undtagelse og returnering. Tilknyt udbyderens dokumenterede statusser til det. Dette er foreslåede interne kategorier, ikke universelle transportørdefinitioner.

Gem den oprindelige statuskode, beskrivelse, hændelsesplacering, reference til udbyderposten og versionen af tilknytningsreglen. En ikke-tilknyttet værdi bør oprette en tilstand, der kan gennemgås, i stedet for som standard at blive sat til leveret eller mislykket. Oprettelse af en etiket bør ikke behandles som bevis på fysisk accept hos transportøren, medmindre kildehændelsen udtrykkeligt understøtter denne fortolkning.

4. Brug overgangsregler, ikke en simpel numerisk rangordning

Forsendelsestilstande danner ikke altid en lige linje. En undtagelse kan efterfølges af normal transport, og et leveringsforsøg er ikke det samme som levering. Returtransport kan begynde efter en tidligere leveringshændelse.

  • Tillad, at en undtagelse ophæves, når efterfølgende dokumentation understøtter genoptaget transport.
  • Forhindr, at en almindelig historisk scanning stiltiende erstatter en leveret tilstand.
  • Tillad en dokumenteret korrektion via en kontrolleret revisionssti.
  • Følg returtransport separat fra udgående afslutning, når OMS understøtter det.
  • Send tvetydig eller modstridende dokumentation til en driftskø.

Versionér disse regler. Når en tilknytning ændres, skal du beslutte, om den kun gælder nye hændelser, eller om historiske poster kræver en kontrolleret genberegning.

Beregn ordrestatus ud fra nødvendige opfyldelsesforpligtelser

Pakkestatus og ordrestatus bør være separate felter. En pakke, der er markeret som leveret, leverer dokumentation for den pågældende pakke; ordreafslutning afhænger af de resterende nødvendige mængder og din forretningspolitik.

En nyttig standard er kun at markere en ordre som fuldt leveret, når alle leveringspligtige mængder har gyldig leveringsdokumentation på pakkeniveau, og ingen nødvendige allokeringer fortsat er uafklarede. Udelad annullerede mængder i henhold til OMS' annulleringsregler. Håndter digitale varer, afhentningsordrer og andre ikke-forsendelsesrelaterede forpligtelser via deres egne afslutningsbetingelser.

Erstatningsforsendelser kræver eksplicitte relationer. Hvis en bortkommet pakke erstattes, skal du beslutte, om erstatningen tilsidesætter den oprindelige leveringsforpligtelse. Ellers kan den oprindelige pakke blokere afslutningen på ubestemt tid, eller begge pakker kan tælle med i opfyldelsen. Registrér beslutningen i stedet for at udlede den alene af sporingsstatus.

Hold leveringsafslutning adskilt fra økonomisk lukning, refusionsberettigelse og tvistbilæggelse. En leveringshændelse fra en transportør bør ikke automatisk godkende en refusion eller afslutte et kundekrav.

Gendan efter fejl uden at miste revisionssporet

Genforsøg midlertidige fejl ved hjælp af begrænset backoff og eventuelle dokumenterede genforsøgsanvisninger. Adskil midlertidige forbindelsesfejl fra ugyldige identifikatorer, udløbne legitimationsoplysninger, tilladelsesfejl og skemauforeneligheder. De sidstnævnte kræver korrigerende handling, ikke endeløse genforsøg.

Vedligehold en kø med mislykket arbejde, som indeholder den berørte lejer, pakke, hændelsesreference, forsøgte handling, fejlkategori og næste handling. Log tilstrækkelig kontekst til undersøgelse uden at kopiere unødvendige kundedata eller legitimationsoplysninger ind i loggene.

Kør afstemning ud over den normale opdateringssti. Gennemgå aktive forsendelser med forældede sporingsoplysninger, accepterede hændelser, hvor OMS-skrivninger mislykkedes, uoverensstemmende observationer og forskelle mellem integrationens beregnede tilstand og OMS. Vælg gennemgangsfrekvens ud fra leveringsforpligtelser, API-begrænsninger og driftsrisiko i stedet for at anvende en vilkårlig universel tidsplan.

Fordel ejerskab: Engineering håndterer indtags- og skrivefejl; opfyldelsesdriften løser manglende pakkerelationer; kundeservice gennemgår undtagelser, der kræver kundekommunikation. En kø uden en ansvarlig ejer er kun et lagringssted.

Test tilknytningen og forretningsreglerne før lancering

Brug kontrollerede testdata og en begrænset produktionsudrulning. Test følgende tilfælde mod både hændelseshistorikken og den resulterende OMS-post:

  • En ordre med én pakke går normalt frem til levering.
  • En delt ordre har én leveret pakke og én pakke, der stadig er under transport.
  • Den samme hændelse modtages gentagne gange uden dublerede bivirkninger.
  • En ældre transportscanning ankommer efter levering.
  • En ukendt transportør eller status sendes til gennemgangskøen.
  • En etiket udskiftes uden at skabe en yderligere opfyldelsesforpligtelse.
  • En erstatningsforsendelse tilsidesætter en oprindelig pakke i henhold til en godkendt regel.
  • OMS er utilgængeligt, efter at en hændelse er blevet accepteret.
  • En proces genstartes mellem en OMS-skrivning og dens kvittering.
  • Det samme viste ordrenummer findes i to butikker uden match på tværs af lejere.

Start, når hver accepteret hændelse har et sporbart behandlingsresultat, tvetydige match ikke automatisk kan opdatere ordrer, og operatører kan afspille mislykket arbejde sikkert. Dette er mere nyttige acceptkriterier end blot at demonstrere, at en API-anmodning lykkes.

Ofte stillede spørgsmål

Kan jeg forbinde sporingsnumre direkte med ordrer?

For en strengt enkeltpakke-baseret arbejdsgang kan en direkte relation være tilstrækkelig i begyndelsen. Brug dog en intern forsendelsesidentitet mellem ordren og sporingstilknytningen. Det giver en migrationssti for delte forsendelser, ommærkning og erstatninger uden at ændre betydningen af ordreposten.

Bør integrationen bruge webhooks eller polling?

Brug den leveringsmekanisme, som udbyderen understøtter, og som er kompatibel med din infrastruktur. Webhooks kan reducere gentagen hentning, mens polling kan understøtte hentningsbaserede arbejdsgange og afstemning, hvor det er tilgængeligt. Ingen af metoderne fjerner behovet for permanent lagring, dublethåndtering og gendannelse.

Hvad skal der ske, når en sporingshændelse ikke har en matchende ordre?

Gem den i en kø for uoverensstemmende hændelser, og undersøg registreringsposten, lejerkonteksten, transportøridentiteten og tidspunktet for oprettelse af forsendelsen. Opret ikke automatisk en ordre, og tilknyt ikke hændelsen til en sandsynlig kunde. Afspil den igen, når tilknytningen er rettet.

Bør leveringsmeddelelser komme fra OMS eller sporingssystemet?

Vælg én ejer for hver meddelelsestype og udløser. Hvis to systemer kan sende den samme meddelelse, skal du deaktivere den ene sti eller dele et permanent meddelelsesregister. Beslut også, om en meddelelse henviser til én pakke eller hele ordren, især ved delt opfyldelse.

Betyder en undtagelsesstatus, at ordren er mislykket?

Nej. En undtagelse er en observation, der kræver fortolkning, ikke nødvendigvis et permanent resultat. Bevar årsagen, overvåg efterfølgende hændelser, og brug din eskaleringspolitik til at afgøre, hvornår driften skal gribe ind.

Kilder