Skip to main content
Faqja kryesoreBlogUdhëzuesSi të lidhni të dhënat e gjurmimit të dërgesave me Oms: rregullat e hartëzimit dhe sinkronizimit të porosive

Si të lidhni të dhënat e gjurmimit të dërgesave me Oms: rregullat e hartëzimit dhe sinkronizimit të porosive

17TRACK

Për të lidhur të dhënat e gjurmimit të dërgesave me një sistem të menaxhimit të porosive (OMS), lidhni çdo paketë të gjurmuar me një regjistrim të brendshëm të dërgesës, më pas lidhni atë dërgesë me porosinë dhe linjat e përmbushjes. Merrni përditësimet e gjurmimit përmes ndërfaqes së mbështetur nga ofruesi, ruani ngjarjet origjinale dhe zbatoni rregulla të qarta për dublikatat, përditësimet e vonuara, statusin e dërgesës dhe përfundimin e porosisë. Mos përdorni vetëm numrin e gjurmimit si identifikues të porosisë dhe mos lejoni që një ngjarje e vetme dorëzimi të mbyllë automatikisht një porosi me shumë paketa.

Si të lidhni të dhënat e gjurmimit të dërgesave me një porosi OMS

Ky udhëzues është për inxhinierët e integrimit dhe ekipet e operacioneve të tregtisë elektronike që zbatojnë këtë lidhje. Dizajni i rekomanduar i ndan vëzhgimet e transportuesit nga vendimet e biznesit: të dhënat e gjurmimit përshkruajnë udhëtimin e një pakete, ndërsa OMS vendos se çfarë do të thotë ai udhëtim për përmbushjen, komunikimin me klientin dhe mbylljen e porosisë.

Përcaktoni cili sistem zotëron çdo regjistrim

Para se të ndërtoni një lidhje API, bini dakord për pronësinë me administratorin e OMS-së, ekipin e përmbushjes dhe ekipin e shërbimit ndaj klientit. Përndryshe, një integrim teknikisht i suksesshëm mund të mbishkruajë ende të dhëna të vlefshme të biznesit.

  • OMS: Zotëron porositë, linjat e porosive, sasitë e kërkuara, anulimet dhe rregullat për përfundimin e porosisë.
  • Sistemi i përmbushjes: Zotëron regjistrimet e dërgesave ose paketave që krijon, duke përfshirë ndarjet e paketimit dhe caktimet e etiketave. Ky mund të jetë vetë OMS-ja ose një sistem i veçantë magazine.
  • Ofruesi i gjurmimit: Furnizon vëzhgimet e gjurmimit dhe çdo klasifikim statusi të përcaktuar nga ofruesi.
  • Shtresa e integrimit: Zotëron referencat e ndërsjella të identifikuesve, përpunimin e ngjarjeve, normalizimin, trajtimin e riprovimeve dhe regjistrimet e auditimit të sinkronizimit.

Trajtojini këto si kufij të rekomanduar, jo si supozime për softuerin tuaj. Dokumentoni përjashtimet. Për shembull, nëse magazina mund të zëvendësojë një etiketë transporti, integrimi ka nevojë për një përditësim të qartë nga ai sistem, në vend që të hamendësojë se një numër i ri i vëzhguar zëvendëson të vjetrin.

Ndërtoni lidhjen porosi-paketë para sinkronizimit të statuseve

Një marrëdhënie praktike është porosi → përmbushje → paketë → caktim gjurmimi. OMS-ja juaj mund të përdorë emra të ndryshëm ose të kombinojë disa prej këtyre regjistrimeve. Ruani marrëdhëniet edhe nëse struktura e bazës së të dhënave ndryshon.

Një porosi mund të ketë disa përmbushje dhe një përmbushje mund të përmbajë disa paketa. Një paketë mund të marrë gjithashtu një caktim zëvendësues gjurmimi ose një identifikues të lidhur të miljes së fundit. Këta identifikues nuk duhet të krijojnë sasi shtesë të porositura.

