Skip to main content
DomovBlogPríručkyLetecká nákladná doprava vs. sledovanie cezhraničných zásielok: Aké funkcie API potrebujete?

Letecká nákladná doprava vs. sledovanie cezhraničných zásielok: Aké funkcie API potrebujete?

17TRACK

Vyberte si API na sledovanie leteckého nákladu, keď vaša aplikácia musí sledovať letecké nákladné listy, úseky letov, míľniky manipulácie s nákladom a množstvá zásielok. API na sledovanie cezhraničných balíkov si vyberte vtedy, keď potrebujete aktualizácie na úrovni balíkov naprieč dopravcami, informácie o problémoch s doručením a stav doručenia v poslednej míli. Ak vaše zásielky kombinujú konsolidovanú leteckú nákladnú dopravu s doručením jednotlivých balíkov, potrebujete obe vrstvy viditeľnosti a spoľahlivý spôsob prepojenia ich identifikátorov.

Air Cargo vs Cross Border Parcel Tracking What API Capabilities

Pre vývojárske tímy, logistických operátorov a e-commerce spoločnosti je rozhodnutie o nákupe menej otázkou toho, ktoré API vracia viac udalostí, a viac otázkou toho, či tieto udalosti opisujú jednotku zásielky, ktorú skutočne spravujete. Udalosť o prílete lietadla sama osebe nedokáže zákazníkovi povedať, kde sa jeho balík nachádza ani kedy dorazí k jeho dverám.

Začnite jednotkou zásielky, nie spôsobom prepravy

Letecký náklad a cezhraničné balíky nie sú navzájom výlučné kategórie prepravy. Balík môže cestovať medzinárodne lietadlom, zatiaľ čo letecká spoločnosť s ním zaobchádza ako so súčasťou väčšej konsolidovanej zásielky. Rozhodujúcim faktorom pri výbere API je sledovaný prevádzkový objekt.

Viditeľnosť leteckého nákladu sa zvyčajne sústreďuje na letecký nákladný list a súvisiaci pohyb pri preprave. V závislosti od zdroja môžu údaje opisovať prijatie, odlet, prílet, dostupnosť nákladu a odovzdanie. Viditeľnosť balíka sa sústreďuje na jednotlivé balíky a ich postup cez vyzdvihnutie, medzinárodnú prepravu, spracovanie v cieľovej krajine a doručenie.

Hlavný letecký nákladný list môže predstavovať konsolidovaný pohyb obsahujúci viacero základných zásielok. Domovské letecké nákladné listy, štítky balíkov a sledovacie čísla cieľového dopravcu môžu identifikovať rôzne úrovne v rámci tohto pohybu. Nepredpokladajte, že poskytovateľ sledovania dokáže všetky tieto vzťahy automaticky objaviť alebo prepojiť.

Oblasť rozhodovaniaSledovanie leteckého nákladuSledovanie cezhraničných balíkov
Primárny objektLetecký nákladný list, zásielka alebo úsek prepravyJednotlivý balík a jeho identifikátory dopravcu
Prevádzkové otázkyBol náklad prijatý, prepravený letecky, dorazil alebo bol odovzdaný?Kde sa balík nachádza, čo bráni jeho doručeniu a bol doručený?
Vzťahy, ktoré treba zachovaťHlavné a domovské referencie, úseky, kusy a rozdelené pohybyPrepojenia objednávok na balíky, odovzdania medzi dopravcami, náhradné identifikátory a vratky
Typický vlastník úkonuTím špedície, prepravy alebo prevádzky nákladnej dopravyTím e-commerce prevádzky, zákazníckej podpory alebo riadenia doručenia
Hlavné interpretačné rizikoPovažovanie jedného úseku alebo čiastočného príletu za dokončenie celej zásielkyPovažovanie odovzdania alebo nejednoznačnej udalosti doručenia za prevzatie kupujúcim

Čo musí podporovať API na sledovanie leteckého nákladu

Identita leteckého nákladného listu a vzťahy medzi zásielkami

Zistite, ktoré identifikátory API prijíma a čo vracia každé vyhľadávanie. Podpora hlavného leteckého nákladného listu automaticky neznamená podporu viditeľnosti na úrovni domovských zásielok. Ak vaše operácie závisia od domovských zásielok, vyžadujte ukážku s použitím vlastných referencií a autorizovaných zdrojov údajov.

Dátový model by mal zachovať vzťahy medzi zásielkou, jej úsekmi prepravy a všetkými časťami, ktoré sa prepravujú samostatne. Pri pracovných postupoch citlivých na množstvo sa opýtajte, či sú počty kusov a hmotnosti dostupné na úrovni zásielky, udalosti alebo na oboch úrovniach. Celkový údaj za zásielku nenahrádza informáciu o tom, koľko nákladu dorazilo na konkrétne letisko.

