Skip to main content
DomovBlogPríručkyAko môžu značky v oblasti e-commerce založeného na predplatnom sledovať opakované zásielky pomocou API na sledovanie zásielok

Ako môžu značky v oblasti e-commerce založeného na predplatnom sledovať opakované zásielky pomocou API na sledovanie zásielok

17TRACK

Ak chcete sledovať opakované zásielky pomocou sledovacieho API, vytvorte záznam zásielky pre každý fyzický balík, prepojte ho s objednávkou na expedíciu pre daný cyklus predplatného a zaregistrujte jeho sledovacie číslo, keď vám ho poskytne sklad alebo partner zabezpečujúci plnenie objednávok. Pomocou aktualizácií sledovania z API zobrazujte zákazníkom, kde sa daný balík nachádza, a označujte výnimky pri doručení pre svoj tím. ID predplatného používajte ako prepojenie medzi cyklami, nie ako identifikátor balíka.

Ako môžu značky v oblasti predplatného elektronického obchodu sledovať opakované zásielky

Sledujte balík, nie predplatné

Predplatné vám hovorí, čo má zákazník dostávať v priebehu času. Objednávka na expedíciu vám hovorí, čo treba odoslať v rámci jedného cyklu. Sledovacie číslo vám poskytuje informácie o konkrétnom balíku. Oddelenie týchto záznamov zabráni tomu, aby sa oneskorená zásielka z jedného cyklu zobrazila na stránke sledovania pre nasledujúci cyklus.

Napríklad si predstavte, že májová predplatiteľská krabica je rozdelená do dvoch balíkov a júnová krabica sa odošle, zatiaľ čo jeden májový balík je stále na ceste. Zákazník by mal vidieť dva balíky pod májovou objednávkou a samostatný balík pod júnovou objednávkou. Oneskorená májová aktualizácia by mala zmeniť iba májový balík. Ak odošlete náhradu, vytvorte nový záznam zásielky a prepojte ho s pôvodným záznamom, aby podpora videla, prečo existujú oba.

  • Predplatné: Uložte ID predplatného, aby podpora mohla nájsť históriu zásielok zákazníka.
  • Cyklus a objednávka: Zaznamenajte identifikátor cyklu alebo plánovaný dátum plnenia objednávky, ID objednávky a všetky ID plnenia potrebné na priradenie balíkov k správnej objednávke. Cyklus neurčujte podľa dátumu prijatia udalosti sledovania.
  • Zásielka: Každému balíku priraďte interné ID zásielky. Uložte jeho dopravcu a sledovacie číslo, príslušný odkaz na plnenie objednávky a všetky ID registrácie sledovania, ktoré poskytovateľ vráti. Zrušené štítky a nahradené sledovacie čísla nezobrazujte v aktívnom zákazníckom prehľade, ale históriu si ponechajte pre podporu.

Na stránke objednávky zobrazte priebeh na úrovni balíkov spolu so súhrnom objednávky. Ak je jeden balík doručený a druhý je na ceste, uveďte to. Celú objednávku označte ako doručenú až vtedy, keď dorazia všetky balíky potrebné na jej dokončenie, pričom zohľadnite zrušené zásielky a náhrady.

Prepojte plnenie objednávok so sledovacím API

  1. Registráciu spúšťajte z udalosti plnenia objednávky. Registráciu spustite, keď systém plnenia objednávok, sklad alebo externý logistický partner odošle dopravcu a sledovacie číslo. Platba za obnovenie predplatného je príliš skorá: objednávka môže stále čakať na odoslanie a sledovacie číslo nemusí existovať.
  2. Pred volaním API uložte zásielku. Uložte interný záznam zásielky a požiadavku na registráciu vložte do frontu. Ak rovnaká správa o plnení príde dvakrát, použite tento záznam namiesto vytvorenia ďalšieho balíka. Ak volanie API vyprší, pred opakovaním skontrolujte, či bola pôvodná požiadavka úspešná, ak vám to poskytovateľ umožňuje.
  3. Aktualizácie priraďte k zaregistrovanému balíku. Ak sa v aktualizáciách vráti identifikátor registrácie poskytovateľa, použite ho. V opačnom prípade priraďujte podľa identifikátorov uvedených v jeho dokumentácii a výsledok overte podľa záznamov zásielok. Ak by aktualizácia mohla patriť k viac než jednému záznamu, odošlite ju na kontrolu namiesto priradenia k najnovšej objednávke.
  4. Oddeľte vytvorenie štítku od pohybu zásielky u dopravcu. Sledovacie číslo môže existovať ešte predtým, než dopravca zaznamená prevzatie. Ak máte iba štítok, použite napríklad správu „Príprava na vyzdvihnutie dopravcom“. Stav „Na ceste“ používajte iba vtedy, keď ho podporujú informácie od dopravcu.