RegjistrimiFushat e rekomanduaraQëllimi
PorosiaID-ja e qiramarrësit ose e dyqanit, ID-ja e pandryshueshme e porosisë në OMSNdan tregtarët dhe shmang varësinë nga numrat e porosive të shfaqura.
PërmbushjaID-ja e përmbushjes, ID-ja e porosisë, ID-të dhe sasitë e linjave të caktuaraIdentifikon artikujt e blerë që po përmbushen.
PaketaID-ja e brendshme e paketës, ID-ja e përmbushjes, ndarjet e paketës kur janë të disponueshmeSiguron një identitet të qëndrueshëm, të pavarur nga etiketat e gjurmimit.
Caktimi i gjurmimitID-ja e caktimit, ID-ja e paketës, llogaria e ofruesit, identifikuesi i transportuesit, numri i gjurmimit, periudha aktiveLidh vëzhgimet hyrëse të gjurmimit me paketën e saktë dhe ciklin jetësor të caktimit.

Përputhni përditësimet përmes një reference të ruajtur të ndërsjellë

Kur krijohet një dërgesë, ruani ID-të e saj të brendshme para se ta regjistroni për gjurmim. Ruani çdo ID të regjistrimit të gjurmimit të lëshuar nga ofruesi që kthehet nga procesi i dokumentuar i regjistrimit. Nëse ofruesi mbështet një referencë tregtari, përdorni një referencë të brendshme opake dhe ruajeni lidhjen lokalisht.

Për përditësimet hyrëse, së pari zgjidhni ID-në e ruajtur të regjistrimit të ofruesit brenda llogarisë dhe qiramarrësit të saktë të ofruesit. Nëse ky identifikues nuk është i disponueshëm, përdorni kombinimin e dokumentuar të numrit të gjurmimit, identitetit të transportuesit, kontekstit të llogarisë dhe historikut të caktimit. Trajtojeni këtë si strategji kërkimi, jo si garanci se kombinimi është globalisht unik.

Mos përputhni sipas emrit të klientit, adresës së emailit ose numrit të shfaqur të porosisë pa kontekst. Ruajini numrat e gjurmimit si vargje që zerot në fillim të mbeten. Shmangni heqjen e karaktereve ose ndryshimin e shkronjave, përveçse kur kontrata përkatëse e transportuesit ose ofruesit lejon një normalizim të tillë.

Nëse një kërkim nuk kthen asnjë përputhje ose kthen disa përputhje të mundshme, vendoseni përditësimin në karantinë për hetim. Një ngjarje e pazgjidhur është më e sigurt se një përditësim i sigurt në porosinë e klientit të gabuar.

Trajtoni porositë e ndara pa shpikur ndarje paketash

Merrni në konsideratë një porosi ilustruese që përmban tre njësi. Paketa A mbart dy njësi dhe Paketa B një. Dorëzimi i Paketës A do të thotë se ka prova dorëzimi për dy njësi; nuk do të thotë se e gjithë porosia është dorëzuar.

Nëse sistemi i përmbushjes regjistron vetëm se të dyja paketat i përkasin të njëjtës përmbushje, mos shpikni ndarje në nivel njësie. Mund të llogarisni ende nëse të gjitha paketat e kërkuara janë dorëzuar, por raportimi i dorëzimit në nivel artikulli duhet të mbetet i padisponueshëm ose shprehimisht i pasigurt derisa të ekzistojnë të dhënat e ndarjes.

Lidhni API-në e gjurmimit përmes një shtrese të qëndrueshme marrjeje

Përdorni një rrjedhë pune që e mban komunikimin me ofruesin të ndarë nga shkrimet në OMS:

Krijimi i dërgesës → regjistrimi i gjurmimit → përditësimi hyrës ose marrja e planifikuar → ruajtja e qëndrueshme e ngjarjes → përputhja dhe normalizimi → përditësimi i OMS-së → rakordimi

Për një zbatim me 17TRACK, faqja e produktit Tracking API dhe dokumentacioni zyrtar i API-së janë pikat përkatëse të nisjes. Konfirmoni ndërfaqen e zbatueshme të regjistrimit, identifikuesit e transportuesve, opsionet e dërgimit të përditësimeve, kërkesat e autentikimit, përkufizimet e statuseve dhe kufijtë e llogarisë para se të zbatoni përshtatësin. Modeli i të dhënave në këtë udhëzues është një rekomandim integrimi, jo një pretendim se 17TRACK përdor këta emra fushash ose ofron një lidhës vendas për OMS-në tuaj.

