Skip to main content
DomůBlogPrůvodciJak poskytovatelé poprodejních služeb využívají údaje o sledování k obsluze více značek pomocí jediného API

Jak poskytovatelé poprodejních služeb využívají údaje o sledování k obsluze více značek pomocí jediného API

17TRACK

Poskytovatelé poprodejních služeb mohou obsluhovat více značek prostřednictvím jediné integrace sledovacího API, a to centrálním shromažďováním aktualizací zásilek, přiřazením každé zásilky ke správné značce a objednávce a poskytováním prostředí specifického pro danou značku prostřednictvím vlastních kanálů každého klienta. Sdílené připojení zjednodušuje shromažďování údajů o sledování; neodstraňuje však potřebu samostatných zákaznických údajů, pravidel zasílání zpráv, oprávnění a servisních pracovních postupů pro každou značku.

Jak poskytovatelé poprodejních služeb využívají údaje o sledování

Tento model je užitečný pro agentury, platformy zákaznické podpory, partnery zajišťující plnění objednávek a další poskytovatele, kteří jménem několika obchodníků spravují komunikaci o doručení. Praktická otázka nezní jednoduše, zda jedno API dokáže vrátit stav sledování. Jde o to, zda poskytovatel dokáže tento stav proměnit ve spolehlivou a vhodně označenou akci, aniž by zobrazil údaje jednoho klienta jinému.

Co sdílené API skutečně dělá

Sledovací API poskytuje poskytovateli služby programový způsob, jak odesílat nebo vyhledávat identifikátory zásilek a získávat informace o jejich sledování. Namísto vytváření samostatné integrace s přepravci pro každého obchodníka může poskytovatel zpřístupnit údaje o sledování své vlastní aplikaci prostřednictvím společného připojení k nadřazené službě. Aplikace poskytovatele poté určí, které značce zásilka patří a co s těmito informacemi provést.

Toto rozlišení je důležité. Jedno sledovací API není totéž co jeden sdílený zákaznický účet, jedna sledovací stránka nebo jedna šablona upozornění. Integrace s nadřazenou službou řeší shromažďování údajů. Poskytovatel služby je i nadále odpovědný za svůj navazující produkt: registraci obchodníků, přiřazování objednávek, jazyk komunikace se zákazníky, řízení přístupu, nástroje podpory a záznamy o tom, co bylo komunikováno.

Funkční architektura má tři vrstvy. První, vstupní vrstva přijímá referenci zásilky a získává aktualizace sledování. Druhá, interní záznam zásilky propojuje tyto aktualizace se správným obchodníkem, objednávkou, přepravcem a příjemcem. Třetí, prezentační vrstva používá pravidla obchodníka k rozhodnutí, zda aktualizovat stránku objednávky, upozornit pracovníka podpory nebo odeslat zákazníkovi zprávu. Oddělení těchto vrstev usnadňuje přidání další značky bez nutnosti přepracování sledovacího připojení.

Sledujte jednu zásilku od registrace až po akci zákazníka

Představte si poskytovatele, který spravuje aktualizace doručení pro dva nesouvisející internetové obchody. Oba obchody poskytovateli odesílají údaje o zásilkách, každý záznam však musí obsahovat identifikátor tenanta: jednoznačný interní klíč poskytovatele pro značku, které zásilka patří. Poskytovatel také potřebuje dostatek informací k přiřazení zásilky k objednávce. Samotné sledovací číslo nemusí být bezpečným globálním klíčem, protože zásilky mohou využívat různé přepravce, znovu použitá identifikační čísla nebo opravy původních údajů objednávky.

  1. Registrace zásilky. Přijměte identifikátor značky, referenci objednávky, sledovací číslo a další povolené údaje potřebné k přiřazení. Před vyžádáním údajů o sledování vstup ověřte. Přihlašovací údaje a kontaktní informace zákazníků ukládejte, pokud je to praktické, odděleně od obecných záznamů událostí sledování.
  2. Shromáždění a uchování zdrojové aktualizace. Získejte informace o sledování prostřednictvím nadřazeného API pomocí jeho zdokumentovaných metod. Pokud jsou k dispozici, uchovejte zdrojový stav, popis události, časové razítko a místo. Nenahrazujte původní událost pouze zjednodušeným štítkem; pracovníci podpory mohou při vyšetřování výjimky potřebovat původní znění.
  3. Pečlivá normalizace. Mapujte zdrojové události do malé interní sady stavů, například na cestě, doručování, doručeno nebo výjimka. Původní událost uchovejte spolu s tímto mapováním. Obecný stav je užitečný pro automatizaci, ale může skrýt rozdíly důležité pro zákazníka nebo pracovníka podpory.
  4. Použití pravidel značky. Jeden obchodník může chtít e-mail o doručování, zatímco jiný pouze aktualizaci stránky objednávky. Způsobilost určete podle konfigurace značky, komunikačních preferencí zákazníka, aktuálnosti události a historie již odeslaných zpráv.
  5. Zaznamenání výsledku. Uložte, která událost vyvolala kterou akci, která zásada značky byla použita a zda bylo doručení do navazujícího kanálu úspěšné. Získáte tak stopu pro řešení duplicitních upozornění a stížností zákazníků.

