Skip to main content
DomovBlogPríručkyAko si vybrať API na sledovanie zásielok v Spojenom kráľovstve: pokrytie prepravcov a integrácia

Ako si vybrať API na sledovanie zásielok v Spojenom kráľovstve: pokrytie prepravcov a integrácia

17TRACK

Vyberte si API na sledovanie zásielok v Spojenom kráľovstve tak, že otestujete dopravcov a doručovacie služby, ktoré skutočne používate, a následne overíte, či je možné jeho sledovacie udalosti spoľahlivo integrovať do vašich systémov. Dlhý zoznam dopravcov nestačí: váš užší výber by mal prejsť testami skutočných zásielok pre vnútroštátne doručenia v Spojenom kráľovstve, cezhraničné odovzdania, presnosť stavov, spracovanie webhookov a celkové prevádzkové náklady.

Ako si vybrať API na sledovanie zásielok v Spojenom kráľovstve podľa pokrytia dopravcov

Pre vedúceho ecommerce prevádzky je výsledkom spoľahlivý prehľad o zásielkach. Pre inžiniersky tím je to integrácia, ktorá zostáva predvídateľná, keď aktualizácie prichádzajú neskoro, sledovacie čísla sú nejednoznačné alebo sa doručovací partneri zmenia. Pred rozhodnutím o poskytovateľovi vyhodnoťte oba výsledky.

Začnite skladbou svojich zásielok, nie počtom dopravcov poskytovateľa

API na sledovanie získava informácie o zásielkach na použitie v aplikácii, systéme správy objednávok, nástroji zákazníckej podpory alebo inom softvéri. Nepredpokladajte, že integrácia sledovania zároveň nakupuje štítky, rezervuje vyzdvihnutia alebo spravuje vrátenia. Ide o samostatné požiadavky, ktoré je potrebné overiť.

Pred preskúmaním poskytovateľov exportujte reprezentatívnu vzorku svojich zásielok a zoskupte ich podľa dopravcu, služby, pôvodu, cieľa a obchodnej dôležitosti. Zahrňte úspešne doručené aj problémové zásielky. Vzorka obsahujúca iba jednoduché vnútroštátne doručenia vám o medzinárodných odovzdaniach alebo výnimkách pri doručení veľa nepovie.

Vytvorte hárok požiadaviek s týmito poľami:

  • Dopravca a služba: Zaznamenajte presnú službu, ktorú vaša firma používa, nie iba obchodný názov dopravcu.
  • Trasa: Oddeľte vnútroštátne zásielky v Spojenom kráľovstve, prichádzajúce zásielky do Spojeného kráľovstva a odchádzajúce zásielky zo Spojeného kráľovstva.
  • Identifikátor zásielky: Uveďte, či dostávate číslo balíka, referenciu zásielky, referenciu objednávky alebo viacero identifikátorov.
  • Požadované udalosti: Určte míľniky, ktoré spúšťajú správy zákazníkom alebo prevádzkové kroky.
  • Vlastník procesu: Priraďte zodpovednosť za skúmanie zadržaných zásielok, neúspešných doručení a nesprávnych aktualizácií.

Váš zoznam nevyhnutného pokrytia môže v závislosti od vašich zmlúv zahŕňať Royal Mail, Parcelforce Worldwide, Evri alebo DPD. Ide o príklady na preskúmanie, nie o tvrdenie, že konkrétne API podporuje každú službu ponúkanú týmito dopravcami.

Čo musí pokrytie dopravcov znamenať v praxi

„Podporuje tohto dopravcu“ je iba začiatok hodnotenia. Užitočné pokrytie znamená, že API získava udalosti, ktoré vaše pracovné postupy potrebujú pre služby a trasy, ktoré používate. Záznam dopravcu považujte za dôvod na testovanie, nie za dôkaz pripravenosti na produkčné nasadenie.

Overte pokrytie na úrovni služby a trasy

Požiadajte poskytovateľa o potvrdenie presnej integrácie dopravcu, prípadných požadovaných prihlasovacích údajov a ďalších polí zásielky. Zistite, či sledovanie funguje pre vaše zmluvné služby a či sú potrebné poštové smerovacie číslo alebo informácie o cieľovej destinácii. Nepredpokladajte, že úspešný test jednej služby dokazuje podporu inej služby.

Na kontrolu úplnosti udalostí použite vlastné zásielky. Porovnajte odpoveď API so sledovacou stránkou dopravcu a zaznamenajte, kedy bola každá z nich skontrolovaná. Cieľom nemusí byť úplne rovnaké znenie; dôležité je, či integrácia zachová prevádzkovo významné informácie.

Medzinárodné odovzdania testujte samostatne