Sledovacie API 17TRACK je jednou z možností pre toto nastavenie. Jeho dokumentácia pre vývojárov je referenciou na registráciu sledovacích čísel a prijímanie aktualizácií sledovania. Tieto aktualizácie používajte na udržiavanie záznamu balíka vo svojom systéme; priradenie cyklu, dokončenie objednávky a pravidlá upozornení zákazníkov ponechajte vo svojej aplikácii elektronického obchodu. Pred spustením otestujte zásielky zo skutočných trás dopravcov a od svojich partnerov zabezpečujúcich plnenie objednávok, namiesto spoliehania sa iba na zoznam dopravcov.

Zaistite bezpečné opakované spracovanie aktualizácií

Ak váš poskytovateľ ponúka webhooky, používajte ich na prijímanie aktualizácií bez neustáleho dopytovania každého balíka. Webhook je požiadavka HTTP, ktorú poskytovateľ odošle do vašej aplikácie. Dodržiavajte požiadavky poskytovateľa na overenie, prijaté dátové údaje ukladajte trvalo a požiadavky potvrdzujte podľa jeho zdokumentovaných pravidiel odpovedí. Pomalšie operácie, ako aktualizácia zobrazenia objednávky alebo odosielanie e-mailov, vykonávajte mimo obsluhy požiadavky.

Spracovanie navrhnite tak, aby opakovaná aktualizácia nemala žiadny ďalší účinok. Ak poskytovateľ dodáva stabilné ID udalostí, používajte ich na rozpoznanie opakovaní. Ak odosiela snímky sledovania namiesto jednotlivých udalostí, pred vykonaním akcie porovnajte prichádzajúci stav a históriu skenov s tým, čo už máte. Duplikáciu zákazníckych správ riešte samostatne: upozornenie o doručení, ktoré už bolo odoslané, sa nesmie odoslať znova len preto, že sa rovnaké údaje o zásielke spracovali dvakrát.

Čas uskutočnenia skenu uchovávajte oddelene od času, keď ho prijala vaša aplikácia. Neskoro doručený sken zásielky na ceste môže patriť do histórie balíka bez toho, aby nahradil novší stav doručenia. Nepredpokladajte však, že každá oprávnená zmena posúva balík vpred. Oprava dopravcu alebo aktualizácia o vrátení odosielateľovi môže vyžadovať zmenu zobrazených údajov. Ak sú nové údaje v rozpore s uloženým stavom a nedokážete určiť, ktoré sú správne, vložte zásielku do frontu na kontrolu.

Pravidelne kontrolujte otvorené zásielky, ktoré môžu vyžadovať pozornosť: registrácie stále čakajúce na spracovanie, balíky bez prvého skenu po očakávanom odovzdaní a zásielky, pri ktorých sa aktualizácie sledovania zastavili. Ak API podporuje vyhľadanie alebo obnovenie údajov, používajte ho selektívne v rámci limitov poskytovateľa. Pred eskaláciou skontrolujte vzorec naprieč dopravcami a skladmi. Ak sa aktualizácie naraz zastavia pri mnohých nesúvisiacich zásielkach, preskúmajte integráciu skôr, než otvoríte jednotlivé prípady doručenia.

Premeňte údaje o sledovaní na užitočné správy pre zákazníkov

Zákazníci zriedka potrebujú e-mail pri každom skene. Začnite správami súvisiacimi s tým, čo potrebujú vedieť alebo urobiť: balík vstúpil do siete dopravcu, pokus o doručenie vyžaduje akciu alebo dopravca oznámil doručenie. Zobrazte referenciu objednávky a príslušnú krabicu alebo cyklus, aby predplatitelia vedeli, ktorej zásielky sa správa týka. Pri rozdelenej objednávke identifikujte balík a jasne uveďte, či je zvyšok objednávky stále na ceste.

  • Štítok vytvorený, bez skenu: Porovnajte očakávané odovzdanie so záznamami skladu. Ak lehota na odovzdanie uplynula, požiadajte plnenie objednávok o potvrdenie, či balík opustil prevádzku, a až potom zákazníkovi oznámte, že sa jeho zásielka oneskorila.
  • Sledovanie sa prestalo aktualizovať: Používajte prahové hodnoty, ktoré zohľadňujú trasu a službu, namiesto jedného časovača pre každý balík. Pri cezhraničných zásielkach si pred rozhodnutím o kontaktovaní zákazníka alebo eskalácii prezrite poslednú udalosť dopravcu.
  • Neúspešný pokus alebo potrebné vyzdvihnutie: Ak dopravca poskytuje jasné pokyny, povedzte zákazníkovi, akú akciu treba vykonať. Ak je udalosť nejasná, presmerujte prípad na podporu namiesto hádania dátumu opätovného doručenia alebo miesta vyzdvihnutia.
  • Označené ako doručené, ale neprevzaté: Ponechajte stav nahlásený dopravcom a otvorte samostatný prípad pre podporu. Váš pracovný postup podpory by mal rozlišovať medzi hlásením zákazníka a opravou dopravcu.

