Ako platformy na spracovanie vrátení používajú API na sledovanie zásielok na sledovanie vratných zásielok
Platformy na spracovanie vráteného tovaru používajú API na sledovanie zásielok na prepojenie schváteného vrátenia s jeho fyzickou zásielkou. Platforma zaznamenáva dopravcu a identifikátor sledovania vrátenej zásielky, získava udalosti sledovania a používa ich na zobrazenie priebehu alebo na vyžiadanie prevádzkovej kontroly. API poskytuje prehľad o zásielke; platforma na spracovanie vráteného tovaru však naďalej spravuje požiadavku na vrátenie, rozhodnutia podľa pravidiel, kontrolu v sklade a proces vrátenia peňazí.

Pre tím zodpovedný za prevádzku vráteného tovaru alebo produktový tím nie je užitočná otázka jednoducho to, či API dokáže zobraziť stav sledovania. Dôležité je, či integrácia dokáže spoľahlivo identifikovať správnu vrátenú zásielku, interpretovať prijaté udalosti a zabrániť tomu, aby aktualizácia sledovania spustila nesprávnu správu pre zákazníka alebo nesprávnu akciu vrátenia peňazí.
Ako sledovanie zapadá do procesu vrátenia
Vrátenie sa začína ako obchodný záznam: zákazník požiada o odoslanie položky späť a obchodník rozhodne, čo schváli. Záznam sledovania opisuje inú vec: pohyb balíka. Prepojenie týchto dvoch záznamov umožňuje platforme odpovedať na otázky, napríklad či zákazník balík odovzdal, či smeruje k miestu vrátenia a či bola nahlásená udalosť doručenia.
Toto prepojenie musí byť explicitné. Objednávka môže obsahovať viacero položiek, zákazník môže v rámci jednej objednávky uskutočniť viac vrátení a jedno vrátenie môže zahŕňať viac balíkov. Pôvodné číslo sledovania odosielanej zásielky sa nesmie zameniť za číslo sledovania vrátenej zásielky. Praktický dátový model uchováva samostatné identifikátory objednávky, autorizácie vrátenia, vráteného balíka, dopravcu a záznamu sledovania a následne medzi nimi ukladá vzťahy.
Sledovanie má tiež jasné hranice. Udalosť doručenia od dopravcu môže naznačovať, že balík dorazil na adresu alebo do zariadenia. Nepotvrdzuje však, že sklad prijal očakávanú položku, že položka prešla kontrolou alebo že je potrebné vrátiť peniaze. Tieto rozhodnutia si vyžadujú vlastné dôkazy a pravidlá.
Priebeh integrácie od autorizácie po prijatie
1. Vytvorte záznam o vrátení ešte pred sledovaním balíka
Platforma najprv zaznamená požiadavku, príslušné položky, autorizované miesto určenia a povolené riešenie. Ak sa pri vrátení používa štítok vystavený obchodníkom, platforma môže priradiť identifikátor sledovania zo štítku k vrátenému balíku. Ak zákazník zabezpečí prepravu samostatne, platforma môže pred začatím sledovania potrebovať spôsob, ako zhromaždiť a overiť dopravcu a číslo sledovania.
Toto je prvý bod, v ktorom kvalita údajov ovplyvňuje viditeľnosť. Číslo sledovania bez spoľahlivého prepojenia balíka s vrátením môže vytvoriť úplne presnú aktualizáciu od dopravcu, ale pri nesprávnom vrátení. Tímy by mali tiež rozhodnúť, ako budú riešiť opravené čísla sledovania, náhradné štítky a zákazníkov, ktorí odošlú rovnaký identifikátor dvakrát.
2. Zaregistrujte zásielku alebo ju vyhľadajte
Platforma odošle poskytovateľovi sledovania potrebné informácie na vytvorenie alebo získanie záznamu o zásielke. Presné polia požiadavky a poradie závisia od dokumentácie daného poskytovateľa. Minimálne musí implementácia spoľahlivo priradiť referenciu zásielky poskytovateľa k vlastnému záznamu vráteného balíka. Ak je potrebná identifikácia dopravcu, platforma by mala potvrdiť, ako sa riešia nejednoznačné alebo nepodporované údaje o dopravcovi, a nemala by predpokladať, že samotné číslo sledovania vždy stačí.
Uchovávajte odpoveď poskytovateľa, chyby integrácie a dátum, keď platforma začala sledovanie. Prijatá požiadavka nemusí byť dôkazom, že dopravca balík naskenoval. Pred prvým skenom môže stav zobrazený zákazníkovi uvádzať, že sledovanie čaká na aktualizáciu, a nie že vrátenie je v preprave.
3. Prijímajte aktualizácie bez straty pôvodnej udalosti
V závislosti od API môžu aktualizácie prichádzať prostredníctvom webhooku, získavať sa pravidelným dotazovaním alebo používať inú zdokumentovanú metódu. Integrácia by mala uchovávať nespracované informácie o udalosti od poskytovateľa spolu so zjednodušeným stavom zobrazeným na platforme. Užitočné polia môžu zahŕňať opis udalosti, čas udalosti, miesto, ak je uvedené, referenciu dopravcu a čas, keď platforma aktualizáciu prijala.
Tieto dva časové údaje odpovedajú na rôzne otázky. Časová pečiatka udalosti opisuje, kedy sa podľa hlásenia aktivita uskutočnila; časová pečiatka prijatia ukazuje, kedy sa o nej platforma dozvedela. Oneskorenia, opakované doručenia a správy v nesprávnom poradí môžu inak spôsobiť, že vrátenie bude vyzerať, akoby sa vracalo späť. Ak poskytovateľ ponúka identifikátory udalostí, používajte ich na odstránenie duplicít. Ak ich neposkytuje, definujte opatrnú metódu deduplikácie a otestujte ju na skutočných vzorkách integrácie.
4. Preveďte udalosti sledovania na stavy vrátenia
Opisy udalostí dopravcu nie sú pravidlami pre vrátenie. Platforma ich zvyčajne mapuje na menšiu skupinu prevádzkových stavov, napríklad čaká sa na odovzdanie, v preprave, doručenie nahlásené alebo vyžaduje kontrolu. Mapovanie by malo počítať s neznámymi udalosťami a nemalo by každú nerozpoznanú aktualizáciu potichu považovať za pokrok.
Prvý sken dopravcu môže napríklad stačiť na informovanie zákazníka, že jeho balík je zrejme na ceste. Nemusí však stačiť na prisľúbenie dátumu vrátenia peňazí. Udalosť doručenia môže skladu pomôcť uprednostniť zodpovedajúci balík, ale pravidlo vrátenia peňazí môže stále vyžadovať fyzické prijatie a kontrolu. Tímy by mali tieto rozdiely zapracovať do pracovného postupu ešte pred prepojením stavov s automatizovanými akciami.
5. Uzavrite cyklus dôkazmi zo skladu
Po doručení balíka môže sklad alebo zariadenie na spracovanie vráteného tovaru naskenovať interný čiarový kód, priradiť balík k autorizácii vrátenia, skontrolovať jeho obsah a zaznamenať výsledok. Ide o udalosti správy vráteného tovaru, nie o udalosti sledovania dopravcu. Ak sú oba systémy prepojené, platforma môže zobraziť užitočnejšiu postupnosť: pohyb zásielky, doručenie nahlásené dopravcom, prijatie balíka zariadením a dokončenie spracovania.
Táto postupnosť tiež pomáha riešiť výnimky. Ak sledovanie uvádza doručenie, ale nezobrazuje sa prijatie v sklade, pracovník môže pred komunikáciou so zákazníkom preveriť miesto určenia, udalosť dopravcu, front na príjem v zariadení a identifikátor balíka. Ak sklad prijme balík bez použiteľnej histórie sledovania, fyzické prijatie možno stále zaznamenať; chýbajúce údaje o sledovaní by nemali vymazať nezávislé dôkazy zo skladu.
Čo môže a nemôže API na sledovanie zásielok platforme oznámiť
API na sledovanie zásielok môže sprístupniť pohyb nahlásený dopravcom inej aplikácii v závislosti od zdokumentovaného pokrytia poskytovateľa, dostupnosti udalostí a správania integrácie. Samo osebe však nemôže overiť obsah vrátenia ani rozhodnúť, či boli splnené pravidlá obchodníka. Pred prvým skenom dopravcu tiež nemusí mať k dispozícii žiadnu aktualizáciu.
Toto rozlíšenie je dôležité pri navrhovaní automatizácie. Stavy by sa mali považovať za signály s definovaným použitím, nie za vzájomne zameniteľné dôkazy. Udalosť odovzdania dopravcovi môže spustiť oznámenie o priebehu. Udalosť doručenia môže vytvoriť úlohu pre sklad. Potvrdené prijatie v sklade môže posunúť vrátenie ku kontrole. Rozhodnutie o vrátení peňazí alebo výmene by sa malo riadiť skutočnými pravidlami obchodníka a dôkazmi, ktoré tieto pravidlá vyžadujú.
Rovnakú hranicu by mal odrážať aj jazyk určený zákazníkom. „Dopravca uvádza, že vaše vrátenie bolo doručené“ je presnejšie než „Vaše vrátenie peňazí bolo schválené“, ak ešte neprebehla kontrola. Rovnako „Čakáme na prvú aktualizáciu od dopravcu“ je informatívnejšie než nevysvetlená prázdna stránka sledovania.
Kontroly návrhu, ktoré zabraňujú chybám pri sledovaní vrátení
- Priraďujte na úrovni balíka. Testujte rozdelené vrátenia, viac balíkov v rámci jednej autorizácie, náhradné štítky a opakované vrátenia v jednej objednávke. Každý balík potrebuje jednoznačné prepojenie s vlastným záznamom sledovania.
- Definujte prioritu stavov. Rozhodnite, čo sa stane, ak staršia udalosť o preprave príde po udalosti doručenia. Uchovajte históriu udalostí bez automatického zníženia zobrazeného stavu vrátenia.
- Oddeľte chyby poskytovateľa od mlčania dopravcu. Zlyhanie autentifikácie, zamietnutá požiadavka alebo neúspešné spracovanie webhooku sú problémy integrácie. Skutočnosť, že zatiaľ neprebehol sken, je iná podmienka a mala by sa komunikovať odlišne.
- Počítajte s duplicitami a opakovaniami. Aktualizácia doručenia sa môže opakovať. Zaistite bezpečné opakovanie prijímania udalostí a zabráňte odoslaniu rovnakej správy zákazníkovi alebo vytvoreniu rovnakej úlohy dvakrát.
- Chráňte údaje zákazníkov a zásielok. Obmedzte prístup k prihlasovacím údajom na sledovanie, uchovávajte iba údaje potrebné pre pracovný postup a pred spustením skontrolujte zdokumentované požiadavky poskytovateľa na autentifikáciu a bezpečnosť.
- Uchovajte manuálnu cestu. Niektoré vrátenia budú mať neúplné, oneskorené alebo nesprávne priradené údaje sledovania. Pracovníci musia mať možnosť preskúmať a opraviť záznam vrátenia bez vymýšľania udalostí dopravcu.
Tieto kontroly sú najužitočnejšie, keď sa testujú na konkrétnych scenároch, nie iba na jednej úspešnej zásielke. Malá testovacia množina by mala zahŕňať chýbajúci prvý sken, nesprávne číslo sledovania, duplicitnú udalosť, udalosť v nesprávnom poradí, hlásenie o doručení bez prijatia v sklade a prijatie v sklade bez zodpovedajúceho hlásenia o doručení. Pre každý prípad by sa mala určiť očakávaná správa zákazníkovi a akcia pracovníka.
Výber API a definovanie rozdelenia práce
Začnite trasami vrátenia a dopravcami, ktorých podnik skutočne používa. Potom v aktuálnej dokumentácii poskytovateľa overte, ako funguje registrácia zásielok, ktoré identifikátory sú potrebné, ako sa doručujú aktualizácie, aké údaje o udalostiach sú dostupné a ako sa riešia chyby a opakovania. Relevantných dopravcov a trasy vrátenia potvrďte priamo namiesto odvodzovania z všeobecného vyhlásenia o pokrytí dopravcov. Pred spoliehaním sa na namapované stavy pri komunikácii so zákazníkmi alebo automatizácii testujte reprezentatívne zásielky.
17TRACK zverejňuje prehľad Tracking API a dokumentáciu API; jeho stránka produktu 17RETURNS sa týka oblasti správy vráteného tovaru. Ide o relevantné východiskové body pre tím, ktorý posudzuje viditeľnosť sledovania spolu s procesom vrátenia. Existencia oboch produktových oblastí nie je dôkazom, že konkrétna integrácia, dopravca, udalosť alebo automatizované pravidlo vrátenia peňazí sú dostupné. Presný pracovný postup overte v aktuálnej dokumentácii a v prípade potreby u poskytovateľa.
Pri obstarávaní alebo overovaní konceptu požiadajte tím zodpovedný za pravidlá vrátenia a prevádzku skladu, aby spolu s vývojármi skontroloval mapovanie stavov. Vývojári môžu potvrdiť, či API poskytuje použiteľné udalosti; prevádzka môže potvrdiť, či tieto udalosti odôvodňujú navrhovanú akciu. Úspešná integrácia je taká, ktorá pomáha pracovníkom a zákazníkom sledovať balík a zároveň zachováva autorizáciu, prijatie, kontrolu a vyriešenie ako samostatné kroky.
Často kladené otázky
Potrebuje vrátenie iné číslo sledovania než pôvodná objednávka?
Platforma by mala uchovávať samostatné záznamy o odoslanej a vrátenej zásielke. Vrátenie sa zvyčajne prepravuje ako samostatná zásielka, preto musí byť jeho identifikátor sledovania priradený k vrátenému balíku, nie automaticky považovaný za identifikátor odoslanej zásielky pôvodnej objednávky. Dostupné identifikátory závisia od spôsobu odoslania vrátenia.
Môže API na sledovanie potvrdiť, že treba vrátiť peniaze?
Nie. Žiadna samostatná udalosť sledovania nepotvrdzuje, že vrátená položka spĺňa podmienky obchodníka na vrátenie peňazí. Platforma môže používať udalosti dopravcu ako vstupy do pracovného postupu, ale oprávnenosť na vrátenie peňazí môže závisieť aj od autorizácie, fyzického prijatia, kontroly a pravidiel obchodníka.
Čo ak sledovanie ukazuje doručenie, ale sklad balík nemôže nájsť?
Uchovajte udalosť doručenia nahlásenú dopravcom a záznam o prijatí v sklade oddelene. Skontrolujte nahlásené miesto určenia a podrobnosti udalosti, potom preskúmajte proces príjmu a priraďovania v zariadení. Doručenie dopravcom potichu nepremeňte na potvrdené prijatie v sklade.
Sú webhooky na sledovanie vrátených zásielok povinné?
Nie nevyhnutne. Metóda aktualizácie závisí od zvoleného poskytovateľa a jeho zdokumentovaných možností. Ak sú webhooky dostupné, počítajte s autentifikáciou, opakovaniami, duplicitnými doručeniami a chybami spracovania. Ak sa používa dotazovanie, zvoľte interval a pravidlo ukončenia, ktoré vyhovujú pracovnému postupu vrátenia a požiadavkám poskytovateľa.
Kedy by mal zákazník vidieť prvú aktualizáciu sledovania?
Závisí to od toho, kedy dopravca nahlási udalosť a kedy ju integrácia prijme. Vytvorenie štítku alebo registrácia zásielky môže prebehnúť pred skenom dopravcu. Tento rozdiel zobrazte jasne, aby zákazníci nepovažovali čakajúcu prvú aktualizáciu za potvrdený pohyb.


