Skip to main content
DomovBlogVodnikiKako povezati podatke o sledenju pošiljkam z Oms: pravila za preslikavo in sinhronizacijo naročil

Kako povezati podatke o sledenju pošiljkam z Oms: pravila za preslikavo in sinhronizacijo naročil

17TRACK

Za povezavo podatkov o sledenju pošiljk s sistemom za upravljanje naročil (OMS) preslikajte vsak sledeni paket v interni zapis pošiljke, nato pa to pošiljko povežite z njenim naročilom in vrsticami izpolnitve. Posodobitve sledenja prejemajte prek vmesnika, ki ga podpira ponudnik, ohranite izvirne dogodke ter določite jasna pravila za podvojitve, pozne posodobitve, stanje pošiljke in dokončanje naročila. Številke za sledenje ne uporabljajte kot edinega identifikatorja naročila in ne dovolite, da bi en sam dogodek dostave samodejno zaprl naročilo z več paketi.

Kako povezati podatke o sledenju pošiljk z OMS za upravljanje naročil

Ta vodnik je namenjen inženirjem za integracije in ekipam za upravljanje e-trgovine, ki izvajajo to povezavo. Priporočena zasnova ločuje opažanja prevoznika od poslovnih odločitev: podatki o sledenju opisujejo pot paketa, OMS pa določa, kaj ta pot pomeni za izpolnitev naročila, komunikacijo s strankami in zaprtje naročila.

Določite, kateri sistem je lastnik posameznega zapisa

Pred vzpostavitvijo povezave API se z administratorjem OMS, ekipo za izpolnitev naročil in ekipo za podporo strankam dogovorite o lastništvu. V nasprotnem primeru lahko tehnično uspešna integracija še vedno prepiše veljavne poslovne podatke.

  • OMS: Je lastnik naročil, vrstic naročil, zahtevanih količin, preklicev in pravil za dokončanje naročil.
  • Sistem za izpolnitev naročil: Je lastnik zapisov pošiljk ali paketov, ki jih ustvari, vključno z razporeditvami pakiranja in dodelitvami nalepk. To je lahko sam OMS ali ločen skladiščni sistem.
  • Ponudnik sledenja: Zagotavlja opažanja sledenja in klasifikacije stanj, ki jih določi ponudnik.
  • Integracijska plast: Je lastnik navzkrižnih sklicev identifikatorjev, obdelave dogodkov, normalizacije, obravnave ponovnih poskusov in revizijskih zapisov sinhronizacije.

Te meje obravnavajte kot priporočene, ne kot predpostavke o vaši programski opremi. Dokumentirajte izjeme. Če lahko na primer skladišče zamenja odpremno nalepko, integracija potrebuje izrecno posodobitev tega sistema, namesto da bi ugibala, da nova opažena številka nadomešča staro.

Pred sinhronizacijo stanj vzpostavite preslikavo od naročila do paketa

Praktičen odnos je naročilo → izpolnitev → paket → dodelitev sledenja. Vaš OMS lahko uporablja drugačna imena ali združuje nekatere od teh zapisov. Odnose ohranite tudi, če je struktura podatkovne zbirke drugačna.

Naročilo ima lahko več izpolnitev, izpolnitev pa lahko vsebuje več paketov. Paket lahko pridobi tudi nadomestno dodelitev sledenja ali povezan identifikator zadnje milje. Ti identifikatorji ne smejo ustvariti dodatnih naročenih količin.

ZapisPriporočena poljaNamen
NaročiloID najemnika ali trgovine, nespremenljiv ID naročila OMSLočuje trgovce in preprečuje odvisnost od prikazanih številk naročil.
IzpolnitevID izpolnitve, ID naročila, ID-ji in količine dodeljenih vrsticDoloča, kateri kupljeni izdelki se izpolnjujejo.
PaketInterni ID paketa, ID izpolnitve, dodelitve paketa, kjer so na voljoZagotavlja stabilno identiteto, neodvisno od sledilnih nalepk.
Dodelitev sledenjaID dodelitve, ID paketa, račun ponudnika, identifikator prevoznika, številka za sledenje, obdobje veljavnostiPovezuje prihajajoča opažanja sledenja s pravilnim paketom in življenjskim ciklom dodelitve.

Posodobitve ujemajte prek shranjenega navzkrižnega sklica

Ko je pošiljka ustvarjena, shranite njene interne ID-je, preden jo registrirate za sledenje. Shranite ID zapisa sledenja, ki ga vrne ponudnik in je izdan v dokumentiranem postopku registracije. Če ponudnik podpira referenco trgovca, uporabite nepregledno interno referenco in preslikavo hranite lokalno.