Viditeľnosť úsekov prepravy a manipulácie

Vyžadujte dostatok kontextu na rozlíšenie odletu z východiskového miesta od odletu s prestupom a plánovaného pohybu od skutočného pohybu. Užitočné polia môžu zahŕňať východiskové a cieľové letiská, referencie letov, miesta udalostí a plánované aj skutočné časové pečiatky. Ich dostupnosť závisí od zdroja a mala by sa overiť, nie predpokladať.

Rozlišujte tiež pohyb letu od pohybu nákladu. Prílet lietadla sám osebe nedokazuje, že každá súvisiaca zásielka bola naložená, vyložená, spracovaná alebo sprístupnená. Zistite, či je udalosť špecifická pre zásielku alebo odvodená z dát o lete.

Čiastočné pohyby a význam míľnikov

Nákladná zásielka sa môže prepravovať po častiach. Váš systém by nemal označiť celú zásielku ako doručenú len preto, že pre jej časť existuje udalosť príletu. Otestujte, ako API reprezentuje viacero letov, čiastočné množstvá, zmenené trasy a opravy.

Podobnú pozornosť si vyžadujú aj definície míľnikov. Odovzdanie špeditérovi alebo inej logistickej strane nemusí znamenať doručenie konečnému príjemcovi. Nechajte si od poskytovateľa vysvetliť prevádzkový význam udalostí dokončenia a zachovajte tento význam vo svojom internom modeli stavov.

Iniciatíva ONE Record organizácie IATA predstavuje relevantnú priemyselnú referenciu pre zdieľanie údajov o náklade a štandardizované dátové štruktúry. Tvrdenie o dodržiavaní štandardov však nie je dôkazom prístupu ku každej leteckej spoločnosti, manipulátorovi, zásielke alebo míľniku. Zistite, ktorá implementácia, dátové vzťahy, povolenia a prevádzkové zdroje sú skutočne dostupné.

Čo musí podporovať API na sledovanie cezhraničných balíkov

Identifikácia dopravcu a kontinuita pri odovzdaní

Medzinárodné cesty balíkov môžu zahŕňať pôvodného operátora, cezhraničného logistického poskytovateľa a doručovacieho dopravcu v cieľovej krajine. Integrácia by vám mala pomôcť zachovať kontinuitu, keď sa zmení identifikátor alebo zodpovedný dopravca.

Overte, či API vracia následné sledovacie čísla, vzťahy medzi dopravcami alebo iba udalosti pre identifikátor, ktorý ste odoslali. Ak tieto vzťahy nie sú dostupné, zistite, či ich môže poskytnúť vaša prepravná platforma, sklad alebo logistický partner. Bez otestovania nesľubujte automatické prepojenie od začiatku do konca.

Detekcia dopravcu potrebuje aj záložné riešenie. Podobné vzory sledovacích čísel môžu vytvárať nejednoznačnosť, preto by vaša integrácia mala umožniť explicitný výber dopravcu alebo inú zdokumentovanú metódu rozlíšenia, ak je podporovaná.

Normalizované stavy s pôvodnými dôkazmi

Spoločný model stavov uľahčuje automatizáciu oznámení naprieč dopravcami. Normalizácia by však nemala odstrániť pôvodný opis udalosti, miesto, časovú pečiatku ani zdrojového dopravcu.

Široký stav výnimky môže napríklad predstavovať problém s adresou, oneskorenie súvisiace s colným konaním alebo neúspešný pokus o doručenie. Tieto situácie si vyžadujú odlišné kroky. Zachovajte pôvodnú správu a konkrétne kategórie výnimiek používajte iba vtedy, keď ich zdroj podporuje.

Výsledky doručenia a použiteľné výnimky

Tímy pre balíky zvyčajne potrebujú rozlišovať udalosti „na doručení“, pokus o doručenie, dostupnosť na vyzdvihnutie, doručenie a udalosti súvisiace s vrátením. Zistite, ktoré rozdiely API sprístupňuje a či sú konzistentné medzi dopravcami, ktorých používate.

Potvrdenie o doručení považujte za samostatnú požiadavku. Stav doručenia nezaručuje prístup k podpisu, fotografii, menu príjemcu alebo dokumentu. Pri príslušných službách potvrďte dostupnosť, prístupové oprávnenia, uchovávanie a obmedzenia ochrany súkromia.

Obmedzenia sa týkajú aj colných informácií. Udalosť sledovania spomínajúca clo nemusí poskytovať colné vyhlásenie, vysvetlenie poplatkov ani spoľahlivú prognózu prepustenia. Pravidlá eskalácie vytvárajte podľa toho, čo udalosť skutočne uvádza, nie podľa odvodeného právneho alebo colného výsledku.