Poskytnite pracovníkom podpory jediný prehľad cyklu, objednávky, histórie balíka a už odoslaných správ. Každej výnimke priraďte zodpovednú osobu a ďalší krok. Plnenie objednávok môže preskúmať chýbajúce odovzdanie, logistika môže riešiť výnimku u dopravcu a podpora môže komunikovať so zákazníkom. Stav sledovania opisuje balík; nerozhoduje o tom, či je potrebná náhrada alebo vrátenie peňazí.

Pred spustením otestujte prekrývanie cyklov

Začnite s jedným partnerom zabezpečujúcim plnenie objednávok a so súborom zásielok, ktorý odráža jeho skutočný spôsob expedície objednávok. Zahrňte cyklus s viacerými balíkmi, zneplatnený štítok, náhradu a staršiu zásielku, ktorá je stále otvorená v čase odoslania ďalšieho cyklu. Potom zámerne zopakujte duplicitný webhook a doručte staršiu udalosť po novšej. Skontrolujte záznam balíka, stránku objednávky zákazníka, zobrazenie pre podporu a denník upozornení. Test, ktorý overuje iba úspešnú odpoveď API, môže prehliadnuť najdrahšiu chybu: aktualizáciu nesprávnej objednávky alebo odoslanie správy nesprávnemu zákazníkovi.

Sledujte zlyhania registrácie, podiel oprávnených balíkov, ktoré boli úspešne zaregistrované, prvé skeny uskutočnené neskôr, než sa očakávalo, a nepriradené aktualizácie. Ak sledujete oneskorenie aktualizácií, rozlišujte čas medzi udalosťou dopravcu a jej prijatím od času, ktorý váš vlastný systém potrebuje na spracovanie. Pomôže vám to rozhodnúť, či máte preskúmať dátový kanál dopravcu, koncový bod webhooku alebo front vo svojej aplikácii.

Rozšírte systém na ďalšie trasy, keď budete schopní pri každom balíku odpovedať na tri otázky: Ku ktorému cyklu patrí? Čo naposledy nahlásil dopravca? Kto zasiahne, ak aktualizácia chýba alebo je nesprávna? Ak je ktorákoľvek odpoveď nejasná, opravte mapovanie záznamov alebo pracovný postup pre výnimky ešte pred pridaním ďalších pravidiel upozornení.

Často kladené otázky

Môže sledovacie API zákazníkom oznámiť, kedy bude odoslaná ich ďalšia predplatiteľská krabica?

Pri ďalšom plánovanom dátume odoslania použite rozvrh predplatného a systém plnenia objednávok. Sledovacie API slúži na konkrétny balík, keď už existujú informácie o sledovaní. Plánovaný dátum odoslania, odhad doručenia od dopravcu a potvrdené doručenie sú odlišné skutočnosti a mali by byť označené samostatne.

Čo ak sklad po odoslaní e-mailu nahradí sledovacie číslo?

Označte starý štítok ako nahradený a nové sledovacie číslo prepojte s rovnakou objednávkou. Ak e-mail odkazuje na stránku sledovania na úrovni objednávky, aktualizujte túto stránku, aby zákazník našiel aktívny balík bez potreby pôvodného odkazu dopravcu. Ak zmena ovplyvňuje informácie, na základe ktorých musí zákazník konať, odošlite opravu.

Čo ak partner zabezpečujúci plnenie objednávok odošle sledovacie čísla bez kódov dopravcov?

Požiadajte partnera o jednotné pole dopravcu alebo o mapovanie jeho kódov prepravných služieb. Ak vaše API ponúka detekciu dopravcu, pred spoliehaním sa na ňu overte, ako funguje so štítkami partnera. Nejednoznačné zhody odošlite na kontrolu namiesto výberu dopravcu iba na základe sledovacieho čísla.

Potrebujú pozastavené alebo preskočené predplatné záznamy sledovania?

Pre cyklus, ktorý sa nikdy neodošle, nie je potrebný žiadny záznam balíka. Ak je predchádzajúca zásielka stále otvorená, pokračujte v jej sledovaní aj vtedy, keď je predplatné pozastavené, preskočené alebo zrušené. Stav predplatného riadi budúce plnenie objednávok; nehovorí vám, čo sa stalo s balíkom, ktorý už opustil sklad.

Zdroje

  • Sledovacie API 17TRACK — prehľad produktu na integráciu sledovania balíkov do podnikových systémov.
  • Dokumentácia sledovacieho API 17TRACK — referenčné informácie k implementácii registrácie sledovacích čísel a prijímania údajov o sledovaní.
  • Dokumentácia webhookov Stripe — referencia pre všeobecné postupy pri webhookoch, ako je spracovanie duplicitných udalostí a vyhýbanie sa predpokladom o poradí doručenia. Dodržiavajte vlastné pravidlá poskytovateľa sledovania pre overovanie a potvrdzovanie.