Skip to main content
PagrindinisTinklaraštisVadovaiKaip prijungti siuntos sekimo duomenis prie Oms: užsakymų susiejimo ir sinchronizavimo taisyklės

Kaip prijungti siuntos sekimo duomenis prie Oms: užsakymų susiejimo ir sinchronizavimo taisyklės

17TRACK

Norėdami prijungti siuntų sekimo duomenis prie užsakymų valdymo sistemos (OMS), susiekite kiekvieną sekamą paketą su vidiniu siuntos įrašu, tada susiekite tą siuntą su jos užsakymu ir vykdymo eilutėmis. Gaukite sekimo naujinius per teikėjo palaikomą sąsają, išsaugokite pirminius įvykius ir taikykite aiškias pasikartojančių įvykių, vėlyvų naujinių, siuntos būsenos ir užsakymo užbaigimo taisykles. Nenaudokite vien sekimo numerio kaip užsakymo identifikatoriaus ir neleiskite vienam pristatymo įvykiui automatiškai uždaryti užsakymo, kurį sudaro keli paketai.

Kaip prijungti siuntų sekimo duomenis prie OMS užsakymo

Šis vadovas skirtas integracijos inžinieriams ir elektroninės prekybos operacijų komandoms, įgyvendinančioms tokį ryšį. Rekomenduojamas sprendimas atskiria vežėjo stebėjimus nuo verslo sprendimų: sekimo duomenys aprašo paketo kelionę, o OMS nusprendžia, ką ši kelionė reiškia vykdymui, bendravimui su klientu ir užsakymo uždarymui.

Nustatykite, kuri sistema valdo kiekvieną įrašą

Prieš kurdami API ryšį, suderinkite nuosavybę su OMS administratoriumi, vykdymo komanda ir klientų aptarnavimo komanda. Priešingu atveju techniškai sėkminga integracija vis tiek gali perrašyti galiojančius verslo duomenis.

  • OMS: valdo užsakymus, užsakymo eilutes, reikalingus kiekius, atšaukimus ir užsakymo užbaigimo taisykles.
  • Vykdymo sistema: valdo jos sukurtus siuntų arba paketų įrašus, įskaitant pakavimo paskirstymus ir etikečių priskyrimus. Tai gali būti pati OMS arba atskira sandėlio sistema.
  • Sekimo teikėjas: pateikia sekimo stebėjimus ir teikėjo apibrėžtas būsenų klasifikacijas.
  • Integracijos sluoksnis: valdo identifikatorių kryžmines nuorodas, įvykių apdorojimą, normalizavimą, pakartotinius bandymus ir sinchronizavimo audito įrašus.

Vertinkite tai kaip rekomenduojamas ribas, o ne prielaidas apie jūsų programinę įrangą. Dokumentuokite išimtis. Pavyzdžiui, jei sandėlis gali pakeisti siuntimo etiketę, integracijai reikia aiškaus naujinio iš tos sistemos, o ne spėti, kad naujai pastebėtas numeris pakeičia senąjį.

Sukurkite užsakymo ir paketo susiejimą prieš sinchronizuodami būsenas

Praktinis ryšys yra užsakymas → vykdymas → paketas → sekimo priskyrimas. Jūsų OMS gali naudoti kitus pavadinimus arba sujungti kai kuriuos iš šių įrašų. Išsaugokite ryšius, net jei duomenų bazės struktūra skiriasi.

Užsakymas gali turėti kelis vykdymus, o vykdymą gali sudaryti keli paketai. Paketas taip pat gali gauti pakaitinį sekimo priskyrimą arba susietą paskutinės mylios identifikatorių. Šie identifikatoriai neturėtų sukurti papildomų užsakytų kiekių.

