Skip to main content
DomůBlogPrůvodciJak mohou platformy pro vrácení zboží využívat API pro sledování zásilek při vracení a výměnách

Jak mohou platformy pro vrácení zboží využívat API pro sledování zásilek při vracení a výměnách

17TRACK

Platformy pro vrácení zboží mohou využívat API pro sledování zásilek k propojení procesů vrácení a výměny s událostmi týkajícími se zásilek v reálném čase. API může platformě pomoci zjistit, kdy byl vytvořen štítek pro vrácení, sledovat pohyb zásilky v síti přepravce, rozpoznat události doručení nebo výjimky a spustit další provozní krok. Výsledkem je proces vrácení, kterému zákazníci snáze porozumí a který mohou obchodníci snadněji spravovat.

Jak mohou platformy pro vrácení zboží využívat API pro sledování zásilek při vracení zboží

Sledování nenahrazuje pravidla pro vrácení zboží, kontrolu ve skladu, refundace ani kontrolu zásob. Poskytuje údaje o zásilce, které těmto procesům umožňují fungovat s lepším načasováním a menším počtem manuálních kontrol.

Proč je viditelnost zásilek při vracení zboží důležitá

Standardní zásilka má obvykle jeden hlavní cíl: doručit objednávku kupujícímu. Vrácení nebo výměna může mít několik možných výsledků. Zásilka může být doručena do skladu, přijata externím zpracovatelským pracovištěm, přesměrována, zpožděna nebo označena jako doručená ještě před dokončením kontroly obchodníkem. Zákazníci také potřebují vědět, zda se jejich vrácená položka pohybuje, zatímco týmy podpory musí odpovídat na dotazy bez spoléhání na webové stránky přepravců nebo manuální vyhledávání zásilek.

API pro sledování poskytuje platformě pro vracení strukturovaný způsob získávání a normalizace informací o zásilkách od přepravců. V závislosti na dostupném API a datech přepravce může zahrnovat sledovací číslo, stav zásilky, časová razítka událostí, údaje o poloze, odhadované informace o doručení a zprávy o výjimkách. Přesná pole a frekvenci aktualizací je třeba ověřit v dokumentaci vybraného poskytovatele, nikoli předpokládat.

V případě procesu vrácení zboží v e-commerce nespočívá praktická hodnota pouze v zobrazení sledovacího čísla. Jde o využití událostí zásilky jako vstupů pro rozhodování, zprávy zákazníkům, správu případů a koordinaci skladu.

Hlavní události sledování v procesu vrácení nebo výměny

Platforma pro vracení zboží by měla mapovat události přepravce na vlastní provozní stavy. Terminologie přepravců není vždy jednotná, proto by integrace měla používat normalizovaný model stavů a současně uchovávat původní událost přepravce pro účely auditu a podpory.

Událost zásilkyMožná akce platformyHodnota pro zákazníka
Štítek vytvořenOtevřít záznam sledování a přiřadit jej k oprávnění k vrácení.Ukazuje, že pokyny k vrácení byly vydány, aniž by naznačoval, že se zásilka již pohybuje.
Přepravce zásilku přijal nebo provedl první skenSpustit měření doby přepravy a snížit nejistotu, zda zásilka vstoupila do sítě.Potvrzuje, že přepravce balík obdržel.
V přepravěAktualizovat časový plán vrácení a identifikovat zásilky, jejichž pohyb se zastavil.Poskytuje informace o průběhu bez nutnosti kontaktovat podporu.
Výjimka nebo zpožděníVytvořit upozornění, upravit očekávání nebo předat případ podpoře.Vysvětluje, proč vrácení nemusí dorazit podle původního očekávání.
DoručenoInformovat přijímající tým a zahájit kontrolu nebo proces výměny.Potvrzuje doručení na uvedené místo určení a zároveň objasňuje, že kontrola může stále čekat na provedení.

