Skip to main content
DomůBlogPrůvodciJak vybrat API pro sledování zásilek pro doručování v Evropě

Jak vybrat API pro sledování zásilek pro doručování v Evropě

17TRACK

Vyberte API pro sledování zásilek určených k doručení v Evropě tak, že otestujete své skutečné přepravní trasy, přeshraniční předávání, přesnost událostí a spolehlivost integrace — nikoli pouze porovnáním počtu přepravců. Pro tým ecommerce operací a jeho technologického partnera je správné API takové, které promění události zásilky ve spolehlivé aktualizace pro zákazníky a využitelné informace o výjimkách, přičemž splní vaše požadavky na ochranu soukromí, podporu a náklady.

Jak vybrat API pro sledování zásilek určených k doručení v Evropě

Začněte u cest, které vaše firma skutečně využívá k odesílání zásilek. Tuzemský balík, mezinárodní zásilka předaná místnímu doručovacímu partnerovi a vratka mohou na stejnou integraci klást velmi odlišné požadavky. Pomocí těchto cest vytvořte užší výběr, proveďte řízený pilot a přijměte nákupní rozhodnutí.

Definujte, s čím musí API vašemu týmu pomáhat

API pro sledování získává nebo poskytuje informace o stavu zásilek pro použití ve vašich vlastních systémech. Automaticky nejde o službu pro tvorbu přepravních štítků, celní odbavení ani záruku kvality doručení. Tyto požadavky udržujte oddělené, pokud výslovně nepotřebujete kombinované řešení.

Než začnete hodnotit dodavatele, dohodněte se na provozních výsledcích. Zákaznická podpora může potřebovat nejnovější událost přepravce a důvod eskalace. Systém pro správu objednávek může potřebovat standardizované stavy. Stránka pro sledování zásilky určená zákazníkům může vyžadovat přeložené zprávy a jasné rozlišení mezi odhadovaným a potvrzeným doručením.

  • Určete vlastníka rozhodnutí. Provozní tým by měl definovat pracovní postupy doručení, technický tým ověřit chování integrace a týmy pro ochranu soukromí a nákup schválit příslušné smluvní podmínky.
  • Znázorněte zapojené systémy. Určete, který systém registruje zásilky, přijímá aktualizace, ukládá historii a odesílá zákaznická oznámení.
  • Oddělte požadavky od preferencí. Správné sledování kritické doručovací trasy je požadavek. Pohodlný řídicí panel může být pouze preferencí, pokud váš tým již pracuje v interní platformě.
  • Definujte chování při selhání. Rozhodněte, co se stane, když API nebude dostupné, přepravce přestane hlásit události nebo nebude možné identifikovat sledovací číslo.

Tím předejdete běžné chybě při nákupu: výběru atraktivního seznamu funkcí dříve, než rozhodnete, jak budou data využívána.

Hodnoťte evropské doručovací trasy, nejen pokrytí jednotlivých zemí

„Evropské pokrytí“ je příliš široký pojem na to, aby sloužil jako akceptační kritérium. Evropa a Evropská unie nejsou zaměnitelné geografické oblasti a celní režim závisí na příslušných územích, zboží a způsobu přepravy. Skutečnost, že se země objevuje na stránce s informacemi o pokrytí, nepotvrzuje, že jsou podporovány všechny přepravní služby nebo předání na vaší trase.

Vytvořte matici tras na základě vlastní historie zásilek. Uveďte odesílatele, místo určení, přepravce, službu a případného známého doručovacího partnera. Největší podíl pilotu věnujte provozně nejdůležitějším trasám, ale zahrňte i obtížné trasy, které vytvářejí nepřiměřeně velké množství práce pro podporu.

Vzor doručeníCo testovatProč na tom záleží
Doručení domů v rámci jedné zeměPrvní sken, pokus o doručení, událost doručenoStanoví základní hodnotu pro běžné zásilky
Přeshraniční předáníZměny sledovacího čísla a kontinuita mezi přepravciOdhalí, zda viditelnost přetrvá i po předání
Doručení do výdejního místa nebo boxuStav připraveno k vyzvednutí oproti stavu vyzvednutoZabrání tomu, abyste zákazníkům oznámili převzetí nevyzvednuté zásilky
Zásilka procházející celním řízenímDostupné události odbavení a popisy výjimekPomáhá odlišit hlášenou celní aktivitu od nevysvětlené mezery ve sledování
Vrácení odesílateliSměr vratky a koncový stavZabraňuje tomu, aby byla vrácená zásilka považována za úspěšně doručenou zákazníkovi