ĮrašasRekomenduojami laukaiPaskirtis
UžsakymasNuomininko arba parduotuvės ID, nekintamas OMS užsakymo IDAtskiria prekybininkus ir neleidžia priklausyti nuo rodomų užsakymo numerių.
VykdymasVykdymo ID, užsakymo ID, paskirtų eilučių ID ir kiekiaiNustato, kurie įsigyti elementai vykdomi.
PaketasVidinis paketo ID, vykdymo ID, jei įmanoma – paketo paskirstymaiSuteikia stabilią tapatybę, nepriklausančią nuo sekimo etikečių.
Sekimo priskyrimasPriskyrimo ID, paketo ID, teikėjo paskyra, vežėjo identifikatorius, sekimo numeris, aktyvus laikotarpisSusieja gaunamus sekimo stebėjimus su tinkamu paketu ir priskyrimo gyvavimo ciklu.

Susiekite naujinius naudodami išsaugotą kryžminę nuorodą

Kai sukuriama siunta, prieš registruodami ją sekimui išsaugokite vidinius ID. Išsaugokite bet kokį teikėjo suteiktą sekimo įrašo ID, grąžintą dokumentuotame registracijos procese. Jei teikėjas palaiko prekybininko nuorodą, naudokite neskaidrią vidinę nuorodą ir išsaugokite susiejimą vietoje.

Gaunamiems naujiniams pirmiausia nustatykite išsaugotą teikėjo įrašo ID tinkamoje teikėjo paskyroje ir nuomininko kontekste. Jei šio identifikatoriaus nėra, naudokite dokumentuotą sekimo numerio, vežėjo tapatybės, paskyros konteksto ir priskyrimo istorijos derinį. Laikykite tai paieškos strategija, o ne garantija, kad derinys yra visuotinai unikalus.

Nesiekite pagal kliento vardą, el. pašto adresą ar neaprėmintą rodomą užsakymo numerį. Sekimo numerius išsaugokite kaip eilutes, kad nebūtų prarasti pradiniai nuliai. Nenaikinkite simbolių ir nekeiskite raidžių registro, nebent tai leidžia atitinkamo vežėjo ar teikėjo sutartis.

Jei paieška neranda atitikties arba grąžina kelias galimas atitiktis, atskirkite naujinį tyrimui. Neišspręstas įvykis yra saugesnis nei užtikrintas netinkamo kliento užsakymo atnaujinimas.

Tvarkykite padalytus užsakymus nesukurdami išgalvotų paketų paskirstymų

Įsivaizduokime užsakymą, kurį sudaro trys vienetai. Paketas A turi du vienetus, o paketas B – vieną. Paketo A pristatymas reiškia, kad yra pristatymo įrodymų dviem vienetams; tai nereiškia, kad pristatytas visas užsakymas.

Jei vykdymo sistema fiksuoja tik tai, kad abu paketai priklauso tam pačiam vykdymui, nesukurkite išgalvotų vienetų lygio paskirstymų. Vis tiek galite apskaičiuoti, ar pristatyti visi reikalingi paketai, tačiau elementų lygio pristatymo ataskaitos turėtų nebūti arba būti aiškiai pažymėtos kaip neapibrėžtos, kol nėra paskirstymo duomenų.

Prijunkite sekimo API per patvarų duomenų priėmimo sluoksnį

Naudokite procesą, kuris atskiria ryšį su teikėju nuo OMS įrašų:

Siuntos sukūrimas → sekimo registracija → gaunamas naujinys arba suplanuotas gavimas → patvarus įvykio saugojimas → susiejimas ir normalizavimas → OMS naujinys → suderinimas

Įgyvendinant 17TRACK, aktualūs pradžios taškai yra sekimo API produkto puslapis ir oficiali API dokumentacija. Prieš įgyvendindami adapterį patvirtinkite taikomą registracijos sąsają, vežėjų identifikatorius, naujinių pristatymo parinktis, autentifikavimo reikalavimus, būsenų apibrėžimus ir paskyros apribojimus. Šiame vadove pateiktas duomenų modelis yra integracijos rekomendacija, o ne teiginys, kad 17TRACK naudoja šiuos laukų pavadinimus arba teikia savąją jungtį jūsų OMS.

