Теңіз жүк тасымалын қадағалау API-і: контейнер оқиғалары, ETA деректері және таңдау критерийлері

Теңіз жүк тасымалын қадағалау API-і контейнерлердің қозғалысын, тасымалдау кезеңдерін және ETA жаңартуларын сіздің командаңыз басқаратын жөнелтіліммен байланыстыруы керек. Жүк экспедиторлары, импорттаушылар және интеграция топтары үшін таңдау критерийі — жүйенің дұрыс контейнер сапарын сенімді анықтай алуы, нақты оқиғаларды болжамдардан ажыратуы және операциялық шешімдерді қолдауға жеткілікті контекст ұсынуы. Жалпы жөнелтілім күйі немесе түсіндірілмеген келу күні теңіз тасымалын басқару үшін жеткіліксіз.

Бұл нұсқаулықта сұралатын деректер, контейнер оқиғалары мен келу болжамдарын түсіндіру жолы және өндірістік трафикті немесе сатып алу бюджетін бекітпес бұрын интеграцияны бағалау тәсілі түсіндіріледі.

Қадағалау экранынан емес, жөнелтілім моделінен бастаңыз

Теңіз жүк тасымалын қадағалау бірнеше өзара байланысты нысанды қамтиды: коммерциялық жөнелтілім, оның тасымалдау құжаттары, бір немесе бірнеше контейнер және оларды тасымалдайтын тасымалдау кезеңдері. Бұл байланыстар маңызды, себебі бір бронь бірнеше контейнерді қамтуы мүмкін, ал контейнер бірнеше кеме, терминал және құрлықтағы кезең арқылы қозғала алады.

Пайдалы интеграция осы байланыстарды бір ғана күйге біріктірмей, сақтауы керек. Бір жөнелтілімге кіретін екі контейнер әртүрлі қозғалса, жүйе операторға айырмашылықты көруге мүмкіндік беруі тиіс, ал жөнелтілім деңгейіндегі толық көрінетін кезеңді көрсетумен шектелмеуі керек.

API-ді бағаламас бұрын бизнесіңіз нақты алатын сілтемелерді анықтаңыз:

• Контейнер нөмірі: Жабдықты анықтайды, бірақ тиісті жөнелтіліммен немесе сапармен байланыстырылуы керек, себебі контейнерлер қайта пайдаланылады.
• Тасымалдаушының бронь сілтемесі: Бақылау сұрауын броньмен байланыстыра алады, бірақ бұл бастапқы жүйенің іздеу талаптарына тәуелді.
• Тасымалдау құжатының сілтемесі: Жөнелтілімді теңіз тасымалдаушысы деңгейінде анықтауы мүмкін. API командаңызда бар құжат сілтемелерін қабылдайтынын тексеріңіз.
• Ішкі жөнелтілім ID-і: Сыртқы қадағалау жазбаларын тасымалдауды басқару жүйесімен, ERP немесе экспедиторлық бағдарламамен байланыстырады.

Экспедитор берген үй жүкқұжатының сілтемесін теңіз тасымалдаушысының құжат сілтемесі қажет болған кез келген жерде пайдалануға болады деп ойламаңыз. Броньдау және құжат айналымы процестеріңізде қолжетімді нақты идентификаторларды тексеріңіз.

API қандай контейнер оқиғаларын ұсынуы керек?

Digital Container Shipping Association ұйымының Track & Trace стандарттары теңіз жөнелтілімдері туралы деректерді талқылау үшін пайдалы негіз береді. DCSA жөнелтілім, тасымалдау және жабдық оқиғаларын ажыратады. Бұл санаттар әкімшілік ілгерілеуді, тасымалдың қозғалысын және физикалық контейнерді өңдеуді бөлек қарастыруға көмектеседі.

Пайдалы болу үшін жеткізуші сіз қалаған өріс атауларын міндетті түрде қолдануы шарт емес, бірақ оның оқиғалар моделі сізге қажет операциялық кезеңдермен қалай сәйкестенетінін түсіндіруі керек.

Жабдық оқиғалары: контейнермен не болды

Маңызды жабдық кезеңдеріне терминалға кіру, тиеу, түсіру, терминалдан шығу және бос контейнер қозғалысы кіруі мүмкін. Қолжетімділік сапарға, дерек көзіне және өнімге байланысты. Әр терминалда барлық оқиға бар деп болжам жасамай, үлгі жазбаларды талап етіңіз.

