Skip to main content
DomovBlogVodnikiLetalski tovor v primerjavi s sledenjem čezmejnim paketom: Katere zmogljivosti API-ja potrebujete?

Letalski tovor v primerjavi s sledenjem čezmejnim paketom: Katere zmogljivosti API-ja potrebujete?

17TRACK

Izberite API za sledenje letalskemu tovoru, ko mora vaša aplikacija spremljati letalske tovorne liste, posamezne letalske odseke, mejnike pri ravnanju s tovorom in količine pošiljk. Izberite API za sledenje čezmejnim paketom, ko potrebujete posodobitve na ravni paketov pri različnih prevoznikih, informacije o izjemah pri dostavi in stanje dostave v zadnjem kilometru. Če vaše pošiljke združujejo konsolidirani letalski tovor s posamično dostavo paketov, potrebujete obe ravni vidljivosti in zanesljiv način povezovanja njunih identifikatorjev.

API-zmogljivosti za sledenje letalskemu tovoru v primerjavi s čezmejnim sledenjem paketom

Za inženirske ekipe, logistične operaterje in podjetja e-trgovine je odločitev o nakupu manj povezana s tem, kateri API vrne več dogodkov, in bolj s tem, ali ti dogodki opisujejo enoto pošiljke, ki jo dejansko upravljate. Dogodek prihoda letalske družbe sam po sebi kupcu ne more povedati, kje je njegov paket ali kdaj bo prispel na njegov naslov.

Začnite z enoto pošiljke, ne z načinom prevoza

Letalski tovor in čezmejni paketi niso medsebojno izključujoče se kategorije pošiljanja. Paket lahko potuje mednarodno z letalom, medtem ko ga letalska družba obravnava kot del večje konsolidirane pošiljke. Pri izbiri API-ja je odločilni dejavnik operativni objekt, ki mu sledite.

Vidljivost letalskega tovora se običajno osredotoča na letalsko tovorno listo in povezano gibanje prevoza. Glede na vir lahko podatki opisujejo prevzem, odhod, prihod, razpoložljivost tovora in predajo. Vidljivost paketov se osredotoča na posamezne pakete in njihov napredek pri prevzemu, mednarodnem prevozu, obdelavi na namembnem kraju in dostavi.

Glavna letalska tovorna lista lahko predstavlja konsolidirano gibanje, ki vsebuje več osnovnih pošiljk. Hišne letalske tovorne liste, etikete paketov in sledilne številke namembnih prevoznikov lahko označujejo različne ravni znotraj tega gibanja. Ne domnevajte, da lahko ponudnik sledenja samodejno odkrije ali poveže vsa ta razmerja.

Področje odločitveSledenje letalskemu tovoruČezmejno sledenje paketom
Primarni objektLetalska tovorna lista, pošiljka ali transportni odsekPosamezni paket in njegovi identifikatorji prevoznikov
Operativna vprašanjaAli je bil tovor prevzet, prepeljan z letalom, prispel ali predan?Kje je paket, kaj ga zadržuje in ali je bil dostavljen?
Razmerja, ki jih je treba ohranitiReference glavne in hišne tovorne liste, odseki, kosi in razdeljena gibanjaPovezave med naročilom in paketom, predaje med prevozniki, nadomestni identifikatorji in vračila
Običajni nosilec ukrepanjaEkipa za špedicijo, prevoz ali tovorne operacijeEkipa za operacije e-trgovine, podporo strankam ali upravljanje dostave
Glavno tveganje pri razlagiObravnavanje enega odseka ali delnega prihoda kot zaključka celotne pošiljkeObravnavanje predaje ali dvoumnega dogodka dostave kot prejema s strani kupca

Kaj mora podpirati API za sledenje letalskemu tovoru

Identiteta letalske tovorne liste in razmerja med pošiljkami

Preverite, katere identifikatorje API sprejema in kaj vrne posamezno iskanje. Podpora glavni letalski tovorni listi ne pomeni samodejno podpore vidljivosti na ravni hišnih tovornih listov. Če so vaše operacije odvisne od hišnih pošiljk, zahtevajte predstavitev z uporabo lastnih referenc in pooblaščenih podatkovnih virov.

Podatkovni model mora ohraniti razmerja med pošiljko, njenimi transportnimi odseki in morebitnimi ločeno premikajočimi se deli. Pri delovnih tokovih, občutljivih na količine, preverite, ali so število kosov in teže na voljo na ravni pošiljke, dogodka ali obeh. Skupna količina pošiljke ne nadomešča podatka o tem, koliko tovora je prispelo na določeno letališče.

