Skip to main content
ПочетакБлогVodičiКако пружаоци услуга након куповине могу да управљају праћењем више брендова помоћу једног API-ја

Како пружаоци услуга након куповине могу да управљају праћењем више брендова помоћу једног API-ја

17TRACK

Provajderi postprodajnih usluga mogu da upravljaju praćenjem za više ecommerce brendova putem jednog API-ja tako što razdvajaju zajednički sloj podataka o pošiljkama od iskustva svakog brenda namenjenog korisnicima. Praktičan model je usluga praćenja sa više zakupaca: jedna integracija prima zahteve i događaje praćenja, dok pravila zakupca kontrolišu autentifikaciju, brendiranje, ponašanje prevoznika, obaveštenja i izveštavanje. Ovaj pristup smanjuje broj dupliranih integracija, ali dobro funkcioniše samo kada su vlasništvo nad podacima, identitet pošiljke, normalizacija podataka prevoznika i operativne kontrole osmišljeni od samog početka.

Kako provajderi postprodajnih usluga mogu da upravljaju praćenjem za više brendova

Cilj nije samo postaviti nekoliko brendova iza jedne krajnje tačke. Cilj je omogućiti svakom klijentu pouzdan tok rada nakon praćenja, bez potrebe da provajder usluge izgradi i održava zasebnu vezu sa prevoznikom za svaki brend. Dobro osmišljen sistem treba da zajedničku infrastrukturu učini nevidljivom kupcima, uz istovremeno pružanje dovoljne kontrole operaterima za istraživanje izuzetaka i zaštitu granica podataka.

Šta „jedan API“ treba da znači u modelu sa više brendova

U ovom kontekstu, jedan API obično znači jedan integracioni sloj kojim upravlja provajder za više klijentskih brendova. To ne mora da znači da svaki korisnik dobija isti odgovor, interfejs ili tok obaveštenja. API može da izloži zajednički ugovor, dok se pravila specifična za zakupca primenjuju u pozadini.

Tipičan zahtev može da sadrži identifikator zakupca, referencu pošiljke ili porudžbine, informacije o prevozniku kada su dostupne, broj za praćenje, lokalizaciju i traženu operaciju. Usluga zatim autentifikuje pozivaoca, utvrđuje koji brend je vlasnik pošiljke, šalje zahtev za podatke o praćenju ili ih preuzima, normalizuje rezultat i vraća dosledan odgovor. Prodavnica brenda, centar za pomoć, portal za porudžbine ili aplikacija korisničke službe mogu da koriste taj odgovor bez potrebe da razumeju zaseban model podataka svakog prevoznika.

Ovaj model stvara tri granice koje ne treba mešati:

  • Granica integracije: način na koji se svaki klijent povezuje sa provajderom.
  • Granica podataka: kojim pošiljkama, događajima i referencama kupaca svaki klijent može da pristupi.
  • Granica iskustva: način na koji svaki brend svojim kupcima prikazuje praćenje, obaveštenja i opcije podrške.

Jasno održavanje ovih granica omogućava provajderu da centralizuje tehnički rad, uz očuvanje kontrole na nivou brenda.

Počnite sa modelom podataka koji prepoznaje zakupce

Najvažnija odluka u dizajnu jeste način na koji platforma identifikuje brend i njegove pošiljke. Broj za praćenje sam po sebi ne treba tretirati kao potpuni poslovni identitet pošiljke. Ista referenca može se pojaviti u različitim sistemima, a klijentske aplikacije mogu koristiti brojeve porudžbina, ID-jeve ispunjenja porudžbina ili interne ID-jeve slučajeva zajedno sa brojevima za praćenje prevoznika.

Bezbedniji model svakom brendu dodeljuje stabilan ID zakupca i čuva zapise o pošiljkama sa jasno definisanim vlasništvom. Korisna polja mogu da obuhvate ID zakupca, ID pošiljke, referencu porudžbine, broj za praćenje, kod prevoznika, odredišni region kada je relevantno, trenutni status, istoriju događaja, vreme kreiranja, vreme poslednje sinhronizacije i izvorni sistem. Tačna šema će se razlikovati, ali vlasništvo treba da se sprovodi na nivoima API-ja i baze podataka, a ne samo oslanjanjem na klijentski interfejs.

Konfiguraciju brenda takođe treba odvojiti od podataka o pošiljkama. Zapis konfiguracije može da kontroliše domen stranice za praćenje, logo, podržane jezike, formulacije statusa, podešavanja obaveštenja, pravila eskalacije i veze ka korisničkoj službi. Time se operaterima onemogućava da svaki put kada se doda novi klijent kopiraju logiku specifičnu za brend u programski kod aplikacije.

