Skip to main content
DomovBlogVodnikiKako lahko čezmorska skladišča uporabljajo API-je za sledenje za spremljanje lokalnih dostav

Kako lahko čezmorska skladišča uporabljajo API-je za sledenje za spremljanje lokalnih dostav

17TRACK

Čezmorska skladišča lahko uporabljajo API-je za sledenje in spremljajo lokalne dostave tako, da vsak odposlani paket povežejo z njegovim prevoznikom in sledilno številko, dogodke sledenja prenesejo v svoj sistem za upravljanje skladišča ali naročil ter izjeme pri dostavi spremenijo v dodeljene naloge. Najuporabnejša nastavitev razlikuje med ustvarjanjem nalepke in sprejemom pri prevozniku, ohranja zgodovino pošiljke ter operativnim ekipam pokaže, kateri paketi zahtevajo ukrepanje – ne le, kateri paketi imajo novo stanje.

Kako lahko čezmorska skladišča uporabljajo API-je za sledenje lokalnih dostav

Ta vodnik se osredotoča na skladišča, ki hranijo zalogo zunaj domačega trga trgovca in odpošiljajo naročila strankam na ciljnem trgu. Za te ekipe mora čezmorsko sledenje povezati zapise o odpremi iz skladišča s potekom dostave pri lokalnem prevozniku. Ta povezava pomaga vodjem skladišč, koordinatorjem prevoza in ekipam za podporo trgovcem delati z istim zapisom pošiljke.

Določite, kje se konča preglednost skladišča in začne preglednost prevoznika

Sistem za upravljanje skladišča lahko zabeleži, da je bilo naročilo prevzeto, zapakirano, opremljeno z nalepko in odloženo na območje za odpremo. Ti zapisi sami po sebi ne dokazujejo, da je prevoznik paket sprejel. API za sledenje doda dogodke, ki jih poroča prevoznik, vendar ne more nadomestiti zapisa o predaji v skladišču ali ustvariti fizičnega skena, ki se ni nikoli zgodil.

Tri mejnike ohranite ločene: pripravljeno na prevzem, predano v skladu z zapisi skladišča in sprejeto v skladu z dogodki sledenja prevoznika. Ta ločitev olajša preiskavo paketov, ki so interno videti kot odposlani, vendar pri prevozniku nimajo premikov.

Če je na primer paket naveden na seznamu za prevzem, vendar nima dogodka sprejema, je naslednji korak preverjanje zapisov o nakladanju in stik s prevoznikom, ki opravlja prevzem. Prezgodaj bi bilo paket označiti kot izgubljen. Če je prevoznik že poročal o neuspešnem poskusu dostave, je ustrezen ukrep drugačen: preučite razlog in s trgovcem ali pooblaščenim kontaktom prejemnika uskladite naslednji korak.

Vzpostavite zapis pošiljke, preden povežete API

Temelj je zanesljiva povezava med naročilom stranke, fizičnim paketom in identifikatorjem za sledenje pri prevozniku. Številke naročila ne uporabljajte kot nadomestilo za identifikator paketa. Eno naročilo lahko zapusti skladišče v več paketih, nadomestna pošiljka pa potrebuje lasten zapis.

ZapisPriporočena poljaOperativni namen
Identiteta pošiljkeInterni ID pošiljke, ID naročila, ID paketa, račun trgovcaLočite razdeljene pošiljke in različne stranke.
Identiteta prevoznikaIdentifikator prevoznika, sledilna številka, storitev, če je znanaPošljite pravilen zahtevek za sledenje in usmerjajte preiskave.
Predaja v skladiščuSkladišče, čas odpreme, referenca prevzema, referenca manifestaPrimerjajte fizične dokaze o odpremi z dogodki prevoznika.
Zgodovina sledenjaSurovi dogodek, preslikano stanje, čas dogodka, čas prejema, lokacija, če je navedenaOhranite dokaze in razlikujte med časom dogodka ter zamudami pri poročanju.
Potek dela za izjemeVrsta težave, odgovorna oseba, naslednji ukrep, rok pregleda, rešitevInformacije o sledenju spremenite v odgovorno delo.

