Skip to main content
ПочетакБлогVodičiMože li API za praćenje da radi bez otpremnih nalepnica? Praćenje 3Pl i porudžbina sa marketplace platformi?

Može li API za praćenje da radi bez otpremnih nalepnica? Praćenje 3Pl i porudžbina sa marketplace platformi?

17TRACK

Da. API za praćenje može da funkcioniše bez toga da vaše preduzeće kreira transportne etikete, pod uslovom da je prevoznik ili partner za slanje kreirao pošiljku koja se može pratiti i da možete da dobijete upotrebljiv broj za praćenje ili drugi identifikator koji API podržava. Ovo je uobičajeno kada logistički provajder treće strane (3PL) ili prodajno tržište upravlja ispunjavanjem porudžbina. Razlika je između toga da sami ne kupujete etiketu i toga da uopšte nemate identifikator pošiljke: prvo je obično izvodljivo; drugo može ostaviti API bez ičega što bi mogao da prati.

Može li API za praćenje da funkcioniše bez transportnih etiketa za praćenje 3PL pošiljki

Za prodavca, operatera prodajnog tržišta ili integracioni tim, praktičan zadatak je povezivanje svake porudžbine sa pošiljkom koju je kreirala strana koja je stvarno šalje. Za to je potreban pristup odgovarajućim podacima, a ne nužno kontrola nad kreiranjem etiketa.

Šta je API-ju za praćenje potrebno kada ne kreirate etiketu

Transportna etiketa je jedan od načina za generisanje identifikatora pošiljke, ali ona obično nije ulazni podatak koji API za praćenje čita. Integracije za praćenje uglavnom rade sa podacima o pošiljci koji se dostavljaju nakon što je etiketa kreirana na drugom mestu. Pre projektovanja veze, razdvojite tri zapisa koji se često smatraju međusobno zamenljivim:

  • ID porudžbine: Identifikuje kupovinu u vašoj prodavnici, nalogu na prodajnom tržištu ili sistemu za upravljanje porudžbinama. Može obuhvatati više artikala i više pošiljki.
  • ID ispunjavanja porudžbine ili paketa: Identifikuje radnju ispunjavanja ili paket u sistemu 3PL-a ili prodajnog tržišta. Njegov format i značenje zavise od tog sistema.
  • Broj za praćenje kod prevoznika: Identifikuje pošiljku u svrhu praćenja, pod uslovom da ga prevoznik i usluga praćenja prihvataju.

Vaš interni ID porudžbine pomaže vam da pronađete odgovarajuću porudžbinu kupca. On automatski ne funkcioniše kao broj za praćenje kod prevoznika. Uobičajeni obrazac integracije je preuzimanje broja za praćenje od 3PL-a ili prodajnog tržišta, registrovanje ili upućivanje tog broja putem API-ja za praćenje i čuvanje vraćenih informacija o pošiljci uz odgovarajuću porudžbinu ili paket.

Možda će biti potrebno i ime ili kod prevoznika. Neke usluge mogu pokušati da prepoznaju prevoznika, ali to treba testirati, a ne pretpostaviti, naročito kada se identifikatori preklapaju između prevoznika ili kada porudžbina prolazi kroz više dostavnih mreža. Pre nego što se odlučite za implementaciju, proverite dokumentaciju API-ja u vezi sa prihvaćenim identifikatorima, pravilima izbora prevoznika, zahtevima za registraciju i poljima statusa.

Praćenje porudžbina koje šalje 3PL

Kada 3PL zapakuje porudžbinu, kupi etiketu i preda paket prevozniku, vaše preduzeće možda nikada neće videti samu etiketu. I dalje su vam potrebni podaci o pošiljci koji nastaju u tom procesu. Pitajte 3PL koji sistem ili kanal omogućava pristup brojevima za praćenje, informacijama o prevozniku, identifikatorima paketa i referenci porudžbine koju ste naveli prilikom zahteva za ispunjavanje.

Izvodljiv tok rada sa 3PL-om obično izgleda ovako:

  1. Pošaljite porudžbinu i stabilnu referencu 3PL-u kroz postojeći proces ispunjavanja.
  2. Primite potvrdu ispunjavanja koja sadrži broj za praćenje na nivou paketa i, kada je dostupan, prevoznika.
  3. Povežite taj paket sa odgovarajućom porudžbinom kupca i artiklima.
  4. Pošaljite podržani identifikator pošiljke svom API-ju za praćenje ili koristite propisani proces pretrage API-ja.
  5. Beležite ažuriranja praćenja uz paket, a zatim predstavite prikaz na nivou porudžbine svom operativnom timu ili kupcu.