Cezhraničné zásielky môžu zahŕňať viac ako jedného doručovacieho partnera. Otestujte, či integrácia sprístupňuje následného dopravcu alebo sledovacie číslo, keď sú tieto informácie k dispozícii. Skontrolujte tiež, či vaša aplikácia dokáže priradiť viacero sledovacích čísel k jednej zásielke bez vytvárania duplicitných upozornení pre zákazníkov.

Nepredpokladajte, že API dokáže sprístupniť udalosti, ktoré príslušná doručovacia sieť nezverejnila. Pred určením zodpovednosti rozlišujte medzi problémom integrácie, oneskorením pri zverejnení zo strany dopravcu a skutočnou medzerou v priebehu zásielky.

Skontrolujte detekciu dopravcu a nejednoznačné čísla

Ak poskytovateľ ponúka automatickú detekciu dopravcu, otestujte nejednoznačné a nesprávne zadané čísla. Zistite, či môžete zadať explicitný identifikátor dopravcu a ako systém rieši neistú zhodu. Nesprávna zhoda, ktorá vytvára vierohodne vyzerajúce udalosti, môže byť rušivejšia než jasná chyba overenia.

Pri pracovných postupoch s vyšším rizikom ukladajte dopravcu poskytnutého systémom plnenia objednávok spolu so sledovacím číslom. Automatickú detekciu považujte za funkciu, ktorú treba overiť, nie za náhradu uchovávania metadát zásielky.

Vyberte si medzi priamymi integráciami dopravcov a API pre viacerých dopravcov

Priama integrácia dopravcu môže vyhovovať firme so stabilnou skladbou dopravcov a požiadavkami úzko spojenými s údajmi konkrétneho dopravcu. Zároveň však váš tím zodpovedá za implementáciu a údržbu každého samostatného pripojenia.

API pre viacerých dopravcov sa oplatí vyhodnotiť, keď vaše systémy potrebujú spoločnú integráciu naprieč viacerými doručovacími sieťami. Spoločné rozhranie však automaticky neznamená rovnakú hĺbku údajov, frekvenciu aktualizácií ani kvalitu udalostí pri každom dopravcovi. Tieto rozdiely je stále potrebné otestovať.

17TRACK je pre toto hodnotenie relevantný vďaka svojej ponuke Tracking API. Ako východisko pri kontrole požiadaviek na integráciu použite jeho oficiálnu dokumentáciu API a následne priamo overte svoj zoznam dopravcov a služieb. Ide o kandidáta na posúdenie v rámci rovnakého akceptačného procesu, nie o dôvod vynechať testovanie pokrytia alebo spoľahlivosti.

Pravidlo rozhodovania: Uprednostnite prístup s viacerými dopravcami, keď spoločná integrácia výrazne znižuje údržbu bez straty potrebných udalostí. Uprednostnite priamu integráciu tam, kde je požiadavka špecifická pre dopravcu rozhodujúca a váš tím ju dokáže podporovať. Vhodný môže byť aj hybridný prístup, no určte, ktorý zdroj má prednosť, ak oba informujú o rovnakej zásielke.

Pred vytvorením pracovných postupov pre zákazníkov vyhodnoťte model udalostí

Údaje o sledovaní sú užitočné iba vtedy, keď ich váš softvér správne interpretuje. Vyžiadajte si vzorové odpovede pre bežné doručenia, výnimky, vrátenia a zásielky, pri ktorých zatiaľ nie sú k dispozícii žiadne udalosti. Preskúmajte bežné kategórie stavov aj pôvodné opisy dopravcu, ak sú dostupné.

Všeobecný stav „výnimka“ môže byť vhodný pre dashboard, ale tím podpory možno bude musieť rozlíšiť problém s adresou od neúspešného pokusu o doručenie. Naopak, nespracovaná správa dopravcu môže byť príliš nekonzistentná na spúšťanie komunikácie so zákazníkmi bez dodatočného mapovania.

  • Časové pečiatky: Určte, či pole predstavuje čas udalosti, čas získania alebo čas upozornenia a ako sú vyjadrené časové pásma.
  • Identita udalosti: Overte, či majú udalosti stabilné identifikátory alebo či musí vaša aplikácia vytvoriť kľúč na odstránenie duplicít.
  • Zmeny stavu: Zistite, ako sú reprezentované opravy, staršie udalosti a aktualizácie po zdanlivom doručení.
  • Chýbajúce informácie: Potvrďte, ako sa zobrazujú neznáme lokality, chýbajúce časové pečiatky a nedostupné odhady doručenia.
  • Podrobnosti v pôvodnom znení: Rozhodnite, či je pre podporu a vyšetrovanie potrebné uchovávať pôvodný opis udalosti.