Бұл айырмашылықтардың практикалық салдары бар. Кеменің келуі нақты контейнердің түсірілгенін дәлелдемейді. Түсіру контейнердің босатылғанын немесе алып кетуге дайын екенін дәлелдемейді. Терминалдан шығу жазбасына да орналасу мен контекст қажет: қайта тиеу нысанынан шығу соңғы импорт терминалынан алып кетумен бірдей бизнес нәтижесі емес.

Тасымалдау оқиғалары: кеме немесе тасымалдау кезеңі қай жерде тұр

Келу және жөнелу оқиғалары тасымалдау әрекетін сипаттайды. Оларды түсіндіру үшін жүйеңізге байланысты орын, тасымалдау режимі және кезең қажет. Қолжетімді болған жағдайда кеме мен рейс идентификаторлары бір порттарға қызмет көрсететін басқа қозғалыстан жоспарланған рейсті ажыратуға көмектеседі.

Транзитпен тасымалданатын жүк үшін аралық аялдамаларды сақтаңыз. Маршрутты тек шығу орны мен межелі орынға дейін қысқарту байланыс үзілгенін немесе маршруттың өзгергенін жасыруы мүмкін. Операциялық уақыт шкаласы қай кезең аяқталғанын және қайсысы әлі болжамды екенін көрсетуі тиіс.

Жөнелтілім оқиғалары: әкімшілік ілгерілеу физикалық қозғалыс емес

Құжат және жөнелтілімді өңдеу оқиғалары экспедиторлық процестер үшін пайдалы болуы мүмкін, бірақ олар контейнер қозғалысынан ажыратылуы керек. Құжаттық кезең жүктің физикалық қозғалғанын білдірмейді, ал қозғалыс оқиғасы барлық коммерциялық немесе реттеуші талаптардың орындалғанын білдірмейді.

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

ETA деректеріне межелі орын, мағына және тарих қажет

ETA — көрсетілген нүктеге болжамды келу уақыты. Ол жүктің алып кетуге дайын болатыны туралы уәде емес. Теңіз жүк тасымалын қадағалау API-і тек eta деп белгіленген түсініксіз өрісті қайтармай, межелі кезеңді нақты көрсетуі керек.

Мысалы, келу болжамы портқа кіруге, терминалға, ішкі құрлық нысанына немесе басқа анықталған межелі орынға қатысты болуы мүмкін. Оны жүк көліктерін жоспарлау немесе тауардың қолжетімділігіне уәде беру үшін пайдаланбас бұрын, уақыт белгісінің нақты нені білдіретінін анықтаңыз.

Болжам көзін оның күйінен ажыратыңыз

Тасымалдаушы ұсынған болжам мен жеткізуші жасаған болжам — екі түрлі дерек өнімі. Екеуін де нақты келу ретінде көрсетуге болмайды. Жауапта болжамның шығу тегі, оның есептелген немесе жарияланған уақыты және болжанатын орын не оқиға көрсетілгенін сұраңыз.

Егер жеткізуші болжамды ETA ұсынса, оның әдістемесі мен валидация тәсілін сұраңыз. Пайдалы сұрақтарға қай кезең болжанатыны, келуге дейін қанша уақыт бұрын дәлдік өлшенетіні және нәтижелер сіз пайдаланатын бағыттар арасында өзгеше бола ма деген мәселелер жатады. Мақсатты оқиға мен өлшеу терезесі көрсетілмесе, жалпы дәлдік туралы мәлімдемені қолдану қиын.

ETA өзгерістерін қайта жазбай, сақтаңыз

Соңғы ETA бүгінгі жоспарлауды қолдайды, ал өзгерістер тарихы не өзгергенін түсіндіреді. Алдыңғы болжамды, жаңа болжамды, байланысты кезеңді, дерек көзін және жүйеңіз өзгерісті алған уақытты сақтаңыз.

Бұл тарих операциялық топқа елеулі кешігуді формат түзетуінен немесе байланысы жоқ портқа кіру өзгерісінен ажыратуға мүмкіндік береді. Сондай-ақ сапардың ертерек кезеңінде соңғы болжам белгілі болғандай әсер қалдырмай, кейінгі бағалауды қолдайды.

