Skip to main content
DomovBlogVodnikiKako lahko ponudniki poprodajnih storitev upravljajo sledenje več blagovnih znamk z enim API-jem

Kako lahko ponudniki poprodajnih storitev upravljajo sledenje več blagovnih znamk z enim API-jem

17TRACK

Izvajalci poprodajnih storitev lahko prek enega API-ja upravljajo sledenje za več blagovnih znamk e-trgovine tako, da skupni sloj podatkov o pošiljkah ločijo od uporabniške izkušnje posamezne blagovne znamke. Praktični model je večnajemniška storitev sledenja: ena integracija prejema zahteve za sledenje in dogodke, medtem ko pravila najemnika določajo preverjanje pristnosti, blagovno znamko, vedenje prevoznikov, obvestila in poročanje. Ta pristop zmanjšuje podvojene integracije, vendar deluje dobro le, če so lastništvo podatkov, identiteta pošiljke, normalizacija prevoznikov in operativni nadzori zasnovani že od začetka.

Kako lahko izvajalci poprodajnih storitev upravljajo sledenje za več blagovnih znamk

Cilj ni zgolj postaviti več blagovnih znamk za eno končno točko. Cilj je vsaki stranki zagotoviti zanesljiv potek spremljanja pošiljk, ne da bi moral izvajalec storitev za vsako blagovno znamko posebej zgraditi in vzdrževati povezavo z vsakim prevoznikom. Dobro zasnovan sistem mora skupno infrastrukturo kupcem skriti, operaterjem pa zagotoviti dovolj nadzora za preiskovanje izjem in zaščito podatkovnih meja.

Kaj naj bi pomenil »en API« pri modelu z več blagovnimi znamkami

V tem kontekstu en API običajno pomeni eno integracijsko plast, ki jo upravlja ponudnik za več blagovnih znamk strank. To ne pomeni nujno, da vsaka stranka prejme enak odgovor, vmesnik ali potek obvestil. API lahko izpostavi skupno pogodbo, hkrati pa v ozadju uporablja pravila, značilna za posameznega najemnika.

Tipična zahteva lahko vključuje identifikator najemnika, referenco pošiljke ali naročila, podatke o prevozniku, kadar so na voljo, številko za sledenje, lokalne nastavitve in zahtevano operacijo. Storitev nato preveri pristnost klicatelja, ugotovi, katera blagovna znamka je lastnik pošiljke, pošlje ali pridobi podatke o sledenju, normalizira rezultat in vrne dosleden odgovor. Spletna trgovina blagovne znamke, center za pomoč, portal za naročila ali aplikacija za podporo strankam lahko ta odgovor uporabljajo, ne da bi morali razumeti ločen podatkovni model vsakega prevoznika.

Ta model ustvarja tri meje, ki jih ne smemo zamenjevati:

  • Integracijska meja: kako se posamezna stranka poveže s ponudnikom.
  • Podatkovna meja: do katerih pošiljk, dogodkov in referenc strank lahko dostopa posamezna stranka.
  • Meja uporabniške izkušnje: kako posamezna blagovna znamka svojim kupcem predstavi sledenje, obvestila in možnosti podpore.

Če so te meje jasno opredeljene, lahko ponudnik centralizira tehnično delo, hkrati pa ohrani nadzor na ravni blagovne znamke.

Začnite s podatkovnim modelom, ki upošteva najemnike

Najpomembnejša oblikovalska odločitev je, kako platforma prepozna blagovno znamko in njene pošiljke. Številke za sledenje same po sebi ne smemo obravnavati kot celotno poslovno identiteto pošiljke. Ista referenca se lahko pojavi v različnih sistemih, aplikacije strank pa lahko poleg številk za sledenje prevoznikov uporabljajo številke naročil, ID-je izpolnitve ali notranje ID-je primerov.

Varnejši model vsaki blagovni znamki dodeli stabilen ID najemnika in zapise pošiljk shrani z izrecnim lastništvom. Koristna polja lahko vključujejo ID najemnika, ID pošiljke, referenco naročila, številko za sledenje, kodo prevoznika, ciljno regijo, kadar je to primerno, trenutno stanje, zgodovino dogodkov, čas ustvarjanja, čas zadnje sinhronizacije in izvorni sistem. Natančna shema se bo razlikovala, vendar je treba lastništvo uveljavljati na ravni API-ja in zbirke podatkov, ne pa se zanašati samo na uporabniški vmesnik stranke.

Konfiguracijo blagovne znamke je treba ločiti tudi od podatkov o pošiljkah. Konfiguracijski zapis lahko določa domeno strani za sledenje, logotip, podprte jezike, poimenovanje statusov, nastavitve obvestil, pravila eskalacije in povezave do podpore strankam. Tako operaterjem pri dodajanju nove stranke ni treba vsakič znova kopirati logike, značilne za blagovno znamko, v programsko kodo.

