Kaip logistikos technologijų platformos gali į savo produktus integruoti siuntų sekimą
Logistikos technologijų platformos gali integruoti siuntų sekimą, prijungdamos vežėjų duomenis prie foninės sekimo paslaugos, paversdamos siuntų įvykius į nuoseklų vidinį modelį ir pateikdamos šią informaciją savo prietaisų skydeliuose, klientų portaluose bei API. Produktų ir inžinerijos komandoms pagrindinis klausimas nėra, kaip rodyti sekimo numerį. Svarbu tai, kaip užtikrinti patikimą siuntų matomumą, nepadarant kiekvieno produkto darbo proceso priklausomo nuo konkrečių vežėjų duomenų formatų.
Praktinis įgyvendinimas atskiria duomenų rinkimą, įvykių apdorojimą ir pateikimą. Tai leidžia užsakymų valdymo sistemai, transporto platformai, sandėlio programai ar logistikos prekyvietei naudoti tą patį sekimo pagrindą, kartu operatoriams ir klientams pateikiant skirtingą informaciją.
Apibrėžkite, ką jūsų produktas turi atlikti naudodamas sekimą
Pradėkite nuo veiksmo, kurį naudotojas turėtų atlikti pamatęs siuntos atnaujinimą. Pristatymo eigą tikrinančiam klientui reikia lengvai suprantamos būsenos ir paskutinio atnaujinimo laiko. Užstrigusias siuntas tiriančiai operacijų komandai reikia įvykių istorijos, vežėjo konteksto ir galimybės paskirti tyrimą. Integracijos partneriui gali reikėti struktūrizuotų įvykių, o ne sekimo puslapio.
Tai yra skirtingi produkto reikalavimai. Laikant juos vienu sekimo valdikliu, svarbūs darbo procesai gali likti nepalaikomi.
- Matomumas klientui: Rodykite siuntos eigą, aktualią pristatymo informaciją ir aiškų kitą veiksmą iškilus problemai.
- Veiklos matomumas: Išryškinkite išimtis, pasenusius įrašus, vežėjų perdavimus ir siuntas, kurioms reikia dėmesio.
- Darbo procesų automatizavimas: Suaktyvinkite vidines užduotis ar tolesnius pranešimus, kai pasikeičia reikšminga siuntos būsena.
- Platformos išplečiamumas: Suteikite klientams ar partneriams prieigą prie normalizuotų sekimo duomenų per valdomas API arba įvykių prenumeratas.
Pirmajam leidimui pasirinkite vieną pagrindinį darbo procesą. Klientams skirta laiko juosta ir išimčių valdymo prietaisų skydelis gali naudoti bendrą infrastruktūrą, tačiau jiems reikia skirtingų teisių, sąsajos sprendimų ir priėmimo testų.
Prieš kurdami sąsają pasirinkite integracijos modelį
Tinkamas integracijos modelis priklauso nuo jūsų vežėjų derinio, reikalingo duomenų išsamumo ir noro prižiūrėti vežėjų jungtis. Duomenų kelią vertinkite atskirai nuo pateikimo sluoksnio: sekimo puslapis savaime nesuteikia veiklos įvykių konvejerio.
| Metodas | Naudingas, kai | Pagrindinė atsakomybė |
|---|---|---|
| Tiesioginės integracijos su vežėjais | Jūsų produktas priklauso nuo konkrečių vežėjų laukų arba siaurai apibrėžto vežėjų tinklo. | Prižiūrėti autentifikavimą, duomenų susiejimą, klaidų tvarkymą ir kiekvienos jungties pakeitimus. |
| Kelių vežėjų sekimo API | Jūsų produktui reikia bendro integracijos sluoksnio keliems vežėjams. | Patikrinti faktinį siuntų palaikymą, įvykių semantiką, pristatymo mechanizmus ir komercines sąlygas. |
| Hibridinė integracija | Bendras sekimo sluoksnis patenkina daugumą poreikių, tačiau pasirinktiems vežėjams reikia tiesioginių jungčių. | Išspręsti prieštaringų atnaujinimų problemas ir išlaikyti nuoseklų vidinį siuntos modelį. |
Platformai, aptarnaujančiai prekybininkus, turinčius įvairių santykių su vežėjais, kelių vežėjų API įvertinimas yra protingas pradinis žingsnis. Tiesiogines integracijas verta svarstyti, kai reikiamo lauko ar veiklos proceso neįmanoma įgyvendinti per bendrą sluoksnį. Nė vienas metodas nepanaikina poreikio turėti savo siuntos tapatybę, autorizavimo taisykles ar naudotojo patirtį.
Kur pritaikomas 17TRACK
17TRACK sekimo API yra tinkamas variantas, kurį verta įvertinti kaip integruoto sekimo duomenų sluoksnį. Naudokite oficialią API dokumentaciją, kad prieš pasirinkdami architektūrą nustatytumėte, kaip jos integracijos modelis atitinka jūsų produktą.
Šiuo atveju vertinkite kūrėjų integraciją, o ne manykite, kad vartotojų sekimo puslapis ar elektroninės prekybos parduotuvės programa atitinka platformos foninės sistemos reikalavimus. Patvirtinkite taikomus užklausų formatus, atnaujinimų pristatymo parinktis, autentifikavimo reikalavimus, naudojimo limitus ir komercines sąlygas. Tada išbandykite reprezentatyvias siuntas iš savo vežėjų ir maršrutų derinio. Vien vežėjo įrašas nėra įrodymas, kad kiekviena paslauga, maršrutas ar siuntos tipas pateikia jūsų darbo procesui reikalingus laukus.
Kurkite sekimo konvejerį, o ne tiesioginį naršyklės ryšį su teikėju
Rekomenduojama architektūra: siuntos sukūrimas jūsų produkte, foninė registracija sekimo šaltinyje, atnaujinimų priėmimas, įvykių normalizavimas, vidinis saugojimas ir pateikimas jūsų sąsajai arba tolesnėms paslaugoms. Teikėjo prisijungimo duomenis laikykite serveryje. Frontendas turėtų prašyti autorizuotos siuntos informacijos iš jūsų foninės sistemos, o ne gauti pakartotinai naudojamą teikėjo paslaptį.
1. Sukurkite vidinę siuntos tapatybę
Prieš registruodami sekimo numerį priskirkite vidinį siuntos ID. Susiekite jį su nuomininku, užsakymu, pakuote, vežėjo informacija ir bet kokiu konkrečiam teikėjui būdingu identifikatoriumi. Užsakyme gali būti kelios pakuotės, o perdavimo metu viena pakuotė gali gauti kitą sekimo nuorodą. Aiškiai modeliuokite šiuos ryšius, o ne bandykite vieną sekimo numerį priskirti vienam užsakymo įrašui.
Nelaikykite sekimo numerio visame pasaulyje nuolatiniu identifikatoriumi. Išsaugokite vežėjo kontekstą ir aktualias siuntos datas, kad pakartotinai panaudotos ar dviprasmiškos nuorodos nepastebimai nesujungtų nesusijusių įrašų.
2. Užtikrinkite atkuriamą registraciją
Registraciją vykdykite naudodami patikimą užduotį ar kitą atkuriamą procesą. Atskirti negaliojančią užklausą nuo laikino ryšio sutrikimo ir stebėkite kiekvienos siuntos rezultatą. Jei teikėjas palaiko idempotentiškumą, jį naudokite; kitu atveju palaikykite vidinę registracijos būseną, kad sumažintumėte pasikartojančių pateikimų skaičių.
Sėkminga registracija turėtų reikšti tik tai, kad sekimo šaltinis priėmė užklausą pagal savo dokumentuotą semantiką. Tai neturėtų automatiškai reikšti, kad vežėjas fiziškai gavo pakuotę.
3. Priimkite atnaujinimus nestabdydami jų dėl verslo logikos
Jei pasirinktas teikėjas palaiko žiniatinklio kablius, patikrinkite gaunamas užklausas naudodami jo dokumentuotą tikrinimo mechanizmą. Prieš patvirtindami priėmimą patikimai išsaugokite priimtus pranešimus, o tada apdorokite juos asinchroniškai. Taip sumažinama tikimybė, kad dėl lėtos pranešimų paslaugos ar prietaisų skydelio skaičiavimo bus prarastas kitu atveju tinkamas atnaujinimas.
Jei reikalingas apklausimas, suplanuokite jį neviršydami teikėjo limitų ir atsižvelgdami į produkto šviežumo reikalavimus. Jei palaikoma ir leidžiama, suderinimo užklausos gali padėti atkurti per sutrikimą praleistus atnaujinimus. Nemanykite, kad apklausimo ir tiesioginio pristatymo duomenų paketai ar atsiskaitymo pasekmės yra vienodi.
4. Normalizuokite įvykius išsaugodami šaltinio informaciją
Produkto veiksmams naudokite nedidelį vidinį būsenų žodyną, tačiau išsaugokite originalų vežėjo aprašą palaikymui ir tyrimui. Galimos vidinės kategorijos: informacija gauta, gabenama, išvežta pristatyti, pristatyta ir išimtis. Tai yra siūlomos produkto kategorijos, o ne teiginys, kad kiekvienas šaltinis naudoja būtent tokias etiketes.
Naudingame normalizuotame įraše yra:
- Vidinis siuntos ID ir nuomininko ID.
- Šaltinio sistema, vežėjo identifikatorius ir aktuali sekimo nuoroda.
- Originalus būsenos aprašas ir normalizuota būsena.
- Įvykio laikas, įskaitant laiko juostos informaciją, jei ji pateikta.
- Laikas, kada jūsų platforma gavo atnaujinimą.
- Vietos informacija, jei ji prieinama ir tinkama saugoti.
- Šaltinio įvykio ID arba viduje sugeneruotas dublikatų šalinimo raktas.
- Susiejimo versija, kad būtų galima atsekti normalizavimo sprendimus.
Nežinomas reikšmes palikite aiškiai pažymėtas. Trūkstama vieta turi likti nežinoma, o ne būti nustatoma pagal ankstesnį nuskaitymą. Neapdorotus duomenų paketus saugokite tik pagal tinkamą prieigos ir saugojimo politiką; juose gali būti informacijos, kurios klientų sąsajai nereikia.
Tvarkykite uždelstus, pasikartojančius ir prieštaringus įvykius
Kurkite sistemą atsižvelgdami į tai, kad atnaujinimai gali pasikartoti, vėluoti arba būti gauti ne eilės tvarka, o ne manydami, kad pristatymas visada bus tobulas. Prieš suaktyvindami šalutinius veiksmus pašalinkite dublikatus ir atskirkite įvykio laiką nuo laiko, kada jį gavo jūsų sistema. Vėliau gautas senesnis įvykis neturėtų automatiškai pakeisti naujesnės siuntos būsenos.
Paprasto būsenų reitingo nepakanka kiekvienai situacijai. Pristatymo bandymai, grąžinimai, pataisymai ir vežėjų perdavimai gali sukurti perėjimus, kurie netelpa į tiesią seką nuo išsiųsta iki pristatyta. Palaikykite įvykių istoriją ir aiškias perėjimo taisykles, o ne remkitės vien paskutiniu gautu pranešimu.
Tą pačią tvarką taikykite pranešimams. Apibrėžkite verslo trigerį, pavyzdžiui, pirmą patvirtintą perėjimą į būseną „išvežta pristatyti“, tada užregistruokite, kad pranešimas išsiųstas. Pakartotinai paleidus priėmimo užduotį, tas pats kliento pranešimas neturėtų būti siunčiamas dar kartą.
Siuntų išimtis atskirkite nuo integracijos klaidų. Nepavykęs pristatymo bandymas yra logistikos įvykis. Autentifikavimo klaida yra platformos incidentas. Jiems reikia skirtingų įspėjimų, atsakingų asmenų ir eskalavimo kelių.
Kurkite sekimo patirtį, paaiškinančią neapibrėžtumą
Rodykite tai, ką sistema žino, nesudarydami didesnio tikslumo įspūdžio, nei pateikia šaltinis. Vežėjo įvykio laiką nurodykite atskirai nuo paskutinio jūsų platformos atnaujinimo laiko. Jei rodote numatomą pristatymo datą, nurodykite jos šaltinį ir nepateikite jos kaip garantuoto susitikimo laiko.
Sąsajoje atskirkite šias būsenas:
- Sekimas užregistruotas, apie judėjimą nepranešta: Sistema turi sekimo nuorodą, tačiau nėra tinkamo judėjimo įvykio.
- Siunta juda: Įvykiai rodo judėjimą, net jei pristatymo prognozė neprieinama.
- Sekimo informacija pasenusi: Įrašas viršijo jūsų nustatytą šviežumo ribą.
- Atnaujinimo paslauga nepasiekiama: Jūsų platforma šiuo metu negali gauti ar apdoroti naujos informacijos.
- Pristatymo išimtis: Siuntos įvykis rodo problemą, kurią reikia įvertinti arba išspręsti.
Šie skirtumai neleidžia techniniam sutrikimui atrodyti kaip pristatymo nesėkmei. Operatoriams pateikite visą įvykių istoriją ir tyrimo kelią, o klientams – glaustą paaiškinimą bei tinkamą kitą veiksmą. Nevadinkite sekimo realaus laiko, nebent tikrasis šaltinio veikimas leidžia taip žadėti.
Apsaugokite nuomininkų ribas ir prieigą prie sekimo
Kiekvieną sekimo paiešką autorizuokite pagal užklausą pateikusio naudotojo nuomininką ir siuntos teises. Galiojantis sekimo numeris nėra pakankamas leidimas atskleisti užsakymą, gavėjo duomenis ar vidines pastabas. Viešos sekimo nuorodos turėtų rodyti tik informaciją, reikalingą numatytam tikslui.
API prisijungimo duomenis laikykite atokiau nuo naršyklės kodo ir įprastų žurnalų. Naudokite pasirinkto teikėjo palaikomus prisijungimo duomenų valdymo ir tikrinimo valdiklius bei dokumentuokite keitimo procedūrą. Taikykite duomenų mažinimo principą saugomiems duomenų paketams, eksportams ir palaikymo įrankiams.
Prieš paleisdami patvirtinkite su diegimu susijusius sutartinius reikalavimus, įskaitant saugojimą, leidžiamą duomenų naudojimą ir taikomas tvarkymo ar perdavimo sąlygas. Šias sąlygas reikia tiesiogiai peržiūrėti; jų negalima išvesti iš produkto rinkodaros aprašo.
Prieš plėsdami patikrinkite su realiomis siuntomis
Naudokite koncepcijos įrodymą, atspindintį numatomus klientus, o ne tik patogius pavyzdinius numerius. Įtraukite vežėjus, maršrutus, paslaugų tipus ir siuntų etapus, svarbius pirmajam leidimui. Tarpvalstybiniuose darbo procesuose, kai aktualu, įtraukite perdavimus; užsakymuose su keliomis pakuotėmis patikrinkite elgseną pakuotės lygiu.
Išbandykite ir logistikos įvykius, ir infrastruktūros gedimus:
- Registraciją prieš pirmąjį fizinį vežėjo nuskaitymą.
- Dviprasmiškas arba atmestas sekimo nuorodas.
- Pasikartojančius pranešimus ir ne eilės tvarka gaunamus įvykius.
- Žiniatinklio kablio galinio taško sutrikimą ir vėlesnį atkūrimą.
- Pristatymo bandymus, grąžinimus ir pataisytus įvykius, kai yra bandymų duomenų.
- Neleistinos prieigos tarp nuomininkų bandymus.
- Pakartotinį apdorojimą nesiunčiant pakartotinių klientų pranešimų.
Prieš vertindami integraciją susitarkite dėl priėmimo kriterijų. Matuokite naudingą įvykių išsamumą, stebimą atnaujinimo delsą, normalizavimo tikslumą, atkūrimo elgseną ir kainą pagal faktinį teikėjo atsiskaitymo modelį. Šviežumo tikslus apibrėžkite pagal darbo procesą, o ne taikykite vieną universalią ribą kiekvienam vežėjui ir maršrutui.
Nuolatinės veiklos metu stebėkite registracijos klaidas, priėmimo klaidas, neapdorotų užduočių eilę, pasikartojančius įvykius ir siuntas su pasenusiais duomenimis. Paskirstykite atsakomybę tarp inžinerijos, produkto ir logistikos operacijų, kad įspėjimas pasiektų žmogų, galintį išspręsti problemą.
Geriausias pirmasis leidimas yra siauras, patikimas darbo procesas, sukurtas ant atkuriamos infrastruktūros. Kai siuntos tapatybė, įvykių tvarkymas, nuomininkų izoliacija ir šviežumas veikia patikimai, tas pats pagrindas gali palaikyti klientų laiko juostas, išimčių eiles ir partneriams skirtas integracijas nedubliuojant sekimo logikos.
DUK
Ar logistikos platformai pakanka integruoto sekimo puslapio?
Jo gali pakakti, kai reikalavimas yra tiesiog leisti naudotojams peržiūrėti siuntos eigą. Jei sekimas turi aktyvinti įspėjimus, vidines užduotis, analitiką ar partnerių API, jums taip pat reikės foninės duomenų integracijos. Pateikimo sluoksnį ir įvykių konvejerį vertinkite kaip atskirus reikalavimus.
Ar sekimo atnaujinimams naudoti žiniatinklio kablius ar apklausimą?
Naudokite pasirinkto teikėjo palaikomus mechanizmus ir dokumentuokite jų pristatymo elgseną. Žiniatinklio kabliai gali sumažinti pasikartojančias nepasikeitusių įrašų užklausas, o apklausimas gali būti reikalingas duomenims gauti ar suderinti. Nė vienas metodas nepanaikina dublikatų šalinimo, klaidų atkūrimo ir šviežumo stebėjimo poreikio.
Kaip platforma turėtų tvarkyti nežinomą vežėją?
Išsaugokite bet kokį siuntimo darbo proceso pateiktą vežėjo kontekstą. Jei sekimo teikėjas siūlo vežėjo aptikimą, išbandykite dviprasmiškus atvejus, o ne manykite, kad aptikimas visada yra galutinis. Neišspręstus įrašus laikykite atpažįstamus ir suteikite taisymo kelią, užuot tyliai pasirinkę neaiškų atitikmenį.
Ar sekimo duomenys gali įrodyti, kad užsakymas baigtas?
Pristatymo įvykis yra siuntos lygio signalas, o ne būtinai įrodymas, kad atvyko kiekviena užsakymo pakuotė arba kad gavėjas neturi pretenzijų. Pakuotės pristatymą, užsakymo užbaigimą ir klientų pretenzijas laikykite atskiromis verslo sąvokomis, su aiškiomis jų sąsajų taisyklėmis.
Ką komandos turėtų patikrinti prieš pasirinkdamos sekimo API?
Patikrinkite reprezentatyvių siuntų palaikymą, reikalingus įvykių laukus, atnaujinimų pristatymo elgseną, autentifikavimą, limitus, atkūrimo parinktis, duomenų sąlygas ir kainodaros apibrėžimus. Išbandykite visą darbo procesą savo aplinkoje. Funkcijų kontrolinis sąrašas negali nustatyti, ar faktiniai siuntų duomenys atitiks jūsų produkto priėmimo kriterijus.
Šaltiniai
Toliau pateikti oficialūs ištekliai nurodo 17TRACK kūrėjams skirtą pasiūlymą ir jo integracijos dokumentaciją. Šiame vadove aprašyta architektūra, vidinis duomenų modelis ir testavimo planas yra įgyvendinimo rekomendacijos, o ne teikėjo garantijų teiginiai.
- 17TRACK sekimo API — oficialus produkto išteklius sekimo API pasiūlymui įvertinti.
- 17TRACK API dokumentacija — oficiali nuoroda integracijos reikalavimams ir palaikomai API elgsenai patikrinti.