Možnosti, ktoré potrebujú oba typy API

Spoľahlivé prijímanie udalostí a obnova

Pri pracovných postupoch založených na udalostiach vyhodnoťte doručovanie webhookov, autentifikáciu, opakovanie pokusov, spracovanie duplikátov a obnovu po výpadku. Ide o požiadavky na overenie pri nákupe, nie o funkcie, ktoré treba automaticky predpokladať u každého poskytovateľa.

Navrhnite svoj prijímač tak, aby zvládal duplicitné a udalosti mimo poradia. Čas udalosti ukladajte oddelene od času, keď vaša aplikácia aktualizáciu prijala. Ak nie je dostupný stabilný identifikátor udalosti, definujte zdokumentovaný postup odstraňovania duplicít pomocou dostupných polí.

Opýtajte sa, či môžete po zmeškaní oznámení načítať históriu udalostí zásielky. Webhooky sú užitočné na spúšťanie práce; podporované načítanie alebo proces zosúladenia pomáha obnoviť stav, keď sa tento spúšťač zmešká.

Aktuálnosť, pôvod a spracovanie časových pečiatok

Rozlišujte tri časové údaje: kedy fyzická udalosť nastala, kedy ju zdroj zverejnil a kedy vaša aplikácia aktualizáciu prijala. Nie každý zdroj poskytuje všetky tri, no oddelené uchovávanie dostupných časových údajov uľahčuje diagnostiku oneskorení.

Rovnako rozlišujte absenciu novej udalosti od neúspešného vyhľadávania. Nezmenená história zásielky môže odrážať oprávnenú medzeru medzi skenmi, výpadok zdroja, nerozpoznaný identifikátor alebo problém integrácie. Váš prevádzkový tím potrebuje dostatok diagnostických informácií na výber správnej reakcie.

Ak je časové pásmo uvedené, zachovajte ho. Ak časová pečiatka zo zdroja časové pásmo neobsahuje, zaznamenajte toto obmedzenie namiesto tichého prevodu na zdanlivo presný globálny čas.

Prístup, náklady a prevádzkové kontroly

Potvrďte autentifikáciu, izoláciu účtov, uchovávanie údajov, postupy vymazania, limity požiadaviek a podmienky produkčnej podpory. Údaje o sledovaní môžu obsahovať osobné informácie, preto zhromažďujte a sprístupňujte iba to, čo váš pracovný postup potrebuje.

Obchodné podmienky porovnávajte so skutočným pracovným zaťažením. Zistite, čo je spoplatnené: registrovaná zásielka, požiadavka, obnovenie údajov alebo iná jednotka. Objasnite, ako sa riešia neplatné čísla, duplicitné registrácie, opakované sledovanie, historické vyhľadávania a prekročenie limitov. Bez týchto definícií nie je uvádzaná cena spoľahlivým porovnaním nákladov.

Kedy použiť jedno API a kedy kombinovať zdroje údajov

Vyberte si viditeľnosť zameranú na náklad, keď váš tím reaguje na míľniky leteckého nákladného listu, manipuláciu na letisku, zlyhania prestupov alebo čiastočné prílety nákladu. Samotné sledovanie balíkov nie je primeranou náhradou týchto pracovných postupov, pokiaľ nie je výslovne preukázaná požadovaná podrobnosť na úrovni nákladu.

Vyberte si viditeľnosť zameranú na balíky, keď váš tím potrebuje aktualizácie doručenia na úrovni balíka, oznámenia zákazníkom, udalosti cieľového dopravcu a riadenie výnimiek doručenia. Samotný informačný kanál leteckého nákladného listu nestačí na sledovanie doručenia pre kupujúceho.

Kombinujte obe možnosti, keď spravujete medzinárodnú diaľkovú prepravu a doručenie jednotlivých balíkov. Uchovávajte samostatné záznamy o konsolidácii a jej balíkoch a potom ich prepojte pomocou referencií dodaných vaším vlastným logistickým procesom alebo overeným partnerským informačným kanálom.

Obchodník môže napríklad prepraviť konsolidovanú dávku letecky pred jej odovzdaním do balíkovej siete v cieľovej krajine. Prílet nákladu zaznamenajte ku konsolidácii. Každý balík aktualizujte až vtedy, keď existujú dôkazy relevantné pre daný balík; prílet dávky na letisko nepremieňajte na udalosť doručenia pre každú objednávku.

Úloha 17TRACK

Pre balíkovú časť tejto architektúry je 17TRACK's Tracking API relevantné pri hodnotení integrácie sledovania viacerých dopravcov. Pomocou official API documentation overte integráciu podľa požadovaných identifikátorov, polí odpovede, pracovného postupu oznámení a prevádzkových limitov.