Stav „zatiaľ žiadne sledovacie udalosti“ uchovávajte oddelene od stavu „stratené“. Rovnako nepremieňajte odhad doručenia na garantovaný dátum doručenia. Vaša aplikácia by mala zachovávať neistotu, nie vytvárať istotu, ktorú zdrojové údaje nepodporujú.

Navrhujte s ohľadom na zlyhania webhookov, nielen na úspešné požiadavky

Ak API v užšom výbere ponúka webhooky, preskúmajte, ako sa overujú, opakujú a potvrdzujú. Ak používa polling, stanovte limity požiadaviek a harmonogram získavania údajov, ktorý zodpovedá vašim prevádzkovým potrebám. Ani jeden z týchto prístupov neodstraňuje potrebu monitorovania a obnovy.

Pri integrácii založenej na webhookoch je robustným návrhom overiť požiadavku, trvalo uložiť alebo zaradiť obsah do frontu a následne ho potvrdiť podľa požiadaviek poskytovateľa. Spracovanie upozornení zákazníkom oddeľte, aby pomalá služba na odosielanie správ neblokovala príjem údajov.

Pred implementáciou odpovedzte na tieto otázky:

  • Ako váš koncový bod overí, že požiadavka pochádza od poskytovateľa?
  • Čo sa stane, keď váš koncový bod prekročí časový limit alebo vráti chybu?
  • Môžu byť doručenia duplicitné alebo môžu prísť v nesprávnom poradí?
  • Je možné získať alebo zopakovať zmeškané aktualizácie?
  • Ako sa menia prihlasovacie údaje bez prerušenia služby?
  • Čo sa stane, keď sa počas obnovy dosiahnu limity frekvencie?

Spracovanie navrhnite ako idempotentné: opätovné prijatie rovnakej aktualizácie by nemalo vytvoriť ďalšiu správu zákazníkovi ani duplicitnú úlohu podpory. Stav zásielky uchovávajte oddelene od histórie upozornení a zaznamenávajte, prečo bola spustená každá akcia smerom k zákazníkovi.

Naplánujte aj zlyhania registrácie. Ak pridanie sledovacieho čísla zlyhá, uložte jasnú chybu a opakujte pokus iba tam, kde je to vhodné. Opakované skúšanie neplatného identifikátora nie je stratégiou obnovy.

Spustite overenie koncepcie s jasnými kritériami úspechu

Užitočné overenie koncepcie porovnáva integráciu s vašimi požiadavkami, nie s prepracovanou ukážkou. Zahrňte zásielky z každej dôležitej kombinácie dopravcu a služby a zámerne testujte nepriaznivé podmienky.

Testovací prípadČo overiťPrincíp akceptácie
Vnútroštátne doručenie v Spojenom kráľovstveÚplnosť udalostí a konečný stavPožadované míľniky sa dostanú k správnej objednávke.
Cezhraničné odovzdanieZmeny dopravcu a ďalšie identifikátoryDostupné informácie o odovzdaní zostanú prepojené so zásielkou.
Výnimka pri doručeníVýznam stavu a pôvodné podrobnostiPríslušný tím dokáže určiť ďalší krok.
Duplicitná alebo staršia aktualizáciaOdstránenie duplicít a poradie udalostíNevznikne duplicitná správa ani nesprávny návrat stavu.
Dočasný výpadok koncového boduOpakovanie pokusov a zosúladenieZmeškané informácie možno obnoviť testovaným postupom.

Pred testom si stanovte vlastné prahové hodnoty. Merajte úplnosť udalostí voči definovaným míľnikom a zaznamenávajte oneskorenie medzi pozorovaním udalosti u dopravcu a jej prijatím prostredníctvom API. Metódy pozorovania udržiavajte konzistentné; samotná časová pečiatka udalosti neurčuje, kedy sa táto udalosť stala dostupnou.

Oddeľte kritické zlyhania od preferencií. Chýbajúce požadované pokrytie alebo nepoužiteľný proces obnovy by mali nasadenie zablokovať. Menej pohodlný dashboard nemusí. Nedovoľte, aby vysoké celkové skóre skrylo zlyhanie povinnej požiadavky.

Porovnajte celkové náklady, prácu s údajmi a podporu

Vyžiadajte si cenovú ponuku na základe objemu zásielok a spôsobu používania. Ujasnite si, čo sa účtuje: registrované sledovacie čísla, požiadavky, aktívne zásielky, aktualizácie alebo iná jednotka. Zistite, ako sa posudzujú duplicitné registrácie, historické vyhľadávania, neúspešné odoslania a prekročenie limitov. Nepredpokladajte, že dva programy používajú rovnakú definíciu sledovanej zásielky.

