Skip to main content
DomovBlogVodnikiKako izbrati API za sledenje pošiljkam v Združenem kraljestvu: pokritost prevoznikov in integracija

Kako izbrati API za sledenje pošiljkam v Združenem kraljestvu: pokritost prevoznikov in integracija

17TRACK

Izberite API za sledenje pošiljkam v Združenem kraljestvu tako, da preizkusite prevoznike in dostavne storitve, ki jih dejansko uporabljate, nato pa preverite, ali je mogoče dogodke sledenja zanesljivo vključiti v vaše sisteme. Dolg seznam prevoznikov ni dovolj: vaš ožji izbor mora prestati preizkuse resničnih pošiljk za domače dostave v Združenem kraljestvu, čezmejne predaje, natančnost statusov, obravnavo webhookov in skupne operativne stroške.

Kako izbrati API za sledenje pošiljkam v Združenem kraljestvu glede na pokritost prevoznikov

Za vodjo e-trgovinskih operacij je rezultat zanesljiv pregled nad pošiljkami. Za inženirsko ekipo pa je to integracija, ki ostane predvidljiva, ko posodobitve prispejo pozno, so sledilne številke dvoumne ali se dostavni partnerji zamenjajo. Preden se zavežete ponudniku, ocenite oba vidika.

Začnite s svojo mešanico pošiljk, ne s številom prevoznikov ponudnika

API za sledenje pridobiva informacije o pošiljkah za uporabo v aplikaciji, sistemu za upravljanje naročil, orodju za podporo strankam ali drugi programski opremi. Ne domnevajte, da integracija za sledenje vključuje tudi nakup etiket, naročanje prevzemov ali upravljanje vračil. To so ločene zahteve, ki jih morate preveriti.

Pred pregledom ponudnikov izvozite reprezentativen vzorec svojih pošiljk in jih razvrstite glede na prevoznika, storitev, izvor, cilj in poslovni pomen. Vključite uspešne dostave in problematične pošiljke. Vzorec, ki vsebuje samo preproste domače dostave, vam bo povedal malo o mednarodnih predajah ali izjemah pri dostavi.

Ustvarite seznam zahtev z naslednjimi polji:

  • Prevoznik in storitev: Zabeležite točno storitev, ki jo uporablja vaše podjetje, ne samo blagovne znamke prevoznika.
  • Pot: Ločite domače pošiljke v Združenem kraljestvu, pošiljke, prispele v Združeno kraljestvo, in pošiljke, poslane iz Združenega kraljestva.
  • Identifikator pošiljke: Zabeležite, ali prejmete številko paketa, referenco pošiljke, referenco naročila ali več identifikatorjev.
  • Zahtevani dogodki: Določite mejnike, ki sprožijo sporočila strankam ali operativne ukrepe.
  • Poslovni skrbnik: Določite odgovornost za preiskovanje zadržanih pošiljk, neuspešnih dostav in nepravilnih posodobitev.

Vaš seznam obvezne pokritosti lahko glede na vaše pogodbe vključuje Royal Mail, Parcelforce Worldwide, Evri ali DPD. To so primeri za preverjanje, ne trditev, da kateri koli API podpira vse storitve teh prevoznikov.

Kaj mora pokritost prevoznikov pomeniti v praksi

»Podpira tega prevoznika« je šele začetek ocenjevanja. Uporabna pokritost pomeni, da API pridobi dogodke, ki jih vaši delovni tokovi potrebujejo za storitve in poti, ki jih uporabljate. Seznam prevoznikov obravnavajte kot razlog za testiranje, ne kot dokaz pripravljenosti za produkcijo.

Preverite pokritost na ravni storitve in poti

Od ponudnika zahtevajte potrditev točne integracije prevoznika, morebitnih zahtevanih poverilnic računa in dodatnih podatkov o pošiljki. Ugotovite, ali sledenje deluje za vaše pogodbene storitve in ali so potrebne informacije o poštni številki ali cilju. Ne domnevajte, da uspešen preizkus ene storitve dokazuje podporo drugi.

Za preverjanje popolnosti dogodkov uporabite lastne pošiljke. Odziv API-ja primerjajte s stranjo za sledenje prevoznika in zabeležite, kdaj je bilo vsako preverjanje izvedeno. Cilj ni nujno enako besedilo, temveč to, ali se pri integraciji ohranijo operativno pomembne informacije.

Mednarodne predaje preizkusite ločeno