Za ponudnike storitev ima ta ločitev še eno prednost: integracijo s prevoznikom je mogoče izboljšati enkrat in jo nato uporabiti pri vseh ustreznih najemnikih. Vendar skupna koda ne sme pomeniti skupnih dovoljenj. Povezava s prevoznikom je lahko skupna, vidnost pošiljk pa mora ostati omejena na najemnika, ki je pošiljko poslal ali je njen lastnik.

Normalizirajte podatke prevoznikov, preden jih izpostavite blagovnim znamkam

Sledenje za več blagovnih znamk postane zahtevno, ko vsak prevoznik uporablja različna imena dogodkov, logiko statusov, časovne žige in opise izjem. En prevoznik lahko paket opiše kot paket, ki se premika po omrežju, drugi pa uporabi natančnejši dogodek prevoza ali objekta. Neposredno posredovanje teh surovih vrednosti vsaki stranki ustvarja nedosledne izkušnje kupcev in otežuje poročanje.

Skupna normalizacijska plast mora dogodke, značilne za posamezne prevoznike, preslikati v nadzorovan notranji slovar. Pogoste kategorije lahko vključujejo prejete informacije, v tranzitu, na voljo za prevzem, predano v dostavo, dostavljeno, izjemo pri dostavi in dogodke, povezane z vračilom. Notranji model mora poleg normaliziranega statusa ohraniti tudi izvirni dogodek prevoznika. Tako lahko uporabniška izkušnja ostane preprosta, ne da bi izgubili diagnostične podrobnosti, ki jih potrebujejo ekipe za podporo.

Normalizacija mora upoštevati tudi negotovost. Platforma mora razlikovati med dogodkom dostave, ki ga je potrdil prevoznik, začasnim pomanjkanjem posodobitev in sklepanim operativnim stanjem. Ne sme dvoumnega sporočila prevoznika pretvoriti v dokončno obljubo. Če prevoznik posreduje predvideni datum dostave, ga mora API označiti kot oceno, ne pa ga predstaviti kot zagotovljen termin.

Ponudnika, kot je 17TRACK, je mogoče oceniti kot skupni sloj podatkov za sledenje, če se zahtevane zmogljivosti prevoznikov in API-ja ujemajo s primerom uporabe ponudnika storitev. Za potrditev podprtih operacij, formatov zahtev, preverjanja pristnosti, omejitev in zahtev za izvedbo je treba pred načrtovanjem produkcije uporabiti uradna gradiva API-ja in dokumentacijo za razvijalce.

API-pogodbo oblikujte glede na operativne primere uporabe

API za več blagovnih znamk je treba oblikovati glede na to, kaj morajo sistemi strank početi, ne le glede na podatke, ki jih posreduje prevoznik. Pogodba mora najmanj opredeliti, kako lahko stranka ustvari ali registrira zahtevo za sledenje, pridobi trenutno stanje pošiljke, pridobi zgodovino dogodkov in prejme posodobitve ob spremembi stanja, če je dostava dogodkov del izbrane storitve.

Pogodba mora dokumentirati:

  • Kako se najemniki in aplikacije preverjajo.
  • Kateri identifikatorji so obvezni in kateri neobvezni.
  • Kako se kode prevoznikov posredujejo, zaznajo ali popravijo.
  • Kaj pomeni uspešen odgovor v primerjavi z zahtevo, sprejeto v poznejšo obdelavo.
  • Kako so predstavljeni neznani, zakasnjeni, podvojeni ali nasprotujoči si dogodki.
  • Kako se obravnavajo paginacija, ponovni poskusi, omejitve hitrosti in napake.
  • Kako se upravljajo podpisi webhookov, zaščita pred ponovitvami in vrstni red dogodkov, če se uporabljajo webhooki.

Idempotentnost je še posebej pomembna. Stranke lahko po časovni omejitvi omrežja ponovijo zahtevo, platforma pa ne sme ustvariti podvojenih zapisov pošiljk samo zato, ker je bila ista zahteva poslana dvakrat. Vsak najemnik mora prejeti tudi poverilnice z najmanjšim praktičnim obsegom. Aplikacija blagovne znamke ne sme imeti možnosti poizvedovati po podatkih o pošiljkah druge blagovne znamke s spremembo identifikatorja v zahtevi.

Skupni podatkovni sloj ločite od izkušnje blagovne znamke

En API ne zahteva ene strani za sledenje. Ponudnik storitev lahko iste normalizirane podatke uporabi za različne uporabniške izkušnje: brendirano stran s stanjem naročila, vdelan gradnik, konzolo za podporo strankam ali obvestila, ki jih upravlja obstoječa komercialna platforma stranke.

