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

Како 3Pl и пружаоци услуга испуњења користе API за праћење пошиљака на налозима клијената

17TRACK

3PL i pružaoci usluga ispunjenja koriste API za praćenje pošiljaka kako bi prikupljali ažuriranja prevoznika za pošiljke koje pripadaju većem broju klijenata, a zatim svako ažuriranje usmerili ka odgovarajućem korisničkom nalogu, porudžbini, timu za podršku i prikazu izveštaja. API obezbeđuje podatke o praćenju; sopstveni sistem pružaoca mora da održava vlasništvo klijenata, kontroliše pristup, obrađuje izuzetke i odlučuje šta svaki klijent i kupac mogu da vide.

Kako 3PL i pružaoci usluga ispunjenja koriste API za praćenje pošiljaka

Ova razlika je važna kada jedna skladišna operacija opslužuje mnoge trgovce. Sam broj za praćenje nije identifikator korisničkog naloga. Da bi obezbedio pouzdanu vidljivost između naloga, pružalac usluga ispunjenja mora da vodi evidenciju o tome ko je vlasnik svake pošiljke i da ima ponovljiv proces za pretvaranje ažuriranja prevoznika u informacije specifične za klijenta.

Osnovni tok rada: registrujte, primite, usmerite, postupite

Vlasnik radnje je obično operativni ili inženjerski tim 3PL-a. On jednom integriše uslugu praćenja, a zatim koristi svoj sistem za upravljanje skladištem, sistem za upravljanje porudžbinama ili integracioni sloj da poveže zapise o praćenju sa pojedinačnim klijentima. Praktičan tok rada ima četiri faze:

  1. Registrujte pošiljku. Kada se kreira etiketa ili se paket preda prevozniku, pružalac čuva broj za praćenje, informacije o prevozniku kada su dostupne, ID korisničkog naloga, referencu porudžbine i svaki interni ID pošiljke. Detalje o praćenju prosleđuje svojoj integraciji za praćenje koristeći dokumentovani metod pružaoca.
  2. Primajte ažuriranja. Integracija dobija nove informacije o praćenju putem metoda koje API zaista podržava. U zavisnosti od usluge i konfiguracije, to može obuhvatati zahteve za trenutni status, obaveštenja o promenama ili oba načina.
  3. Usmerite i protumačite. Pružalac povezuje vraćeni zapis o praćenju sa svojim internim ID-jem pošiljke i korisničkim nalogom. Čuva poruku prevoznika i mapira je na ograničen skup operativnih stanja, bez odbacivanja korisnih detalja.
  4. Preduzmite mere. Odgovarajući klijent može da vidi napredak, korisnička služba može da odgovori na upit, a operativni tim može da ispita izuzetak. Ažuriranja namenjena kupcima treba da koriste odobrene kanale i pravila komunikacije tog klijenta.

Ključna odluka o dizajnu donosi se pre prvog API zahteva: svaka pošiljka mora imati nedvosmislenog vlasnika u evidencijama 3PL-a. Bez te veze, odgovor o praćenju može biti tehnički tačan, ali neupotrebljiv — ili vidljiv pogrešnom trgovcu.

Odvojite vlasništvo klijenta od identiteta praćenja

Model podataka za više klijenata treba da razlikuje korisnički nalog, porudžbinu, internu pošiljku, prevoznika i identifikator za praćenje. Oni su povezani, ali nisu međusobno zamenljivi. Jedna porudžbina može proizvesti više paketa; paket može imati broj za praćenje pre nego što se pojave značajna skeniranja prevoznika; a klijent može koristiti različite prevoznike za različite porudžbine.

Na primer, ako skladište pošalje dva paketa za porudžbinu trgovca, stranica porudžbine možda treba da prikaže dve odvojene vremenske linije pošiljki. Ako jedan paket naiđe na problem pri isporuci, 3PL treba da identifikuje pogođeni paket, a ne da celu porudžbinu označi kao neisporučivu. Interni ID pošiljke predstavlja stabilnu tačku povezivanja tih zapisa čak i kada reference porudžbina namenjene kupcima nisu jedinstvene između klijenata.

Čuvajte ID korisničkog naloga sa zapisom pošiljke i sprovodite provere pristupa kada se zapis kreira, preuzima, izvozi ili šalje drugom sistemu. Nemojte se oslanjati na broj za praćenje kao jedini autorizacioni ključ. Brojevi za praćenje su operativni identifikatori, a ne akreditivi, i deljeni kontrolni panel ne sme da otkrije porudžbine jednog trgovca samo zato što korisnik zna broj.

Ako klijenti upravljaju sopstvenim prevoznicima ili obezbeđuju sopstvene akreditive, odredite gde se ti akreditivi čuvaju i koji nalog može da ih koristi. Jedna integracija za praćenje ne znači automatski da svi klijenti dele iste ugovore sa prevoznicima, dozvole za podatke ili preference u komunikaciji sa kupcima. Te granice moraju biti odražene u konfiguraciji i testirane.

Pretvorite poruke prevoznika u upotrebljiv status namenjen klijentu