Čezmejne pošiljke lahko vključujejo več kot enega dostavnega partnerja. Preizkusite, ali integracija razkrije naslednjega prevoznika ali sledilno številko, ko so te informacije na voljo. Preverite tudi, ali lahko vaša aplikacija več sledilnih številk poveže z eno pošiljko, ne da bi ustvarila podvojena obvestila strankam.

Ne domnevajte, da lahko API razkrije dogodke, ki jih osnovno dostavno omrežje ni dalo na voljo. Preden določite odgovornost, ločite med težavo z integracijo, zamudo pri objavi prevoznika in dejansko vrzeljo v poteku pošiljke.

Preverite zaznavanje prevoznika in dvoumne številke

Če ponudnik omogoča samodejno zaznavanje prevoznika, preizkusite dvoumne in napačno vnesene številke. Vprašajte, ali lahko posredujete izrecni identifikator prevoznika in kako sistem obravnava negotovo ujemanje. Napačno ujemanje, ki ustvari na videz verjetne dogodke, je lahko bolj moteče kot jasna napaka pri preverjanju.

Pri delovnih tokovih z večjim tveganjem shranite prevoznika, ki ga posreduje vaš sistem za izpolnjevanje naročil, skupaj s sledilno številko. Samodejno zaznavanje obravnavajte kot funkcijo, ki jo je treba preveriti, ne kot nadomestilo za ohranjanje metapodatkov o pošiljki.

Izbirajte med neposrednimi integracijami prevoznikov in API-jem za več prevoznikov

Neposredna integracija prevoznika je lahko primerna za podjetje s stabilno mešanico prevoznikov in zahtevami, tesno povezanimi s podatki določenega prevoznika. Hkrati je vaša ekipa odgovorna za izvedbo in vzdrževanje vsake ločene povezave.

API za več prevoznikov je vredno oceniti, ko vaši sistemi potrebujejo skupno integracijo za več dostavnih omrežij. Vendar skupni vmesnik samodejno ne pomeni enake globine podatkov, pogostosti posodobitev ali kakovosti dogodkov pri vseh prevoznikih. Te razlike je še vedno treba preizkusiti.

17TRACK je za to ocenjevanje relevanten zaradi svoje ponudbe Tracking API. Kot izhodišče za preverjanje zahtev integracije uporabite njegovo uradno dokumentacijo API-ja, nato pa neposredno preverite svoj seznam prevoznikov in storitev. To je kandidat za ocenjevanje v istem postopku sprejemljivosti, ne razlog za preskok preverjanja pokritosti ali zanesljivosti.

Pravilo odločanja: izberite pristop z več prevozniki, ko skupna integracija občutno zmanjša vzdrževanje, ne da bi izgubili potrebne dogodke. Neposredno integracijo izberite, kadar je zahteva, specifična za prevoznika, odločilna in jo vaša ekipa lahko podpira. Primeren je lahko tudi hibridni pristop, vendar določite, kateri vir ima prednost, če oba poročata o isti pošiljki.

Pred izdelavo delovnih tokov za stranke ocenite model dogodkov

Podatki o sledenju postanejo uporabni šele, ko jih vaša programska oprema pravilno razlaga. Zahtevajte vzorčne odzive za običajne dostave, izjeme, vračila in pošiljke, pri katerih še ni dogodkov. Preglejte običajne kategorije statusov in vse razpoložljive izvirne opise prevoznika.

Splošni status »izjema« je lahko primeren za nadzorno ploščo, vendar mora vaša podporna ekipa morda razlikovati med težavo z naslovom in neuspešnim poskusom dostave. Nasprotno pa je lahko surovo sporočilo prevoznika preveč nedosledno, da bi brez dodatnega preslikovanja sprožilo komunikacijo s strankami.

  • Časovni žigi: Ugotovite, ali polje predstavlja čas dogodka, čas pridobitve ali čas obvestila ter kako so izraženi časovni pasovi.
  • Identiteta dogodka: Preverite, ali imajo dogodki stabilne identifikatorje ali mora vaša aplikacija ustvariti ključ za odstranjevanje dvojnikov.
  • Spremembe statusa: Ugotovite, kako so predstavljeni popravki, starejši dogodki in posodobitve po navidezni dostavi.
  • Manjkajoče informacije: Potrdite, kako so prikazane neznane lokacije, manjkajoči časovni žigi in nedostopne ocene dostave.
  • Surove podrobnosti: Odločite, ali je za podporo in preiskovanje treba ohraniti izvirni opis dogodka.