Tato mapování by měla zůstat oddělená od konečného rozhodnutí obchodníka o refundaci. Událost doručení znamená, že přepravce nahlásil doručení; sama o sobě nedokazuje, že byla vrácena správná položka, že není poškozená ani že vrácení splňuje pravidla obchodníka.

Jak propojit API pro sledování s provozem vrácení zboží

1. Vytvoření záznamu vratné zásilky

Po schválení vrácení by platforma měla vytvořit záznam, který propojí oprávnění k vrácení s původní objednávkou, zákazníkem, položkou, místem určení a identifikátorem zásilky. Pokud se jedná o výměnu, měl by záznam také identifikovat náhradní objednávku nebo akci související s vyřízením. Toto propojení brání tomu, aby byla událost sledování považována za izolovanou aktualizaci zásilky.

Platforma by měla rozlišovat mezi původní odchozí zásilkou a vratnou zásilkou. Mohou využívat různé přepravce, úrovně služeb, sledovací čísla a místa doručení. Jednoduchý datový model může zahrnovat ID objednávky, ID vrácení, případně ID výměny, přepravce, sledovací číslo, směr, aktuální normalizovaný stav, čas poslední události a nezpracovanou událost přepravce.

2. Odeslání sledovacího čísla do API

Integrace odešle přepravce a sledovací číslo do služby sledování v souladu s požadavky poskytovatele na ověřování, požadavky a identifikaci přepravce. Pokud systém nedokáže přepravce spolehlivě identifikovat, měl by použít schválenou metodu detekce nebo si vyžádat přepravce od uživatele či obchodníka. Nesprávné přiřazení přepravce může vést ke zpožděným nebo nepřesným výsledkům.

V této fázi by platforma měla zaznamenat, kdy byl požadavek na sledování vytvořen a zda API zásilku přijalo, odmítlo nebo ji zatím nedokázalo identifikovat. Přijetí požadavku API není totéž jako sken přepravce. Tyto stavy by neměly být v uživatelském rozhraní spojovány.

3. Příjem aktualizací prostřednictvím dotazování nebo webhooků

Poskytovatelé sledování běžně podporují jednu nebo více metod získávání pozdějších událostí. Platforma může v závislosti na dokumentaci poskytovatele a požadované prodlevě dotazovat aktualizace, přijímat oznámení push nebo používat kombinaci obou metod. Dokumentace 17TRACK API je vhodným místem k ověření aktuálního modelu integrace, podporovaných vzorců požadavků a implementačních požadavků.

Ať už se použije kterákoli metoda, platforma by měla zajistit idempotentnost aktualizací. Stejná událost může být doručena více než jednou, může přijít mimo pořadí nebo ji může přepravce upravit. Pokud je k dispozici identifikátor události, uložte jej, porovnávejte časová razítka událostí a uchovávejte historii namísto přepisování každého předchozího stavu.

4. Normalizace událostí do obchodních stavů

Stavy přepravců jsou navrženy pro přepravní operace, nikoli nutně pro rozhodování o vrácení zboží. Platforma pro vracení může události mapovat do stavů, jako jsou štítek vydán, čeká se na předání, v přepravě, zpožděno, doručeno, výjimka při doručení a vyžadováno šetření. Mapování by mělo zachovávat nejistotu. Například stav „doručeno“ může případ přesunout do stavu „čeká na kontrolu“, nikoli přímo do stavu „refundace schválena“.

Obchodní pravidla by měla zohledňovat také chybějící nebo rozporné události. Zásilka bez nového skenu po několik dní může vyžadovat interní upozornění, ale neměla by být automaticky považována za ztracenou, pokud takový závěr nepodporují pravidla obchodníka a postup přepravce.

5. Spouštění provozních akcí a akcí pro zákazníky