Opisi događaja prevoznika se razlikuju. 3PL može želeti zajednički skup oznaka — kao što su etiketa kreirana, u transportu, na isporuci, isporučeno i izuzetak — za kontrolne panele i redove za izuzetke. To mapiranje je odluka aplikacije, a ne zamena za originalni događaj. Sačuvajte izvorni status, vreme događaja kada je navedeno, identitet prevoznika i lokaciju kada su dostupni, kako bi agent podrške mogao da razume šta se zaista dogodilo.

Ne tretirajte svaku novu poruku kao napredak. Ažuriranja mogu stići sa zakašnjenjem, opisivati ranija skeniranja ili ponavljati događaj koji je već primljen. Za svako dolazno ažuriranje integracija treba da proveri da li pripada poznatoj pošiljci, da li je duplikat i da li vreme događaja menja vremensku liniju. Najnovija primljena poruka nije nužno najnoviji događaj koji se dogodio.

Slično tome, status „isporučeno“ ne treba pretvarati u tvrdnju da je predviđeni primalac lično preuzeo paket. Značenje skeniranja isporuke zavisi od detalja događaja prevoznika i svih dostupnih informacija o dokazu isporuke za tu pošiljku. Interfejs namenjen klijentu treba da prikaže dokaze kojima raspolaže, a ne da zaključuje više nego što podaci podržavaju.

Koristan obrazac je čuvati i normalizovani status za filtriranje i osnovni događaj prevoznika za istragu. Zajednički status pomaže 3PL-u da pronađe pošiljke kojima je potrebna pažnja kroz više korisničkih naloga; originalni detalj pomaže osoblju da objasni pojedinačnu pošiljku, bez pretvaranja široke kategorije u pogrešan zaključak.

Projektujte obradu izuzetaka prema tome ko može da reši problem

Praćenje postaje operativno vredno kada menja ono što tim radi sledeće. Izuzetak pri isporuci može zahtevati obaveštavanje klijenta, upit prevozniku, proveru adrese ili nikakvu neposrednu radnju dok se čeka naredno skeniranje. Ispravan odgovor zavisi od događaja i odgovornosti dodeljenih između 3PL-a i njegovog klijenta.

Uspostavite pravila vlasništva za uobičajene slučajeve pre izrade upozorenja. Na primer, 3PL može biti odgovoran za istragu paketa za koji izgleda da je zastao pre predaje, dok trgovac obrađuje zahtev kupca za promenu adrese isporuke. To su primeri mogućih aranžmana, a ne univerzalna pravila. Svaki pružalac treba da dokumentuje sopstvene granice usluge i put eskalacije.

Pravila obaveštavanja takođe zahtevaju zaštitne mere. Slanje poruke za svako skeniranje može preopteretiti osoblje i kupce. Međutim, potiskivanje svakog ponovljenog statusa može sakriti značajnu promenu lokacije ili novi izuzetak. Definišite koji događaji ulaze u operativni red, koji se pojavljuju samo na kontrolnom panelu i koji mogu pokrenuti komunikaciju sa klijentom ili kupcem. Omogućite osoblju pristup osnovnoj vremenskoj liniji praćenja kada je potrebno preispitati pravilo.

Šta proveriti pri izboru ili implementaciji API-ja

API za praćenje dobro odgovara kada je 3PL-u potrebno da ažuriranja pošiljaka dobija u svojim sistemima, umesto da zaposleni proveravaju svakog prevoznika pojedinačno. Pitanje nabavke nije samo da li API vraća status. Važno je da li njegovo dokumentovano ponašanje podržava stvarnu mešavinu pošiljaka i tok naloga pružaoca.

  • Usklađenost prevoznika i pošiljaka: Proverite konkretne prevoznike i usluge slanja koje klijenti koriste. Potvrdite kako API identifikuje prevoznika i šta se dešava kada je broj za praćenje nejasan ili još nema događaja.
  • Dostavljanje ažuriranja: Pregledajte dokumentovane opcije za dobijanje promena, očekivane formate zahteva i odgovora i način obrade grešaka ili ponovljenih pokušaja. Ako su obaveštenja o događajima dostupna, proverite njihovu autentifikaciju i ponašanje pri ponovnom pokušaju, umesto da pretpostavite da uklanjaju sve naknadne zahteve.
  • Mapiranje naloga: Utvrdite da li pružalac može da doda sopstvenu referencu zapisu o praćenju. Bez obzira na funkcije API-ja, održavajte interno mapiranje od zapisa o praćenju do korisničkog naloga i ID-ja pošiljke.
  • Detalji podataka: Pregledajte primere odgovora za događaje, vremenske oznake, opise prevoznika, lokacije i informacije o isporuci koje su potrebne operacijama i podršci. Potvrdite koja polja mogu nedostajati.
  • Operativna ograničenja: Proverite dokumentovanu autentifikaciju, ograničenja korišćenja, odgovore na greške i komercijalne uslove relevantne za očekivani obim pošiljaka. Ne procenjujte troškove na osnovu istaknute cene bez testiranja planiranog obrasca zahteva.
  • Bezbednost i čuvanje: Odlučite ko može da pristupa istorijama praćenja, kako se akreditivi štite, koliko dugo se zapisi čuvaju i kako klijenti dobijaju ili izvoze sopstvene podatke.