Sledilne številke shranjujte kot besedilo, da se ohrani njihovo oblikovanje. Če skladišče že pozna prevoznika iz ustvarjanja nalepke, to identiteto posredujte prek integracije, namesto da bi se zanašali samo na prepoznavanje številke. Ohranjajte tudi povezave med prvotnimi, nadomestnimi, vračilnimi in nadaljnjimi dostavnimi paketi, ne da bi prepisali njihove posamezne zgodovine.

Izberite integracijo, ki ustreza mešanici prevoznikov v skladišču

Skladišče se lahko neposredno integrira s prevozniki ali uporabi API za sledenje več prevoznikom. Neposredna integracija je lahko praktična za stabilno poslovanje z majhnim številom prevoznikov, zlasti kadar so potrebni podatki, značilni za posameznega prevoznika. API za več prevoznikov je smiselno oceniti, kadar skladišče potrebuje enoten vmesnik za sledenje v več dostavnih omrežjih.

Tracking API podjetja 17TRACK je primerna možnost za ta model integracije. V official API documentation preverite, kako bi se registracija pošiljk, pridobivanje podatkov o sledenju in posodobitve sledenja vključili v vaš sistem. Potrdite natančne kombinacije prevoznikov in storitev, ki jih uporablja posamezno skladišče, namesto da bi splošna razpoložljivost prevoznika pomenila, da bodo vrnjeni vsi zahtevani dogodki.

Povezavo ocenite glede na dejanske operativne zahteve:

  • Ali lahko vaš sistem zanesljivo registrira pakete, ustvarjene v konicah odpreme?
  • Kateri dogodki se vrnejo za lokalne dostavne storitve, ki jih dejansko kupujete?
  • Kako se obravnavajo neuspešni zahtevki, podvojene registracije in neveljavni identifikatorji prevoznikov?
  • Kako se posodobitve dostavijo ali pridobijo in kako je mogoče uskladiti izpuščene posodobitve?
  • Katere omejitve uporabe, pogoji hrambe, varnostni ukrepi in komercialni pogoji veljajo za vaš račun?

Ne predpostavljajte, da povezava za sledenje vključuje nakup nalepk, popravljanje naslova, prestavljanje dostave ali oddajo zahtevkov. Obravnavajte jih kot ločene poteke dela, razen če ustrezna dokumentacija izdelka izrecno potrdi drugače.

Povežite odpremo, posodobitve sledenja in obravnavo izjem

1. Registrirajte pakete ob nadzorovanem mejniku odpreme

Izberite dosleden sprožilec registracije, na primer potrditev nalepke ali potrditev odpreme. Registracija ob ustvarjanju nalepke lahko razkrije pakete, ki ostanejo neprevzeti, vendar zahteva tudi obravnavo preklicanih nalepk. Registracija šele po odpremi zmanjša število neuporabljenih registracij, vendar lahko skrije čas med ustvarjanjem nalepke in fizično predajo.

Ne glede na izbrani sprožilec shranite rezultat registracije pri paketu. Neuspešne registracije morajo vstopiti v čakalno vrsto za ponovni poskus ali popravek, namesto da izginejo v dnevnikih aplikacije. Uporabite stabilen interni identifikator, da ponavljajoča obdelava ne ustvari podvojenih poslovnih zapisov.

2. Prejemajte posodobitve, ne da bi nadzorna plošča postala vir resnice

Odvisno od dokumentiranih možnosti API-ja lahko posodobitve pridobite prek zahtevkov ali prejmete prek obvestil webhook. Webhook je sporočilo, poslano vašemu sistemu, ko ima ponudnik posodobitev; anketiranje pomeni, da vaš sistem zahteva informacije.

Pri izvedbah na osnovi webhooka preverite dohodna sporočila z dokumentirano metodo ponudnika. Sprejeta sporočila trajno shranite, preden jih potrdite, nato pa jih obdelajte asinhrono. Načrtujte podvojena sporočila in dogodke, ki prispejo v napačnem vrstnem redu. Upoštevajte dokumentirane zahteve glede odgovorov in ponovnih poskusov, namesto da bi predpostavljali enako vedenje vseh ponudnikov.

Pri anketiranju dajte prednost aktivnim pošiljkam in nerešenim izjemam, pri tem pa ostanite znotraj veljavnih omejitev uporabe. Kjer je podprto, uporabite zahtevke za uskladitev, da preverite pošiljke, katerih zgodovina posodobitev je videti nepopolna. Napake pri zajemu podatkov beležite ločeno od izjem pri dostavi prevoznika: nedelujoča povezava ni dokaz, da se je paket prenehal premikati.