Izkušnja mora določiti, koliko informacij se prikaže. Premijska blagovna znamka lahko prikaže podrobno časovnico in povezavo do podpore, druga stranka pa lahko želi kompaktno kartico s statusom. Obe lahko uporabljata isti osnovni model dogodkov. Sem sodijo tudi jezik, prikaz časovnega pasu, izrazoslovje blagovne znamke in navodila za stik.

Za ponudnike e-trgovine je referenca naročila za kupca pogosto enako pomembna kot številka za sledenje. Odgovor API-ja mora zato omogočiti povezavo statusa pošiljke s pravilnim naročilom, ne da bi razkril nepotrebne osebne podatke. Strani, namenjene kupcem, morajo uporabljati najmanjši potrebni obseg podatkov, operativne nadzorne plošče pa morajo za agente, skrbnike računov in administratorje uporabljati dostop na podlagi vlog.

Vzpostavite nadzor nad platformo, ne le nad pošiljkami

Skupna storitev sledenja ima dve vrsti težav pri spremljanju. Prepoznati mora težave na ravni pošiljke, kot so izjema pri dostavi ali nenavadno dolgo obdobje brez posodobitve, in težave na ravni platforme, kot so povečano število napak API-ja, zakasnjena obdelava dogodkov ali povezava s prevoznikom, ki vrača nepopolne podatke.

Metrike je treba, kadar podatki to omogočajo, razčleniti po najemniku, prevozniku, regiji, končni točki in vrsti napake. Koristni operativni pregledi vključujejo stopnjo uspešnosti zahtev, zakasnitev odgovorov, zakasnitev obdelave dogodkov, stopnjo podvojenih dogodkov, neuspešne prijave in število zapisov, ki zahtevajo ročni pregled. Razčlenitev je pomembna, ker je lahko skupna metrika platforme videti zdrava, medtem ko ima ena blagovna znamka ali prevoznik resne težave.

Pred uvedbo ustvarite pot eskalacije. Določite, kdo prejme opozorilo, kateri dokazi so priloženi, kako se težava pri prevozniku razlikuje od težave s podatki stranke in kdaj je treba obvestiti ekipo za podporo strankam. Skupni API mora zmanjšati operativno razdrobljenost, ne pa skrivati težav za enim splošnim sporočilom o napaki.

Za vsako blagovno znamko uporabite nadzorovan postopek uvajanja

Dodajanje nove blagovne znamke mora biti ponovljiv izvedbeni proces. Najprej preslikajte sisteme naročil, izpolnjevanja in podpore strankam. Potrdite, kateri identifikatorji pošiljk so na voljo, kateri prevozniki se uporabljajo, katere regije zahtevajo posebno obravnavo in ali želi stranka, da ponudnik upravlja obvestila, zagotavlja samo podatke ali podpira oboje.

  1. Opredelite najemnika: ustvarite zapis blagovne znamke, poverilnice, vloge, okolja in pričakovanja glede hrambe podatkov.
  2. Preslikajte identifikatorje: dokumentirajte povezavo med naročili, zapisi izpolnitve, številkami za sledenje in referencami, namenjenimi kupcem.
  3. Preizkusite vnose prevoznikov: uporabite reprezentativne pošiljke z glavnih destinacij blagovne znamke in za glavne vrste storitev.
  4. Preverite normalizirane statuse: primerjajte rezultate API-ja z razpoložljivimi podatki za sledenje prevoznika in želenim izrazoslovjem stranke.
  5. Preizkusite primere napak: vključite neveljavne številke, zakasnjena skeniranja, podvojene zahteve, neznane prevoznike, vračila in delne pošiljke.
  6. Izvedite omejeno izdajo: spremljajte dejanski promet nadzorovane skupine, preden omogočite celotno bazo strank.
  7. Dokumentirajte lastništvo: zabeležite, kdo odobri besedilo statusov, obravnava eskalacije podpore in pregleduje spremembe platforme.

Ta proces ponudniku omogoča tudi praktično odločitev, ali je obstoječa zasnova z enim API-jem zadostna. Če stranka potrebuje prevoznika, podatkovno polje, kanal obvestil ali regionalni potek, ki ga skupni sloj ne more zanesljivo podpreti, je treba to vrzel zabeležiti in preizkusiti, ne pa je skriti z začasno rešitvijo po meri.