Pri prihajajočih posodobitvah najprej poiščite shranjeni ID zapisa ponudnika v pravilnem računu ponudnika in najemniškem kontekstu. Če ta identifikator ni na voljo, uporabite dokumentirano kombinacijo številke za sledenje, identitete prevoznika, konteksta računa in zgodovine dodelitve. To obravnavajte kot strategijo iskanja, ne kot zagotovilo, da je kombinacija globalno edinstvena.

Ne ujemajte po imenu stranke, e-poštnem naslovu ali neomejeni prikazani številki naročila. Številke za sledenje hranite kot nize, da se začetne ničle ohranijo. Ne odstranjujte znakov in ne spreminjajte velikosti črk, razen če ustrezna pogodba s prevoznikom ali ponudnikom dovoljuje takšno normalizacijo.

Če iskanje ne vrne zadetka ali vrne več možnih zadetkov, posodobitev izolirajte za preiskavo. Nerazrešen dogodek je varnejši od samozavestne posodobitve naročila napačne stranke.

Obravnavajte deljena naročila brez izmišljanja dodelitev paketov

Vzemimo ponazoritveno naročilo s tremi enotami. Paket A vsebuje dve enoti, paket B pa eno. Dostava paketa A pomeni, da obstajajo dokazi o dostavi za dve enoti; ne pomeni, da je dostavljeno celotno naročilo.

Če sistem za izpolnitev naročil beleži samo, da oba paketa pripadata isti izpolnitvi, ne izmišljajte razporeditev na ravni enot. Še vedno lahko izračunate, ali so dostavljeni vsi zahtevani paketi, vendar mora poročanje o dostavi na ravni izdelkov ostati nedostopno ali izrecno negotovo, dokler niso na voljo podatki o razporeditvi.

API za sledenje povežite prek trajne plasti za vnos podatkov

Uporabite cevovod, ki komunikacijo s ponudnikom ločuje od zapisov v OMS:

Ustvarjanje pošiljke → registracija sledenja → prihajajoča posodobitev ali načrtovano pridobivanje → trajna hramba dogodkov → preslikava in normalizacija → posodobitev OMS → usklajevanje

Pri izvedbi za 17TRACK sta ustrezni začetni točki stran izdelka Tracking API in uradna dokumentacija API. Pred izvedbo adapterja potrdite veljavni vmesnik za registracijo, identifikatorje prevoznikov, možnosti dostave posodobitev, zahteve za preverjanje pristnosti, definicije stanj in omejitve računa. Podatkovni model v tem vodniku je priporočilo za integracijo, ne trditev, da 17TRACK uporablja ta imena polj ali zagotavlja izvorni povezovalnik za vaš OMS.

Če izbrani ponudnik podpira spletne kljuke, prihajajoče zahteve preverjajte pristnosti z njegovim dokumentiranim mehanizmom in sprejeta sporočila trajno shranite, preden jih potrdite. Počasno delo OMS naj bo zunaj poti zahtevka. Upoštevajte dejansko pogodbo ponudnika glede potrjevanja in ponovnih poskusov, namesto da bi predpostavljali določeno telo odgovora ali časovno omejitev.

Če je potrebno anketiranje, shranite napredek pridobivanja, kjer ga API podpira, nadzorujte sočasnost in upoštevajte dokumentirane omejitve hitrosti. Niti prejem spletne kljuke niti uspešna zahteva za anketiranje ne dokazujeta, da je bil OMS posodobljen; te izide beležite ločeno.

Določite pravila sinhronizacije, ki prenesejo ponovne poskuse in pozne dogodke

1. Obdelava naj bo idempotentna

Dvakratna obdelava istega opažanja ne sme podvojiti pošiljke, dvakrat povečati količin ali znova poslati istega obvestila stranki. HTTP poljubne operacije POST ne naredi idempotentne; integracija mora izvajati zaščito pred podvajanjem. RFC 9110 pojasnjuje idempotentnost metod HTTP.

Uporabite stabilen ID dogodka ponudnika, kadar je dokumentiran in na voljo. Sicer določite prstni odtis iz ID-ja dodelitve in ustreznih polj dogodka, kot so časovni žig dogodka, izvorno stanje in lokacija. Dokumentirajte možnost trkov ali spremenjenih opisov dogodkov. Surovo opažanje ohranite, tudi če ne povzroči dodatnega dejanja OMS.

Vsak stranski učinek zaščitite ločeno. Zapis stanja OMS in e-poštno obvestilo na primer potrebujeta lastna nadzora deduplikacije. Uporabite transakcijski izhodni predal ali enakovreden trajni delovni zapis, da sesutje procesa ne bi pustilo sprejetega dogodka brez načrtovane posodobitve.