Vidljivost transportnih odsekov in ravnanja s tovorom

Zahtevajte dovolj konteksta za razlikovanje med odhodom z izvornega letališča in odhodom s povezovalnega letališča ter med načrtovanim in dejanskim gibanjem. Koristna polja lahko vključujejo izvorna in namembna letališča, reference letov, lokacije dogodkov ter načrtovane in dejanske časovne žige. Njihova razpoložljivost je odvisna od vira, zato jo je treba preveriti in ne domnevati.

Prav tako razlikujte gibanje leta od gibanja tovora. Prihod letala sam po sebi ne dokazuje, da je bila vsaka povezana pošiljka naložena, razložena, obdelana ali dana na voljo. Preverite, ali je dogodek specifičen za pošiljko ali izpeljan iz podatkov o letu.

Delna gibanja in pomen mejnikov

Tovorna pošiljka se lahko premika po delih. Sistem ne sme označiti celotne pošiljke kot prispele samo zato, ker obstaja dogodek prihoda za njen del. Preizkusite, kako API predstavlja več letov, delne količine, spremenjene poti in popravke.

Podobno pozornost zahtevajo tudi opredelitve mejnikov. Predaja špediterju ali drugi logistični stranki ni nujno dostava končnemu prejemniku. Ponudnik naj pojasni operativni pomen dogodkov zaključka, vi pa ta pomen ohranite v notranjem modelu stanj.

Iniciativa IATA ONE Record je pomembna industrijska referenca za izmenjavo podatkov o tovoru in standardizirane podatkovne strukture. Vendar trditev o skladnosti s standardi ni dokaz dostopa do vsake letalske družbe, izvajalca, pošiljke ali mejnika. Preverite, katera izvedba, podatkovna razmerja, dovoljenja in operativni viri so dejansko na voljo.

Kaj mora podpirati API za čezmejno sledenje paketom

Identifikacija prevoznika in neprekinjenost pri predaji

Mednarodna pot paketov lahko vključuje izvornega operaterja, čezmejnega logističnega ponudnika in namembnega dostavnega prevoznika. Integracija vam mora pomagati ohraniti neprekinjenost, ko se spremenita identifikator ali odgovorni prevoznik.

Preverite, ali API vrne nadaljnje sledilne številke, razmerja med prevozniki ali samo dogodke za poslani identifikator. Če ta razmerja niso na voljo, ugotovite, ali jih lahko zagotovi vaša platforma za pošiljanje, skladišče ali logistični partner. Ne obljubljajte samodejne povezave od začetka do konca, ne da bi jo preizkusili.

Prepoznavanje prevoznika potrebuje tudi rezervni mehanizem. Podobni vzorci sledilnih številk lahko povzročijo dvoumnost, zato mora integracija omogočati izrecno izbiro prevoznika ali drugo dokumentirano metodo razločevanja, kadar je podprta.

Normalizirana stanja z izvirnimi dokazi

Skupni model stanj olajša avtomatizacijo obvestil pri različnih prevoznikih. Vendar normalizacija ne sme izbrisati izvirnega opisa dogodka, lokacije, časovnega žiga ali izvornega prevoznika.

Široko stanje izjeme lahko na primer predstavlja težavo z naslovom, zamudo, povezano s carino, ali neuspešen poskus dostave. Ti primeri zahtevajo različne ukrepe. Ohranite izvirno sporočilo in uporabljajte posebne kategorije izjem samo takrat, ko jih vir podpira.

Izidi dostave in uporabne izjeme

Ekipa za pakete mora običajno ločiti dogodke »v dostavi«, poskus dostave, razpoložljivost za prevzem, dostavo in dogodke, povezane z vračilom. Preverite, katere razlike API izpostavlja in ali so dosledne pri prevoznikih, ki jih uporabljate.

Dokazilo o dostavi obravnavajte kot ločeno zahtevo. Stanje »dostavljeno« ne zagotavlja dostopa do podpisa, fotografije, imena prejemnika ali dokumenta. Za ustrezne storitve potrdite razpoložljivost, dovoljenja za dostop, hrambo in omejitve zasebnosti.

Tudi carinski podatki imajo omejitve. Dogodek s sklicem na carino ne zagotavlja nujno deklaracijskega zapisa, razlage dajatev ali zanesljive napovedi sprostitve. Pravila eskalacije oblikujte na podlagi dejanskega sporočila dogodka, ne na podlagi sklepanega pravnega ali carinskega izida.