Уақыт белдеулерін арнайы тексеру қажет. Бастапқы уақыт белгісін және берілген жағдайда оның ығысуын сақтаңыз, есептеу үшін уақыт белгілерін қалыпқа келтіріңіз және қажет болғанда жергілікті операциялық уақытты көрсетіңіз. Егер дерек көзі тек күнді берсе, оны нақты түн ортасында келу уәдесіне үнсіз айналдырмаңыз.

Қамтуды оқиға деңгейінде бағалаңыз

Тасымалдаушының қамту тізімінде болуы өздігінен әр контейнер кезеңі қолжетімді екенін білдірмейді. Қамту бизнесіңіз үшін маңызды тасымалдаушыларға, бағыттарға, жөнелтілім сілтемелеріне және операциялық оқиғаларға қатысты тексерілуі керек.

Нақты талаптарыңызбен бағалау матрицасын құрыңыз. Әр үлгілік жөнелтілім бойынша API сілтемені шеше ала ма, дұрыс маршрутты қайтара ма, қажетті кезеңдерді көрсете ме және сіз басқаратын сапар бөлігі бойындағы жаңартуларды сақтай ма — тексеріңіз.

• Тікелей теңіз тасымалы: Шығу орнынан жөнелуді, межелі орынға келуді және тиісті контейнер өңдеу оқиғаларын анықтай аласыз ба?
• Транзиттік тасымал: Аралық кезеңдер көріне ме және бөлек қозғалған контейнерлерді ажыратуға бола ма?
• Құрлықтағы кезеңдер: Қызметіңіз оларды қамтыса, API тиісті теміржол, баржа немесе жүк көлігі кезеңдерін бере ме, әлде көріну портта аяқтала ма?
• Ерекше жағдайлар: Жетіспейтін оқиғалар, өзгерген маршруттар, сәйкеспеген сілтемелер және дерек көзінің үзілуі қалай көрсетіледі?
• Аяқталған жөнелтілімдер: Командаңыз клиент дауын зерттеу немесе операциялық жазбаны салыстыру үшін жеткілікті тарихи деректі ала ала ма?

Қолжетімсіз деректерді теріс оқиғалардан бөлек ұстаңыз. Түсіру жазбасының болмауы түсіру болмағанын дәлелдемейді. Пайдалы интеграция нақты операциялық күйді көріну деректеріндегі олқылықтан ажыратады.

API әрекеті оқиғалар тізімі сияқты маңызды

Тіпті оқиғалар ағыны бай болған жағдайда да, жеткізу тәртібі түсініксіз болса, оны пайдалану қиын болуы мүмкін. Қолданбаңыз жаңартуларды қалай алатынын, түзетулерді қалай өңдейтінін және үзілістен кейін қалай қалпына келетінін бағалаңыз.

Сұрау жіберу, вебхуктар және қалпына келу

Сұрау жіберу қолданбаңызға жаңартуларды өз кестесі бойынша сұратуға мүмкіндік береді. Вебхуктар жеткізушіге жаңартуларды сіз басқаратын соңғы нүктеге жіберуге мүмкіндік береді. Екі механизмнің ешқайсысы деректің жаңалығын өздігінен қамтамасыз етпейді: бірден жеткізілген вебхукте де дерек көзінен кеш алынған оқиға болуы мүмкін.

Қолжетімді болса, бастапқы оқиға уақытын, жеткізушінің алған уақытын және хабарландыру уақытын бөлек анықтауды сұраңыз. Вебхуктар үшін аутентификацияны немесе қолтаңбаны тексеруді, қайталап жіберуді, дубликат жеткізу тәртібін және сәтсіз хабарландыруларды қайта ойнатуға болатынын растаңыз. Сұрау жіберу кезінде беттеуді, жиілік шектеулерін, инкременттік алуды және тарихи түзетулердің өңделуін тексеріңіз.

Дәлелдерді жоғалтпай қалыпқа келтіру

Қалыпқа келтірілген күйлер тасымалдаушылар арасындағы процестерді жеңілдетеді, бірақ шамадан тыс жеңілдету пайдалы контексті жояды. Мүмкін болған жағдайда қалыпқа келтірілген оқиғаны бастапқы дерек көзінің сипаттамасымен немесе кодымен бірге сақтауға мүмкіндік беретін модельді таңдаңыз.

