Skip to main content
DomovBlogVodnikiKako lahko tehnološke platforme za logistiko v svoje izdelke vgradijo sledenje pošiljkam

Kako lahko tehnološke platforme za logistiko v svoje izdelke vgradijo sledenje pošiljkam

17TRACK

Logistične tehnološke platforme lahko vgradijo sledenje pošiljkam tako, da podatke prevoznikov povežejo z zaledno storitvijo za sledenje, dogodke pošiljk pretvorijo v enoten interni model ter te informacije prikažejo prek lastnih nadzornih plošč, portalov za stranke in API-jev. Za produktne in inženirske ekipe glavna odločitev ni, kako prikazati številko za sledenje. Gre za to, kako zagotoviti zanesljiv vpogled v pošiljke, ne da bi bil vsak produktni potek odvisen od formatov podatkov posameznih prevoznikov.

Kako lahko logistične tehnološke platforme vgradijo sledenje pošiljkam v svoje

Praktična izvedba ločuje zbiranje podatkov, obdelavo dogodkov in predstavitev. Tako lahko sistem za upravljanje naročil, transportna platforma, skladiščna aplikacija ali logistična tržnica uporablja isto osnovo za sledenje, hkrati pa operaterjem in strankam prikazuje različne informacije.

Opredelite, kaj mora vaš produkt omogočati pri sledenju

Začnite z dejanjem, ki naj ga uporabnik izvede po ogledu posodobitve pošiljke. Stranka, ki preverja napredek dostave, potrebuje razumljivo stanje in čas zadnje posodobitve. Operativna ekipa, ki preiskuje pošiljke z zastojem, potrebuje zgodovino dogodkov, kontekst prevoznika in možnost dodelitve preiskave. Integracijski partner morda potrebuje strukturirane dogodke namesto strani za sledenje.

To so različne produktne zahteve. Če jih obravnavate kot en sam pripomoček za sledenje, lahko pomembni delovni tokovi ostanejo nepodprti.

  • Vpogled za stranke: Prikažite napredek pošiljke, pomembne informacije o dostavi in jasen naslednji korak, ko pride do težave.
  • Operativni vpogled: Izpostavite izjeme, zastarele zapise, predaje med prevozniki in pošiljke, ki zahtevajo pozornost.
  • Avtomatizacija delovnih tokov: Sprožite interne naloge ali nadaljnja sporočila, ko se pomemben pogoj pošiljke spremeni.
  • Razširljivost platforme: Strankam ali partnerjem omogočite dostop do normaliziranih podatkov o sledenju prek nadzorovanih API-jev ali naročnin na dogodke.

Za prvo izdajo izberite en primarni delovni tok. Časovnica, namenjena strankam, in nadzorna plošča za upravljanje izjem lahko uporabljata isto infrastrukturo, vendar zahtevata različna dovoljenja, odločitve glede vmesnika in sprejemne teste.

Pred oblikovanjem vmesnika izberite integracijski model

Ustrezen integracijski model je odvisen od vaše kombinacije prevoznikov, zahtevane globine podatkov in pripravljenosti za vzdrževanje povezav s prevozniki. Podatkovno pot ocenite ločeno od predstavitvene plasti: stran za sledenje sama po sebi ne zagotavlja operativnega cevovoda dogodkov.

PristopUporaben, koGlavna odgovornost
Neposredne integracije s prevoznikiVaš produkt je odvisen od posebnih polj prevoznika ali ozko opredeljenega omrežja prevoznikov.Vzdrževanje preverjanja pristnosti, preslikave podatkov, obravnave napak in sprememb za vsako povezavo.
API za sledenje več prevoznikomVaš produkt potrebuje skupno integracijsko plast za več prevoznikov.Preverjanje dejanske podpore pošiljkam, semantike dogodkov, načinov dostave in komercialnih pogojev.
Hibridna integracijaSkupna plast za sledenje zadostuje za večino potreb, vendar izbrani prevozniki zahtevajo neposredne povezave.Reševanje nasprotujočih si posodobitev in ohranjanje enotnega internega modela pošiljke.

Za platformo, ki oskrbuje trgovce z različnimi odnosi s prevozniki, je ocena API-ja za več prevoznikov smiseln začetek. O neposrednih integracijah je vredno razmisliti, kadar zahtevano polje ali operativnega delovnega toka ni mogoče podpreti prek skupne plasti. Noben pristop ne odpravi potrebe po lastni identiteti pošiljke, pravilih avtorizacije ali uporabniški izkušnji.

Kje se umešča 17TRACK