Stejný stav z nadřazené služby proto může u různých značek vést k odlišným akcím. To je smyslem modelu sdílené služby: centralizovat shromažďování a provozní údržbu a současně zachovat vztah každého obchodníka se zákazníky.

Rozhodnutí o návrhu, která určují, zda bude řešení škálovat

Výslovně určete vlastnictví tenanta

Každá zásilka, událost, vazba na objednávku, pravidlo upozornění a odkaz určený zákazníkovi by měly odkazovat na konkrétního tenanta. Vlastnictví tenanta kontrolujte při vstupu údajů do systému a znovu při jejich načítání aplikací nebo pracovníkem podpory. Stránka označená značkou obchodníka by neměla spoléhat pouze na sledovací číslo při určování, který zákaznický záznam zobrazit. Přístup by měl být omezen podle ověřeného obchodníka nebo vhodně vymezeného zákaznického odkazu.

Rozdělte přihlašovací údaje a oprávnění podle skutečného modelu účtů nabízeného nadřazeným poskytovatelem a smluvního vztahu s každým obchodníkem. Jediná technická integrace automaticky neuděluje oprávnění sdružovat všechny údaje obchodníků ani neposkytuje každému klientovi stejný přehled. Zdokumentujte, kdo může registrovat zásilky, načítat události, exportovat záznamy a měnit nastavení upozornění.

Považujte události sledování za aktualizace, nikoli za zaručené příkazy

Informace o sledování mohou dorazit se zpožděním, v nesprávném pořadí nebo mohou obsahovat opravu. Systém, který odešle novou zprávu pokaždé, když načte událost, riskuje duplicitní nebo zavádějící e-maily. Pokud ji zdroj poskytuje, použijte stabilní klíč události; v opačném případě definujte zdokumentované pravidlo deduplikace s využitím dostupných polí zásilky a události. Okamžik, kdy poskytovatel aktualizaci zaznamenal, ukládejte odděleně od času události uvedeného zdrojem.

Než předpokládejte, že každá zásilka prochází stejnou posloupností stavů. Výjimka může být později vyřešena a událost s pozdějším časem přijetí může popisovat dřívější fyzické skenování. Před použitím stavu ke spuštění příslibu nebo eskalace rozhodněte, jak aplikace zpracuje zastaralé, konfliktní nebo chybějící informace. U tvrzení určeného zákazníkovi, jako je doručení, zobrazte podpůrnou událost, místo abyste naznačovali, že interní štítek dokazuje více, než uvádí zdrojový záznam.

Naplánujte dotazování, zpětná volání a řešení selhání

Strategie aktualizací poskytovatele musí vycházet ze skutečné dokumentace nadřazeného API. Pokud jsou pro příslušný účet a typ události dostupná zpětná volání, aplikace stále musí ověřovat příchozí požadavky, zpracovávat opakované pokusy a bezpečně zvládat duplicitní doručení. Pokud používá dotazování, potřebuje plán, který respektuje zdokumentované limity a zabraňuje zbytečným opakovaným požadavkům. Ani jeden z těchto přístupů neodstraňuje potřebu obnovy po vynechané aktualizaci nebo selhání navazujícího upozornění.

Správně je třeba interpretovat také odpovědi HTTP. Přijatý požadavek by například neměl být považován za důkaz, že zásilka již obdržela novou událost sledování. Specifikace HTTP Semantics definuje významy stavových kódů; vlastní dokumentace poskytovatele sledování musí stanovit, co konkrétní odpověď API znamená pro registraci nebo načtení zásilky. Vytvořte monitorování technických i obchodních selhání, například platné odpovědi, kterou nelze přiřadit k objednávce.

Co ověřit před výběrem sledovacího API

Pro poskytovatele obsluhujícího více značek je nejlepší integrace ta, která zapadá do celého provozního modelu, nikoli pouze ta, která vrátí ukázkový výsledek sledování. Požádejte potenciální poskytovatele, aby ukázali, jak jejich zdokumentované API podporuje zásilky a pracovní postupy, které skutečně zpracováváte. Krátký konceptuální test by měl zahrnovat více obchodníků, přepravce, které tito obchodníci používají, a alespoň jeden neúplný nebo problematický záznam zásilky.

  • Příjem zásilky: Jaké identifikátory a údaje o přepravci jsou vyžadovány? Jak se hlásí neplatná nebo duplicitní odeslání? Může aplikace k požadavku přiřadit vlastní objednávku nebo referenci tenanta, nebo musí toto přiřazení zůstat výhradně v její databázi?
  • Doručení aktualizací: Načítají se aktualizace, odesílají se, nebo se pro příslušný tarif používají oba způsoby? Jaké jsou zdokumentované limity požadavků, očekávání ohledně opakování, metody ověřování a chybové odpovědi? Ověřte tyto informace v aktuální dokumentaci, místo abyste předpokládali, že funkce popsaná na vysoké úrovni je dostupná v každé konfiguraci.
  • Kvalita událostí: Která původní pole jsou vracena a jak je třeba interpretovat časová razítka, názvy přepravců, místa a události související s doručením? Testujte na skutečných příkladech zásilek obchodníků, které registrujete.
  • Provoz tenantů: Dokáže poskytovatel ve vlastním systému oddělit přístup, účtování využití a šetření podpory podle klienta? Pokud potřebuje oddělení účtů u nadřazené služby, potvrďte před schválením architektury, zda a jak je podporováno.
  • Zpracování údajů: Jaké zákaznické nebo zásilkové informace musí být odesílány nadřazené službě? Požadavky na uchovávání, mazání, zabezpečení a smluvní podmínky projednejte se stranami odpovědnými za tyto údaje. Pokyny k zabezpečení API, včetně OWASP API Security Project, poskytují užitečný základ pro posouzení rizik autorizace a přístupu.