Jei pasirinktas teikėjas palaiko saityno kablius, autentifikuokite gaunamas užklausas naudodami dokumentuotą mechanizmą ir prieš patvirtindami jas patvariai išsaugokite priimtus pranešimus. Lėtą OMS darbą vykdykite ne užklausos kelyje. Laikykitės faktinės teikėjo patvirtinimo ir pakartotinių bandymų sutarties, o ne manykite apie konkretų atsakymo turinį ar skirtąjį laiką.

Jei reikia apklausos, saugokite gavimo eigą ten, kur ją palaiko API, kontroliuokite lygiagretumą ir laikykitės dokumentuotų dažnio apribojimų. Nei saityno kablio gavimas, nei sėkminga apklausos užklausa neįrodo, kad OMS buvo atnaujinta; šiuos rezultatus fiksuokite atskirai.

Apibrėžkite sinchronizavimo taisykles, atsparias pakartotiniams bandymams ir vėlyviems įvykiams

1. Užtikrinkite idempotentinį apdorojimą

Du kartus apdorojus tą patį stebėjimą neturėtų būti dubliuojama siunta, du kartus padidinami kiekiai ar dar kartą siunčiamas tas pats kliento pranešimas. HTTP savaime nepadaro savavališkos POST operacijos idempotentine; integracija turi įgyvendinti pasikartojančių įrašų apsaugą. RFC 9110 paaiškina HTTP metodų idempotentiškumą.

Naudokite stabilų teikėjo įvykio ID, kai jis dokumentuotas ir prieinamas. Kitu atveju apibrėžkite piršto atspaudą iš priskyrimo ID ir svarbių įvykio laukų, pavyzdžiui, įvykio laiko, šaltinio būsenos ir vietos. Dokumentuokite susidūrimų arba pakeistų įvykio aprašymų galimybę. Išsaugokite neapdorotą stebėjimą, net jei jis nesukuria kito OMS veiksmo.

Atskirkite kiekvieną šalutinį poveikį. Pavyzdžiui, OMS būsenos įrašymui ir el. pašto pranešimui reikia atskirų dublikatų šalinimo valdiklių. Naudokite transakcinę išvesties eilę arba lygiavertį patvarų darbo įrašą, kad proceso gedimas nepaliktų priimto įvykio be suplanuoto naujinio.

2. Atskirai saugokite įvykio ir gavimo laiką

Įvykio atsiradimo laikas ir laikas, kada jį gavo jūsų integracija, atsako į skirtingus klausimus. Saugokite abu, taip pat pirminį laiko žymos atvaizdavimą ir pateiktą laiko juostos poslinkį. Neskirkite sandėlio laiko juostos įvykiui, kurio laiko juosta nežinoma.

Vėlai gautas skenavimas „gabenama“ paprastai turėtų papildyti istoriją, o ne pakeisti naujesnę būseną „pristatyta“. Tačiau vien laiko žymų nepakanka: teikėjas gali išduoti pataisą, o įvykiuose gali trūkti laiko informacijos. Kai įmanoma, naudokite dokumentuotus sekos arba peržiūros laukus ir aiškią taisymų politiką.

3. Normalizuokite būsenas neištrindami šaltinio informacijos

Sukurkite nedidelį vidinį žodyną, kurį supranta OMS, pavyzdžiui: laukiama vežėjo priėmimo, gabenama, išvežta pristatyti, pristatyta, išimtis ir grąžinama. Susiekite į jį dokumentuotas teikėjo būsenas. Tai siūlomos vidinės kategorijos, o ne universalūs vežėjų apibrėžimai.

Saugokite pradinį būsenos kodą, aprašą, įvykio vietą, teikėjo įrašo nuorodą ir susiejimo taisyklės versiją. Nepriskirta reikšmė turėtų sukurti peržiūrėtiną sąlygą, o ne būti numatytai pakeista į „pristatyta“ ar „nepavyko“. Etiketės sukūrimas neturėtų būti laikomas fizinio vežėjo priėmimo įrodymu, nebent šaltinio įvykis aiškiai pagrindžia tokį aiškinimą.

4. Naudokite perėjimų taisykles, o ne paprastą skaitinį reitingą

