Въздушен карго транспорт срещу проследяване на трансгранични пратки: Какви възможности на API са ви необходими?
Изберете API за проследяване на въздушни товари, когато приложението ви трябва да проследява въздушни товарителници, полетни отсечки, етапи на обработка на товара и количества пратки. Изберете API за проследяване на трансгранични колети, когато се нуждаете от актуализации на ниво пакет при различни превозвачи, изключения при доставката и статус на доставката до крайния получател. Ако пратките ви комбинират консолидиран въздушен товар с доставка на отделни колети, са ви необходими и двата слоя на видимост, както и надежден начин за свързване на техните идентификатори.

За инженерни екипи, логистични оператори и електронни магазини решението за покупка зависи по-малко от това кое API връща повече събития и повече от това дали тези събития описват единицата на пратката, която действително управлявате. Събитие за пристигане на авиокомпания само по себе си не може да каже на купувача къде се намира пакетът му или кога ще пристигне до неговата врата.
Започнете от единицата на пратката, а не от транспортния режим
Въздушните товари и трансграничните колети не са взаимно изключващи се категории доставки. Един колет може да пътува международно със самолет, докато авиокомпанията го обработва като част от по-голяма консолидирана пратка. Разликата при избора на API е оперативният обект, който се проследява.
Видимостта при въздушните товари обикновено се съсредоточава върху въздушната товарителница и свързаното транспортно движение. В зависимост от източника данните може да описват приемане, отпътуване, пристигане, наличност на товара и предаване. Видимостта при колетите се съсредоточава върху отделните пакети и напредъка им през получаването, международния транспорт, обработката в държавата на местоназначение и доставката.
Главната въздушна товарителница може да представлява консолидирано движение, съдържащо множество отделни пратки. Вътрешните въздушни товарителници, етикетите на колетите и проследяващите номера на превозвача в държавата на местоназначение могат да идентифицират различни нива в това движение. Не приемайте, че доставчикът на проследяване може автоматично да открие или свърже всички тези зависимости.
| Област на решението | Проследяване на въздушни товари | Проследяване на трансгранични колети |
|---|---|---|
| Основен обект | Въздушна товарителница, товарна пратка или транспортна отсечка | Отделен пакет и неговите идентификатори при превозвача |
| Оперативни въпроси | Приет ли е товарът, превозен ли е по въздух, пристигнал ли е или е предаден? | Къде се намира пакетът, какво го блокира и доставен ли е? |
| Връзки, които трябва да се запазят | Референции на главни и вътрешни товарителници, отсечки, бройки и разделени движения | Връзки между поръчка и пакет, предаване между превозвачи, заместващи идентификатори и връщания |
| Типичен отговорен екип | Екип за спедиция, транспорт или операции с товари | Екип за операции в електронната търговия, обслужване на клиенти или управление на доставките |
| Основен риск при интерпретацията | Приемане на една отсечка или частично пристигане за приключване на цялата пратка | Приемане на предаване или нееднозначно събитие за доставка като получаване от купувача |
Какво трябва да поддържа API за проследяване на въздушни товари
Идентичност на въздушната товарителница и връзки между пратките
Попитайте какви идентификатори приема API и какво връща всяка заявка. Поддръжката на главна въздушна товарителница не означава автоматично поддръжка на видимост на ниво вътрешна товарителница. Ако операциите ви зависят от вътрешни пратки, поискайте демонстрация с ваши собствени референции и оторизирани източници на данни.
Моделът на данните трябва да запазва връзките между пратката, транспортните ѝ отсечки и всички части, които се придвижват отделно. При работни процеси, чувствителни към количествата, попитайте дали броят на бройките и теглото са налични на ниво пратка, събитие или и на двете нива. Общото количество на ниво пратка не заменя информацията колко товар е достигнал до конкретно летище.
Видимост на транспортните отсечки и обработката
Изисквайте достатъчно контекст, за да различавате отпътуване от началната точка от отпътуване при прекачване, както и планирано движение от действително движение. Полезните полета може да включват летища на произход и местоназначение, референции на полети, местоположения на събития и планирани спрямо действителни времеви маркери. Наличността им зависи от източника и трябва да бъде проверена, а не предполагана.
Също така различавайте движението на самолета от движението на товара. Пристигането на самолет само по себе си не доказва, че всяка свързана пратка е била натоварена, разтоварена, обработена или предоставена за получаване. Попитайте дали събитието е специфично за пратката или е извлечено от канал с данни за полета.
Частични движения и значение на етапите
Товарната пратка може да се придвижва на части. Системата ви не трябва да маркира цялата товарна пратка като пристигнала само защото има събитие за пристигане на част от нея. Тествайте как API представя множество полети, частични количества, променени маршрути и корекции.
Определенията на етапите изискват същото внимание. Предаването на спедитор или друга логистична страна не е непременно доставка до крайния получател. Нека доставчикът обясни оперативното значение на събитията за приключване и запазете това значение във вътрешния си модел на статуси.
Инициативата ONE Record на IATA предоставя подходяща индустриална референция за споделяне на данни за товари и стандартизирани структури от данни. Твърдението за съответствие със стандарт обаче не доказва достъп до всяка авиокомпания, обработващ оператор, пратка или етап. Попитайте каква реализация, връзки между данните, разрешения и оперативни източници са действително налични.
Какво трябва да поддържа API за проследяване на трансгранични колети
Идентификация на превозвача и непрекъснатост при предаване
Международните пътувания на колетите може да включват оператор в началната държава, трансграничен логистичен доставчик и превозвач за доставка в държавата на местоназначение. Интеграцията трябва да ви помага да запазите непрекъснатостта, когато идентификаторът или отговорният превозвач се промени.
Проверете дали API връща последващи проследяващи номера, връзки между превозвачите или само събития за подадения от вас идентификатор. Ако тези връзки не са налични, определете дали платформата ви за доставки, складът или логистичният партньор може да ги предостави. Не обещавайте автоматична връзка от край до край, без да я тествате.
Откриването на превозвача също се нуждае от резервен вариант. Подобните модели на проследяващите номера могат да създадат неяснота, затова интеграцията ви трябва да позволява изричен избор на превозвач или друг документиран метод за разграничаване, когато се поддържа.
Нормализирани статуси с оригинални доказателства
Общият модел на статусите улеснява автоматизирането на известията при различни превозвачи. Нормализирането обаче не трябва да заличава оригиналното описание на събитието, местоположението, времевия маркер или превозвача източник.
Например общият статус за изключение може да означава проблем с адреса, забавяне, свързано с митницата, или неуспешен опит за доставка. Тези случаи изискват различни действия. Запазете оригиналното съобщение и използвайте конкретни категории за изключения само когато източникът ги поддържа.
Резултати от доставката и изпълними изключения
Екипите за колети обикновено трябва да разграничават събитията „изпратено за доставка“, „направен опит за доставка“, „готово за получаване“, „доставено“ и събитията, свързани с връщане. Попитайте какви разграничения предоставя API и дали са последователни при използваните от вас превозвачи.
Разглеждайте доказателството за доставка като отделно изискване. Статусът „доставено“ не гарантира достъп до подпис, снимка, име на получателя или документ. Потвърдете наличността, разрешенията за достъп, съхранението и ограниченията за поверителност за съответните услуги.
Митническата информация също има ограничения. Събитие за проследяване, което споменава митница, не предоставя непременно декларационен запис, обяснение на митата или надеждна прогноза за освобождаване. Изграждайте правила за ескалация въз основа на действително казаното от събитието, а не на предполагаем правен или митнически резултат.
Възможности, от които се нуждаят и двата типа API
Надеждно получаване и възстановяване на събития
При работни процеси, задвижвани от събития, оценете доставката на webhook известия, удостоверяването, повторните опити, обработката на дубликати и възстановяването след прекъсване. Това са изисквания за проверка при избора на доставчик, а не функции, които трябва да се приемат за даденост.
Проектирайте потребителя си така, че да обработва дублирани и неподредени съобщения. Съхранявайте времето на събитието отделно от времето, когато системата ви е получила актуализацията. Ако няма стабилен идентификатор на събитието, определете документиран подход за премахване на дубликати чрез наличните полета.
Попитайте дали можете да извлечете историята на събитията на пратка след пропуснати известия. Webhook известията са полезни за задействане на работа; поддържаният процес за извличане или съгласуване помага за възстановяване, когато задействането е пропуснато.
Актуалност, произход и обработка на времеви маркери
Разделяйте три часовника: кога е настъпило физическото събитие, кога източникът го е публикувал и кога приложението ви е получило информацията. Не всеки източник предоставя и трите, но разделянето на наличните времеви маркери улеснява диагностицирането на забавяния.
По същия начин различавайте липсата на ново събитие от неуспешното търсене. Непроменената история на пратката може да отразява нормална пауза между сканирания, прекъсване на източника, неразпознат идентификатор или проблем с интеграцията. Оперативният ви екип се нуждае от достатъчно диагностична информация, за да избере правилната реакция.
Запазвайте информацията за часовата зона, когато е предоставена. Ако времевият маркер от източника няма часова зона, отбележете това ограничение, вместо тихомълком да го преобразувате в привидно точно глобално време.
Достъп, разходи и оперативен контрол
Потвърдете удостоверяването, изолирането на акаунтите, съхранението на данни, процедурите за изтриване, ограниченията на заявките и условията за производствена поддръжка. Данните за проследяване може да съдържат лична информация, затова събирайте и показвайте само необходимото за работния процес.
Сравнявайте търговските условия с действителното си натоварване. Попитайте какво се таксува: регистрирана пратка, заявка, обновяване или друга единица. Изяснете как се третират невалидните номера, дублираните регистрации, повторното проследяване, историческите заявки и превишенията. Без тези определения обявената цена не е надеждна основа за сравнение на разходите.
Кога да използвате едно API и кога да комбинирате източници на данни
Изберете видимост, насочена към товарите, когато екипът ви предприема действия въз основа на етапи по въздушната товарителница, обработка на летището, пропуснати връзки или частични пристигания на товара. Самото проследяване на колети не е адекватен заместител на тези работни процеси, освен ако необходимите подробности на ниво товар не са изрично демонстрирани.
Изберете видимост, насочена към колетите, когато екипът ви се нуждае от актуализации на ниво пакет, известия за клиенти, събития от превозвача в държавата на местоназначение и управление на изключенията при доставка. Само канал с данни за въздушната товарителница не е достатъчен за проследяване на доставката пред купувача.
Комбинирайте двете, когато управлявате международен основен транспорт и доставка на отделни колети. Поддържайте отделни записи за консолидираната пратка и нейните пакети, след което ги свържете чрез референции, предоставени от собствения ви логистичен процес или проверен партньорски канал.
Например търговец може да изпрати консолидирана партида по въздух, преди тя да бъде въведена в мрежа за колети в държавата на местоназначение. Запишете пристигането на товара спрямо консолидираната пратка. Актуализирайте всеки пакет само когато има доказателство, отнасящо се до него; не превръщайте пристигането на партидата на летището в събитие „доставено“ за всяка поръчка.
Къде се вписва 17TRACK
За колетната страна на тази архитектура Tracking API на 17TRACK е подходящ за оценка на интеграция за проследяване при множество превозвачи. Използвайте официалната документация на API, за да проверите интеграцията спрямо необходимите идентификатори, полета в отговора, работен процес за известия и оперативни ограничения.
Не приемайте, че оценката на API за колети потвърждава функционалност за въздушни товари. Ако се нуждаете и от връзки между главна и вътрешна товарителница, подробности за полетните отсечки или частични движения на бройки, поискайте изрично потвърждение и примерни отговори за тези изисквания. Правилната роля на даден продукт се определя от работните процеси, които може да обоснове, а не от широтата на думата „проследяване“.
Проведете доказване на концепцията, преди да се ангажирате
Използвайте представителни пратки от действителните си превозвачи, маршрути и видове услуги. Включете както приключили пратки с известен резултат, така и текущи пратки. Успешното търсене на една лесна пратка не е достатъчно за валидиране на интеграцията.
- Определете решението, което всяко събитие трябва да подпомогне. Примери са разследване на пропусната връзка за товар, свързване с купувач заради проблем с адреса или изпращане на известие за доставка.
- Създайте представителен тестов набор. Включете предаване между превозвачи, периоди без събития, опити за доставка, връщания и разделени движения на товара, когато е уместно.
- Проверете точността на ниво обект. Потвърдете дали всяко събитие се отнася до полет, товарна пратка, част или отделен пакет.
- Сравнете с оперативния източник. Проверете липсващите етапи, времевите маркери, местоположенията, оригиналните съобщения и обработката на корекции спрямо записи на превозвача или партньора, до които имате разрешен достъп.
- Проверете възстановяването при повреди. Тествайте дублирани събития, забавени събития, невалидни идентификатори, нееднозначни превозвачи, прекъсвания на webhook известия и съгласуване.
- Потвърдете икономиката и отговорностите. Изчислете разходите според натоварването си и определете отговорността за проблеми с данните от източника, грешки в интеграцията и комуникация с клиентите.
Определете критериите за приемане, преди да преглеждате резултатите. Те трябва да обхващат необходимите полета, значението на събитията, поведението при възстановяване и приемливите забавяния на актуализациите за всеки работен процес. Известие към клиент и намеса при товар може да изискват различни прагове.
Често задавани въпроси
Може ли едно API за проследяване да обхваща въздушни товари и колети?
Потенциално, но потвърдете модела на данните и достъпа до източниците и за двете. Общата крайна точка не доказва поддръжка на количества товари, полетни отсечки, връзки между главни и вътрешни товарителници или предаване на колети. Поискайте отделни демонстрации за двата работни процеса.
Мога ли да използвам номер на въздушна товарителница, за да проследя отделен колет?
Не непременно. Въздушната товарителница може да идентифицира по-голяма товарна пратка, а не отделен пакет. Необходима е проверена връзка между тази пратка и идентификатора на колета, за да свържете историите им.
Означава ли „проследяване в реално време“ непрекъснато физическо местоположение?
Не приемайте това за даденост. Проследяването може да се основава на оперативни събития, публикувани на интервали, а не на непрекъсната телеметрия за местоположението. Попитайте какво задейства актуализациите, кои времеви маркери са достъпни и дали данните за местоположение идват от отделен сензорен източник.
По-добри ли са webhook известията от периодичното извличане?
Webhook известията са полезни за получаване на уведомления за събития без повтарящи се заявки за статус. Периодичното извличане или друг механизъм за извличане все пак може да подпомага съгласуването и възстановяването. Изберете дизайн въз основа на документираното поведение и ограниченията на доставчика, както и на допустимото от вас ниво на пропуснати или забавени актуализации.
Доказва ли събитие „доставено“, че купувачът е получил пратката?
Не във всеки контекст. Приключването на товарна операция може да описва предаване на логистична страна, докато събитията за доставка на колет зависят от процеса на превозвача. Проверете определението на събитието и получете отделно доказателство за доставка, когато работният ви процес го изисква.
Източници
- IATA — ONE Record: индустриална референция за стандартизирано споделяне на данни за товари; не е гаранция за обхвата на конкретно API.
- 17TRACK — Tracking API: официална продуктова референция за оценка на интеграция за проследяване на колети.
- 17TRACK — документация на API: техническа референция за валидиране на изискванията за реализация.