Nëse ofruesi i zgjedhur mbështet webhooks, autentikoni kërkesat hyrëse duke përdorur mekanizmin e dokumentuar dhe ruani në mënyrë të qëndrueshme mesazhet e pranuara para se t'i konfirmoni. Mbajeni punën e ngadaltë të OMS-së jashtë rrugës së kërkesës. Ndiqni kontratën faktike të konfirmimit dhe riprovimit të ofruesit, në vend që të supozoni një trup të caktuar përgjigjeje ose afat kohor.

Nëse kërkohet polling, ruani përparimin e marrjes aty ku API-ja e mbështet, kontrolloni konkurencën dhe ndiqni kufijtë e dokumentuar të shpejtësisë. As marrja e një webhook-u dhe as një kërkesë e suksesshme polling nuk provojnë se OMS-ja u përditësua; regjistroni këto rezultate veçmas.

Përcaktoni rregulla sinkronizimi që i përballojnë riprovimet dhe ngjarjet e vonuara

1. Bëjeni përpunimin idempotent

Përpunimi i të njëjtit vëzhgim dy herë nuk duhet të dublikojë një dërgesë, të avancojë sasitë dy herë ose të dërgojë sërish të njëjtin njoftim për klientin. HTTP nuk e bën një operacion arbitrar POST idempotent; integrimi duhet të zbatojë mbrojtjen nga dublikatat. RFC 9110 shpjegon idempotencën e metodave HTTP.

Përdorni një ID të qëndrueshme të ngjarjes së ofruesit kur dokumentohet dhe është e disponueshme. Përndryshe, përcaktoni një gjurmë nga ID-ja e caktimit dhe fushat përkatëse të ngjarjes, si vula kohore e ngjarjes, statusi burimor dhe vendndodhja. Dokumentoni mundësinë e përplasjeve ose ndryshimit të përshkrimeve të ngjarjeve. Ruani vëzhgimin e papërpunuar edhe kur ai nuk prodhon një veprim tjetër në OMS.

Mbroni çdo efekt anësor veçmas. Për shembull, një shkrim statusi në OMS dhe një njoftim me email kanë nevojë për kontrollet e tyre të deduplikimit. Përdorni një transactional outbox ose një regjistrim ekuivalent të qëndrueshëm pune, në mënyrë që një rrëzim i procesit të mos lërë një ngjarje të pranuar pa një përditësim të planifikuar.

2. Ruani veçmas kohën e ngjarjes dhe kohën e marrjes

Koha e ndodhjes së një ngjarjeje dhe koha kur integrimi juaj e mori atë u përgjigjen pyetjeve të ndryshme. Ruajini të dyja, së bashku me paraqitjen origjinale të vulës kohore dhe çdo zhvendosje të dhënë të zonës kohore. Mos i caktoni në heshtje zonën kohore të magazinës një ngjarjeje, zona kohore e së cilës është e panjohur.

Një skanim i vonuar gjatë transportit zakonisht duhet të pasurojë historikun pa zëvendësuar një status më të ri të dorëzuar. Megjithatë, vetëm vulat kohore nuk mjaftojnë: një ofrues mund të lëshojë një korrigjim dhe ngjarjet mund të kenë informacion kohor të paplotë. Përdorni fushat e dokumentuara të renditjes ose rishikimit kur janë të disponueshme, së bashku me një politikë të qartë korrigjimi.

3. Normalizoni statuset pa fshirë hollësitë e burimit

Krijoni një fjalor të vogël të brendshëm që OMS-ja e kupton, si në pritje të pranimit nga transportuesi, në transit, në shpërndarje, dorëzuar, përjashtim dhe në kthim. Lidhni statuset e dokumentuara të ofruesit me të. Këto janë kategori të sugjeruara të brendshme, jo përkufizime universale të transportuesve.

Ruani kodin origjinal të statusit, përshkrimin, vendndodhjen e ngjarjes, referencën e regjistrimit të ofruesit dhe versionin e rregullit të përputhjes. Një vlerë e papërputhur duhet të krijojë një gjendje që mund të shqyrtohet, në vend që të vendoset si parazgjedhje në dorëzuar ose dështuar. Krijimi i etiketës nuk duhet të trajtohet si provë e pranimit fizik nga transportuesi, përveçse kur ngjarja burimore e mbështet shprehimisht këtë interpretim.

4. Përdorni rregulla tranzicioni, jo një renditje të thjeshtë numerike

