API за следење на океански товар: настани на контејнерите, податоци за ETA и критериуми за избор

API за следење на поморски товар треба да ги поврзува движењата на контејнерите, транспортните пресвртници и ажурирањата на ETA со пратката со која управува вашиот тим. За шпедитерите, увозниците и тимовите за интеграција, тестот за избор е дали може сигурно да го идентификува правилното патување на контејнерот, да ги разликува реалните настани од прогнозите и да обезбеди доволно контекст за поддршка на оперативните одлуки. Општ статус на пратката или необјаснет датум на пристигнување не е доволен за управување со поморски товар.

Овој водич објаснува кои податоци треба да ги побарате, како да ги толкувате настаните на контејнерите и проценките за пристигнување и како да ја оцените интеграцијата пред да ѝ доверите продукциски сообраќај или буџет за набавка.

Започнете со моделот на пратката, а не со екранот за следење

Следењето на поморскиот товар опфаќа неколку поврзани објекти: комерцијална пратка, нејзините транспортни документи, еден или повеќе контејнери и транспортните делници со кои се пренесуваат. Овие врски се важни бидејќи една резервација може да опфаќа повеќе контејнери, додека еден контејнер може да минува низ неколку пловила, терминали и копнени делници.

Корисната интеграција мора да ги зачува овие врски наместо да претвора сè во еден статус. Ако два контејнери под иста пратка се движат различно, системот треба да му овозможи на операторот да ја види разликата наместо да прикажува навидум целосна пресвртница на ниво на пратка.

Пред да оценувате API, идентификувајте ги референците што вашиот бизнис навистина ги прима:

• Број на контејнер: Ја идентификува опремата, но треба да биде поврзан со соодветната пратка или патување бидејќи контејнерите повторно се користат.
• Референца за резервација кај превозникот: Може да го поврзе барањето за следење со резервација, зависно од условите за пребарување на изворниот систем.
• Референца на транспортниот документ: Може да ја идентификува пратката на ниво на поморскиот превозник. Потврдете дали API прифаќа референци на документите што ги поседува вашиот тим.
• Интерен ID на пратката: Ги поврзува надворешните записи за следење со вашиот систем за управување со транспортот, ERP или софтвер за шпедиција.

Не претпоставувајте дека референцата на куќниот товарен лист издадена од шпедитер може да се користи насекаде каде што се бара референца на документот на поморскиот превозник. Тестирајте ги точните идентификатори достапни во вашите текови за резервации и документи.

Кои настани на контејнерите треба да ги обезбедува API?

Стандардите Track & Trace на Digital Container Shipping Association се корисна референца за дискусија за податоците за поморските пратки. DCSA ги разликува настаните на пратката, транспортот и опремата. Овие категории помагаат да се одделат административниот напредок, движењето на транспортот и ракувањето со физичкиот контејнер.

Не е неопходно продавачот да ги користи вашите омилени имиња на полиња за да биде корисен, но треба да објасни како неговиот модел на настани се поврзува со оперативните пресвртници што ви се потребни.

Настани на опремата: што се случило со контејнерот

Релевантните пресвртници на опремата може да вклучуваат влез на порта, натоварување, истовар, излез од порта и движења на празен контејнер. Достапноста зависи од патувањето, изворот и производот. Барајте примероци на записи наместо да претпоставувате дека секој настан е достапен на секој терминал.

Овие разлики имаат практични последици. Пристигнувањето на пловилото не докажува дека конкретен контејнер е истоварен. Истоварот не докажува дека контејнерот е ослободен или подготвен за преземање. Записот за излез од порта исто така бара локација и контекст: излез од претоварен објект не е ист деловен исход како преземање од крајниот увозен терминал.

Транспортни настани: каде се наоѓа пловилото или транспортната делница

Настаните на пристигнување и поаѓање ја опишуваат транспортната активност. За да ги толкува, вашиот систем треба да ја има поврзаната локација, начинот на транспорт и делницата. Кога се достапни, идентификаторите на пловилото и патувањето помагаат да се разликува планираното пловење од друго движење што ги опслужува истите пристаништа.

Кај товарот со претовар, зачувајте ги меѓустаниците. Скратувањето на маршрутата само на почетна и крајна точка може да сокрие пропуштена врска или промена на маршрутата. Оперативната временска линија треба да овозможи да се види која делница е завршена, а која сè уште е проценета.

Настани на пратката: административниот напредок не е физичко движење

Настаните поврзани со документи и обработка на пратката може да бидат корисни за шпедитерските текови, но треба да останат различни од движењето на контејнерот. Документарната пресвртница не потврдува дека товарот физички се движел, а настанот на движење не потврдува дека се исполнети сите комерцијални или регулаторни барања.

За секој настан побарајте тип на настан, релевантен објект, локација, временски печат на настанот, информации за временската зона, извор и ознака дали настанот е планиран, проценет или реален. Исто така побарајте стабилен идентификатор на настанот и однесување при корекции за повторените ажурирања да не создаваат дупликатни пресвртници.

На податоците за ETA им требаат дестинација, значење и историја

ETA е проценето време на пристигнување на одредена точка. Тоа само по себе не е ветување дека товарот ќе биде достапен за преземање. API за следење на поморски товар треба јасно да ја наведе целната пресвртница наместо да враќа двосмислено поле означено само како eta.

На пример, проценката за пристигнување може да се однесува на пристанишен повик, терминал, копнен објект или друга дефинирана дестинација. Пред да ја користите за распоредување камиони или ветување достапност на залихи, утврдете што точно претставува тој временски печат.

Одделете го изворот на проценката од нејзиниот статус

Проценката обезбедена од превозникот и прогнозата генерирана од провајдерот се различни производи на податоци. Ниту една не треба да се прикажува како реално пристигнување. Прашајте дали одговорот го идентификува потеклото на проценката, времето на нејзино пресметување или објавување и локацијата или настанот што го предвидува.

Ако провајдерот нуди предвидувачка ETA, побарајте ја неговата методологија и пристапот за валидација. Корисни прашања се којa пресвртница се предвидува, колку пред пристигнувањето се мери успешноста и дали резултатите се разликуваат по маршрутите што ги користите. Општо тврдење за точноста тешко се применува кога целниот настан и периодот на мерење не се наведени.

Зачувајте ги ревизиите на 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 и потврдете што се случува кога изворот не објавува нов настан.

Може ли настаните за следење да ги пресметаат трошоците за демeрeж или задржување?

Настаните можат да ја поддржат временската линија, но не воспоставуваат целосна пресметка на трошоците. Потребни ви се и важечките договорни услови, правилата за бесплатен период, календарскиот третман и авторитетните почетни и крајни услови. Не изведувајте износи за плаќање само од општи пресвртници.

Извори

• DCSA: Track & Trace стандарди — Референтна рамка за настани на пратки, транспорт и опрема во контејнерскиот превоз.
• DCSA: складиште со OpenAPI спецификации — Техничка референца за DCSA API дефиниции и структури на настани. Проверете ја применливата верзија на спецификацијата при дизајнирање интеграција.
• International Maritime Organization: Automatic Identification Systems — Основни информации за AIS и информациите за пловилата што ги обезбедува.
• 17TRACK: Tracking API и официјална API документација — Почетни точки за потврдување на соодветноста на производот; овде не се доказ за поддршка на настани на океански контејнери или предвидувачка ETA.