3. Normalizirajte stanja in hkrati ohranite izvirne dokaze

Ustvarite majhen nabor operativnih kategorij, kot so čakanje na sprejem, v tranzitu, poslano v dostavo, poskus dostave, dostavljeno in vračanje. To so predlagane kategorije za skladišče, ne obljuba, da bo vsak prevoznik zagotavljal ujemajoče se dogodke.

Izvirni opis ohranite poleg preslikane kategorije. »Na voljo za prevzem« se ne sme tiho spremeniti v »dostavljeno«, »vračilo začeto« pa ne v »prejeto nazaj v skladišče«. Dovolite neznano ali nepreslikano stanje, da neznani dogodki ostanejo vidni za pregled.

Shranite časovni žig dogodka in čas, ko ga je prejel vaš sistem. Če je naveden, ohranite izvirni časovni pas ali odmik ter uporabljajte enoten interni časovni standard. Pozno prispeli dogodek ne sme samodejno premakniti pošiljke nazaj samo zato, ker je bil prejet zadnji; uporabite izrecna pravila zaporedja in ohranite zgodovino.

4. Dodelite odgovorne osebe za izjeme

Opozorilo je uporabno samo, če lahko nekdo ukrepa. Manjkajoče skene sprejema usmerite ekipi skladiščne odpreme, poskuse dostave, ki zahtevajo odziv prejemnika, podporni ekipi trgovca, trajne težave s premiki pri prevozniku pa koordinatorju prevoza. To so priporočene začetne točke; odgovornosti naj odražajo pogodbe in operativni model skladišča.

Vsakemu primeru dodajte zgodovino sledenja, referenco predaje, zadnji dogodek, opombe preiskave in čas naslednjega pregleda. Ponavljajoča opozorila združite pod isto odprto težavo, da en zastal paket po vsaki sinhronizaciji ne ustvari nove naloge.

Opozorila nastavite glede na pričakovano raven storitve, ne na poljubne časovnike

Ni univerzalnega intervala, po katerem paket brez novega skena postane pozen ali izgubljen. Pragove opozoril nastavite glede na storitev prevoznika, urnik prevzema, delovne dni, cilj in zavezo trgovca. Interni prag za preiskavo naj bo ločen od obljube dostave, namenjene stranki.

  • Po predaji ni sprejema: Pred eskalacijo preverite zapis prevzema in potrdilo prevoznika.
  • Brez premika dlje od pričakovanega intervala: Preglejte zadnji dogodek, pričakovano raven storitve in znane prekinitve delovanja.
  • Neuspešen poskus dostave: Pred odločitvijo, ali naslednji ukrep pripada prevozniku, trgovcu ali prejemniku, preberite razlog.
  • Vračanje: Pripravite potek dela za vračila, vendar ne povečujte prodajnih zalog, dokler paket ni fizično prejet in pregledan.
  • Dostavljeno, vendar sporno: Odprite preiskavo in poiščite razpoložljive dokaze o dostavi; samega stanja ne obravnavajte kot rešitev pritožbe.

Sledenje odraža sporočene dogodke pošiljke, ne neprekinjene lokacije paketa. Prikaz časovnega žiga zadnje posodobitve osebju pomaga razumeti aktualnost informacij, ne da bi nakazoval vpogled v GPS v živo.

Vsaki ekipi zagotovite uporaben pogled

Nadzorniki skladišča potrebujejo izjeme med odpremo in sprejemom. Koordinatorji prevoza potrebujejo čakalne vrste po prevoznikih in primere glede na starost. Ekipe za podporo trgovcem potrebujejo jasno časovnico pošiljke in naslednji dogovorjeni ukrep. Skupni podatkovni model lahko podpira te poglede, ne da bi vsakemu uporabniku omogočil dostop do pošiljk vseh trgovcev.

V skladišču z več strankami uveljavite dostop na ravni trgovca na strežniku, ne le prek filtrov nadzorne plošče. Poverilnic API-ja ne vključujte v kodo brskalnika, omejite dostop do podatkov o prejemnikih ter določite pravila hrambe in brisanja. V reference sledenja ali diagnostične dnevnike ne dodajajte nepotrebnih osebnih podatkov.