»Dogodkov sledenja še ni« naj bo ločeno od »izgubljeno«. Prav tako ocene dostave ne spremenite v zajamčen datum dostave. Vaša aplikacija mora ohraniti negotovost, namesto da bi ustvarila gotovost, ki je izvorni podatki ne podpirajo.

Načrtujte napake webhookov, ne le uspešnih zahtev

Če API v ožjem izboru ponuja webhooks, preverite, kako se preverjajo pristnost, ponavljajo in potrjujejo. Če uporablja anketiranje, določite omejitve zahtev in urnik pridobivanja, ki ustreza vašim operativnim potrebam. Noben pristop ne odpravi potrebe po spremljanju in obnovi.

Pri integraciji, ki temelji na webhookih, je robustna zasnova preverjanje zahteve, trajna shramba ali postavitev vsebine v čakalno vrsto ter nato potrditev v skladu z zahtevami ponudnika. Obvestila strankam obdelujte ločeno, da počasna storitev za sporočanje ne bo blokirala sprejema podatkov.

Pred izvedbo odgovorite na naslednja vprašanja:

  • Kako vaša končna točka preveri, da je zahteva prišla od ponudnika?
  • Kaj se zgodi, ko vaša končna točka prekorači čas ali vrne napako?
  • Ali se lahko dostave podvojijo ali prispejo v napačnem vrstnem redu?
  • Ali je mogoče zamujene posodobitve pridobiti ali ponovno predvajati?
  • Kako se poverilnice zamenjajo, ne da bi bila storitev prekinjena?
  • Kaj se zgodi, ko so med obnovo dosežene omejitve hitrosti?

Obdelavo zasnujte tako, da bo idempotentna: ponovni prejem iste posodobitve ne sme ustvariti novega sporočila stranki ali podvojene naloge za podporo. Stanje pošiljke naj bo ločeno od zgodovine obvestil, zabeležite pa tudi, zakaj je bilo posamezno dejanje, usmerjeno k stranki, sproženo.

Načrtujte tudi napake pri registraciji. Če dodajanje sledilne številke ne uspe, shranite jasno napako in ponovite poskus samo tam, kjer je to primerno. Ponavljajoče se pošiljanje neveljavnega identifikatorja ni strategija obnovitve.

Izvedite dokaz koncepta z izrecnimi merili uspeha

Uporaben dokaz koncepta primerja integracijo z vašimi zahtevami, ne z dovršeno predstavitvijo. Vključite pošiljke iz vsake pomembne kombinacije prevoznika in storitve ter namerno preizkusite neugodne pogoje.

Testni primerKaj preveritiNačelo sprejemljivosti
Domača dostava v Združenem kraljestvuPopolnost dogodkov in končni statusZahtevani mejniki dosežejo pravilno naročilo.
Čezmejna predajaSpremembe prevoznika in dodatni identifikatorjiRazpoložljive informacije o predaji ostanejo povezane s pošiljko.
Izjema pri dostaviPomen statusa in izvirne podrobnostiUstrezna ekipa lahko določi naslednji ukrep.
Podvojena ali starejša posodobitevOdstranjevanje dvojnikov in vrstni red dogodkovNe pride do podvojenega sporočila ali napačnega vračanja stanja.
Začasni izpad končne točkePonovni poskusi in usklajevanjeManjkajoče informacije je mogoče obnoviti s preizkušenim postopkom.

Pred preizkusom določite lastne pragove. Popolnost dogodkov merite glede na opredeljene mejnike in zabeležite zamik med zaznavo dogodka pri prevozniku in njegovim prejemom prek API-ja. Načini opazovanja naj bodo dosledni; časovni žig dogodka sam po sebi ne določa, kdaj je dogodek postal na voljo.

Kritične napake ločite od želja. Manjkajoča obvezna pokritost ali neizvedljiv postopek obnovitve morata preprečiti uvedbo. Manj priročna nadzorna plošča morda ne. Ne dovolite, da visoka skupna ocena skrije neuspeh pri obvezni zahtevi.

Primerjajte skupne stroške, ravnanje s podatki in podporo

Zahtevajte ponudbo na podlagi obsega pošiljk in vzorca uporabe. Pojasnite, kaj se zaračunava: registrirane sledilne številke, zahteve, aktivne pošiljke, posodobitve ali druga enota. Vprašajte, kako se obravnavajo podvojene registracije, zgodovinska iskanja, neuspešne oddaje in prekoračitve. Ne domnevajte, da dva paketa uporabljata isto opredelitev sledene pošiljke.