Siuntų būsenos ne visada sudaro tiesią seką. Po išimties gali vėl prasidėti įprastas gabenimas, o bandymas pristatyti nėra pristatymas. Grąžinimas gali prasidėti po ankstesnio pristatymo įvykio.

  • Leiskite išimčiai išnykti, kai vėlesni įrodymai patvirtina atnaujintą judėjimą.
  • Neleiskite įprastam istoriniam skenavimui tyliai pakeisti pristatytos būsenos.
  • Leiskite dokumentuotą pataisą per kontroliuojamą peržiūros kelią.
  • Kai OMS tai palaiko, grąžinimo judėjimą sekite atskirai nuo išsiuntimo užbaigimo.
  • Dviprasmiškus arba prieštaringus įrodymus nukreipkite į operacijų eilę.

Versijuokite šias taisykles. Pakeitus susiejimą nuspręskite, ar jis taikomas tik naujiems įvykiams, ar istorinius įrašus reikia kontroliuojamai perskaičiuoti.

Apskaičiuokite užsakymo būseną pagal privalomus vykdymo įsipareigojimus

Paketo būsena ir užsakymo būsena turėtų būti atskiri laukai. Paketas, pažymėtas kaip pristatytas, pateikia to paketo įrodymus; užsakymo užbaigimas priklauso nuo likusių reikalingų kiekių ir jūsų verslo politikos.

Naudingas numatytasis principas – užsakymą visiškai pristatytu pažymėti tik tada, kai visi pristatyti privalomi kiekiai turi galiojančius paketo lygio pristatymo įrodymus ir nelieka neišspręstų privalomų paskirstymų. Atšauktus kiekius išskirkite pagal OMS atšaukimo taisykles. Skaitmeniniams elementams, atsiėmimo užsakymams ir kitiems ne siuntimo įsipareigojimams taikykite jų pačių užbaigimo sąlygas.

Pakaitinėms siuntoms reikia aiškių ryšių. Jei prarastas paketas pakeičiamas, nuspręskite, ar pakaitalas pakeičia pradinį pristatymo įsipareigojimą. Priešingu atveju pradinis paketas gali neribotai trukdyti užbaigti užsakymą arba abu paketai gali būti įtraukti į vykdymą. Užfiksuokite sprendimą, o ne išveskite jį vien iš sekimo būsenos.

Pristatymo užbaigimą laikykite atskirai nuo finansinio uždarymo, teisės į pinigų grąžinimą ir ginčų sprendimo. Vežėjo pristatymo įvykis neturėtų automatiškai suteikti teisės į pinigų grąžinimą ar išspręsti kliento pretenziją.

Atsigaukite po gedimų neprarasdami audito pėdsako

Laikinus gedimus kartokite naudodami ribotą atidėjimą ir visas dokumentuotas pakartotinių bandymų rekomendacijas. Atskirkite laikinuosius ryšio gedimus nuo netinkamų identifikatorių, pasibaigusių kredencialų, leidimų klaidų ir schemos nesuderinamumo. Pastariesiems reikia taisomųjų veiksmų, o ne nesibaigiančių pakartojimų.

Palaikykite nepavykusių darbų eilę, kurioje būtų paveiktas nuomininkas, paketas, įvykio nuoroda, bandyta operacija, klaidos klasifikacija ir kitas veiksmas. Registruokite pakankamai konteksto tyrimui, tačiau į žurnalus nekopijuokite nereikalingų klientų duomenų ar kredencialų.

Be įprasto naujinimo kelio vykdykite suderinimą. Peržiūrėkite aktyvias siuntas su pasenusia sekimo informacija, priimtus įvykius, kurių OMS įrašai nepavyko, nesutampančius stebėjimus ir skirtumus tarp integracijos apskaičiuotos būsenos bei OMS. Peržiūros dažnį rinkitės pagal pristatymo įsipareigojimus, API apribojimus ir operacinę riziką, o ne taikykite savavališką universalų grafiką.