Za provajdere usluga ovo razdvajanje ima još jednu prednost: integracija sa prevoznikom može se jednom poboljšati, a zatim koristiti za sve odgovarajuće zakupce. Međutim, zajednički kod ne treba da podrazumeva zajedničke dozvole. Veza sa prevoznikom može biti zajednička, dok vidljivost pošiljke ostaje ograničena na zakupca koji je pošiljku poslao ili je njen vlasnik.

Normalizujte podatke prevoznika pre nego što ih izložite brendovima

Praćenje za više brendova postaje teško kada svaki prevoznik koristi različite nazive događaja, logiku statusa, vremenske oznake i opise izuzetaka. Jedan prevoznik može prijaviti da se paket kreće kroz mrežu, dok drugi koristi precizniji događaj vezan za transport ili objekat. Direktno prosleđivanje tih sirovih vrednosti svakom klijentu stvara nedosledno korisničko iskustvo i otežava izveštavanje.

Zajednički sloj za normalizaciju treba da mapira događaje specifične za prevoznika u kontrolisani interni rečnik. Uobičajene kategorije mogu da obuhvate primljene informacije, u tranzitu, dostupno za preuzimanje, kod dostavljača, dostavljeno, izuzetak pri dostavi i događaje povezane sa povraćajem. Interni model treba da sačuva izvorni događaj prevoznika, kao i normalizovani status. Tako korisničko iskustvo može ostati jednostavno, bez odbacivanja dijagnostičkih detalja potrebnih timovima za podršku.

Normalizacija treba da uzme u obzir i neizvesnost. Platforma treba da razlikuje događaj dostave koji je potvrdio prevoznik, privremeni nedostatak ažuriranja i izvedeno operativno stanje. Ne treba nejasnu poruku prevoznika pretvarati u definitivno obećanje. Ako prevoznik dostavi procenjeni datum isporuke, API treba da ga označi kao procenu, a ne da ga predstavi kao garantovani termin.

Provajder kao što je 17TRACK može se proceniti kao zajednički sloj podataka za praćenje kada se potrebne mogućnosti prevoznika i API-ja podudaraju sa slučajem upotrebe provajdera usluge. Zvanični materijali o API-ju i dokumentacija za developere treba da se koriste za potvrdu podržanih operacija, formata zahteva, autentifikacije, ograničenja i zahteva za implementaciju pre planiranja produkcije.

Osmislite API ugovor oko operativnih slučajeva upotrebe

API za više brendova treba osmisliti prema onome što klijentski sistemi treba da rade, a ne samo prema podacima koje prevoznik slučajno pruža. U najmanju ruku, ugovor treba da definiše kako klijent može da kreira ili registruje zahtev za praćenje, preuzme trenutno stanje pošiljke, dobije istoriju događaja i prima ažuriranja kada se stanje promeni, ako je isporuka događaja deo izabrane usluge.

Ugovor treba da dokumentuje:

  • Kako se zakupci i aplikacije autentifikuju.
  • Koji identifikatori su obavezni, a koji opcioni.
  • Kako se kodovi prevoznika prosleđuju, detektuju ili ispravljaju.
  • Šta znači uspešan odgovor u odnosu na zahtev prihvaćen za kasniju obradu.
  • Kako se predstavljaju nepoznati, odloženi, duplirani ili suprotstavljeni događaji.
  • Kako se obrađuju paginacija, ponovni pokušaji, ograničenja broja zahteva i greške.
  • Kako se upravlja potpisima webhook-a, zaštitom od ponavljanja i redosledom događaja ako se koriste webhook-ovi.

Idempotentnost je posebno važna. Klijenti mogu ponoviti zahtev nakon isteka mreže, a platforma ne treba da kreira duplirane zapise o pošiljkama samo zato što je isti zahtev poslat dvaput. Svaki zakupac takođe treba da dobije akreditive sa najmanjim praktičnim obimom dozvola. Aplikacija jednog brenda ne bi smela da može da pretražuje podatke o pošiljkama drugog brenda promenom identifikatora u zahtevu.

Odvojite zajednički sloj podataka od iskustva brenda

Jedan API ne zahteva jednu stranicu za praćenje. Provajder usluge može koristiti iste normalizovane podatke za različita korisnička iskustva: brendiranu stranicu sa statusom porudžbine, ugrađeni vidžet, konzolu korisničke službe ili obaveštenja kojima upravlja postojeća trgovinska platforma klijenta.