Gjendjet e dërgesës nuk formojnë gjithmonë një vijë të drejtë. Një përjashtim mund të pasohet nga tranziti normal dhe një përpjekje dorëzimi nuk është dorëzim. Lëvizja e kthimit mund të fillojë pas një ngjarjeje të mëparshme dorëzimi.

  • Lejoni që një përjashtim të pastrohet kur provat pasuese mbështesin rifillimin e lëvizjes.
  • Parandaloni që një skanim i zakonshëm historik të zëvendësojë në heshtje një status të dorëzuar.
  • Lejoni një korrigjim të dokumentuar përmes një rruge të kontrolluar rishikimi.
  • Gjurmoni lëvizjen e kthimit veçmas nga përfundimi i dërgesës dalëse kur OMS-ja e mbështet këtë.
  • Dërgoni provat e paqarta ose kontradiktore në një radhë operacionale.

Versiononi këto rregulla. Kur ndryshon një përputhje, vendosni nëse ajo zbatohet vetëm për ngjarjet e reja apo nëse regjistrimet historike kërkojnë një rillogaritje të kontrolluar.

Llogaritni statusin e porosisë nga detyrimet e kërkuara të përmbushjes

Statusi i paketës dhe statusi i porosisë duhet të jenë fusha të ndara. Një paketë e shënuar si e dorëzuar siguron prova për atë paketë; përfundimi i porosisë varet nga sasitë e kërkuara të mbetura dhe politika juaj e biznesit.

Një parazgjedhje e dobishme është ta shënoni një porosi si plotësisht të dorëzuar vetëm kur të gjitha sasitë që kërkojnë dorëzim kanë prova të vlefshme dorëzimi në nivel pakete dhe nuk mbeten ndarje të kërkuara të pazgjidhura. Përjashtoni sasitë e anuluara sipas rregullave të anulimit të OMS-së. Trajtoni artikujt dixhitalë, porositë për marrje dhe detyrimet e tjera jo të transportit përmes kushteve të tyre të përfundimit.

Dërgesat zëvendësuese kërkojnë marrëdhënie të qarta. Nëse një paketë e humbur zëvendësohet, vendosni nëse zëvendësimi zëvendëson detyrimin fillestar të dorëzimit. Përndryshe, paketa fillestare mund të bllokojë përfundimin pafundësisht ose të dyja paketat mund të llogariten në përmbushje. Regjistroni vendimin, në vend që ta nxirrni vetëm nga statusi i gjurmimit.

Mbajeni përfundimin e dorëzimit të ndarë nga mbyllja financiare, pranueshmëria për rimbursim dhe zgjidhja e mosmarrëveshjeve. Një ngjarje dorëzimi nga transportuesi nuk duhet të autorizojë automatikisht një rimbursim ose të zgjidhë një pretendim të klientit.

Rikuperoni nga dështimet pa humbur gjurmën e auditimit

Riprovoni dështimet kalimtare duke përdorur tërheqje të kufizuar dhe çdo udhëzim të dokumentuar për riprovimet. Ndani dështimet e përkohshme të lidhjes nga identifikuesit e pavlefshëm, kredencialet e skaduara, gabimet e lejeve dhe papajtueshmëritë e skemës. Këto të fundit kërkojnë veprime korrigjuese, jo riprovime të pafundme.

Mbani një radhë pune të dështuar që përmban qiramarrësin, paketën, referencën e ngjarjes, operacionin e tentuar, klasifikimin e gabimit dhe veprimin e radhës. Regjistroni mjaftueshëm kontekst për hetim, pa kopjuar të dhëna të panevojshme të klientëve ose kredenciale në regjistra.

Kryeni rakordim përveç rrugës normale të përditësimit. Shqyrtoni dërgesat aktive me informacion të vjetruar gjurmimi, ngjarjet e pranuara shkrimet e të cilave në OMS dështuan, vëzhgimet e papërputhura dhe ndryshimet midis gjendjes së llogaritur nga integrimi dhe OMS-së. Zgjidhni shpeshtësinë e shqyrtimit bazuar në angazhimet e dorëzimit, kufijtë e API-së dhe rrezikun operacional, në vend që të zbatoni një orar arbitrar universal.

Përcaktoni pronësinë: inxhinieria trajton marrjen dhe dështimet e shkrimeve; operacionet e përmbushjes zgjidhin marrëdhëniet e munguara të paketave; shërbimi ndaj klientit shqyrton përjashtimet që kërkojnë komunikim me klientin. Një radhë pa pronar përgjegjës është vetëm një vend ruajtjeje.