Zmogljivosti, ki jih potrebujeta obe vrsti API-jev

Zanesljiv sprejem dogodkov in obnovitev

Pri delovnih tokovih, ki temeljijo na dogodkih, ocenite dostavo webhookov, preverjanje pristnosti, ponovne poskuse, obravnavo dvojnikov in obnovitev po izpadu. To so zahteve za nabavo, ki jih je treba preveriti, ne funkcije, za katere bi smeli domnevati, da jih ponuja vsak ponudnik.

Potrošnik podatkov naj bo zasnovan tako, da obravnava podvojena in neurejena sporočila. Čas dogodka shranite ločeno od časa, ko je vaš sistem prejel posodobitev. Če stabilni identifikator dogodka ni na voljo, določite dokumentiran pristop k odstranjevanju dvojnikov z uporabo razpoložljivih polj.

Preverite, ali lahko po izpuščenih obvestilih pridobite zgodovino dogodkov pošiljke. Webhooki so uporabni za sprožanje dela, podprt postopek pridobivanja ali usklajevanja pa omogoča obnovitev, ko je sprožilec spregledan.

Svežina, izvor in obravnava časovnih žigov

Ločite tri ure: kdaj se je fizični dogodek zgodil, kdaj ga je vir objavil in kdaj ga je prejela vaša aplikacija. Vsak vir ne izpostavlja vseh treh, vendar ločeno shranjevanje razpoložljivih časovnih žigov olajša diagnosticiranje zamud.

Prav tako razlikujte med tem, da ni novega dogodka, in neuspešnim iskanjem. Nespremenjena zgodovina pošiljke lahko pomeni legitimno vrzel med skeniranji, izpad vira, neprepoznan identifikator ali težavo z integracijo. Operativna ekipa potrebuje dovolj diagnostičnih informacij za izbiro ustreznega odziva.

Ohranite podatke o časovnem pasu, kadar jih vir posreduje. Če izvorni časovni žig nima časovnega pasu, to omejitev zabeležite, namesto da ga tiho pretvorite v navidezno natančen globalni čas.

Dostop, stroški in operativni nadzor

Potrdite preverjanje pristnosti, ločevanje računov, hrambo podatkov, postopke brisanja, omejitve hitrosti in dogovore o produkcijski podpori. Podatki sledenja lahko vključujejo osebne informacije, zato zbirajte in razkrivajte samo tisto, kar potrebuje vaš delovni tok.

Komercialne pogoje primerjajte z dejansko obremenitvijo. Preverite, kaj se zaračunava: registrirana pošiljka, zahteva, osvežitev ali druga enota. Pojasnite, kako se obravnavajo neveljavne številke, podvojene registracije, ponovno sledenje, zgodovinska iskanja in prekoračitve. Brez teh opredelitev naslovna cena ni zanesljiva primerjava stroškov.

Kdaj uporabiti en API in kdaj združiti vire podatkov

Izberite vidljivost, osredotočeno na tovor, ko vaša ekipa ukrepa na podlagi mejnikov letalske tovorne liste, ravnanja na letališču, neuspešnih povezav ali delnih prihodov tovora. Samo sledenje paketom ni ustrezna zamenjava za te delovne tokove, razen če je zahtevana podrobnost na ravni tovora izrecno dokazana.

Izberite vidljivost, osredotočeno na pakete, ko vaša ekipa potrebuje posodobitve dostave na ravni paketov, obvestila strankam, dogodke namembnega prevoznika in upravljanje izjem pri dostavi. Sam vir letalske tovorne liste ne zadostuje za sledenje dostavi, namenjeno kupcem.

Združite oba vira, ko upravljate mednarodni glavni prevoz in dostavo posameznih paketov. Za konsolidacijo in njene pakete vodite ločene zapise, nato pa jih povežite prek referenc, ki jih zagotovi vaš lastni logistični proces ali preverjen partnerski vir.

Trgovec lahko na primer konsolidirano serijo pošlje po zraku, nato pa jo na namembnem kraju vključi v paketno omrežje. Prihod tovora zabeležite pri konsolidaciji. Posamezen paket posodobite samo takrat, ko obstajajo dokazi, pomembni zanj; prihoda serije na letališče ne pretvorite v dogodek dostave za vsako naročilo.

Kje se umešča 17TRACK

