Jak mohou e-commerce značky s předplatným sledovat opakované zásilky pomocí Tracking API
Pro sledování opakovaných zásilek pomocí sledovacího API vytvořte záznam zásilky pro každý fyzický balík, propojte jej s fulfillment objednávkou pro daný cyklus předplatného a zaregistrujte jeho sledovací číslo, jakmile vám je poskytne sklad nebo fulfillment partner. Pomocí aktualizací sledování z API zákazníkům zobrazte, kde se balík nachází, a označte výjimky při doručení pro svůj tým. ID předplatného uchovávejte jako propojení mezi cykly, nikoli jako identifikátor balíku.

Sledujte balík, ne předplatné
Předplatné vám říká, co má zákazník v průběhu času obdržet. Fulfillment objednávka říká, co je třeba odeslat v rámci jednoho cyklu. Sledovací číslo se týká konkrétního balíku. Oddělené vedení těchto záznamů zabrání tomu, aby se opožděná zásilka z jednoho cyklu zobrazila na stránce sledování pro následující cyklus.
Například předpokládejme, že květnový balíček předplatného je rozdělen do dvou balíků a červnový balíček je odeslán, zatímco jeden květnový balík je stále na cestě. Zákazník by měl pod květnovou objednávkou vidět dva balíky a samostatný balík pod červnovou objednávkou. Opožděná květnová aktualizace by měla změnit pouze květnový balík. Pokud odešlete náhradu, vytvořte nový záznam zásilky a propojte jej s původním, aby podpora viděla, proč oba existují.
- Předplatné: Uložte ID předplatného, aby podpora mohla dohledat historii zásilek zákazníka.
- Cyklus a objednávka: Zaznamenejte identifikátor cyklu nebo plánované datum fulfillmentu, ID objednávky a všechna potřebná ID fulfillmentu pro přiřazení balíků ke správné objednávce. Cyklus neodvozujte od data přijetí události sledování.
- Zásilka: Každému balíku přidělte interní ID zásilky. Uložte dopravce a sledovací číslo, příslušný odkaz na fulfillment a případné ID registrace sledování, které poskytovatel vrátí. Zrušené štítky a nahrazená sledovací čísla nezobrazujte v aktivním zákaznickém pohledu, ale historii uchovejte pro podporu.
Na stránce objednávky zobrazte průběh na úrovni balíků spolu se souhrnem objednávky. Pokud je jeden balík doručen a druhý je na cestě, uveďte to. Celou objednávku označte jako doručenou až tehdy, když dorazí všechny balíky potřebné k jejímu dokončení, přičemž zohledněte zrušené zásilky a náhrady.
Propojte fulfillment se sledovacím API
- Registrujte na základě události fulfillmentu. Registraci spusťte, když fulfillment systém, sklad nebo logistický partner třetí strany odešle dopravce a sledovací číslo. Platba za obnovení předplatného je příliš brzy: objednávka může stále čekat na odeslání a sledovací číslo nemusí existovat.
- Uložte zásilku před voláním API. Uložte interní záznam zásilky a zařaďte požadavek na registraci do fronty. Pokud stejná zpráva o fulfillmentu dorazí dvakrát, použijte tento záznam místo vytvoření dalšího balíku. Pokud volání API vyprší, před opakováním ověřte, zda byl původní požadavek úspěšný, pokud vám to poskytovatel umožňuje.
- Přiřaďte aktualizace k registrovanému balíku. Pokud je v aktualizacích vrácen identifikátor registrace poskytovatele, použijte jej. Jinak přiřazujte podle identifikátorů uvedených v jeho dokumentaci a výsledek ověřte vůči záznamům zásilek. Pokud by aktualizace mohla patřit k více než jednomu záznamu, odešlete ji ke kontrole místo přiřazení k nejnovější objednávce.
- Oddělte vytvoření štítku od pohybu u dopravce. Sledovací číslo může existovat ještě předtím, než dopravce zaznamená převzetí. Pokud máte pouze štítek, použijte zprávu typu „Příprava na vyzvednutí dopravcem“. Označení „Na cestě“ používejte pouze pro informace od dopravce, které to podporují.
Sledovací API 17TRACK je jednou z možností pro toto nastavení. Jeho dokumentace pro vývojáře je referencí pro registraci sledovacích čísel a přijímání aktualizací sledování. Tyto aktualizace používejte k údržbě záznamu balíku ve svém systému; přiřazení k cyklu, dokončení objednávky a pravidla pro informování zákazníků ponechte ve své e-commerce aplikaci. Před spuštěním testujte balíky ze skutečných tras dopravců a od fulfillment partnerů, namísto spoléhání pouze na seznam dopravců.
Zajistěte bezpečné opakované zpracování aktualizací
Pokud váš poskytovatel nabízí webhooky, používejte je k přijímání aktualizací bez průběžného dotazování na každý balík. Webhook je požadavek HTTP, který poskytovatel odesílá do vaší aplikace. Dodržujte požadavky poskytovatele na ověřování, přijatá data ukládejte trvale a požadavky potvrzujte podle jeho zdokumentovaných pravidel odpovědí. Pomalejší operace, například aktualizaci zobrazení objednávky nebo odesílání e-mailů, provádějte mimo obsluhu požadavku.
Zpracování navrhněte tak, aby opakovaná aktualizace neměla žádný další účinek. Pokud poskytovatel dodává stabilní ID událostí, používejte je k rozpoznání opakování. Pokud odesílá snímky sledování namísto jednotlivých událostí, před provedením akce porovnejte příchozí stav a historii skenování s tím, co již máte. Zprávy zákazníkům deduplikujte samostatně: oznámení o doručení, které již bylo odesláno, se nemá odeslat znovu jen proto, že stejná data zásilky byla zpracována dvakrát.
Čas, kdy ke skenování došlo, uchovávejte odděleně od času, kdy jej vaše aplikace přijala. Pozdě dorazivý sken ve stavu „na cestě“ může patřit do historie balíku, aniž by nahradil novější stav „doručeno“. Nepředpokládejte však, že každá legitimní změna posouvá balík vpřed. Oprava dopravce nebo aktualizace o vrácení odesílateli může vyžadovat změnu zobrazených údajů. Pokud jsou nová data v rozporu s uloženým stavem a nelze určit, která jsou správná, zařaďte zásilku do fronty ke kontrole.
Pravidelně kontrolujte otevřené zásilky, které mohou vyžadovat pozornost: registrace stále čekající na vyřízení, balíky bez prvního skenu po očekávaném předání a zásilky, u nichž se sledování odmlčelo. Pokud API podporuje vyhledání nebo obnovení údajů, používejte je selektivně v rámci limitů poskytovatele. Před eskalací kontrolujte vzorec napříč dopravci a sklady. Pokud se aktualizace zastaví u mnoha nesouvisejících zásilek současně, prošetřete integraci dříve, než otevřete jednotlivé případy doručení.
Přeměňte data o sledování na užitečné zprávy pro zákazníky
Zákazníci jen zřídka potřebují e-mail při každém skenu. Začněte zprávami spojenými s něčím, co potřebují vědět nebo udělat: balík vstoupil do sítě dopravce, pokus o doručení vyžaduje akci nebo dopravce oznámil doručení. Uveďte referenci objednávky a příslušný balík nebo cyklus, aby odběratelé poznali, které zásilky se zpráva týká. U rozdělené objednávky identifikujte balík a jasně uveďte, zda je zbytek objednávky stále na cestě.
- Štítek vytvořen, bez skenu: Ověřte očekávané předání podle záznamů skladu. Pokud lhůta předání uplynula, požádejte fulfillment o potvrzení, zda balík opustil provozovnu, a teprve poté zákazníkovi oznamte, že se zásilka zpozdila.
- Sledování se přestalo pohybovat: Používejte prahové hodnoty, které zohledňují trasu a službu, nikoli jeden časovač pro každý balík. U přeshraničních zásilek před rozhodnutím, zda kontaktovat zákazníka nebo případ eskalovat, zkontrolujte poslední událost dopravce.
- Neúspěšný pokus nebo nutné vyzvednutí: Pokud dopravce poskytuje jasné pokyny, řekněte zákazníkovi, jaká akce je potřeba. Pokud je událost nejasná, předejte případ podpoře místo odhadování data opětovného doručení nebo místa vyzvednutí.
- Označeno jako doručené, ale nepřijato: Zachovejte stav nahlášený dopravcem a otevřete samostatný případ podpory. Váš pracovní postup podpory by měl rozlišovat mezi hlášením zákazníka a opravou dopravce.
Poskytněte pracovníkům podpory jednotný pohled na cyklus, objednávku, historii balíků a již odeslané zprávy. Každé výjimce přiřaďte vlastníka a další krok. Fulfillment může prověřit chybějící předání, logistika může řešit výjimku u dopravce a podpora může komunikovat se zákazníkem. Stav sledování popisuje balík; nerozhoduje o tom, zda náleží náhrada nebo refundace.
Před spuštěním otestujte překrývání cyklů
Začněte s jedním fulfillment partnerem a sadou zásilek, která odpovídá jeho skutečnému způsobu odesílání objednávek. Zahrňte cyklus s více balíky, zneplatněný štítek, náhradu a starší zásilku, která je stále otevřená v době odeslání dalšího cyklu. Poté záměrně zopakujte duplicitní webhook a doručte starší událost po novější. Zkontrolujte záznam balíku, stránku objednávky zákazníka, pohled podpory a protokol oznámení. Test, který ověřuje pouze úspěšnou odpověď API, může přehlédnout nejdražší chybu: aktualizaci nesprávné objednávky nebo informování nesprávného zákazníka.
Sledujte selhání registrací, podíl způsobilých balíků, které byly úspěšně zaregistrovány, první skeny opožděné oproti očekávání a nepřiřazené aktualizace. Pokud sledujete latenci aktualizací, rozlišujte čas mezi událostí dopravce a jejím přijetím od času, který váš vlastní systém potřebuje ke zpracování. To vám pomůže rozhodnout, zda prověřit datový kanál dopravce, koncový bod webhooku nebo frontu ve vaší aplikaci.
Rozšiřte systém na další trasy, jakmile dokážete u každého balíku odpovědět na tři otázky: Ke kterému cyklu patří? Co naposledy nahlásil dopravce? Kdo zasáhne, pokud aktualizace chybí nebo je nesprávná? Pokud je některá odpověď nejasná, opravte mapování záznamů nebo pracovní postup pro výjimky dříve, než přidáte další pravidla pro oznámení.
Časté dotazy
Může sledovací API zákazníkům říct, kdy bude odeslán jejich další balíček předplatného?
Pro další plánované datum odeslání použijte rozvrh předplatného a fulfillment systém. Sledovací API slouží ke konkrétnímu balíku poté, co jsou k dispozici informace o sledování. Plánované datum odeslání, odhad doručení dopravce a potvrzené doručení jsou odlišné skutečnosti a měly by být označeny samostatně.
Co když sklad po odeslání e-mailu nahradí sledovací číslo?
Označte starý štítek jako nahrazený a propojte nové sledovací číslo se stejnou objednávkou. Pokud e-mail odkazuje na stránku sledování na úrovni objednávky, aktualizujte tuto stránku, aby zákazník našel aktivní balík bez potřeby původního odkazu dopravce. Pokud změna ovlivňuje informace, podle kterých musí zákazník jednat, odešlete opravu.
Co když fulfillment partner odešle sledovací čísla bez kódů dopravců?
Požádejte partnera o konzistentní pole dopravce nebo mapování jeho kódů přepravních služeb. Pokud vaše API nabízí rozpoznání dopravce, před spoléháním na něj ověřte, jak si vede se štítky partnera. Nejednoznačné shody odešlete ke kontrole místo výběru dopravce pouze podle sledovacího čísla.
Potřebují pozastavená nebo přeskočená předplatná záznamy sledování?
Pro cyklus, který se nikdy neodešle, není záznam balíku potřeba. Pokud je předchozí zásilka stále otevřená, pokračujte v jejím sledování, i když je předplatné pozastavené, přeskočené nebo zrušené. Stav předplatného řídí budoucí fulfillment; neříká vám, co se stalo s balíkem, který již opustil sklad.
Zdroje
- Sledovací API 17TRACK — přehled produktu pro integraci sledování balíků do podnikových systémů.
- Dokumentace sledovacího API 17TRACK — implementační reference pro registraci sledovacích čísel a přijímání dat o sledování.
- Dokumentace webhooků Stripe — reference pro obecné postupy webhooků, například zpracování duplicitních událostí a vyhýbání se předpokladům o pořadí doručení. Dodržujte vlastní pravidla poskytovatele sledování pro ověřování a potvrzování.