Шикі кіріс жазбаларын оларды бақылау тақтасындағы күйлерге айналдыратын бизнес ережелерінен бөлек сақтаңыз. Бұл бастапқы дәлелдерді жоғалтпай сәйкестендіруді қайта қарауға мүмкіндік береді. Сондай-ақ операциялық топтың түсіндірмесінен өзгеше болған клиентке көрсетілетін күйді зерттеуді жеңілдетеді.

Коммерциялық және басқару тексерулері

Есептеу бірлігінің жазбаша түсіндірмесін сұраңыз. Жазылым, қадағаланатын жөнелтілім, контейнер, API сұрауы және хабарландыру бір-бірін алмастыратын өлшемдер емес. Қайта сұраулар, қайталанатын тіркеулер, тарихи іздеулер және қайта белсендірілген жөнелтілімдер төлемге қалай әсер ететінін нақтылаңыз; белгілі бір баға моделін алдын ала қабылдамаңыз.

Сонымен қатар деректерді сақтау мерзімін, қолжетімділікті басқаруды, тіркелгі деректерін ауыстыруды, рұқсат етілген кейінгі пайдалануды, қолдау қызметіне эскалацияны және қызмет міндеттемелерін қарастырыңыз. Шарттық кепілдіктерді өнім көрсетілімдері мен маркетингтік мәлімдемелерден бөлек бағалаңыз.

Жалпы қадағалау API-і теңіз тасымалы талаптарына сәйкес келеді деп ойламаңыз

Қадағалау API-ін санат атауына емес, тексерілген деректер моделіне сүйеніп таңдаңыз. Сәлемдемені жеткізу жаңартулары мен теңіз контейнерлерінің көрінуі, екеуі де жөнелтілімді қадағалау деп аталғанымен, әртүрлі процестерге қызмет етуі мүмкін.

Егер 17TRACK интеграцияңыздың қысқа тізімінде болса, талаптарды тексеруді бастау үшін оның ресми Tracking API бетіне және API құжаттамасына жүгініңіз. Кез келген жалпы қадағалау интеграциясын теңіз жүк тасымалы шешімі деп қабылдамас бұрын, қолданбаңызға қажет нақты теңіз сілтемелерін, контейнер оқиғаларын, тасымалдау кезеңдерін және ETA өрістерін растаңыз. Бұл нұсқаулық 17TRACK үшін теңізге тән мүмкіндіктердің бар екенін дәлелдемейді.

Дәл осындай қабылдау стандарты кез келген үміткерге қолданылуы керек: нақты жөнелтілімдер арқылы қажетті деректерді көрсетіп, шектеулерін түсіндіруі тиіс. Кеңірек тасымалдаушы қадағалау процесі жеткізу тізбегіңіздің басқа бөліктерінде пайдалы болуы мүмкін, бірақ мамандандырылған контейнер оқиғалары ағынын алмастырмауы керек.

Операциялық шешімдер төңірегінде тұжырымдаманы тексеріңіз

Ең тиімді тұжырымдаманы тексеру бақылау тақтасының көрсетілімінен емес, командаңыз қабылдауы тиіс шешімдерден басталады. Өз операцияларыңыздан қарапайым сапарларды да, қолмен жұмыс туғызатын күрделі жағдайларды да қамтитын үлгілік жөнелтілімдерді таңдаңыз.

1. Қабылдау критерийлерін анықтаңыз. Тестілеуге дейін қажетті сілтемелерді, оқиғаларды, орындарды, уақыт белгілерінің мағынасын және жетіспейтін деректерді өңдеудің қолайлы тәртібін көрсетіңіз.
2. Сәйкестікті растаңыз. Әр нәтиже қажетті жөнелтілім мен контейнер сапарына тиесілі екенін тексеріңіз. Қайта пайдаланылған жабдық пен бірнеше контейнерлі броньдарды қажет болғанда қосыңыз.
3. Бастапқы жазбалармен салыстырыңыз. Жаңарту уақытындағы айырмашылықтарды ескере отырып, қайтарылған кезеңдерді қолжетімді тасымалдаушы немесе терминал жазбаларымен салыстырыңыз.
4. Түзетулер мен ақауларды тексеріңіз. Дубликат хабарландыруларды, ретсіз келген оқиғаларды, түзетілген уақыт белгілерін, қолжетімсіз дерек көздерін және соңғы нүкте үзілістерін сынаңыз.
5. Бизнес процесін қайта орындаңыз. Деректердің кешіккен байланыстарды тексеру немесе кіріс тауар қорының болжамын жаңарту сияқты жоспарланған әрекетті қолдайтынын растаңыз.
6. Шешілмеген олқылықтарды қарастырыңыз. Әр олқылықтың бастапқы дерек көзінен, жеткізушінің өңдеуінен немесе интеграцияңыздан туындағанын белгілеңіз. Пайдалануды кеңейтпес бұрын түзету шараларын келісіңіз.