Sloj iskustva treba da odluči koliko informacija će biti prikazano. Premium brend može prikazivati detaljnu vremensku liniju i vezu ka podršci, dok drugi klijent može preferirati sažetu karticu statusa. Oba mogu koristiti isti osnovni model događaja. Tu takođe pripadaju jezik, prikaz vremenske zone, terminologija brenda i uputstva za kontakt.

Za ecommerce provajdere referenca porudžbine je kupcu često jednako važna kao i broj za praćenje. Odgovor API-ja zato treba da omogući povezivanje statusa pošiljke sa odgovarajućom porudžbinom bez izlaganja nepotrebnih ličnih podataka. Stranice namenjene kupcima treba da koriste najmanju potrebnu količinu podataka, a operativne kontrolne table treba da primenjuju pristup zasnovan na ulogama za agente, menadžere naloga i administratore.

Izgradite nadzor za platformu, a ne samo za pošiljke

Zajednička usluga praćenja ima dva problema sa nadzorom. Mora da prepozna probleme na nivou pošiljke, kao što su izuzetak pri dostavi ili neuobičajeno dug period bez ažuriranja, ali i probleme na nivou platforme, kao što su povećan broj grešaka API-ja, odložena obrada događaja ili konektor prevoznika koji vraća nepotpune podatke.

Metrike treba segmentirati prema zakupcu, prevozniku, regionu, krajnjoj tački i vrsti greške kada podaci to podržavaju. Korisne operativne provere obuhvataju stopu uspešnosti zahteva, kašnjenje odgovora, kašnjenje u obradi događaja, stopu dupliranih događaja, neuspešne autentifikacije i broj zapisa koji zahtevaju ručnu proveru. Segmentacija je važna zato što zbirna metrika platforme može izgledati zdravo dok jedan brend ili prevoznik ima ozbiljan problem.

Pre pokretanja kreirajte putanju eskalacije. Definišite ko prima upozorenje, koji dokazi se prilažu, kako se problem sa prevoznikom razlikuje od problema sa podacima klijenta i kada treba obavestiti tim korisničke službe. Zajednički API treba da smanji operativnu fragmentaciju, a ne da skriva probleme iza jedne generičke poruke o grešci.

Koristite kontrolisan proces uvođenja za svaki brend

Dodavanje novog brenda treba da bude ponovljiv proces implementacije. Počnite mapiranjem sistema klijenta za porudžbine, ispunjenje porudžbina i korisničku službu. Potvrdite koji identifikatori pošiljki su dostupni, koji se prevoznici koriste, koji regioni zahtevaju posebno postupanje i da li klijent želi da provajder upravlja obaveštenjima, samo obezbeđuje podatke ili podržava obe opcije.

  1. Definišite zakupca: kreirajte zapis brenda, akreditive, uloge, okruženja i očekivanja u vezi sa zadržavanjem podataka.
  2. Mapirajte identifikatore: dokumentujte odnos između porudžbina, zapisa o ispunjenju, brojeva za praćenje i referenci namenjenih kupcima.
  3. Testirajte ulazne podatke prevoznika: koristite reprezentativne pošiljke kroz glavna odredišta i vrste usluga brenda.
  4. Potvrdite normalizovane statuse: uporedite rezultate API-ja sa dostupnim informacijama o praćenju prevoznika i željenom terminologijom klijenta.
  5. Testirajte slučajeve grešaka: uključite nevažeće brojeve, odložena skeniranja, duplirane zahteve, nepoznate prevoznike, povraćaje i scenarije delimičnih pošiljki.
  6. Sprovedite ograničeno izdanje: pratite stvarni saobraćaj kontrolisane grupe pre uključivanja kompletne baze kupaca.
  7. Dokumentujte vlasništvo: zabeležite ko odobrava formulacije statusa, obrađuje eskalacije podrške i pregleda promene platforme.

Ovaj proces takođe pruža provajderu praktičan način da odluči da li je postojeći dizajn sa jednim API-jem dovoljan. Ako klijent zahteva prevoznika, polje podataka, kanal obaveštenja ili regionalni tok rada koji zajednički sloj ne može pouzdano da podrži, taj nedostatak treba zabeležiti i testirati, a ne sakriti prilagođenim zaobilaznim rešenjem.