V svoj model stroškov vključite vzdrževanje s strani inženirske ekipe, spremljanje, obravnavo izjem in delo pri migraciji. Nizka naročnina ne pomeni nujno nizkih operativnih stroškov, višja pristojbina pa ni dokaz boljše kakovosti sledenja.

Pri ravnanju s podatki dokumentirajte, katera polja bodo zapustila vaše sisteme in zakaj. Izogibajte se pošiljanju podatkov o strankah, ki jih integracija ne potrebuje. S svojima ekipama za varnost in zasebnost preglejte nadzor dostopa, hrambo, brisanje, namestitev gostovanja in pogodbene odgovornosti. Iz dejstva, da API sledi pošiljkam v Združenem kraljestvu, ne sklepajte, da so podatki tam tudi shranjeni ali da je rešitev skladna s predpisi.

Ureditve podpore morajo ustrezati poslovnemu vplivu napak. Vprašajte, kako stopnjevati težavo, specifično za prevoznika, katere diagnostične informacije potrebuje podpora in katere zaveze glede storitev so pogodbene. Splošna zaveza glede razpoložljivosti platforme sama po sebi ne zagotavlja pravočasnih dogodkov vsakega prevoznika.

Uvedbo zasnujte tako, da jo bo mogoče razveljaviti

Začnite z nadzorovano skupino pošiljk in primerjajte rezultate, preden omogočite avtomatizacijo, usmerjeno k strankam. Kjer je praktično, novo integracijo izvajajte v opazovalnem načinu, da lahko vaša ekipa preveri preslikave statusov brez pošiljanja sporočil.

Določite skrbnika za poverilnice, konfiguracijo prevoznikov, opozarjanje in odzivanje na incidente. Ohranite dovolj identifikatorjev pošiljk in zgodovine obdelave za preiskovanje napak in prihodnjo migracijo. Potrdite, da lahko vaša ekipa izvozi potrebne zapise, namesto da bi domnevali njihovo prenosljivost.

Pravi API za sledenje pošiljkam v Združenem kraljestvu je tisti, ki prestane vaše obvezne preizkuse poti in dogodkov, ustreza vaši arhitekturi integracije ter ima sprejemljive operativne pogoje. Odločitev sprejmite na podlagi dokazov o pošiljkah in preizkusov obnovitve, ne le na podlagi skupnega števila prevoznikov ali oznak funkcij.

Pogosta vprašanja

Ali podjetje v Združenem kraljestvu potrebuje API za sledenje, gostovan v Združenem kraljestvu?

Ne samodejno. Pokritost prevoznikov, lokacija gostovanja in pogodbene ureditve obdelave podatkov so različna vprašanja. Najprej določite poslovne zahteve in zahteve glede zasebnosti, nato preverite, ali jim ureditve ponudnika ustrezajo. Sledenje paketom v Združenem kraljestvu ne določa, kje se podatki obdelujejo.

Ali lahko pošiljki sledim samo s številko naročila?

Ne domnevajte tega. Prevoznik ali API morda interne številke naročila ne prepozna. Vaš sistem mora ohraniti povezavo med naročilom in identifikatorji njegovih pošiljk, vključno z več paketi ali nadomestnimi pošiljkami. Potrdite, katere identifikatorje integracija sprejema.

Ali so webhooki vedno boljši od anketiranja?

Ne. Webhooki lahko zmanjšajo število ponavljajočih se zahtev za pridobivanje, vendar zahtevajo zanesljivo sprejemno končno točko in obravnavo dvojnikov. Anketiranje je lahko primerno za nekatere delovne tokove, ob upoštevanju omejitev zahtev in sprejemljivih zamikov. Izbirajte na podlagi dokumentiranega vedenja in preizkušene obnovitve, ne pa obravnavajte nobene metode kot samodejno zadostne.

Kaj naj storim, ko se stran prevoznika in API ne ujemata?

Zabeležite sledilno številko, prevoznika, surove odzive in čase opazovanja. Preverite, ali se razlika nanaša na besedilo, manjkajoče dogodke ali dejansko drugačno stanje pošiljke. Uporabite opredeljen postopek stopnjevanja in usklajevanja; virov ne menjajte tiho, ne da bi upoštevali podvojena obvestila ali nasprotujoče si preslikave statusov.

Viri

Spodnje uradne reference so izhodišča za ocenjevanje 17TRACK kot kandidata. Razpoložljivost storitev prevoznikov, cene, varnostne ureditve in pogodbene zaveze je treba potrditi za predlagano izvedbo. Merila testiranja in izbire v tem vodniku so uredniška priporočila, ne trditve, da vsak ponudnik ponuja opisane zmogljivosti.