Jakmile jsou k dispozici normalizované události, může platforma uplatnit pravidla. První sken přepravcem může zákazníkovi odeslat potvrzení. Výjimka při doručení může vytvořit úkol pro podporu. Událost doručení může upozornit sklad pro vrácené zboží, aby zásilku vyhledal. U výměn se může obchodník rozhodnout, zda náhradní položku odešle po prvním skenu, po doručení nebo po kontrole. Toto rozhodnutí závisí na riziku, zásobách a pravidlech; údaje o sledování jej mohou podpořit, ale nemohou jej určit univerzálně.

Oznámení by měla používat jednoduchý jazyk a uvádět další očekávaný krok. Zákazník by měl být schopen rozlišit mezi „přepravce vaše vrácení převzal“, „obchodník vaše vrácení zkontroloval“ a „refundace byla vystavena“. Jde o různé události, za které odpovídají různé části procesu.

Využití údajů o sledování při výměnách

Procesy výměny mají další závislost: náhradní položku může být nutné odeslat dříve, než vrácená položka dokončí svou cestu. Platforma pro vracení zboží s podporou sledování může spravovat dva související záznamy zásilek: příchozí vratnou zásilku a odchozí náhradní zásilku. Jejich propojení poskytne pracovníkům podpory úplnější přehled o výměně.

Užitečná pravidla pro výměnu mohou zahrnovat:

  • Nepopisujte náhradní položku jako odeslanou, dokud systém vyřízení nepotvrdí tento stav.
  • Zobrazujte časové osy vrácení a náhradní zásilky odděleně, i když jsou součástí jednoho případu výměny.
  • Upozorněte podporu, pokud je vratná zásilka zpožděná, ale náhradní zásilka již byla doručena.
  • Rozhodnutí o způsobilosti zákazníka ponechte oddělené od stavu doručení přepravce.
  • Zaznamenejte, která událost způsobila automatickou akci, aby ji tým mohl auditovat nebo vrátit.

Tento přístup omezuje častý zdroj nejasností: považování doručení náhradní zásilky za důkaz, že původní vrácení bylo dokončeno. Obě zásilky se mohou pohybovat nezávisle a mohou vyžadovat odlišná řešení.

Úloha 17TRACK

17TRACK poskytuje specializované Tracking API pro integrace vývojářů a také nabízí 17RETURNS jako produkt zaměřený na vracení zboží. Tyto produkty by měly být posuzovány podle role, kterou musí obchodník zajistit. Tracking API je relevantní, když platforma pro vracení potřebuje údaje o zásilkách ve vlastním pracovním postupu nebo aplikaci. Produkt pro správu vrácení je relevantní, když podnik potřebuje širší proces pro zahájení, organizaci a správu vrácení.

Oficiální materiály 17TRACK by měly být před implementací použity k ověření aktuálního chování API, podporovaných přepravců a podrobností integrace, požadavků na ověřování a případných omezení konkrétního produktu. Produktová stránka 17RETURNS a nabídka 17RETURNS na Shopify poskytují kontext produktu, zatímco dokumentace API je vhodnějším zdrojem pro rozhodování o technické integraci. Obchodník, který již provozuje vlastní platformu pro vracení, může API používat jako datovou vrstvu; obchodník hledající spravovaný proces vracení by měl posoudit samotný produkt pro vracení, nikoli předpokládat, že tyto funkce poskytuje pouze API.

Kontroly implementace před spuštěním

Ověření konceptu by mělo využívat skutečné scénáře vrácení, nikoli pouze úspěšný příklad zásilky v přepravě. Otestujte alespoň jedno vnitrostátní vrácení, jedno přeshraniční vrácení, pokud je pro podnik relevantní, zpožděnou zásilku, výjimku při doručení, doručený balík, duplicitní aktualizaci a sledovací číslo, které nelze okamžitě identifikovat.