Koraku povezivanja treba posvetiti posebnu pažnju. Jedna porudžbina može napustiti skladište u dve kutije, ili jedan artikal može biti poslat kasnije od ostalih. U oba slučaja ne postoji jedan status paketa koji tačno opisuje celu porudžbinu. Čuvajte zapise na nivou paketa, a poruku na nivou porudžbine izvedite iz njih. Na primer, nemojte označiti porudžbinu kao isporučenu samo zato što je njen prvi paket isporučen.

Dogovorite se sa 3PL-om o načinu dostavljanja ispravki. Etikete mogu biti poništene, paketi mogu biti prepakovani, a početni broj za praćenje može biti zamenjen. Vaša integracija treba da može da poveže zamenu sa istom porudžbinom, bez toga da oba broja neograničeno prikazuje kao aktivne pošiljke.

Praćenje porudžbina sa prodajnog tržišta kada prodajno tržište kontroliše slanje

Ispunjavanje porudžbina sa prodajnog tržišta postavlja slično tehničko pitanje, ali drugačije pitanje pristupa. Prodajno tržište ili njegov partner za ispunjavanje može kreirati etiketu, dok prodavac može primiti samo podatke o slanju koje njegov nalog, tok porudžbine ili ovlašćena integracija izlaže. API za praćenje ne može nadoknaditi broj za praćenje koji vam prodajno tržište nije učinilo dostupnim.

Počnite utvrđivanjem modela ispunjavanja za svaku porudžbinu. Kod porudžbina koje ispunjava prodavac, vaš sopstveni tok slanja ili 3PL može biti izvor podataka o paketu. Kod porudžbina koje ispunjava prodajno tržište, prodajno tržište može biti izvor informacija o pošiljci, a polja dostupna prodavcu mogu se razlikovati. Nemojte pretpostaviti da stranica porudžbine koja prikazuje status isporuke takođe pruža broj za praćenje kod prevoznika pogodan za registraciju u zasebnom API-ju.

Ako prodajno tržište obezbeđuje broj koji se može pratiti, potvrdite da vam je dozvoljeno da ga preuzmete i koristite u predviđenom sistemu. Zatim testirajte da li API za praćenje prihvata taj identifikator i da li dobijeni događaji pružaju korisne informacije mimo statusa na prodajnom tržištu. Ako prodajno tržište izlaže samo sopstvenu referencu porudžbine ili isporuke, proverite da li postoji izričito podržan način pretrage. Nemojte slati interni ID porudžbine sa prodajnog tržišta kao da je broj prevoznika i očekivati pouzdane rezultate.

Držite stanje porudžbine na prodajnom tržištu i stanje pošiljke u API-ju za praćenje odvojeno. Prodajno tržište može opisati porudžbinu kao poslatu čim se potvrdi ispunjavanje, dok praćenje kod prevoznika i dalje može pokazivati da nema skeniranja pri prijemu. Ti zapisi odgovaraju na različita pitanja i mogu se ažurirati u različito vreme.

Kada praćenje bez etikete neće rešiti problem

„Mi nismo kreirali etiketu“ nije prepreka. Sledeće situacije mogu biti:

  • Pošiljka nije kreirana: Pre nego što ispunjavanje generiše upotrebljiv identifikator, možda ne postoji pošiljka prevoznika koju je moguće pretražiti. Sama potvrda porudžbine nije dokaz da je paket u tranzitu.
  • Identifikator vam nije dostupan: 3PL ili prodajno tržište mogu zadržati broj, a da ga ne izlože kroz vaš ovlašćeni tok rada. Taj problem pristupa podacima rešite na izvoru.
  • Identifikator nije podržan: Referentni broj, kod namenjen samo prodajnom tržištu ili format nepodržanog prevoznika možda neće funkcionisati sa izabranim API-jem. Proverite prihvaćene ulazne podatke u dokumentaciji i pomoću probne pošiljke.
  • Paket još nema novo skeniranje: Broj može postojati pre nego što prevoznik zabeleži događaj prijema. Prazan ili nepromenjen rezultat tretirajte kao stanje koje treba ispitati, a ne kao automatski dokaz da je broj nevažeći.
  • Praćenje je ograničeno ili nepotpuno: Prevoznik, usluga ili tok pošiljke možda ne pružaju događaje koji su potrebni vašem korisničkom scenariju. Potvrdite stvarni kvalitet događaja pomoću reprezentativnih pošiljki.

Ova ograničenja su važna jer API ne može da kreira fizičke događaje koji nedostaju niti da omogući pristup podacima o porudžbinama druge strane. Njegova vrednost je u preuzimanju i organizovanju podržanih informacija o praćenju kada neophodni identifikator i dozvole postoje.

Kako proceniti API za ovaj tok rada