17TRACK stranica API-ja za praćenje i dokumentacija za programere predstavljaju relevantne početne tačke za pružaoca koji procenjuje integraciju za praćenje kod više prevoznika. Njihovo postojanje ne znači da usluga upravlja dozvolama klijenata 3PL-a ili strukturom naloga. Proverite trenutno ponašanje API-ja u dokumentaciji i testnoj integraciji, a zatim implementirajte vlasništvo nad korisnicima i kontrole pristupa u sopstvenoj aplikaciji 3PL-a, osim ako nije potvrđen konkretan podržani aranžman.

Mali pilot otkriva više od kontrolne liste funkcija

Pre povezivanja svakog korisničkog naloga, sprovedite pilot sa namerno mešovitom grupom pošiljaka. Uključite više od jednog klijenta, prevoznike koje ti klijenti zaista koriste, porudžbinu sa više paketa, broj za praćenje bez početnog skeniranja i pošiljke koje dostignu i uobičajena stanja isporuke i stanja izuzetaka. Podatke pilota držite odvojene od komunikacije u produkciji kako testovi ne bi slučajno slali poruke kupcima.

Pratite svaku pošiljku od zapisa u skladištu, preko registracije praćenja, do prikaza klijenta. Postavite konkretna pitanja: Da li pravi nalog poseduje zapis? Da li drugi nalog može da ga vidi putem kontrolnog panela, pretrage, izvoza ili obaveštenja? Da li je staro skeniranje pravilno postavljeno na vremenskoj liniji događaja? Šta se dešava ako usluga praćenja privremeno odbije zahtev ili ne vrati nove informacije? Može li agent podrške i dalje da identifikuje originalnu formulaciju prevoznika?

Odgovore zabeležite kao kriterijume prihvatanja, a ne kao utiske. Uspešan pilot pokazuje da 3PL može da identifikuje vlasnika svake pošiljke, prikaže korisne događaje, oporavi se od uobičajenih grešaka integracije i usmeri izuzetke pravom timu. Ako ti uslovi nisu ispunjeni, dodavanje novih korisničkih naloga će uvećati problem umesto da ga reši.

Najtrajnija arhitektura tretira praćenje kao zajednički ulaz podataka sa kontrolama specifičnim za klijenta oko njega. API pomaže u pribavljanju informacija o pošiljkama; 3PL ostaje odgovoran za povezivanje tih informacija sa porudžbinama, zaštitu granica naloga i pretvaranje podataka u konkretne radnje.

ČESTA PITANJA

Može li 3PL koristiti jednu integraciju API-ja za praćenje za više klijenata?

Potencijalno da, ako uslovi i tehnički model API-ja podržavaju predviđenu upotrebu. 3PL i dalje mora da identifikuje koji klijent poseduje svaku pošiljku i da sprovodi tu granicu kroz sve svoje sisteme. Potvrdite zahteve u vezi sa nalogom, akreditivima i komercijalnim uslovima sa pružaocem API-ja, umesto da pretpostavite da jedna integracija dozvoljava svaki aranžman.

Da li korisnički nalozi treba da dele isti kontrolni panel za praćenje?

Mogu deliti istu osnovnu aplikaciju, ali svaki klijent treba da vidi samo pošiljke i informacije kojima je ovlašćen da pristupa. Testirajte izolaciju kroz pretragu, izvoz, obaveštenja, alate za podršku i API odgovore — ne samo na glavnoj stranici kontrolnog panela.

Šta ako broj za praćenje odmah ne vraća ažuriranja?

Ostavite pošiljku povezanu sa njenom porudžbinom i korisničkim nalogom, prikažite tačno stanje na čekanju i sledite dokumentovane smernice API-ja za ponovnu proveru. Etiketa može postojati pre nego što se pojavi aktivnost prevoznika; odsustvo skeniranja ne treba automatski prikazati kao izgubljen paket.

Da li je API za praćenje dovoljan za slanje brendiranih ažuriranja o isporuci?

Ne. Podaci o praćenju mogu obezbediti događaj koji pokreće ažuriranje, ali 3PL ili trgovac takođe mora da odluči ko ga šalje, koje brendiranje klijenta se primenjuje, kojim primaocima je dozvoljeno slanje i šta poruka treba da kaže. Ta pravila komunikacije i naloga nalaze se izvan samog događaja praćenja.

Koju prvu kontrolu treba izgraditi za uvođenje kod više klijenata?

Izgradite i testirajte vezu između svakog internog ID-ja pošiljke i korisničkog naloga koji je njen vlasnik. Primenite tu proveru vlasništva svuda gde se podaci o praćenju mogu pregledati ili distribuirati. To je osnova za pouzdano izveštavanje, tokove rada podrške i izolaciju naloga.

Izvori