U každé trasy požádejte poskytovatele o potvrzení přesné podpory přepravce a služby. Vyjasněte, zda musíte zadat identifikátor přepravce, zda je k dispozici automatická detekce a jak se nakládá s nejednoznačnými sledovacími čísly. Nepředpokládejte, že podpora značky přepravce zahrnuje všechny jeho služby nebo přidružené sítě.

Prověřte význam sledovacích dat

Uchovávejte standardizované stavy i původní události

Standardizované stavy usnadňují tvorbu pracovních postupů napříč více přepravci. Široké označení, jako je „v přepravě“, však může skrývat informace, které váš tým podpory potřebuje. Požadujte normalizovaný stav i popis podkladové události, pokud je k dispozici.

Kontrolujte obtížné příklady, nikoli pouze úspěšně doručené zásilky. Neúspěšný pokus, problém s adresou, událost související s celnicí a zásilka čekající na vyzvednutí by měly vést k odlišným provozním reakcím. Integrace by neměla každou neobvyklou událost převést na stejné naléhavé upozornění zákazníka.

Rozlišujte čas události od času aktualizace

Existuje několik užitečných časových údajů: kdy podle přepravce událost nastala, kdy ji poskytovatel sledování obdržel a kdy ji zpracovala vaše aplikace. Pokud to data umožňují, tyto rozdíly uchovávejte.

Zpracování časových pásem je u evropských tras důležité. Zeptejte se, zda časová razítka obsahují posuny, jak je reprezentována chybějící informace o časovém pásmu a zda může historie událostí dorazit v nesprávném pořadí. Neurčitému časovému údaji ze zdroje tiše nepřiřazujte přesné časové pásmo.

S odhady a překlady zacházejte opatrně

Pokud potřebujete odhadovaná data doručení, zjistěte, zda pocházejí od přepravce, nebo je vypočítává poskytovatel. Ověřte, co se stane, když se odhad změní nebo zmizí. Odhad musí zůstat viditelně odlišný od potvrzené události doručení.

Stejně tak oddělte jazyk rozhraní od překladu událostí. Dokumentace API v angličtině neznamená, že události přepravce budou přeloženy do všech jazyků, které potřebujete. Otestujte reprezentativní zprávy, zejména pokyny k vyzvednutí a výjimky při doručení, a pro účely šetření uchovávejte zdrojový text.

Testujte integraci při selhání, nejen při úspěchu

Úspěšná odpověď API dokazuje, že jeden požadavek fungoval. Nedokazuje však, že vaše aplikace zůstane synchronizovaná při opakovaných pokusech, opožděných událostech nebo výpadku.

Pokud poskytovatel nabízí webhooky, ověřte způsob ověřování, chování při opakování, očekávané časové limity a řešení duplicitního doručení. Přijímající služba by měla požadavek ověřit, trvale jej uložit nebo zařadit do fronty a včas vrátit požadované potvrzení. Navazující zpracování navrhněte tak, aby přijetí stejné události dvakrát neodeslalo dvě oznámení ani neopakovalo obchodní akci.

Pokud je k dispozici dotazování, seznamte se s limity rychlosti a způsobem obnovení zmeškaných aktualizací. Integrace založená na webhooks může stále těžit z cesty pro obnovení, ale ověřte, které mechanismy obnovení poskytovatel skutečně podporuje.

  • Registrace: Otestujte duplicitní odeslání, neplatné identifikátory a zásilky registrované před prvním skenem přepravce.
  • Pořadí událostí: Ověřte, zda opožděná starší událost nemůže nesprávně nahradit novější stav zásilky.
  • Obnovení: Přerušte svou přijímající službu a ověřte, jak lze následně obnovit aktualizace.
  • Bezpečnost: Prověřte rotaci přihlašovacích údajů, řízení přístupu, zabezpečení přenosu a případný zdokumentovaný mechanismus ověřování webhooků.
  • Životní cyklus: Stanovte, kdy sledování končí, jak dlouho zůstává historie dostupná a zda lze zásilku v případě potřeby sledovat znovu.
  • Správa změn: Zeptejte se, jak jsou oznamovány verze API, nekompatibilní změny a incidenty související s přepravci.