Hodnotenie balíkového API nepovažujte za potvrdenie funkčnosti pre letecký náklad. Ak potrebujete aj vzťahy medzi hlavnými a domovskými zásielkami, podrobnosti o úsekoch letov alebo čiastočné pohyby kusov, vyžiadajte si výslovné potvrdenie a vzorové odpovede na tieto požiadavky. Správna úloha produktu sa určuje podľa pracovných postupov, ktoré dokáže doložiť, nie podľa šírky slova „tracking“.

Pred záväzným rozhodnutím vykonajte proof of concept

Použite reprezentatívne zásielky od svojich skutočných dopravcov, na svojich trasách a s používanými typmi služieb. Zahrňte dokončené zásielky so známymi výsledkami aj živé zásielky. Úspešné vyhľadanie jednej jednoduchej zásielky nestačí na overenie integrácie.

  1. Definujte rozhodnutie, ktoré musí každá udalosť podporiť. Príkladmi sú preverenie zmeškaného prestupu nákladu, kontaktovanie kupujúceho pre problém s adresou alebo odoslanie oznámenia o doručení.
  2. Vytvorte reprezentatívnu testovaciu súpravu. Podľa relevantnosti zahrňte odovzdania medzi dopravcami, obdobia bez aktualizácií, pokusy o doručenie, vratky a rozdelené pohyby nákladu.
  3. Skontrolujte presnosť na úrovni objektu. Potvrďte, či sa každá udalosť týka letu, zásielky, časti alebo jednotlivého balíka.
  4. Porovnajte údaje s prevádzkovým zdrojom. Skontrolujte chýbajúce míľniky, časové pečiatky, miesta, pôvodné správy a spracovanie opráv voči záznamom dopravcu alebo partnera, ku ktorým máte oprávnený prístup.
  5. Otestujte obnovu po zlyhaní. Testujte duplicitné udalosti, oneskorené udalosti, neplatné identifikátory, nejednoznačných dopravcov, výpadky webhookov a zosúladenie.
  6. Overte ekonomiku a zodpovednosť. Odhadnite náklady podľa svojho pracovného zaťaženia a priraďte zodpovednosť za problémy so zdrojovými údajmi, zlyhania integrácie a komunikáciu so zákazníkom.

Pred vyhodnotením výsledkov stanovte akceptačné kritériá. Mali by pokrývať požadované polia, význam udalostí, správanie pri obnove a prijateľné oneskorenia aktualizácií pre každý pracovný postup. Oznámenie zákazníkovi a zásah pri náklade môžu vyžadovať odlišné prahové hodnoty.

Často kladené otázky

Môže jedno sledovacie API pokrývať letecký náklad aj balíky?

Potenciálne áno, ale potvrďte dátový model a prístup k zdrojom pre obe oblasti. Spoločný koncový bod nedokazuje podporu množstiev nákladu, úsekov letov, domovských vzťahov ani odovzdaní balíkov. Vyžiadajte si samostatné ukážky pre oba pracovné postupy.

Môžem použiť číslo leteckého nákladného listu na sledovanie jednotlivého balíka?

Nie nevyhnutne. Letecký nákladný list môže identifikovať väčšiu zásielku, nie jednotlivý balík. Na prepojenie ich histórie potrebujete overený vzťah medzi touto zásielkou a identifikátorom balíka.

Znamená „real-time tracking“ nepretržitú fyzickú polohu?

Nepredpokladajte to. Sledovanie môže byť založené na prevádzkových udalostiach zverejňovaných v intervaloch, nie na nepretržitej telemetrii polohy. Zistite, čo spúšťa aktualizácie, ktoré časové pečiatky sú sprístupnené a či údaje o polohe pochádzajú zo samostatného zdroja senzorov.

Sú webhooky lepšie ako polling?

Webhooky sú užitočné na prijímanie oznámení o udalostiach bez opakovaných požiadaviek na stav. Polling alebo iný mechanizmus načítania môže naďalej podporovať zosúladenie a obnovu. Návrh vyberte podľa zdokumentovaného správania a limitov poskytovateľa a podľa tolerancie voči zmeškaným alebo oneskoreným aktualizáciám.

Dokazuje udalosť doručenia, že kupujúci zásielku prijal?

Nie v každom kontexte. Dokončenie nákladnej prepravy môže opisovať odovzdanie logistickej strane, zatiaľ čo udalosti doručenia balíka závisia od procesu doručenia dopravcu. Overte definíciu udalosti a v prípade potreby svojho pracovného postupu získajte samostatný dôkaz o doručení.

Zdroje