Testoni përputhjen dhe rregullat e biznesit para lançimit

Përdorni të dhëna testimi të kontrolluara dhe një lançim të kufizuar në prodhim. Testoni rastet e mëposhtme si kundrejt historikut të ngjarjeve, ashtu edhe kundrejt regjistrimit rezultues në OMS:

  • Një porosi me një paketë përparon normalisht deri në dorëzim.
  • Një porosi e ndarë ka një paketë të dorëzuar dhe një tjetër ende në lëvizje.
  • E njëjta ngjarje merret në mënyrë të përsëritur pa efekte anësore të dyfishta.
  • Një skanim më i vjetër gjatë transportit mbërrin pas dorëzimit.
  • Një transportues ose status i panjohur hyn në radhën e shqyrtimit.
  • Një etiketë zëvendësohet pa krijuar një detyrim tjetër përmbushjeje.
  • Një dërgesë zëvendësuese zëvendëson një paketë fillestare sipas një rregulli të miratuar.
  • OMS-ja nuk është e disponueshme pasi një ngjarje është pranuar.
  • Një proces rinis midis një shkrimi në OMS dhe konfirmimit të tij.
  • I njëjti numër porosie i shfaqur ekziston në dy dyqane pa përputhje ndërmjet qiramarrësve.

Hapeni sistemin kur çdo ngjarje e pranuar të ketë një rezultat të gjurmueshëm përpunimi, përputhjet e paqarta të mos mund të përditësojnë automatikisht porositë dhe operatorët të mund të riluajnë në mënyrë të sigurt punën e dështuar. Këto janë kritere pranimi më të dobishme sesa thjesht demonstrimi se një kërkesë API-je ka sukses.

FAQ

A mund t'i lidh numrat e gjurmimit drejtpërdrejt me porositë?

Për një rrjedhë pune rreptësisht me një paketë, një marrëdhënie e drejtpërdrejtë mund të jetë fillimisht e mjaftueshme. Megjithatë, përdorni një identitet të brendshëm dërgese midis porosisë dhe caktimit të gjurmimit. Ai siguron një rrugë migrimi për dërgesat e ndara, rilabelimin dhe zëvendësimet pa ndryshuar kuptimin e regjistrimit të porosisë.

A duhet integrimi të përdorë webhooks apo polling?

Përdorni mekanizmin e dërgimit të mbështetur nga ofruesi dhe të pajtueshëm me infrastrukturën tuaj. Webhooks mund të reduktojnë marrjen e përsëritur, ndërsa polling mund të mbështesë rrjedhat e punës të bazuara në marrje dhe rakordimin kur është i disponueshëm. Asnjëra qasje nuk eliminon nevojën për ruajtje të qëndrueshme, trajtim të dublikatave dhe rikuperim.

Çfarë duhet të ndodhë kur një ngjarje gjurmimi nuk ka porosi përkatëse?

Ruajeni në një radhë ngjarjesh të papërputhura dhe hetoni regjistrimin e regjistrimit, kontekstin e qiramarrësit, identitetin e transportuesit dhe kohën e krijimit të dërgesës. Mos krijoni automatikisht një porosi ose mos e lidhni ngjarjen me një klient të mundshëm. Riluajeni pasi të korrigjohet përputhja.

A duhet njoftimet e dorëzimit të vijnë nga OMS-ja apo nga sistemi i gjurmimit?

Zgjidhni një pronar për çdo lloj dhe nxitës njoftimi. Nëse dy sisteme mund të dërgojnë të njëjtin mesazh, çaktivizoni një rrugë ose ndani një regjistër të qëndrueshëm njoftimesh. Vendosni gjithashtu nëse një mesazh i referohet një pakete apo porosisë së plotë, veçanërisht për përmbushjen e ndarë.

A do të thotë një status përjashtimi se porosia ka dështuar?

Jo. Një përjashtim është një vëzhgim që kërkon interpretim, jo domosdoshmërisht një rezultat të përhershëm. Ruani arsyen, monitoroni ngjarjet pasuese dhe përdorni politikën tuaj të përshkallëzimit për të vendosur kur duhet të ndërhyjnë operacionet.

Burimet