API za sledenje 17TRACK je ustrezna možnost za oceno kot vgrajena podatkovna plast za sledenje. Uporabite uradno dokumentacijo API-ja, da pred odločitvijo o arhitekturi ugotovite, kako se njegov integracijski model ujema z vašim produktom.

Pri tem primeru ocenite integracijo za razvijalce, namesto da bi predpostavili, da stran za sledenje za potrošnike ali aplikacija za spletno trgovino izpolnjuje zaledne zahteve platforme. Potrdite ustrezne formate zahtev, možnosti dostave posodobitev, zahteve za preverjanje pristnosti, omejitve uporabe in komercialne pogoje. Nato preizkusite reprezentativne pošiljke iz lastne kombinacije prevoznikov in poti. Seznam prevoznikov sam po sebi ni dokaz, da vsaka storitev, pot ali vrsta pošiljke zagotavlja polja, ki jih vaš delovni tok potrebuje.

Vzpostavite cevovod za sledenje, ne neposredne povezave med brskalnikom in ponudnikom

Priporočena arhitektura vključuje: ustvarjanje pošiljke v vašem produktu, zaledno registracijo pri viru za sledenje, zajem posodobitev, normalizacijo dogodkov, interno shranjevanje ter dostavo v vaš vmesnik ali nadaljnje storitve. Poverilnice ponudnika hranite na strežniku. Vaš vmesnik naj od zaledja zahteva avtorizirane informacije o pošiljki, namesto da prejme ponovno uporabno skrivnost ponudnika.

1. Ustvarite interno identiteto pošiljke

Pred registracijo številke za sledenje dodelite interni ID pošiljke. Povežite ga z najemnikom, naročilom, paketom, podatki o prevozniku in morebitnim identifikatorjem, značilnim za ponudnika. Naročilo lahko vsebuje več paketov, paket pa lahko med predajo pridobi drugo referenco za sledenje. Te odnose modelirajte izrecno, namesto da bi eno številko za sledenje na silo vnesli v en zapis naročila.

Ne predpostavljajte, da je številka za sledenje trajno globalno enoličen identifikator. Hranite kontekst prevoznika in ustrezne datume pošiljke, da se ponovno uporabljene ali dvoumne reference ne bi neopazno združile z nepovezanimi zapisi.

2. Omogočite obnovljivo registracijo

Registracijo izvajajte prek trajnega opravila ali enakovrednega obnovljivega procesa. Ločite neveljavno zahtevo od začasne napake povezave in spremljajte izid za vsako pošiljko. Če ponudnik podpira idempotentnost, jo uporabite; sicer vzdržujte interno stanje registracije, da zmanjšate število podvojenih oddaj.

Uspešna registracija naj pomeni le, da je vir za sledenje sprejel zahtevo v skladu s svojo dokumentirano semantiko. Samodejno naj ne pomeni, da je prevoznik paket fizično prevzel.

3. Zajemajte posodobitve, ne da bi čakali na poslovno logiko

Če izbrani ponudnik podpira spletne kavlje, preverite dohodne zahteve z njegovim dokumentiranim mehanizmom preverjanja. Sprejeta sporočila trajno shranite, preden jih potrdite, nato pa jih obdelajte asinhrono. S tem zmanjšate možnost, da bi počasna storitev za obvestila ali izračun nadzorne plošče povzročil izgubo sicer veljavne posodobitve.

Če je potrebno periodično preverjanje, ga načrtujte znotraj omejitev ponudnika in zahtev vašega produkta glede ažurnosti. Kjer je podprto in dovoljeno, lahko uskladitvene poizvedbe pomagajo obnoviti posodobitve, ki so bile med izpadom zgrešene. Ne predpostavljajte, da imata periodično preverjanje in potisna dostava enake vsebine ali posledice za obračunavanje.

4. Normalizirajte dogodke, pri tem pa ohranite podrobnosti vira

Za vedenje produkta uporabite majhen interni besednjak stanj, hkrati pa ohranite izvirni opis prevoznika za podporo in preiskave. Možne interne kategorije vključujejo prejete informacije, v tranzitu, v dostavi, dostavljeno in izjema. To so predlagane produktne kategorije, ne trditev, da vsak vir uporablja natanko te oznake.

Uporaben normaliziran zapis vsebuje:

  • Interni ID pošiljke in ID najemnika.
  • Izvorni sistem, identifikator prevoznika in ustrezno referenco za sledenje.
  • Izvirni opis stanja in normalizirano stanje.
  • Čas nastanka dogodka, vključno s podatki o časovnem pasu, kadar so na voljo.
  • Čas, ko je vaša platforma prejela posodobitev.
  • Podatke o lokaciji, če so na voljo in jih je primerno hraniti.
  • ID dogodka vira ali interno ustvarjen ključ za odstranjevanje dvojnikov.
  • Različico preslikave, da je mogoče slediti odločitvam pri normalizaciji.