Stránka 17TRACK Tracking API a dokumentace pro vývojáře jsou vhodnými výchozími body pro poskytovatele, který vyhodnocuje sdílenou integraci sledování. Dokumentaci považujte za autoritativní zdroj podrobností implementace a před vytvořením služby pro více klientů ověřte požadované metody, podporované scénáře zásilek, podmínky přístupu a obchodní ujednání pro zamýšlené použití. Samotná veřejná stránka API nepotvrzuje, že jsou podporovány všechny požadované pracovní postupy obchodníků.

Kde by si měl poskytovatel zachovat kontrolu

Údaje o sledování mohou informovat o poprodejní zkušenosti, neměly by však určovat celou tuto zkušenost. Poskytovatel by měl vlastnit mapování zásilky na obchodníka, pravidla kontaktování zákazníků a jazyk používaný v případě nejisté aktualizace. Pokud událost pouze uvádí, že balík dorazil do zařízení, značková zpráva by neměla slibovat datum doručení. Pokud se sledování přestane aktualizovat, měl by systém odlišit nedostatek nových informací od důkazu, že se balík ztratil.

Stejnou pozornost si zaslouží pracovní postupy podpory. Oprávněným pracovníkům poskytněte původní událost sledování, normalizovaný stav, čas zaznamenání každého z nich a historii upozornění. Tento pohled pracovníkovi pomůže vysvětlit, proč zákazník obdržel konkrétní zprávu, a rozhodnout, zda problém vyžaduje další šetření. Usnadňuje také audit provozu pro více značek: problém lze vysledovat k aktualizaci z nadřazené služby, chybě při přiřazování, pravidlu obchodníka nebo selhání zasílání zpráv, místo aby byl neurčitě připisován API.

Začněte úzce zaměřeným pilotním projektem. Připojte jednoho nebo dva obchodníky, zaregistrujte reprezentativní zásilky a otestujte běžné události doručení spolu s výjimkami, chybějícími údaji o přepravci, duplicitními aktualizacemi a opravenými objednávkami. Ověřte, že každá značka vidí pouze své vlastní zásilky a že neúspěšné upozornění lze zopakovat bez vytvoření druhé zprávy zákazníkovi. Další obchodníky přidávejte až poté, co budou tyto scénáře předvídatelné. Jedno API může snížit integrační práci, ale spolehlivá služba napříč značkami vzniká díky kontrolním mechanismům vybudovaným kolem něj.

Časté dotazy

Znamená jedno sledovací API, že každá značka používá stejnou sledovací stránku?

Ne. API může dodávat informace o sledování aplikaci poskytovatele, zatímco každá značka si zachovává vlastní design stránky, nastavení domény, jazyk komunikace se zákazníky a pravidla upozornění. Tato značková prostředí musí být implementována a udržována samostatně.

Může samotné sledovací číslo identifikovat správnou značku?

Nemělo by být jediným identifikátorem tenanta. Při vstupu zásilky do systému uložte explicitní klíč značky nebo tenanta a poté sledovací číslo přiřaďte k záznamu objednávky této značky. Před zobrazením informací o zásilce nebo odesláním zprávy toto přiřazení znovu ověřte.

Měl by poskytovatel odesílat upozornění na každou novou událost sledování?

Obvykle ne. Některé události se opakují, přicházejí se zpožděním nebo jsou pro zákazníka příliš technické. Definujte typy událostí, které se mají použít, potlačujte duplicity, kontrolujte komunikační preference a původní aktualizaci uchovávejte pro kontrolu podporou.

Co je třeba otestovat před přidáním dalšího obchodníka?

Otestujte skutečné vstupy zásilek obchodníka, kombinaci přepravců, přiřazování objednávek, přístupová oprávnění, pravidla upozornění a zpracování výjimek. Zahrňte případ, kdy údaje o sledování chybí nebo přicházejí pozdě, a ověřte, že žádné údaje o zásilce ani zákazníkovi nemohou přejít do účtu jiného obchodníka.

Zdroje