Dostupnost služby oddělujte od aktuálnosti sledování. API může být dostupné, zatímco zdroj dat přepravce přestal poskytovat nové informace. Monitorování by mělo pokrývat technická selhání i neočekávané ticho na důležitých trasách.

Zařaďte požadavky na ochranu soukromí do nákupního procesu

Sledovací číslo nemusí být anonymní. Pokud jej lze spojit s identifikovatelným zákazníkem, může jeho zpracování zahrnovat osobní údaje. Prověřte celý datový obsah včetně jmen, adres, údajů o doručení a všech dalších informací, které vaše integrace odesílá nebo přijímá.

Obecné nařízení o ochraně osobních údajů stanoví požadavky relevantní pro toto posouzení, včetně minimalizace údajů a omezení doby uložení v článku 5, ujednání se zpracovateli v článku 28, bezpečnosti v článku 32 a požadavků na mezinárodní předávání v kapitole V. Uplatňované povinnosti závisí na vašich zpracovatelských činnostech a rolích jednotlivých stran.

Požádejte poskytovatele o příslušné podmínky zpracování údajů, informace o dalších zpracovatelích, pravidla uchovávání, proces mazání a místa zpracování. Pokud jsou osobní údaje předávány mimo Evropský hospodářský prostor, nechte svůj tým pro ochranu soukromí posoudit příslušná pravidla předávání. Samotný hosting v Evropě neprokazuje soulad s předpisy a zpracování mimo Evropu není automaticky zakázáno.

Omezte vystavení údajů i ve vlastní implementaci. Neodesílejte informace o zákaznících, které pracovní postup sledování nepotřebuje, omezte přístup k nezpracovaným datům a zabraňte zbytečnému ukládání osobních údajů do aplikačních protokolů.

Porovnávejte celkové náklady při stejném pracovním zatížení

Nejprve zjistěte, co jednotlivé plány účtují, a teprve poté porovnávejte hlavní ceny. Zeptejte se, zda se poplatky vztahují k registrovaným zásilkám, požadavkům, aktualizacím, kreditům nebo jiné jednotce. Ověřte, jak se posuzují neúspěšné registrace, duplicitní registrace, opakované sledování a překročení limitů.

Každému poskytovateli v užším výběru předložte stejný popis pracovního zatížení: očekávaný počet měsíčních zásilek, špičkový provoz registrací, obvyklou dobu sledování, požadované trasy a očekávání ohledně podpory. Vyžádejte si písemný odhad a předpoklady, z nichž vychází.

Interní porovnání by mělo zahrnovat práci na implementaci, monitorování, úsilí podpory a řešení výjimek — nejen fakturu za API. Nepřisuzujte spekulativní úspory menšímu počtu kontaktů na podporu, pokud tento předpoklad nepodporuje pilot nebo stávající provozní data.

Ověřte také, jak byste službu opustili. Zjistěte, zda můžete exportovat potřebnou historii zásilek, jak se ruší přihlašovací údaje a uložená data a jaké změny by migrace vyžadovala ve vašem interním modelu stavů.

Jak do hodnocení zapadá 17TRACK

Pro firmu, která hodnotí integraci sledování u více přepravců, je Tracking API společnosti 17TRACK relevantním kandidátem k posouzení. Pomocí oficiální dokumentace API prozkoumejte požadavky na integraci a poté ověřte své evropské trasy na reprezentativních zásilkách.

Na 17TRACK uplatněte stejná akceptační kritéria jako na kteréhokoli jiného poskytovatele v užším výběru. Potvrďte podporu přepravců a služeb, chování událostí, limity účtu, obchodní podmínky a požadavky na ochranu soukromí pro zamýšlené nasazení. Spotřebitelské vyhledávání zásilky může pomoci při šetření konkrétního balíku, nenahrazuje však testování pracovního postupu API, který bude používat váš produkční systém.

