Әуе жүктерін тасымалдау мен трансшекаралық сәлемдемелерді қадағалау: Сізге қандай API мүмкіндіктері қажет?
Қолданбаңыз әуе жүкқұжаттарын, ұшу кезеңдерін, жүкті өңдеу межелерін және жөнелтілім көлемін бақылауы қажет болса, әуе жүктерін қадағалау API интерфейсін таңдаңыз. Тасымалдаушылар арасында пакет деңгейіндегі жаңартулар, жеткізу ерекшеліктері және соңғы милядағы жеткізу күйі қажет болса, трансшекаралық сәлемдемелерді қадағалау API интерфейсін таңдаңыз. Егер жөнелтілімдеріңіз шоғырландырылған әуе тасымалын жеке сәлемдемелерді жеткізумен біріктірсе, сізге екі көріну деңгейі де және олардың идентификаторларын байланыстырудың сенімді тәсілі де қажет.

Инженерлік командалар, логистикалық операторлар және электрондық коммерция компаниялары үшін сатып алу туралы шешім қай API көбірек оқиға қайтаратынына емес, сол оқиғалардың сіз нақты басқаратын жөнелтілім бірлігін сипаттайтынына байланысты. Әуе компаниясының келу оқиғасы сатып алушыға оның сәлемдемесі қайда екенін немесе есігіне қашан жететінін өздігінен айта алмайды.
Көлік түрінен емес, жөнелтілім бірлігінен бастаңыз
Әуе жүктері мен трансшекаралық сәлемдемелер бір-бірін жоққа шығаратын тасымалдау санаттары емес. Сәлемдеме халықаралық бағытта әуе кемесімен тасымалдануы мүмкін, ал әуе компаниясы оны ірі шоғырландырылған жөнелтілімнің бөлігі ретінде өңдейді. API таңдауындағы негізгі айырмашылық — бақыланатын операциялық нысан.
Әуе жүктерінің көрінуі әдетте әуе жүкқұжатына және оған байланысты тасымал қозғалысына негізделеді. Дереккөзге байланысты деректер қабылдауды, жөнелтуді, келуді, жүктің қолжетімділігін және тапсыруды сипаттауы мүмкін. Сәлемдеме көрінуі жеке пакеттерге және олардың жинаудан, халықаралық тасымалдаудан, межелі жерде өңдеуден және жеткізуден өту барысына бағытталады.
Негізгі әуе жүкқұжаты бірнеше төменгі деңгейдегі жөнелтілімді қамтитын шоғырландырылған қозғалысты көрсете алады. Ішкі әуе жүкқұжаттары, сәлемдеме жапсырмалары және межелі тасымалдаушының қадағалау нөмірлері осы қозғалыстың әртүрлі деңгейлерін анықтауы мүмкін. Қадағалау провайдері осы байланыстардың барлығын автоматты түрде тауып, байланыстыра алады деп ойламаңыз.
| Шешім қабылдау саласы | Әуе жүктерін қадағалау | Трансшекаралық сәлемдемелерді қадағалау |
|---|---|---|
| Негізгі нысан | Әуе жүкқұжаты, жүк жөнелтілімі немесе тасымалдау кезеңі | Жеке пакет және оның тасымалдаушы идентификаторлары |
| Операциялық сұрақтар | Жүк қабылданды ма, ұшырылды ма, келді ме немесе тапсырылды ма? | Пакет қайда, оған не кедергі келтіруде және ол жеткізілді ме? |
| Сақталуы тиіс байланыстар | Негізгі және ішкі сілтемелер, кезеңдер, орындар және бөлінген қозғалыстар | Тапсырыс пен пакет байланыстары, тасымалдаушы ауысуы, алмастыру идентификаторлары және қайтарымдар |
| Әдеттегі әрекет иесі | Экспедиторлық, тасымалдау немесе жүк операциялары командасы | Электрондық коммерция операциялары, клиенттерге қызмет көрсету немесе жеткізуді басқару командасы |
| Негізгі түсіндіру тәуекелі | Бір кезеңді немесе ішінара келуді бүкіл жөнелтілімнің аяқталуы ретінде қарастыру | Тапсыруды немесе анық емес жеткізу оқиғасын сатып алушының алғаны ретінде қарастыру |
Әуе жүктерін қадағалау API интерфейсі нені қолдауы керек
Әуе жүкқұжатының идентификациясы және жөнелтілім байланыстары
API қандай идентификаторларды қабылдайтынын және әр іздеу нәтижесінде не қайтаратынын сұраңыз. Негізгі әуе жүкқұжатын қолдау ішкі деңгейдегі көрінуді автоматты түрде қамтамасыз етпейді. Операцияларыңыз ішкі жөнелтілімдерге тәуелді болса, өз сілтемелеріңіз бен рұқсат етілген дереккөздеріңізді пайдаланып көрсетілім талап етіңіз.
Деректер моделі жөнелтілім, оның тасымалдау кезеңдері және бөлек қозғалатын кез келген бөліктер арасындағы байланыстарды сақтауы керек. Саны маңызды жұмыс процестері үшін дана саны мен салмақтың жөнелтілім деңгейінде, оқиға деңгейінде немесе екеуінде де қолжетімді екенін сұраңыз. Жөнелтілімнің жалпы саны белгілі бір әуежайға қанша жүктің жеткенін білу қажеттілігін алмастырмайды.
Тасымалдау кезеңдері мен өңдеудің көрінуі
Бастапқы әуежайдан жөнелтуді байланыс рейсінің жөнелтуінен және жоспарланған қозғалысты нақты қозғалыстан ажыратуға жеткілікті контекст талап етіңіз. Пайдалы өрістерге бастапқы және межелі әуежайлар, рейс сілтемелері, оқиға орындары, жоспарланған және нақты уақыт белгілері кіруі мүмкін. Олардың қолжетімділігі дереккөзге байланысты, сондықтан болжам жасамай, тексеру қажет.
Сондай-ақ рейс қозғалысын жүк қозғалысынан ажыратыңыз. Әуе кемесінің келуі өздігінен оған қатысты әрбір жөнелтілімнің тиелгенін, түсірілгенін, өңделгенін немесе қолжетімді болғанын дәлелдемейді. Оқиғаның жөнелтілімге қатысты екенін немесе рейс арнасынан алынғанын сұраңыз.
Ішінара қозғалыстар және межелердің мағынасы
Жүк жөнелтілімі бөліктерге бөлініп қозғалуы мүмкін. Оның бір бөлігіне қатысты келу оқиғасы бар болғандықтан ғана бүкіл жөнелтілімді келді деп белгілемеуіңіз керек. API бірнеше рейсті, ішінара көлемдерді, қайта қаралған бағыттарды және түзетулерді қалай көрсететінін тексеріңіз.
Межелердің анықтамалары да мұқият тексерілуі керек. Экспедиторға немесе басқа логистикалық тарапқа тапсыру соңғы алушыға жеткізу дегенді білдірмейді. Провайдерден аяқталу оқиғаларының операциялық мағынасын түсіндіріп, сол мағынаны ішкі күй моделіңізде сақтауды талап етіңіз.
IATA-ның ONE Record бастамасы жүк деректерін бөлісу және стандартталған деректер құрылымдары үшін маңызды салалық анықтамалық болып табылады. Алайда стандарттарға сәйкестік туралы мәлімдеме әрбір әуе компаниясына, өңдеушіге, жөнелтілімге немесе межеге қолжетімділіктің дәлелі емес. Нақты қандай іске асыру, деректер байланыстары, рұқсаттар және операциялық дереккөздер қолжетімді екенін сұраңыз.
Трансшекаралық сәлемдемелерді қадағалау API интерфейсі нені қолдауы керек
Тасымалдаушыны сәйкестендіру және тапсыру кезіндегі үздіксіздік
Халықаралық сәлемдеме жолына бастапқы оператор, трансшекаралық логистика провайдері және межелі жердегі жеткізу тасымалдаушысы қатысуы мүмкін. Интеграция идентификатор немесе жауапты тасымалдаушы өзгерген кезде үздіксіздікті сақтауға көмектесуі керек.
API кейінгі қадағалау нөмірлерін, тасымалдаушылар арасындағы байланыстарды немесе тек сіз жіберген идентификаторға қатысты оқиғаларды қайтаратынын тексеріңіз. Егер бұл байланыстар қолжетімсіз болса, оларды тасымалдау платформаңыз, қоймаңыз немесе логистикалық серіктесіңіз бере алатынын анықтаңыз. Тестілеусіз автоматты толық байланыстыруға уәде бермеңіз.
Тасымалдаушыны анықтауда қосалқы тәсіл де қажет. Ұқсас қадағалау нөмірлерінің үлгілері түсініксіздік тудыруы мүмкін, сондықтан интеграция қолдау көрсетілген жағдайда тасымалдаушыны нақты таңдауға немесе құжатталған басқа ажырату әдісіне мүмкіндік беруі керек.
Бастапқы дәлелі сақталған қалыпқа келтірілген күйлер
Ортақ күй моделі тасымалдаушылар арасында хабарландыруларды автоматтандыруды жеңілдетеді. Бірақ қалыпқа келтіру бастапқы оқиға сипаттамасын, орнын, уақыт белгісін немесе бастапқы тасымалдаушыны жоймауы керек.
Мысалы, жалпы ерекшелік күйі мекенжай мәселесін, кеденге байланысты кідірісті немесе сәтсіз жеткізу әрекетін білдіруі мүмкін. Бұл жағдайлардың әрқайсысы әртүрлі әрекетті талап етеді. Бастапқы хабарламаны сақтап, нақты ерекшелік санаттарын тек дереккөз қолдаған кезде пайдаланыңыз.
Жеткізу нәтижелері және әрекет етуге болатын ерекшеліктер
Сәлемдемелермен жұмыс істейтін командалар әдетте жеткізуге шығарылды, жеткізу әрекеті жасалды, алып кетуге қолжетімді, жеткізілді және қайтаруға қатысты оқиғаларды ажыратуы керек. API қандай айырмашылықтарды көрсететінін және олардың сіз пайдаланатын тасымалдаушылар арасында бірізді екенін сұраңыз.
Жеткізілгенін растайтын дәлелді бөлек талап ретінде қарастырыңыз. Жеткізілді күйі қолтаңбаға, фотосуретке, алушының атына немесе құжатқа қолжетімділік бар екеніне кепілдік бермейді. Тиісті қызметтер үшін қолжетімділікті, рұқсаттарды, сақтау мерзімін және құпиялылық шектеулерін растаңыз.
Кеден ақпаратының да шектеулері бар. Кеден туралы айтылған қадағалау оқиғасы декларация жазбасын, баждардың түсіндірмесін немесе босатудың сенімді болжамын міндетті түрде бермейді. Эскалация ережелерін болжамды заңдық немесе кедендік нәтижеге емес, оқиғада нақты айтылған ақпаратқа негіздеңіз.
API-дің екі түріне де қажет мүмкіндіктер
Сенімді оқиға қабылдау және қалпына келтіру
Оқиғаларға негізделген жұмыс процестері үшін webhook жеткізуін, аутентификацияны, қайталап жіберуді, қайталанатын оқиғаларды өңдеуді және үзілістен кейін қалпына келтіруді бағалаңыз. Бұлар әр провайдерде бар деп есептелетін мүмкіндіктер емес, тексерілуі тиіс сатып алу талаптары.
Қабылдаушы жүйеңіз қайталанатын және ретсіз келген хабарламаларды өңдей алатындай етіп жобалаңыз. Оқиға уақытын жүйеңіз жаңартуды алған уақыттан бөлек сақтаңыз. Тұрақты оқиға идентификаторы қолжетімді болмаса, бар өрістерді пайдаланып, қайталануды жоюдың құжатталған тәсілін анықтаңыз.
Хабарландыруларды өткізіп алғаннан кейін жөнелтілімнің оқиғалар тарихын қайта ала алатыныңызды сұраңыз. Webhook жұмысқа бастау үшін пайдалы, ал қолдау көрсетілетін алу немесе салыстыру процесі осы іске қосу өткізіліп кеткен кезде қалпына келуге көмектеседі.
Жаңалық, дереккөз және уақыт белгілерін өңдеу
Үш уақытты бөлек қарастырыңыз: физикалық оқиға болған уақыт, дереккөз оны жариялаған уақыт және қолданбаңыз жаңартуды алған уақыт. Әрбір дереккөз осы үшеуін де ашпауы мүмкін, бірақ қолжетімді уақыт белгілерін бөлек сақтау кідірістерді анықтауды жеңілдетеді.
Сол сияқты жаңа оқиғаның жоқтығын сәтсіз іздеуден ажыратыңыз. Өзгермеген жөнелтілім тарихы сканерлеулер арасындағы қалыпты үзілісті, дереккөздің істен шығуын, танылмаған идентификаторды немесе интеграция мәселесін білдіруі мүмкін. Операциялар командаңызға дұрыс жауапты таңдау үшін жеткілікті диагностикалық ақпарат қажет.
Берілген жағдайда уақыт белдеуі туралы ақпаратты сақтаңыз. Дереккөздің уақыт белгісінде уақыт белдеуі болмаса, оны көрінетіндей дәл жаһандық уақытқа үнсіз түрлендірмей, осы шектеуді тіркеңіз.
Қолжетімділік, құн және операциялық бақылау
Аутентификацияны, есептік жазбаларды оқшаулауды, деректерді сақтау мерзімін, жою процедураларын, сұрау шектеулерін және өндірістік қолдау шарттарын растаңыз. Қадағалау деректері жеке ақпаратты қамтуы мүмкін, сондықтан жұмыс процесіңізге қажет ақпаратты ғана жинап, көрсетіңіз.
Коммерциялық шарттарды нақты жұмыс көлеміңізбен салыстырыңыз. Не үшін ақы алынатынын сұраңыз: тіркелген жөнелтілім үшін бе, сұрау үшін бе, жаңарту үшін бе немесе басқа бірлік үшін бе. Жарамсыз нөмірлердің, қайталанған тіркеулердің, қайта қадағалаудың, тарихи іздеулердің және шектен асудың қалай есептелетінін нақтылаңыз. Бұл анықтамаларсыз көрсетілген баға сенімді құн салыстыруы емес.
Бір API-ді қашан пайдалану және дереккөздерді қашан біріктіру керек
Жүкке бағытталған көрінуді таңдаңыз, егер командаңыз әуе жүкқұжатының межелерімен, әуежайдағы өңдеумен, байланыс рейстерінің үзілуімен немесе жүктің ішінара келуімен жұмыс істесе. Қажетті жүк деңгейіндегі мәліметтер нақты көрсетілмейінше, сәлемдемелерді қадағалау ғана бұл жұмыс процестерін жеткілікті алмастыра алмайды.
Сәлемдемеге бағытталған көрінуді таңдаңыз, егер командаңызға пакет деңгейіндегі жеткізу жаңартулары, клиент хабарландырулары, межелі тасымалдаушы оқиғалары және жеткізу ерекшеліктерін басқару қажет болса. Әуе жүкқұжатының арнасы ғана сатып алушыға арналған жеткізуді қадағалау үшін жеткіліксіз.
Екеуін біріктіріңіз, егер халықаралық магистральдық тасымалды және жеке сәлемдемелерді жеткізуді басқарсаңыз. Шоғырландырылған жөнелтілім мен оның пакеттері үшін бөлек жазбалар сақтап, оларды өз логистикалық процессіңіз берген немесе тексерілген серіктес арнасы ұсынған сілтемелер арқылы байланыстырыңыз.
Мысалы, сатушы межелі жерде сәлемдемелер желісіне енгізілмес бұрын шоғырландырылған топтаманы әуе арқылы жібере алады. Жүк келуін шоғырландырылған жөнелтілімге қатысты тіркеңіз. Әр пакетке қатысты дәлел болғанда ғана оны жаңартыңыз; топтаманың әуежайға келуін әрбір тапсырыс үшін жеткізілді оқиғасына айналдырмаңыз.
17TRACK қай жерде сәйкес келеді
Осы архитектураның сәлемдеме жағы үшін 17TRACK's Tracking API көп тасымалдаушыны қадағалау интеграциясын бағалауға қатысты. Интеграцияны қажетті идентификаторлармен, жауап өрістерімен, хабарландыру жұмыс процесімен және операциялық шектеулермен салыстыру үшін ресми API құжаттамасын пайдаланыңыз.
Сәлемдемелер API интерфейсін бағалауды әуе жүктерінің функциялары расталды деп қабылдамаңыз. Егер сізге негізгі және ішкі деңгейдегі байланыстар, ұшу кезеңдерінің егжей-тегжейі немесе даналардың ішінара қозғалысы да қажет болса, осы талаптар бойынша нақты растау мен үлгі жауаптарды сұраңыз. Өнімнің дұрыс рөлі «қадағалау» сөзінің кеңдігімен емес, өзі дәлелдей алатын жұмыс процестерімен анықталады.
Шешім қабылдамас бұрын тұжырымдаманы тексеріңіз
Нақты тасымалдаушыларыңыздан, бағыттарыңыздан және қызмет түрлеріңізден алынған репрезентативті жөнелтілімдерді пайдаланыңыз. Нәтижесі белгілі аяқталған жөнелтілімдерді де, белсенді жөнелтілімдерді де қосыңыз. Бір қарапайым жөнелтілімді сәтті іздеу интеграцияны растауға жеткіліксіз.
- Әр оқиға қолдауы тиіс шешімді анықтаңыз. Мысалы, жіберілген жүк байланысын зерттеу, мекенжай мәселесі туралы сатып алушыға хабарласу немесе жеткізу хабарландыруын жіберу.
- Репрезентативті сынақ жиынтығын құрыңыз. Тиісті жерде тасымалдаушы ауысуларын, тыныш кезеңдерді, жеткізу әрекеттерін, қайтарымдарды және жүктің бөлінген қозғалыстарын қосыңыз.
- Нысан деңгейіндегі дәлдікті тексеріңіз. Әр оқиғаның рейске, жөнелтілімге, бөлікке немесе жеке пакетке қатысты екенін растаңыз.
- Операциялық дереккөзбен салыстырыңыз. Жетіспейтін межелерді, уақыт белгілерін, орындарды, бастапқы хабарламаларды және түзетулерді өзіңіз қол жеткізуге рұқсатыңыз бар тасымалдаушы немесе серіктес жазбаларымен салыстырыңыз.
- Ақаудан қалпына келтіруді тексеріңіз. Қайталанатын, кешіккен оқиғаларды, жарамсыз идентификаторларды, анық емес тасымалдаушыларды, webhook үзілістерін және салыстыруды сынаңыз.
- Экономика мен жауапкершілікті растаңыз. Жұмыс көлеміңізге қарай құнды есептеп, бастапқы деректер мәселелеріне, интеграция ақауларына және клиенттермен байланысқа жауапкершілікті бөліңіз.
Нәтижелерді қараудан бұрын қабылдау критерийлерін белгілеңіз. Олар әрбір жұмыс процесі үшін қажетті өрістерді, оқиға мағынасын, қалпына келу тәртібін және қолайлы жаңарту кідірістерін қамтуы керек. Клиент хабарландыруы мен жүкке араласу әртүрлі шектерді талап етуі мүмкін.
Жиі қойылатын сұрақтар
Бір қадағалау API интерфейсі әуе жүктері мен сәлемдемелерді қамти ала ма?
Мүмкін, бірақ екеуі үшін де деректер моделін және дереккөздерге қолжетімділікті растаңыз. Ортақ соңғы нүкте жүк көлемдерін, ұшу кезеңдерін, ішкі байланыстарды немесе сәлемдеме тапсыруларын қолдайтынын дәлелдемейді. Екі жұмыс процесі үшін бөлек көрсетілімдер сұраңыз.
Жеке сәлемдемені қадағалау үшін әуе жүкқұжатының нөмірін пайдалана аламын ба?
Міндетті емес. Әуе жүкқұжаты жеке пакетті емес, ірі жөнелтілімді анықтауы мүмкін. Олардың тарихын байланыстыру үшін сол жөнелтілім мен сәлемдеме идентификаторы арасындағы тексерілген байланыс қажет.
«Нақты уақыттағы қадағалау» үздіксіз физикалық орынды білдіре ме?
Олай деп ойламаңыз. Қадағалау үздіксіз орын телеметриясына емес, белгілі аралықтарда жарияланатын операциялық оқиғаларға негізделуі мүмкін. Жаңартуларды не іске қосатынын, қандай уақыт белгілері көрсетілетінін және кез келген орын деректерінің бөлек сенсор көзінен келетінін сұраңыз.
Webhook polling-тен жақсы ма?
Webhook қайталанатын күй сұрауларынсыз оқиға хабарландыруларын алуға пайдалы. Polling немесе басқа алу механизмі салыстыру мен қалпына келтіруді әлі де қолдай алады. Провайдердің құжатталған тәртібіне, шектеулеріне және өткізіліп кеткен немесе кешіккен жаңартуларға төзімділігіңізге қарай жобаны таңдаңыз.
Жеткізілді оқиғасы сатып алушының жөнелтілімді алғанын дәлелдей ме?
Барлық жағдайда емес. Жүктің аяқталуы логистикалық тарапқа тапсыруды сипаттауы мүмкін, ал сәлемдемені жеткізу оқиғалары тасымалдаушының жеткізу процесіне байланысты. Оқиға анықтамасын тексеріп, жұмыс процесіңіз талап етсе, жеткізудің бөлек дәлелін алыңыз.
Дереккөздер
- IATA — ONE Record: стандартталған жүк деректерін бөлісуге арналған салалық анықтама; белгілі бір API қамтуына кепілдік бермейді.
- 17TRACK — Tracking API: сәлемдемелерді қадағалау интеграциясын бағалауға арналған ресми өнім анықтамасы.
- 17TRACK — API құжаттамасы: іске асыру талаптарын тексеруге арналған техникалық анықтама.