2. Čas dogodka in čas prejema shranjujte ločeno

Čas nastanka dogodka in čas, ko ga je prejela vaša integracija, odgovarjata na različni vprašanji. Shranite oba, skupaj z izvirno predstavitvijo časovnega žiga in morebitnim navedenim odmikom časovnega pasu. Časovnega pasu skladišča ne dodelite tiho dogodku, katerega časovni pas ni znan.

Pozno prispelo skeniranje med prevozom bi moralo običajno dopolniti zgodovino, ne pa nadomestiti novejšega stanja dostave. Vendar časovni žigi sami po sebi niso dovolj: ponudnik lahko izda popravek, dogodki pa imajo lahko nepopolne časovne podatke. Kadar so na voljo, uporabite dokumentirana polja zaporedja ali revizije ter izrecno politiko popravkov.

3. Stanja normalizirajte, ne da bi izbrisali podrobnosti vira

Ustvarite majhen notranji besednjak, ki ga razume OMS, na primer čakanje na sprejem prevoznika, v prevozu, na poti za dostavo, dostavljeno, izjema in vračanje. Dokumentirana stanja ponudnika preslikajte vanj. To so predlagane notranje kategorije, ne univerzalne opredelitve prevoznikov.

Shranite izvirno kodo stanja, opis, lokacijo dogodka, sklic na zapis ponudnika in različico pravila preslikave. Nepreslikana vrednost mora ustvariti stanje, ki ga je mogoče pregledati, namesto da bi se privzeto obravnavala kot dostavljena ali neuspešna. Ustvarjanje nalepke ne sme veljati za dokaz fizičnega sprejema pri prevozniku, razen če izvorni dogodek to razlago izrecno podpira.

4. Uporabljajte pravila prehodov, ne preprostega številčnega razvrščanja

Stanja pošiljke ne tvorijo vedno ravne črte. Izjemi lahko sledi običajen prevoz, poskus dostave pa ni dostava. Premik vračila se lahko začne po prejšnjem dogodku dostave.

  • Dovolite odpravo izjeme, ko poznejši dokazi podpirajo nadaljevanje premika.
  • Preprečite, da bi običajno zgodovinsko skeniranje tiho nadomestilo stanje dostave.
  • Dovolite dokumentiran popravek prek nadzorovane revizijske poti.
  • Kjer ga OMS podpira, spremljajte premik vračila ločeno od dokončanja odhodne pošiljke.
  • Nejasne ali nasprotujoče si dokaze usmerite v operativno čakalno vrsto.

Ta pravila različicujte. Ko se preslikava spremeni, določite, ali velja samo za nove dogodke ali pa zgodovinski zapisi zahtevajo nadzorovan ponovni izračun.

Stanje naročila izračunajte na podlagi zahtevanih obveznosti izpolnitve

Stanje paketa in stanje naročila naj bosta ločeni polji. Paket, označen kot dostavljen, zagotavlja dokaz za ta paket; dokončanje naročila je odvisno od preostalih zahtevanih količin in vaše poslovne politike.

Koristna privzeta nastavitev je, da naročilo označite kot v celoti dostavljeno šele, ko imajo vse količine, za katere je potrebna dostava, veljavne dokaze o dostavi na ravni paketov in ni več nerešenih zahtevanih razporeditev. Preklicane količine izključite v skladu s pravili preklica OMS. Digitalne izdelke, naročila za prevzem in druge obveznosti, ki niso povezane s pošiljanjem, obravnavajte z lastnimi pogoji dokončanja.

Nadomestne pošiljke zahtevajo izrecne odnose. Če je izgubljeni paket nadomeščen, določite, ali nadomestni paket prevzame prvotno obveznost dostave. V nasprotnem primeru lahko prvotni paket neskončno preprečuje dokončanje ali pa se oba paketa vštevata v izpolnitev. Odločitev zabeležite, namesto da bi jo izpeljali samo iz stanja sledenja.

Dokončanje dostave ločite od finančnega zaprtja, upravičenosti do vračila in reševanja sporov. Dogodek dostave prevoznika ne sme samodejno odobriti vračila ali zaključiti zahtevka stranke.

Napake odpravite brez izgube revizijske sledi

Prehodne napake ponovite z omejenim umikom in morebitnimi dokumentiranimi navodili za ponovne poskuse. Začasne napake povezave ločite od neveljavnih identifikatorjev, poteklih poverilnic, napak dovoljenj in nezdružljivosti sheme. Slednje zahtevajo popravljalni ukrep, ne neskončnih ponovnih poskusov.