Neznane vrednosti ohranite kot izrecno neznane. Manjkajoča lokacija naj ostane manjkajoča, namesto da bi jo sklepali iz prejšnjega skeniranja. Surove vsebine shranjujte le v skladu z ustreznimi pravili dostopa in hrambe; lahko vsebujejo informacije, ki jih vmesnik za stranke ne potrebuje.

Obravnavajte zakasnjene, ponavljajoče se in nasprotujoče si dogodke

Načrtujte za posodobitve, ki se lahko ponovijo, zamujajo ali prispejo v napačnem vrstnem redu, namesto da bi predpostavili popolno dostavo. Pred sprožitvijo stranskih učinkov odstranite dvojnike ter ločite čas nastanka dogodka od časa, ko ga je prejel vaš sistem. Starejši dogodek, ki prispe pozneje, ne sme samodejno nadomestiti novejšega stanja pošiljke.

Preprosta razvrstitev stanj ni zadostna za vsako situacijo. Poskusi dostave, vračila, popravki in predaje med prevozniki lahko ustvarijo prehode, ki se ne prilegajo ravni črti od odpreme do dostave. Ohranite zgodovino dogodkov in izrecna pravila prehodov, namesto da bi se zanašali le na zadnje prejeto sporočilo.

Enako disciplino uporabite pri obvestilih. Opredelite poslovni sprožilec, kot je prvi sprejeti prehod v stanje »v dostavi«, nato pa zabeležite, da je bilo obvestilo poslano. Ponovna izvedba opravila za zajem ne sme znova poslati istega sporočila stranki.

Izjeme pri pošiljkah ločite od integracijskih napak. Neuspešen poskus dostave je logistični dogodek. Napaka pri preverjanju pristnosti je incident platforme. Potrebujeta različna opozorila, odgovorne osebe in poti eskalacije.

Oblikujte izkušnjo sledenja, ki pojasnjuje negotovost

Prikažite, kar sistem ve, ne da bi nakazovali večjo natančnost, kot jo zagotavlja vir. Čas dogodka prevoznika označite ločeno od časa zadnje osvežitve vaše platforme. Če prikažete predvideni datum dostave, navedite njegov vir in ga ne predstavljajte kot zagotovljen termin.

V vmesniku ločite ta stanja:

  • Sledenje registrirano, premik ni prijavljen: Sistem ima referenco za sledenje, vendar nima ustreznega dogodka premika.
  • Pošiljka napreduje: Dogodki kažejo premik, tudi če ocena dostave ni na voljo.
  • Informacije o sledenju so zastarele: Zapis je presegel vaš določeni prag ažurnosti.
  • Storitev posodabljanja ni na voljo: Vaša platforma trenutno ne more pridobiti ali obdelati novih informacij.
  • Izjema pri dostavi: Dogodek pošiljke kaže težavo, ki zahteva razlago ali ukrepanje.

Te razlike preprečujejo, da bi tehnični izpad izgledal kot neuspešna dostava. Operaterjem zagotovite celotno zgodovino dogodkov in pot za preiskavo; strankam pa jedrnato razlago in ustrezen naslednji korak. Sledenja ne opisujte kot sprotnega, razen če dejansko vedenje vira podpira takšno obljubo.

Zaščitite meje najemnikov in dostop do sledenja

Vsako poizvedbo za sledenje avtorizirajte glede na najemnika in dovoljenja za pošiljko uporabnika, ki jo zahteva. Veljavna številka za sledenje ni zadostna avtorizacija za razkritje naročila, podatkov o prejemniku ali internih opomb. Javne povezave za sledenje naj razkrijejo le informacije, potrebne za predvideni namen.

Poverilnic API-ja ne vključujte v kodo brskalnika ali običajne dnevnike. Uporabite podprte kontrole izbranega ponudnika za upravljanje poverilnic in preverjanje ter dokumentirajte postopek njihovega menjavanja. Za shranjene vsebine, izvoze in podporna orodja uporabite načelo najmanjšega obsega podatkov.

Pred uvedbo potrdite pogodbene zahteve, pomembne za vašo uvedbo, vključno s hrambo, dovoljeno uporabo podatkov ter morebitnimi dogovori o obdelavi ali prenosu. Te pogoje je treba neposredno pregledati; ni jih mogoče sklepati iz trženjskega opisa produkta.

Pred širitvijo preverite dejanske pošiljke