Priskirkite atsakomybę: inžinerija tvarko priėmimo ir įrašymo klaidas; vykdymo operacijos sprendžia trūkstamus paketų ryšius; klientų aptarnavimas peržiūri išimtis, kurioms reikia bendrauti su klientu. Eilė be atsakingo savininko tėra saugojimo vieta.

Prieš paleidimą patikrinkite susiejimą ir verslo taisykles

Naudokite kontroliuojamus testinius duomenis ir ribotą paleidimą gamybinėje aplinkoje. Patikrinkite šiuos atvejus pagal įvykių istoriją ir gautą OMS įrašą:

  • Vieno paketo užsakymas įprastai pereina iki pristatymo.
  • Padalytame užsakyme vienas paketas pristatytas, o kitas vis dar gabenamas.
  • Tas pats įvykis gaunamas pakartotinai nesukuriant pasikartojančių šalutinių poveikių.
  • Senas gabenimo skenavimas gaunamas po pristatymo.
  • Nežinomas vežėjas arba būsena patenka į peržiūros eilę.
  • Etiketė pakeičiama nesukuriant kito vykdymo įsipareigojimo.
  • Pakaitinė siunta pagal patvirtintą taisyklę pakeičia pradinį paketą.
  • Priėmus įvykį OMS tampa nepasiekiama.
  • Procesas paleidžiamas iš naujo tarp OMS įrašymo ir jo patvirtinimo.
  • Tas pats rodomas užsakymo numeris egzistuoja dviejose parduotuvėse ir nesusiejamas tarp nuomininkų.

Paleiskite sistemą, kai kiekvienas priimtas įvykis turi atsekamą apdorojimo rezultatą, dviprasmiškos atitiktys negali automatiškai atnaujinti užsakymų, o operatoriai gali saugiai pakartoti nepavykusius darbus. Tai naudingesni priėmimo kriterijai nei vien parodyti, kad API užklausa sėkminga.

DUK

Ar galiu tiesiogiai susieti sekimo numerius su užsakymais?

Griežtai vieno paketo procese tiesioginio ryšio iš pradžių gali pakakti. Vis dėlto tarp užsakymo ir sekimo priskyrimo naudokite vidinę siuntos tapatybę. Tai suteikia kelią pereiti prie padalytų siuntų, perženklinimo ir pakeitimų nekeičiant užsakymo įrašo reikšmės.

Ar integracija turėtų naudoti saityno kablius, ar apklausą?

Naudokite teikėjo palaikomą ir su jūsų infrastruktūra suderinamą pristatymo mechanizmą. Saityno kabliai gali sumažinti pakartotinį gavimą, o apklausa gali palaikyti gavimu grindžiamus procesus ir suderinimą, jei tai prieinama. Nė vienas būdas nepanaikina patvaraus saugojimo, dublikatų tvarkymo ir atkūrimo poreikio.

Kas turėtų nutikti, kai sekimo įvykis neturi atitinkančio užsakymo?

Išsaugokite jį nesutampančių įvykių eilėje ir ištirkite registracijos įrašą, nuomininko kontekstą, vežėjo tapatybę bei siuntos sukūrimo laiką. Automatiškai nekurkite užsakymo ir nepriskirkite įvykio tikėtinam klientui. Pakartokite jį, kai susiejimas bus ištaisytas.

Ar pristatymo pranešimai turėtų būti siunčiami iš OMS, ar sekimo sistemos?

Kiekvienam pranešimo tipui ir paleidikliui pasirinkite vieną savininką. Jei dvi sistemos gali siųsti tą pačią žinutę, išjunkite vieną kelią arba naudokite bendrą patvarų pranešimų žurnalą. Taip pat nuspręskite, ar pranešimas susijęs su vienu paketu, ar visu užsakymu, ypač padalyto vykdymo atveju.

Ar išimties būsena reiškia, kad užsakymas nepavyko?

Ne. Išimtis yra stebėjimas, kurį reikia interpretuoti, o ne būtinai galutinis rezultatas. Išsaugokite priežastį, stebėkite vėlesnius įvykius ir naudokite eskalavimo politiką, kad nuspręstumėte, kada turi įsikišti operacijos.

Šaltiniai