17TRACK-ov API za praćenje je relevantna opcija za razmatranje kada vašem timu trebaju podaci o praćenju pošiljki u sopstvenim sistemima, a ne alat za kupovinu etiketa. Njegova dokumentacija za programere predstavlja mesto za proveru prihvaćenih polja za registraciju, podržanih prevoznika, strukture odgovora, autentifikacije i svih dostupnih metoda dostavljanja ažuriranja za vaš slučaj upotrebe. Nemojte zaključivati da su određeni 3PL, prodajno tržište ili vlasnički identifikator podržani samo na osnovu postojanja opšteg API-ja za praćenje.

Pre izbora ili uvođenja bilo kog provajdera napravite mali skup testova. Uključite porudžbinu iz 3PL-a sa brojem prevoznika, porudžbinu sa prodajnog tržišta za koju vaš nalog izlaže broj, porudžbinu sa više paketa, broj kreiran pre prvog skeniranja i pošiljku sa kasnijim događajem isporuke. Ako su zamene ili međunarodne primopredaje uobičajene, uključite i njih. Test treba da odgovori na operativna pitanja, a ne samo na to da li zahtev vraća uspešan HTTP odgovor:

  • Možete li proslediti identifikatore koje stvarno primate, bez njihovog ručnog prepisivanja?
  • Možete li pouzdano povezati svaki zapis praćenja sa odgovarajućom porudžbinom i paketom?
  • Da li su opisi događaja, vremenske oznake i informacije o prevozniku dovoljni za vaše poruke kupcima i tokove korisničke podrške?
  • Kako će vaš sistem postupati sa duplim ažuriranjima, događajima koji nedostaju, promenama brojeva i neuspelim zahtevima?
  • Da li je vaša predviđena upotreba podataka sa prodajnog tržišta i podataka o kupcima u skladu sa uslovima pristupa koji se primenjuju na te podatke?

Za samu integraciju sačuvajte i izvorni zapis i zapis API-ja za praćenje. Čuvajte referencu porudžbine, referencu paketa, poslati broj za praćenje, informacije o prevozniku ako su dostupne i vreme prijema svakog ažuriranja. Tako je lakše istražiti nepodudaranje, bez predstavljanja događaja iz API-ja kao da je kompletna istorija ispunjavanja. Ako API nudi izbor između provere po rasporedu i primanja ažuriranja putem podržanog mehanizma dostavljanja, izaberite na osnovu dokumentovanog ponašanja i potrebe za pravovremenim ažuriranjima; nijedan pristup ne uklanja potrebu za obradom grešaka.

Praktična odluka

Koristite API za praćenje bez kreiranja etiketa kada druga strana šalje paket i daje vam podržani identifikator pošiljke koji ste ovlašćeni da koristite. Najpre obezbedite pouzdan kanal podataka o paketima od 3PL-a ili prodajnog tržišta. Zatim testirajte identifikatore i događaje praćenja u odnosu na API i svoju logiku povezivanja porudžbina. Ako imate samo ID porudžbine ili status sa prodajnog tržišta, rešite taj nedostatak izvornih podataka pre ulaganja u integraciju za praćenje kod prevoznika.

Česta pitanja

Mogu li da pratim porudžbinu koristeći samo broj porudžbine iz svoje prodavnice?

Obično ne putem API-ja za praćenje kod prevoznika. Broj porudžbine iz vaše prodavnice identifikuje kupovinu u vašem sistemu. Uglavnom vam je potreban odgovarajući identifikator pošiljke, osim ako određena usluga izričito podržava pretragu prema vašoj vrsti reference porudžbine.

Da li mi je potrebna dozvola 3PL-a za korišćenje njegovih brojeva za praćenje?

Potvrdite svoj ugovorni i tehnički pristup podacima o pošiljci. 3PL možda već vraća brojeve za praćenje kao deo svog kanala za ispunjavanje, ali integracija treba da koristi ovlašćeni kanal i da pravilno postupa sa podacima o kupcima.

Zašto API ne prikazuje kretanje nakon što 3PL pošalje broj?

Broj je možda kreiran pre prvog zabeleženog skeniranja kod prevoznika. Proverite da li su identifikator i prevoznik ispravni, da li je prvobitna etiketa zamenjena i da li kasniji upit proizvodi događaje. Nemojte izjednačavati „još nema skeniranja“ sa „nije poslato“ bez provere zapisa o ispunjavanju.

Šta ako se jedna porudžbina sa prodajnog tržišta šalje u više paketa?

Pratite svaki dostupni identifikator paketa zasebno i povežite sve pakete sa istom porudžbinom. Držite status porudžbine namenjen kupcu odvojenim od statusa pojedinačnih paketa, kako jedan isporučeni paket ne bi učinio da cela porudžbina izgleda završeno.

Izvori