Vzdržujte čakalno vrsto neuspešnega dela, ki vsebuje zadevnega najemnika, paket, sklic na dogodek, poskušano operacijo, razvrstitev napake in naslednje dejanje. Zabeležite dovolj konteksta za preiskavo, vendar v dnevnike ne kopirajte nepotrebnih podatkov strank ali poverilnic.

Poleg običajne poti posodobitev izvajajte usklajevanje. Pregledujte aktivne pošiljke z zastarelimi informacijami o sledenju, sprejete dogodke, pri katerih zapisi OMS niso uspeli, neusklajena opažanja ter razlike med izračunanim stanjem integracije in OMS. Pogostost pregledov izberite glede na obljube dostave, omejitve API-ja in operativno tveganje, namesto da bi uporabljali poljuben univerzalni urnik.

Določite lastništvo: inženiring obravnava napake pri vnosu in zapisovanju; operacije izpolnitve rešujejo manjkajoče odnose paketov; podpora strankam pregleduje izjeme, ki zahtevajo komunikacijo s stranko. Čakalna vrsta brez odgovornega lastnika je samo mesto za shranjevanje.

Pred uvedbo preizkusite preslikavo in poslovna pravila

Uporabite nadzorovane testne podatke in omejeno uvedbo v produkciji. Naslednje primere preizkusite glede na zgodovino dogodkov in nastali zapis OMS:

  • Naročilo z enim paketom normalno napreduje do dostave.
  • Deljeno naročilo ima en dostavljen paket, drugi pa je še v premiku.
  • Isti dogodek je prejet večkrat brez podvojenih stranskih učinkov.
  • Starejše skeniranje med prevozom prispe po dostavi.
  • Neznani prevoznik ali stanje se uvrsti v čakalno vrsto za pregled.
  • Nalepka je zamenjana brez ustvarjanja nove obveznosti izpolnitve.
  • Nadomestna pošiljka v skladu z odobrenim pravilom nadomesti prvotni paket.
  • OMS ni na voljo po sprejemu dogodka.
  • Proces se znova zažene med zapisom v OMS in potrditvijo tega zapisa.
  • Enaka prikazana številka naročila obstaja v dveh trgovinah brez ujemanja med najemniki.

Uvedite sistem, ko ima vsak sprejeti dogodek sledljiv izid obdelave, dvoumna ujemanja ne morejo samodejno posodobiti naročil in lahko operaterji varno znova zaženejo neuspešno delo. To so uporabnejša merila sprejemljivosti kot preprost dokaz, da zahteva API uspe.

Pogosta vprašanja

Ali lahko številke za sledenje neposredno povežem z naročili?

Pri strogo enopaketnem poteku je lahko neposredna povezava na začetku zadostna. Kljub temu uporabite interno identiteto pošiljke med naročilom in dodelitvijo sledenja. Zagotavlja pot za prehod na deljene pošiljke, ponovno označevanje in zamenjave, ne da bi spremenili pomen zapisa naročila.

Ali naj integracija uporablja spletne kljuke ali anketiranje?

Uporabite mehanizem dostave, ki ga podpira ponudnik in je združljiv z vašo infrastrukturo. Spletne kljuke lahko zmanjšajo ponavljajoče se pridobivanje, medtem ko anketiranje podpira poteke, ki temeljijo na pridobivanju, in usklajevanje, kjer je na voljo. Noben pristop ne odpravi potrebe po trajni hrambi, obravnavi podvojitev in obnovi po napakah.

Kaj se mora zgoditi, ko dogodek sledenja nima ujemajočega naročila?

Shranite ga v čakalno vrsto neusklajenih dogodkov in preverite zapis registracije, kontekst najemnika, identiteto prevoznika in čas ustvarjanja pošiljke. Ne ustvarjajte naročila in dogodka samodejno ne pripenjajte k verjetni stranki. Ko je preslikava popravljena, ga znova obdelajte.

Ali naj obvestila o dostavi prihajajo iz OMS ali sistema za sledenje?

Za vsako vrsto in sprožilec obvestila izberite enega lastnika. Če lahko oba sistema pošljeta isto sporočilo, eno pot onemogočite ali delite trajni dnevnik obvestil. Odločite tudi, ali se sporočilo nanaša na en paket ali celotno naročilo, zlasti pri deljeni izpolnitvi.

Ali stanje izjeme pomeni, da je naročilo neuspešno?

Ne. Izjema je opažanje, ki zahteva razlago, in ni nujno trajen izid. Ohranite razlog, spremljajte poznejše dogodke in s svojo politiko eskalacije določite, kdaj mora posredovati operativa.

Viri