Kaip prenumeratos el. prekybos prekių ženklai gali sekti pasikartojančias siuntas naudodami siuntų sekimo API
Norėdami sekti pasikartojančias siuntas naudodami siuntų sekimo API, sukurkite siuntos įrašą kiekvienam fiziniam paketui, susiekite jį su atitinkamo prenumeratos ciklo įvykdymo užsakymu ir užregistruokite sekimo numerį, kai jį pateikia jūsų sandėlis arba užsakymų vykdymo partneris. Naudokite API sekimo atnaujinimus, kad klientams parodytumėte, kur yra jų paketas, o savo komandai pažymėtumėte pristatymo išimtis. Prenumeratos ID naudokite kaip ryšį tarp ciklų, o ne kaip paketo identifikatorių.

Sekite paketą, o ne prenumeratą
Prenumerata nurodo, ką klientas turėtų gauti per tam tikrą laiką. Užsakymo vykdymo užsakymas nurodo, ką reikia išsiųsti per vieną ciklą. Sekimo numeris pateikia informaciją apie konkretų paketą. Laikant šiuos įrašus atskirai, išvengiama situacijos, kai vėluojanti vieno ciklo siunta rodoma kito ciklo sekimo puslapyje.
Pavyzdžiui, tarkime, kad gegužės prenumeratos dėžutė padalyta į du paketus, o birželio dėžutė išsiunčiama, kai vienas gegužės paketas vis dar vežamas. Klientas turėtų matyti du paketus prie gegužės užsakymo ir atskirą paketą prie birželio užsakymo. Vėlyvas gegužės atnaujinimas turėtų pakeisti tik gegužės paketą. Jei siunčiate pakaitinę siuntą, sukurkite naują siuntos įrašą ir susiekite jį su pradiniu, kad pagalbos tarnyba matytų, kodėl egzistuoja abu įrašai.
- Prenumerata: Išsaugokite prenumeratos ID, kad pagalbos tarnyba galėtų rasti kliento siuntų istoriją.
- Ciklas ir užsakymas: Įrašykite ciklo identifikatorių arba suplanuotą užsakymo vykdymo datą, užsakymo ID ir visus reikalingus vykdymo ID, kad paketus būtų galima susieti su tinkamu užsakymu. Nenustatykite ciklo pagal datą, kada gaunamas sekimo įvykis.
- Siunta: Kiekvienam paketui suteikite vidinį siuntos ID. Išsaugokite vežėją ir sekimo numerį, susijusią vykdymo nuorodą bei bet kokį teikėjo grąžinamą sekimo registracijos ID. Atšauktų etikečių ir pakeistų sekimo numerių nerodykite aktyviame kliento lange, tačiau išsaugokite istoriją pagalbos tarnybai.
Užsakymo puslapyje kartu su užsakymo suvestine rodykite kiekvieno paketo eigą. Jei vienas paketas pristatytas, o kitas dar vežamas, taip ir nurodykite. Visą užsakymą rodykite kaip pristatytą tik tada, kai atvyko visi jam užbaigti reikalingi paketai, atsižvelgiant į atšauktas siuntas ir pakaitines siuntas.
Susiekite užsakymo vykdymą su sekimo API
- Registruokite pagal užsakymo vykdymo įvykį. Pradėkite registraciją, kai užsakymo vykdymo sistema, sandėlis arba trečiosios šalies logistikos partneris atsiunčia vežėją ir sekimo numerį. Atsinaujinimo mokėjimas yra per ankstyvas: užsakymas dar gali laukti išsiuntimo, o sekimo numerio gali nebūti.
- Išsaugokite siuntą prieš skambindami API. Išsaugokite vidinį siuntos įrašą ir įtraukite registracijos užklausą į eilę. Jei ta pati vykdymo žinutė gaunama du kartus, naudokite tą patį įrašą, o ne kurkite kitą paketą. Jei API užklausa baigiasi skirtuoju laiku, prieš bandydami dar kartą patikrinkite, ar pradinė užklausa buvo sėkminga, jei teikėjas suteikia tokią galimybę.
- Susiekite atnaujinimus su užregistruotu paketu. Jei atnaujinimuose grąžinamas teikėjo registracijos identifikatorius, naudokite jį. Kitu atveju naudokite dokumentacijoje nurodytus identifikatorius ir patikrinkite rezultatą pagal savo siuntų įrašus. Jei atnaujinimas galėtų priklausyti daugiau nei vienam įrašui, nusiųskite jį peržiūrai, o ne pritaikykite naujausiam užsakymui.
- Atskirkite etiketės sukūrimą nuo vežėjo siuntos perėmimo. Sekimo numeris gali egzistuoti dar prieš vežėjui užfiksuojant siuntos perėmimą. Kai turite tik etiketę, naudokite pranešimą, pvz., „Ruošiama vežėjo paėmimui“. „Vežama“ naudokite tik tada, kai tai patvirtina vežėjo informacija.
17TRACK Tracking API yra viena iš šio sprendimo galimybių. Jos kūrėjų dokumentacija yra pagrindinis šaltinis registruojant sekimo numerius ir gaunant sekimo atnaujinimus. Naudokite šiuos atnaujinimus siuntos įrašui savo sistemoje prižiūrėti; ciklo priskyrimo, užsakymo užbaigimo ir klientų informavimo taisykles laikykite savo elektroninės prekybos programoje. Prieš paleisdami sprendimą, išbandykite jį su paketais iš tikrųjų naudojamų vežėjų maršrutų ir užsakymų vykdymo partnerių, o ne remkitės vien vežėjų sąrašu.
Padarykite atnaujinimų apdorojimą saugų net juos gavus du kartus
Jei jūsų teikėjas siūlo žiniatinklio kabliukus, naudokite juos atnaujinimams gauti, o ne nuolat tikrinkite kiekvieną paketą. Žiniatinklio kabliukas yra HTTP užklausa, kurią teikėjas siunčia jūsų programai. Laikykitės teikėjo patvirtinimo reikalavimų, patikimai išsaugokite priimtus duomenis ir patvirtinkite užklausas pagal dokumentuotas atsakymo taisykles. Lėtesnes operacijas, pavyzdžiui, užsakymų rodinių atnaujinimą ar el. laiškų siuntimą, vykdykite už užklausos apdorojimo funkcijos ribų.
Sukurkite apdorojimo kelią taip, kad pakartotinis atnaujinimas neturėtų papildomo poveikio. Jei teikėjas pateikia stabilius įvykių ID, naudokite juos pakartojimams atpažinti. Jei jis siunčia sekimo būsenos momentines kopijas, o ne atskirus įvykius, prieš imdamiesi veiksmų palyginkite gaunamą būseną ir skenavimo istoriją su jau turima informacija. Klientų pranešimus dubliuokite atskirai: jau išsiųstas pranešimas apie pristatymą neturėtų būti siunčiamas dar kartą vien todėl, kad tie patys siuntos duomenys buvo apdoroti du kartus.
Laiką, kada buvo nuskenuota siunta, atskirkite nuo laiko, kada jūsų programa ją gavo. Vėlyvas skenavimo įrašas „vežama“ gali priklausyti siuntos istorijai, tačiau neturėtų pakeisti naujesnės būsenos „pristatyta“. Vis dėlto nemanykite, kad kiekvienas teisėtas pakeitimas reiškia siuntos judėjimą pirmyn. Vežėjo pataisa arba atnaujinimas apie grąžinimą siuntėjui gali pakeisti tai, ką rodote. Jei nauji duomenys nesutampa su išsaugota būsena ir negalite nustatyti, kurie yra teisingi, perkelkite siuntą į peržiūros eilę.
Periodiškai tikrinkite atidarytas siuntas, kurioms gali reikėti dėmesio: dar neįvykdytas registracijas, paketus, kuriuose po numatyto perdavimo nėra pirmojo skenavimo, ir siuntas, kurių sekimo informacija nustojo atsinaujinti. Jei API palaiko paiešką arba atnaujinimą, naudokite juos pasirinktinai, laikydamiesi teikėjo ribojimų. Prieš eskaluodami problemą patikrinkite tendencijas tarp vežėjų ir sandėlių. Jei atnaujinimai vienu metu sustoja daugelyje nesusijusių siuntų, ištirkite integraciją prieš atidarydami atskiras pristatymo bylas.
Paverskite sekimo duomenis naudingais klientų pranešimais
Klientams retai reikia el. laiško apie kiekvieną skenavimą. Pradėkite nuo pranešimų, susijusių su tuo, ką jiems reikia žinoti arba padaryti: paketas pateko į vežėjo tinklą, pristatymo bandymui reikia veiksmų arba vežėjas praneša apie pristatymą. Rodykite užsakymo nuorodą ir atitinkamą dėžutę arba ciklą, kad prenumeratoriai galėtų suprasti, apie kurią siuntą kalbama. Jei užsakymas padalytas, nurodykite paketą ir aiškiai pasakykite, ar likusi užsakymo dalis dar vežama.
- Etiketė sukurta, nėra skenavimo: Patikrinkite numatytą perdavimą pagal sandėlio įrašus. Jei perdavimo laikotarpis praėjo, paprašykite užsakymų vykdymo komandos patvirtinti, ar paketas išvyko iš objekto, prieš informuodami klientą, kad siunta vėluoja.
- Sekimas nebejuda: Naudokite maršrutą ir paslaugą atspindinčias ribas, o ne vieną laikmatį visiems paketams. Tarpvalstybinių siuntų atveju prieš nuspręsdami susisiekti su klientu ar eskaluoti problemą peržiūrėkite paskutinį vežėjo įvykį.
- Nesėkmingas bandymas arba reikia atsiimti: Jei vežėjas pateikia aiškias instrukcijas, pasakykite klientui, kokių veiksmų reikia. Jei įvykis neaiškus, nukreipkite atvejį pagalbos tarnybai, o ne spėliokite pakartotinio pristatymo datą ar atsiėmimo vietą.
- Pažymėta kaip pristatyta, bet negauta: Išsaugokite vežėjo nurodytą būseną ir atidarykite atskirą pagalbos atvejį. Pagalbos darbo eiga turėtų atskirti kliento pranešimą nuo vežėjo pataisos.
Suteikite pagalbos darbuotojams vieną ciklo, užsakymo, siuntos istorijos ir jau išsiųstų pranešimų vaizdą. Kiekvienai išimčiai priskirkite atsakingą asmenį ir kitą veiksmą. Užsakymų vykdymo komanda gali tirti neįvykusį perdavimą, logistika gali sekti vežėjo išimtį, o pagalbos tarnyba gali bendrauti su klientu. Sekimo būsena apibūdina paketą; ji nenustato, ar priklauso pakaitinė siunta arba pinigų grąžinimas.
Išbandykite ciklų persidengimą prieš paleisdami
Pradėkite nuo vieno užsakymų vykdymo partnerio ir siuntų rinkinio, atspindinčio jo faktinį užsakymų išsiuntimo procesą. Įtraukite ciklą su keliais paketais, anuliuotą etiketę, pakaitinę siuntą ir senesnę dar neuždarytą siuntą, kai išsiunčiamas kitas ciklas. Tada tyčia pakartokite pasikartojantį žiniatinklio kabliuką ir pristatykite senesnį įvykį po naujesnio. Patikrinkite siuntos įrašą, kliento užsakymo puslapį, pagalbos rodinį ir pranešimų žurnalą. Testas, kuriuo tik patikrinamas sėkmingas API atsakymas, gali neatskleisti brangiausios klaidos: netinkamo užsakymo atnaujinimo arba netinkamo kliento informavimo.
Stebėkite registracijos klaidas, sėkmingai užregistruotų tinkamų paketų dalį, vėliau nei tikėtasi atliktus pirmuosius skenavimus ir nesutampančius atnaujinimus. Jei stebite atnaujinimo delsą, atskirkite laiką nuo vežėjo įvykio iki jo gavimo nuo laiko, kurio jūsų sistema užtrunka jį apdoroti. Tai padės nuspręsti, ar tirti vežėjo duomenų srautą, jūsų žiniatinklio kabliuko galinį tašką, ar jūsų programos eilę.
Išplėskite sprendimą į daugiau maršrutų, kai galėsite atsakyti į tris kiekvieno paketo klausimus: kuriam ciklui jis priklauso? Ką paskutinį kartą pranešė vežėjas? Kas imsis veiksmų, jei atnaujinimo trūksta arba jis neteisingas? Jei kuris nors atsakymas neaiškus, pataisykite įrašų susiejimą arba išimčių darbo eigą prieš pridėdami daugiau pranešimų taisyklių.
DUK
Ar sekimo API gali pasakyti klientams, kada bus išsiųsta kita jų prenumeratos dėžutė?
Kitai planuojamai išsiuntimo datai naudokite prenumeratos grafiką ir užsakymų vykdymo sistemą. Sekimo API skirta konkrečiam paketui, kai atsiranda sekimo informacija. Planuojama išsiuntimo data, vežėjo pristatymo įvertis ir patvirtintas pristatymas yra skirtingi faktai, todėl jie turėtų būti žymimi atskirai.
Kas nutiks, jei sandėlis pakeis sekimo numerį jau išsiuntus el. laišką?
Pažymėkite seną etiketę kaip pakeistą ir susiekite naują sekimo numerį su tuo pačiu užsakymu. Jei el. laiške pateikiama nuoroda į užsakymo lygio sekimo puslapį, atnaujinkite tą puslapį, kad klientas galėtų rasti aktyvų paketą be pradinės vežėjo nuorodos. Išsiųskite pataisą, kai pakeitimas turi įtakos informacijai, pagal kurią klientas turi imtis veiksmų.
Kas nutiks, jei užsakymų vykdymo partneris atsiųs sekimo numerius be vežėjų kodų?
Paprašykite partnerio pateikti nuoseklų vežėjo lauką arba jo pristatymo paslaugų kodų susiejimą. Jei jūsų API siūlo vežėjo aptikimą, prieš pasikliaudami juo patikrinkite, kaip jis veikia su partnerio etiketėmis. Neaiškius sutapimus nukreipkite peržiūrai, o ne rinkitės vežėją vien pagal sekimo numerį.
Ar pristabdytoms arba praleistoms prenumeratoms reikia sekimo įrašų?
Įrašas nereikalingas ciklui, kuris niekada neišsiunčiamas. Jei ankstesnė siunta vis dar atidaryta, toliau ją sekite, net jei prenumerata pristabdyta, praleista arba atšaukta. Prenumeratos būsena kontroliuoja būsimą užsakymų vykdymą; ji nepasako, kas nutiko paketui, kuris jau išvyko iš sandėlio.
Šaltiniai
- 17TRACK Tracking API — produkto apžvalga, skirta siuntų sekimui integruoti į verslo sistemas.
- 17TRACK Tracking API dokumentacija — diegimo nuorodos, skirtos sekimo numeriams registruoti ir sekimo duomenims gauti.
- Stripe žiniatinklio kabliukų dokumentacija — bendrosios žiniatinklio kabliukų praktikos, pavyzdžiui, pasikartojančių įvykių tvarkymas ir prielaidų apie pristatymo tvarką vengimas. Laikykitės savo sekimo teikėjo taisyklių dėl patvirtinimo ir atsakymų.