Uporabite dokaz koncepta, ki predstavlja vaše predvidene stranke, ne le priročnih vzorčnih številk. Vključite prevoznike, poti, vrste storitev in faze pošiljk, pomembne za prvo izdajo. Pri čezmejnih potekih vključite ustrezne predaje; pri naročilih z več paketi preverite vedenje na ravni paketa.

Preizkusite logistične dogodke in odpovedi infrastrukture:

  • Registracijo pred prvim fizičnim skeniranjem prevoznika.
  • Nejasne ali zavrnjene reference za sledenje.
  • Podvojena sporočila in dogodke v napačnem vrstnem redu.
  • Izpad končne točke spletnega kavlja, ki mu sledi obnovitev.
  • Poskuse dostave, vračila in popravljene dogodke, kjer so testni podatki na voljo.
  • Poskuse nepooblaščenega dostopa med najemniki.
  • Ponavljajočo se obdelavo brez ponavljajočih se obvestil strankam.

Pred ocenjevanjem integracije se dogovorite o sprejemnih merilih. Izmerite uporabno popolnost dogodkov, opaženi zamik posodobitev, natančnost normalizacije, vedenje pri obnovitvi in stroške v skladu z dejanskim modelom obračunavanja ponudnika. Cilje ažurnosti določite glede na delovni tok, namesto da bi za vsakega prevoznika in vsako pot uporabili enoten prag.

Pri stalnem delovanju spremljajte napake pri registraciji, napake pri zajemu, zaostanke pri obdelavi, podvojene dogodke in pošiljke z zastarelimi podatki. Odgovornost razdelite med inženiring, produkt in logistične operacije, da opozorilo doseže nekoga, ki ga lahko razreši.

Najboljša prva izdaja je ozek in zaupanja vreden delovni tok, zgrajen na obnovljivi infrastrukturi. Ko so identiteta pošiljke, obravnava dogodkov, izolacija najemnikov in ažurnost zanesljive, lahko ista osnova podpira časovnice za stranke, vrste izjem in integracije za partnerje, ne da bi podvajali logiko sledenja.

Pogosta vprašanja

Ali za logistično platformo zadostuje vgrajena stran za sledenje?

Zadostuje lahko, kadar je zahteva preprosto omogočiti uporabnikom ogled napredka pošiljke. Če mora sledenje sprožati opozorila, interne naloge, analitiko ali partnerske API-je, potrebujete tudi zaledno podatkovno integracijo. Predstavitveno plast in cevovod dogodkov obravnavajte kot ločeni zahtevi.

Ali naj posodobitve sledenja uporabljajo spletne kavlje ali periodično preverjanje?

Uporabite mehanizme, ki jih podpira izbrani ponudnik, in dokumentirajte njihovo vedenje pri dostavi. Spletni kavlji lahko zmanjšajo ponavljajoče se zahteve za nespremenjene zapise, medtem ko je periodično preverjanje morda potrebno za pridobivanje ali usklajevanje. Noben pristop ne odpravi potrebe po odstranjevanju dvojnikov, obnovi po napakah in spremljanju ažurnosti.

Kako naj platforma obravnava neznanega prevoznika?

Shranite vsak kontekst prevoznika, ki ga zagotovi delovni tok pošiljanja. Če ponudnik sledenja omogoča zaznavanje prevoznika, preizkusite dvoumne primere, namesto da bi predpostavili, da je zaznavanje vedno dokončno. Nerazrešeni zapisi naj ostanejo prepoznavni, uporabnikom pa ponudite možnost popravka, namesto da bi tiho izbrali negotovo ujemanje.

Ali lahko podatki o sledenju dokažejo, da je naročilo zaključeno?

Dogodek dostave je signal na ravni pošiljke in ni nujno dokaz, da je prispel vsak paket v naročilu ali da prejemnik nima ugovora. Dostavo paketa, zaključek naročila in zahtevke strank obravnavajte kot ločene poslovne koncepte z izrecnimi pravili, ki jih povezujejo.

Kaj morajo ekipe preveriti pred izbiro API-ja za sledenje?

Preverite podporo reprezentativnim pošiljkam, zahtevana polja dogodkov, vedenje pri dostavi posodobitev, preverjanje pristnosti, omejitve, možnosti obnovitve, pogoje glede podatkov in opredelitve cen. Celoten delovni tok preizkusite v lastnem okolju. Seznam funkcij ne more potrditi, ali bodo dejanski podatki o pošiljkah izpolnili sprejemna merila vašega produkta.

Viri

Spodnji uradni viri predstavljajo ponudbo za razvijalce 17TRACK in referenco za integracijo. Arhitektura, interni podatkovni model in testni načrt v tem priročniku so priporočila za izvedbo, ne izjave o zagotovilih ponudnika.