Do modelu nákladov zahrňte údržbu zo strany inžinierov, monitorovanie, spracovanie výnimiek a prácu potrebnú na migráciu. Nízky poplatok za predplatné nemusí znamenať nízke prevádzkové náklady a vyšší poplatok nie je dôkazom kvalitnejšieho sledovania.

Pri práci s údajmi zdokumentujte, ktoré polia opustia vaše systémy a prečo. Vyhnite sa odosielaniu informácií o zákazníkoch, ktoré integrácia nepotrebuje. So svojimi bezpečnostnými a ochrannými tímami preskúmajte riadenie prístupu, uchovávanie, mazanie, hostingové usporiadanie a zmluvné zodpovednosti. Z toho, že API sleduje zásielky v Spojenom kráľovstve, nevyvodzujte, že údaje sú uložené v Spojenom kráľovstve alebo že spĺňa regulačné požiadavky.

Usporiadanie podpory by malo zodpovedať obchodnému vplyvu zlyhania. Zistite, ako eskalovať problém špecifický pre dopravcu, aké diagnostické informácie podpora potrebuje a ktoré záväzky týkajúce sa služieb sú zmluvné. Všeobecný záväzok dostupnosti platformy sám o sebe nezaručuje včasné udalosti od každého dopravcu.

Urobte nasadenie vratným

Začnite s kontrolovanou skupinou zásielok a pred povolením automatizácie orientovanej na zákazníkov porovnajte výsledky. Ak je to praktické, spustite novú integráciu v režime pozorovania, aby váš tím mohol kontrolovať mapovanie stavov bez odosielania správ.

Určte vlastníka prihlasovacích údajov, konfigurácie dopravcov, upozornení a reakcie na incidenty. Uchovávajte dostatok identifikátorov zásielok a histórie spracovania na skúmanie chýb a podporu budúcej migrácie. Potvrďte, že váš tím dokáže exportovať potrebné záznamy, a nepredpokladajte automatickú prenositeľnosť.

Správne API na sledovanie zásielok v Spojenom kráľovstve je to, ktoré prejde vašimi povinnými testami trás a udalostí, zapadne do vašej integračnej architektúry a má prijateľné prevádzkové podmienky. Rozhodujte sa na základe dôkazov zo zásielok a testov obnovy, nie iba podľa počtu dopravcov alebo označení funkcií.

Často kladené otázky

Potrebuje firma zo Spojeného kráľovstva API na sledovanie hostované v Spojenom kráľovstve?

Nie automaticky. Pokrytie dopravcov, umiestnenie hostingu a zmluvné podmienky spracovania údajov sú odlišné otázky. Najprv si stanovte obchodné požiadavky a požiadavky na ochranu súkromia a potom overte, či ich usporiadanie poskytovateľa spĺňa. Sledovanie balíkov zo Spojeného kráľovstva neurčuje, kde sa údaje spracúvajú.

Môžem sledovať zásielku iba pomocou čísla objednávky?

Nepredpokladajte to. Interné číslo objednávky nemusí dopravca ani API rozpoznať. Váš systém by mal uchovávať vzťah medzi objednávkou a jej identifikátormi zásielky vrátane viacerých balíkov alebo náhradných zásielok. Potvrďte identifikátory, ktoré integrácia prijíma.

Sú webhooky vždy lepšie než polling?

Nie. Webhooky môžu znížiť počet opakovaných požiadaviek na získavanie údajov, vyžadujú však spoľahlivý prijímajúci koncový bod a spracovanie duplicít. Polling môže vyhovovať niektorým pracovným postupom s ohľadom na limity požiadaviek a prijateľné oneskorenia. Vyberajte podľa zdokumentovaného správania a otestovanej obnovy, nie podľa toho, že by jedna z metód bola sama osebe vždy dostačujúca.

Čo mám robiť, keď sa stránka dopravcu a API nezhodujú?

Zaznamenajte sledovacie číslo, dopravcu, nespracované odpovede a časy pozorovania. Skontrolujte, či sa rozdiel týka formulácie, chýbajúcich udalostí alebo skutočne odlišného stavu zásielky. Uplatnite definovaný proces eskalácie a zosúladenia; zdroje potichu neprepínajte bez zváženia duplicitných upozornení alebo konfliktného mapovania stavov.

Zdroje

Oficiálne odkazy nižšie sú východiskom pri hodnotení 17TRACK ako kandidáta. Dostupnosť služieb dopravcov, ceny, bezpečnostné opatrenia a zmluvné záväzky je potrebné potvrdiť pre navrhovanú implementáciu. Kritériá testovania a výberu v tejto príručke sú redakčnými odporúčaniami, nie tvrdením, že každý poskytovateľ ponúka opísané funkcie.