Implementační tým by měl potvrdit následující:

  • Kteří přepravci a služby jsou pro trasy vrácení obchodníka vyžadováni a jak jsou tito přepravci identifikováni.
  • Které události jsou pro jednotlivé relevantní přepravce dostupné a zda se podrobnosti událostí liší podle místa určení.
  • Jak často se aktualizace obnovují a jak platforma řeší chyby API, limity požadavků a dočasné výpadky.
  • Jak jsou ukládány a sjednocovány duplicitní, pozdní, chybějící nebo události mimo pořadí.
  • Které akce jsou automatické a které vyžadují kontrolu člověkem.
  • Jak jsou oznámení zákazníkům překládána, opatřována značkou, pozastavována a auditována.
  • Jak jsou osobní údaje a data o zásilkách chráněny, uchovávány a odstraňovány podle požadavků obchodníka.
  • Jak systém rozlišuje doručení přepravcem od převzetí ve skladu, kontroly, schválení, refundace a vyřízení výměny.

Provozní odpovědnost je stejně důležitá jako technické propojení. Logistické týmy by měly definovat význam událostí, týmy podpory zprávy pro zákazníky, finanční týmy kontrolu refundací a skladové týmy postup po doručení. Bez těchto rozhodnutí může i technicky úspěšné připojení API vytvářet zavádějící automatizaci.

Praktický rámec rozhodování

API pro sledování zásilek použijte, když proces vrácení závisí na včasných událostech přepravce, podnik potřebuje propojit více systémů nebo zákazníci a pracovníci podpory potřebují sdílený přehled o pohybu zásilky. O platformě pro správu vrácení uvažujte, když širší problém zahrnuje konfiguraci pravidel, oprávnění k vrácení, pracovní postupy štítků, komunikaci se zákazníky, naložení se zásobami a reporting. V některých provozech obě vrstvy spolupracují: systém vrácení spravuje případ, zatímco služba sledování poskytuje normalizované události zásilky.

Nejlepší návrh považuje sledování za důkaz v rámci většího stavového automatu. Platformě říká, co přepravce nahlásil, kdy to nahlásil a ke které zásilce to patří. Obchodní pravidla pak rozhodnou, co se má stát dál. Toto oddělení činí vracení a výměny transparentnějšími, aniž by slibovalo míru jistoty, kterou údaje přepravce nemohou poskytnout.

Často kladené otázky

Může API pro sledování potvrdit, že náleží refundace?

Ne. Může nahlásit události zásilky, jako je převzetí, pohyb, výjimka nebo doručení, pokud jsou tyto události dostupné. Způsobilost k refundaci obvykle závisí také na pravidlech vrácení, stavu položky, kontrole, kontrolách podvodů a schválení obchodníkem.

Má doručené vrácení automaticky spustit refundaci?

Ne nutně. Doručení znamená, že přepravce nahlásil, že zásilka dorazila na místo určení. Obchodník může před schválením refundace stále potřebovat ověřit položku, množství, stav a oprávnění k vrácení.

Je pro sledování vrácení lepší dotazování, nebo doručování prostřednictvím webhooků?

Žádná metoda není univerzálně lepší. Volba závisí na metodách podporovaných poskytovatelem, požadované rychlosti aktualizací, náročnosti implementace a toleranci ke zpožděným oznámením. Některé platformy používají aktualizace push s pravidelným sjednocováním, aby zachytily zmeškané události.

Jak by měla platforma pro výměny sledovat dvě zásilky?

Příchozí vratnou zásilku a odchozí náhradní zásilku ukládejte jako samostatné záznamy zásilek propojené se stejným případem výměny. Jejich stavy zobrazujte nezávisle a definujte pravidla, která zabrání záměně stavu jedné zásilky za dokončení druhé.

Co je třeba otestovat před připojením API pro sledování?

Otestujte úspěšné sledování, zpožděné skeny, výjimky, duplicitní události, nesprávné nebo neznámé informace o přepravci, přeshraniční případy, pokud jsou relevantní, a výpadky API. Otestujte také zprávy pro zákazníky a postupy kontroly člověkem, které následují po každé události.

Zdroje