ETA тестілеу кезінде әр болжамды келген сәтінде сақтап, оны сол кезеңнің кейінгі нақты оқиғасымен салыстырыңыз. Портқа келу болжамын қоймаға қабылдаумен салыстырмаңыз және өте әртүрлі алдын ала мерзімдерде жасалған болжамдарды түсіндірілмеген бір көрсеткішке біріктірмеңіз.

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

Жиі қойылатын сұрақтар

Теңіз жөнелтілімін тек контейнер нөмірі арқылы қадағалай аламын ба?

Бұл дерек көзі мен API-ге байланысты. Кейбір процестерге тасымалдаушы идентификаторы, бронь сілтемесі немесе тасымалдау құжатының сілтемесі де қажет болуы мүмкін. Жабдық қайта пайдаланылатындықтан, тек контейнер нөміріне сүйенбей, қайтарылған оқиғалардың сіз көздеген сапарға тиесілі екенін растаңыз.

Кеменің нақты келуі контейнерім алып кетуге дайын дегенді білдіре ме?

Жоқ. Кеменің келуі, контейнерді түсіру, жүктің қолжетімділігі және алып кетуге рұқсат — бөлек операциялық фактілер. Жөнелтілімге байланысты алып кету үшін босату туралы ақпарат пен терминалдағы қабылдау уақыты да қажет болуы мүмкін. Тиісті шарттарды оларға жауапты тараптармен тексеріңіз.

AIS кемелерді қадағалау контейнерлерді қадағалауды алмастыра ма?

Жоқ. AIS кемені анықтауға және оның қозғалысы туралы ақпаратқа қатысты; ол жеке контейнердің тиелуін, түсірілуін, босатылуын немесе терминалдан шығуын өздігінен растамайды. Кеме қозғалысы контекст бере алады, бірақ контейнердің рейспен байланысы әлі де расталуы керек.

Теңіз қадағалау API-і қаншалықты жиі жаңартылуы керек?

Барлық процесс үшін бірдей пайдалы интервал жоқ. Талаптарды командаңыз тиісті бастапқы ақпарат қолжетімді болғаннан кейін қаншалықты жылдам әрекет етуі керек екеніне қарай белгілеңіз. Дерек көзінің кідірісін API арқылы жеткізу кідірісінен бөлек өлшеңіз және дерек көзі жаңа оқиға жарияламағанда не болатынын растаңыз.

Қадағалау оқиғалары демерредж немесе контейнерді ұстау төлемдерін есептей ала ма?

Оқиғалар уақыт шкаласын қолдай алады, бірақ толық төлем есебін анықтамайды. Сондай-ақ қолданылатын шарт талаптары, тегін уақыт ережелері, күнтізбелік есеп тәртібі және басталу мен аяқталудың беделді шарттары қажет. Төленуге тиіс соманы тек жалпы кезеңдерден шығармаңыз.

Дереккөздер

• DCSA: Track & Trace стандарттары — Контейнерлік тасымалдағы жөнелтілім, тасымалдау және жабдық оқиғаларына арналған анықтамалық негіз.
• DCSA: OpenAPI спецификацияларының репозиторийі — DCSA API анықтамалары мен оқиға құрылымдарына арналған техникалық анықтама. Интеграцияны жобалау кезінде қолданылатын спецификация нұсқасын тексеріңіз.
• Халықаралық теңіз ұйымы: автоматты сәйкестендіру жүйелері — AIS және ол ұсынатын кеме туралы ақпарат жөніндегі жалпы мәлімет.
• 17TRACK: Tracking API және ресми API құжаттамасы — өнімнің сәйкестігін тексеруді бастау нүктелері; мұнда мұхит контейнері оқиғаларын немесе болжамды ETA қолдауын дәлелдемейді.