Pogoste načine odpovedi, ki se jim je treba izogniti

  • Uporaba imen blagovnih znamk kot varnostnih mehanizmov: konfiguracija prikaza ni nadomestilo za avtorizacijo najemnikov.
  • Vračanje surovih statusov prevoznikov povsod: to ustvarja zmedeno izražanje za kupce in nedosledno analitiko.
  • Predpostavka, da ena številka za sledenje pomeni eno naročilo: deljene pošiljke, zamenjave in vračila lahko spremenijo to razmerje.
  • Ignoriranje časovnih pasov: časovne žige dogodkov je treba hraniti dosledno in jih prikazati na razumljiv način.
  • Vgradnja obvestil v osnovni podatkovni model: nastavitve obvestil morajo biti prilagodljive, da lahko različne blagovne znamke uporabljajo različne kanale in besedila.
  • Preizkušanje samo uspešnih dostav: izjeme in manjkajoče posodobitve so običajno vir stroškov podpore.
  • Obljubljanje pokritosti prevoznikov brez preverjanja: v uradni dokumentaciji ali tehničnem preizkusu koncepta potrdite trenutne zahteve glede prevoznika, regije in operacije.

Praktični okvir za odločanje

Pristop z enim API-jem je zelo primeren, kadar si več blagovnih znamk deli podobne poteke pošiljk, potrebuje dosledne podatke prevoznikov in želi, da ponudnik storitev prevzame vzdrževanje integracij. Manj preprost je, kadar vsaka stranka zahteva bistveno drugačne podatkovne pogodbe, strogo regionalno ločevanje ali operativne postopke, značilne za prevoznika. Takšne zahteve skupne platforme samodejno ne izključujejo, vendar povečujejo potrebo po konfiguraciji, testiranju in jasno opredeljenih mejah storitev.

Pred izbiro ponudnika API-ja izvedite preizkus koncepta z resničnimi, vendar nadzorovanimi primeri pošiljk. Preizkusite prepoznavanje prevoznika, normalizacijo dogodkov, čas posodobitev, odgovore na napake, preverjanje pristnosti, izolacijo najemnikov in možnost pridobivanja informacij, ki jih potrebujejo ekipe za podporo strankam. Preglejte uradna navodila ponudnika za sledenje z več prevozniki in dokumentacijo API-ja, nato pa morebitne nerešene zahteve potrdite neposredno. Prava odločitev ne temelji na številu prevoznikov, navedenih na marketinški strani, temveč na tem, ali lahko ponudnik podpira blagovne znamke, destinacije, poteke in nadzore, ki jih bo platforma dejansko uporabljala.

Če je dobro izveden, en API za sledenje postane ponovna uporabna operativna plast, ne pa še ena izolirana integracija. Izvajalcem poprodajnih storitev zagotavlja dosleden način zbiranja posodobitev pošiljk, ohranjanja izkušenj na ravni blagovne znamke in širjenja uvajanja strank brez podvajanja istega dela s prevozniki za vsak račun e-trgovine.

Pogosta vprašanja

Ali lahko en API služi več blagovnim znamkam, ne da bi si delile podatke?

Da, če se identiteta in avtorizacija najemnika uveljavljata skozi celoten sistem. Vsaka zahteva mora biti povezana z dovoljenim najemnikom, poizvedbe po pošiljkah pa je treba pred vračanjem podatkov preveriti glede na tega najemnika. Ločene poverilnice, dostop na podlagi vlog, revizijski dnevniki in testi izolacije morajo biti del izvedbe.

Ali mora vsaka blagovna znamka uporabljati isto stran za sledenje?

Ne. Skupni API lahko zagotavlja normalizirane podatke o sledenju, medtem ko vsaka blagovna znamka uporablja svojo stran, gradnik, jezik, izrazoslovje in povezave do podpore. Ločevanje predstavitve od podatkovnega sloja olajša upravljanje operacij za več blagovnih znamk.

Kaj je treba preizkusiti pred produkcijo?

Preizkusite vnose prevoznikov iz resničnega sveta, neveljavne številke za sledenje, zakasnjene dogodke, podvojene zahteve, deljene pošiljke, vračila, neznane prevoznike, ponovne poskuse webhookov, če so pomembni, in nadzore izolacije najemnikov. Preverite tudi, ali se normalizirani statusi ujemajo z jezikom, ki ga želi stranka prikazati kupcem.

Ali en API odpravi potrebo po upravljanju razlik med prevozniki?

Ne. Centralizira velik del integracijskega dela, vendar je treba razlike med prevozniki še vedno skrbno spremljati in predstavljati. Ponudnik mora ohraniti uporabne podrobnosti surovih dogodkov, aplikacijam strank pa izpostaviti stabilen normaliziran model.

Kako naj ponudnik oceni API za sledenje?

API ocenite glede na dejanske blagovne znamke, prevoznike, regije, zahteve glede dogodkov, model preverjanja pristnosti, omejitve, obravnavo napak, vedenje posodobitev in postopek podpore. Nadzorovan preizkus koncepta je zanesljivejši od predpostavke, da splošen opis funkcij pokriva vsak zahtevan potek.

Viri