Uporabne meritve vključujejo delež odposlanih paketov, uspešno registriranih za sledenje, delež z dogodki sprejema pri prevozniku, čas od odpreme do sprejema, starost nerešenih izjem in napake pri obdelavi integracije. Določite vsak imenovalec in časovno osnovo. Pri merjenju pravočasne dostave primerjajte z dokumentirano obljubo ali zavezo storitve, ne s splošnim trajanjem dostave.

Pred širitvijo najprej preizkusite potek dela

Začnite z jasno opredeljenim skladiščem, naborom prevoznikov in skupino trgovcev. Vključite običajne dostave ter zahtevne zapise: preklicane nalepke, razdeljena naročila, manjkajoče prve skene, neuspešne poskuse dostave, podvojena obvestila, dogodke v napačnem vrstnem redu in vračila. Kjer je primerno, uporabite odobrene testne podatke ali zgodovinske zapise; v produkciji ne izmišljajte dogodkov prevoznikov.

Pred uvedbo se dogovorite o merilih sprejemljivosti. Vsak odposlan paket mora imeti bodisi uspešen zapis registracije bodisi primer neuspeha z določeno odgovorno osebo. Ponovno predvajana sporočila ne smejo ustvariti podvojenih nalog. Dogodki sledenja morajo ostati sledljivi do svojega vira, uporabniki pa ne smejo videti zapisov drugega trgovca.

Širite rešitev šele, ko lahko operativno osebje zanesljivo obdeluje čakalno vrsto izjem, tehnično osebje pa obnovi neuspešne posodobitve. Praktični cilj ni nadzorna plošča, polna stanj. Cilj je sledljiva povezava od odpreme v skladišču do dostave pri prevozniku z jasno odgovornostjo, kadar ta pot zahteva pozornost.

Pogosta vprašanja

Ali lahko API za sledenje nadomesti sistem za upravljanje skladišča?

Ne. API za sledenje zagotavlja preglednost pošiljke. Sistem skladišča ostaja odgovoren za dejavnosti, kot so nadzor zaloge, prevzem, pakiranje in fizični zapisi o odpremi. Oba sistema povežite prek identifikatorjev paketov, da dogodki prevoznika dodajo kontekst, ne da bi nadomestili dokaze skladišča.

Ali API za sledenje zagotavlja lokacijo GPS v realnem času?

Ne predpostavljajte tega. Sledenje paketom običajno vključuje sporočene dogodke in lokacije. Čas posodobitve je odvisen od prevoznika in integracije. Neprekinjena lokacija vozila ali paketa zahteva ločeno preverjeno zmogljivost.

Kaj naj osebje stori, ko paket nima posodobitev sledenja?

Najprej preverite uspešnost registracije, identiteto prevoznika in pravilnost sledilne številke. Nato primerjajte zadnji dogodek z dokazi o predaji v skladišču in pričakovano časovnico storitve. Pred odločitvijo, katera ekipa naj eskalira primer, ločeno preiščite napake integracije in manjkajoče skene prevoznika.

Ali lahko dogodki sledenja samodejno sprožijo vračila ali posodobitve zaloge?

Obvestijo lahko potek dela, vendar pomembni ukrepi zahtevajo dodatne nadzore. Izjema pri dostavi ne dokazuje nujno upravičenosti do vračila, vračanje pa ne dokazuje fizičnega prejema v skladišču. Pred spreminjanjem denarnih ali zalogovnih zapisov uporabite politike trgovca, preverjanje pooblastil in postopke prevzema.

Kako naj se razdeljena naročila prikažejo ekipam za podporo trgovcem?

Vsak paket prikažite ločeno pod nadrejenim naročilom. Dostava enega paketa ne sme označiti celotnega naročila kot dokončanega, če je drug paket še v tranzitu. Nadomestne in vračilne pošiljke naj bodo povezane, vendar razločljive.

Viri

  • 17TRACK Tracking API — uradna referenca izdelka za možnost integracije API-ja za sledenje.
  • 17TRACK API Documentation — tehnična referenca za preverjanje registracije, zahtevkov za sledenje, obravnavo posodobitev in zahteve izvedbe. Operativni poteki dela in pravila opozoril v tem vodniku so priporočila, ne jamstva glede vedenja ponudnika ali prevoznika.