Za paketni del te arhitekture je 17TRACK's Tracking API pomemben pri ocenjevanju integracije sledenja pri več prevoznikih. Uporabite official API documentation za preverjanje integracije glede na zahtevane identifikatorje, odzivna polja, potek obvestil in operativne omejitve.

Ocene paketnega API-ja ne obravnavajte kot potrditev funkcionalnosti za letalski tovor. Če potrebujete tudi razmerja med glavnimi in hišnimi tovornimi listami, podrobnosti letalskih odsekov ali premike delnih kosov, zahtevajte izrecno potrditev in vzorčne odgovore za te zahteve. Ustrezna vloga izdelka je določena z delovnimi tokovi, ki jih lahko podpre, ne s širino besede »sledenje«.

Pred zavezo izvedite dokaz koncepta

Uporabite reprezentativne pošiljke svojih dejanskih prevoznikov, poti in vrst storitev. Vključite zaključene pošiljke z znanimi izidi in pošiljke v živo. Uspešno iskanje ene preproste pošiljke ne zadošča za potrditev integracije.

  1. Določite odločitev, ki jo mora podpreti vsak dogodek. Primeri vključujejo preiskavo zamujene povezave tovora, stik s kupcem zaradi težave z naslovom ali pošiljanje obvestila o dostavi.
  2. Izdelajte reprezentativen testni nabor. Kadar je pomembno, vključite predaje med prevozniki, obdobja brez dogodkov, poskuse dostave, vračila in razdeljena gibanja tovora.
  3. Preverite natančnost na ravni objekta. Potrdite, ali se vsak dogodek nanaša na let, pošiljko, njen del ali posamezni paket.
  4. Primerjajte z operativnim virom. Manjkajoče mejnike, časovne žige, lokacije, izvirna sporočila in obravnavo popravkov preverite glede na zapise prevoznika ali partnerja, do katerih imate dovoljen dostop.
  5. Preizkusite obnovitev po napaki. Preizkusite podvojene in zakasnele dogodke, neveljavne identifikatorje, dvoumne prevoznike, izpade webhookov in usklajevanje.
  6. Potrdite ekonomiko in odgovornosti. Stroške ocenite na podlagi svoje obremenitve ter določite odgovornost za težave z izvornimi podatki, napake integracije in komunikacijo s strankami.

Merila sprejemljivosti določite pred pregledom rezultatov. Zajemati morajo zahtevana polja, pomen dogodkov, vedenje pri obnovitvi in sprejemljive zamude pri posodobitvah za vsak delovni tok. Obvestilo stranki in ukrepanje pri tovoru lahko zahtevata različna pragova.

Pogosta vprašanja

Ali lahko en API za sledenje pokriva letalski tovor in pakete?

Morda, vendar potrdite podatkovni model in dostop do virov za oba. Skupna končna točka ne dokazuje podpore količinam tovora, letalskim odsekom, hišnim razmerjem ali predajam paketov. Zahtevajte ločene predstavitve za oba delovna toka.

Ali lahko s številko letalske tovorne liste sledim posameznemu paketu?

Ne nujno. Letalska tovorna lista lahko označuje večjo pošiljko in ne posameznega paketa. Za povezavo njunih zgodovin potrebujete preverjeno razmerje med to pošiljko in identifikatorjem paketa.

Ali »sledenje v realnem času« pomeni neprekinjeno fizično lokacijo?

Ne domnevajte tega. Sledenje lahko temelji na operativnih dogodkih, objavljenih v časovnih intervalih, in ne na neprekinjeni telemetriji lokacije. Preverite, kaj sproži posodobitve, kateri časovni žigi so izpostavljeni in ali kateri podatki o lokaciji prihajajo iz ločenega senzorskega vira.

Ali so webhooki boljši od anketiranja?

Webhooki so uporabni za prejemanje obvestil o dogodkih brez ponavljajočih se zahtev za stanje. Anketiranje ali drug mehanizem pridobivanja lahko še vedno podpre usklajevanje in obnovitev. Izberite zasnovo glede na dokumentirano vedenje in omejitve ponudnika ter svojo toleranco do izpuščenih ali zakasnjenih posodobitev.

Ali dogodek dostave dokazuje, da je kupec prejel pošiljko?

Ne v vsakem kontekstu. Zaključek tovora lahko opisuje predajo logistični stranki, medtem ko so dogodki dostave paketov odvisni od postopka dostave prevoznika. Preverite opredelitev dogodka in pridobite ločeno dokazilo o dostavi, kadar ga vaš delovni tok zahteva.

Viri