Uobičajeni načini otkazivanja koje treba izbeći

  • Korišćenje naziva brendova kao bezbednosnih kontrola: konfiguracija prikaza nije zamena za autorizaciju zakupca.
  • Vraćanje sirovih statusa prevoznika svuda: to stvara zbunjujući jezik za kupce i nedoslednu analitiku.
  • Pretpostavka da jedan broj za praćenje znači jednu porudžbinu: podeljene pošiljke, zamene i povraćaji mogu promeniti taj odnos.
  • Zanemarivanje vremenskih zona: vremenske oznake događaja treba dosledno čuvati i prikazivati na način razumljiv korisnicima.
  • Ugrađivanje obaveštenja u osnovni model podataka: podešavanja obaveštenja treba da budu konfigurabilna kako bi različiti brendovi mogli da koriste različite kanale i formulacije.
  • Testiranje samo uspešnih dostava: izuzeci i nedostajuća ažuriranja obično stvaraju najveće troškove podrške.
  • Obećavanje pokrivenosti prevoznika bez provere: potvrdite trenutne zahteve u vezi sa prevoznikom, regionom i operacijama u zvaničnoj dokumentaciji ili tehničkom proverom koncepta.

Praktični okvir za donošenje odluke

Pristup sa jednim API-jem dobro odgovara situacijama u kojima više brendova deli uglavnom slične tokove rada sa pošiljkama, potrebni su im dosledni podaci prevoznika i žele da provajder usluge preuzme održavanje integracija. Manje je jednostavan kada svaki klijent zahteva suštinski različite ugovore o podacima, strogu regionalnu izolaciju ili operativne procese specifične za prevoznika. Ti zahtevi ne isključuju automatski zajedničku platformu, ali povećavaju potrebu za konfiguracijom, testiranjem i jasno definisanim granicama usluge.

Pre izbora provajdera API-ja sprovedite proveru koncepta koristeći stvarne, ali kontrolisane primere pošiljaka. Testirajte identifikaciju prevoznika, normalizaciju događaja, vreme ažuriranja, odgovore na greške, autentifikaciju, izolaciju zakupaca i mogućnost preuzimanja informacija potrebnih timovima korisničke službe. Pregledajte zvanične smernice za praćenje više prevoznika i dokumentaciju API-ja provajdera, a zatim direktno potvrdite sve nerešene zahteve. Prava odluka ne zasniva se na broju prevoznika navedenih na marketinškoj stranici, već na tome da li provajder može da podrži brendove, odredišta, tokove rada i kontrole kojima će platforma zaista upravljati.

Ako se dobro osmisli, jedan API za praćenje postaje ponovo upotrebljiv operativni sloj, a ne još jedna izolovana integracija. On provajderima postprodajnih usluga pruža dosledan način za prikupljanje ažuriranja pošiljaka, očuvanje iskustava na nivou brenda i skaliranje uvođenja klijenata bez ponavljanja istog rada sa prevoznicima za svaki ecommerce nalog.

Česta pitanja

Može li jedan API da opslužuje više brendova bez deljenja njihovih podataka?

Da, ako se identitet zakupca i autorizacija sprovode kroz ceo sistem. Svaki zahtev treba da bude povezan sa dozvoljenim zakupcem, a upiti za pošiljke treba da se provere u odnosu na tog zakupca pre vraćanja podataka. Zasebni akreditive, pristup zasnovan na ulogama, dnevnici revizije i testovi izolacije treba da budu deo implementacije.

Da li svaki brend treba da koristi istu stranicu za praćenje?

Ne. Zajednički API može da obezbedi normalizovane podatke o praćenju, dok svaki brend koristi sopstvenu stranicu, vidžet, jezik, terminologiju i veze ka podršci. Odvajanje prezentacije od sloja podataka olakšava upravljanje operacijama sa više brendova.

Šta treba testirati pre produkcije?

Testirajte ulazne podatke prevoznika iz stvarnog sveta, nevažeće brojeve za praćenje, odložene događaje, duplirane zahteve, podeljene pošiljke, povraćaje, nepoznate prevoznike, ponovne pokušaje webhook-a kada je primenljivo i kontrole izolacije zakupaca. Takođe proverite da li normalizovani statusi odgovaraju jeziku koji klijent želi da kupci vide.

Da li jedan API uklanja potrebu za upravljanjem razlikama između prevoznika?

Ne. On centralizuje veliki deo integracionog rada, ali razlike između prevoznika i dalje treba pažljivo pratiti i predstavljati. Provajder treba da sačuva korisne detalje sirovih događaja, uz izlaganje stabilnog normalizovanog modela klijentskim aplikacijama.

Kako provajder treba da proceni API za praćenje?

Procenite API u odnosu na stvarne brendove, prevoznike, regione, zahteve za događajima, model autentifikacije, ograničenja, obradu grešaka, ponašanje ažuriranja i proces podrške provajdera. Kontrolisana provera koncepta pouzdanija je od pretpostavke da opšti opis funkcija obuhvata svaki potreban tok rada.

Izvori