Rozhodnutí by mělo následovat po pilotu: službu zařaďte do užšího výběru, pokud splňuje vaše požadavky na úrovni tras i v provozu, místo abyste považovali známost značky nebo široká tvrzení o pokrytí za dostatečný důkaz.

Proveďte pilot s jasnými akceptačními kritérii

Pomocí historických zásilek prověřte dokončené sekvence událostí a pomocí živých zásilek otestujte doručování aktualizací. Pokud je to relevantní, zahrňte úspěšná doručení, předání, neúspěšné pokusy, cesty přes výdejní místa a vratky. Z testovací sady odstraňte nepotřebné údaje o zákaznících.

  1. Nejprve definujte požadavky pro úspěch nebo neúspěch. Mezi příklady patří podpora kritické trasy, správné rozlišení vyzvednutí a doručení, obnovitelné aktualizace a přijatelné podmínky zpracování.
  2. Ověřujte podle záznamů přepravce. Porovnejte vzorkované události API s vlastním záznamem sledování přepravce. Zaznamenejte chybějící události, rozdíly ve stavech a nejednoznačnost časových razítek.
  3. Měřte aktuálnost spravedlivě. Zaznamenejte, kdy váš test zaznamená událost u zdroje přepravce a prostřednictvím API. Popište způsob pozorování; nemusí odhalit přesný okamžik, kdy přepravce událost poprvé zveřejnil.
  4. Testujte provozní výsledky. Ověřte, že pracovníci podpory dokážou interpretovat výjimky a že zákaznická oznámení zůstávají přesná, když události dorazí opožděně nebo opakovaně.
  5. Prověřujte nesrovnalosti. Oddělte mezery u zdrojového přepravce, chování poskytovatele a chyby ve vlastním mapování. Nepřipisujte každou chybějící událost API.
  6. Rozhodnutí zdokumentujte. Zaznamenejte přijatá omezení, nevyřešené otázky, obchodní předpoklady a vlastníka každého následného úkolu.

Vyberte API, které projde vašimi kritickými trasami a scénáři selhání, a teprve potom optimalizujte volitelné funkce. Pokud neprojde žádný kandidát, zúžte rozsah nasazení nebo před širším zavedením vyřešte nedostatky. Jasné omezení se řídí snáze než neotestovaný předpoklad vložený do komunikace se zákazníky.

Časté dotazy

Znamená delší seznam přepravců lepší sledování v Evropě?

Ne. Seznam přepravců je užitečný pro vytvoření užšího výběru, nepotvrzuje však podporu na úrovni služby, kontinuitu při předání ani kvalitu událostí na vašich trasách. Otestujte přepravce a vzory doručení, které jsou pro vaši firmu důležité.

Dokáže API pro sledování přimět přepravce, aby své skeny aktualizoval rychleji?

Samotné API nikoli. Proces získávání a doručování informací poskytovatele ovlivňuje, kdy váš systém obdrží dostupná data, nemůže však vytvořit fyzický sken, který přepravce nezaznamenal. Než budete každou mezeru ve sledování považovat za problém integrace, prověřte zdrojový záznam.

Potřebuji webhooky, dotazování, nebo obojí?

Webhooky mohou při jejich podpoře poskytovatelem omezit opakované požadavky. Dotazování může sloužit k plánovanému získávání dat nebo k odsouhlasení. Volte podle zdokumentovaných záruk doručení, limitů rychlosti a možností obnovení a bezpečné řešení duplicit zajistěte bez ohledu na použitou metodu.

Mělo by každé upozornění na výjimku při sledování vyvolat zprávu zákazníkovi?

Ne. Některé výjimky vyžadují interní šetření, nikoli okamžitou reakci zákazníka. Namapujte události na obchodní pravidla a rozlišujte informativní aktualizaci od požadavku, aby zákazník něco udělal.

Co by mělo zablokovat spuštění v produkci?

Spuštění by měla zablokovat nevyřešená selhání na kritických trasách, zavádějící mapování stavů, nedostatečné chování při obnově nebo nesplněné bezpečnostní a privacy požadavky. Volitelná funkce řídicího panelu by obvykle neměla. Na těchto rozdílech se dohodněte před začátkem pilotu.

Zdroje