Skip to main content
ГлавнаяБлогРуководстваОтслеживание авиагрузов и трансграничных посылок: какие возможности API вам нужны?

Отслеживание авиагрузов и трансграничных посылок: какие возможности API вам нужны?

17TRACK

Выбирайте API для отслеживания авиагрузов, если вашему приложению необходимо отслеживать авианакладные, этапы полётов, контрольные точки обработки грузов и объёмы отправлений. Выбирайте API для отслеживания трансграничных посылок, если вам нужны обновления на уровне отдельных посылок у разных перевозчиков, информация об исключениях при доставке и статус доставки на последней миле. Если ваши отправления объединяют консолидированные авиаперевозки с доставкой отдельных посылок, вам нужны оба уровня видимости и надёжный способ связать их идентификаторы.

Air Cargo vs Cross Border Parcel Tracking What API Capabilities

Для инженерных команд, операторов логистики и компаний электронной коммерции решение о покупке зависит не столько от того, какой API возвращает больше событий, сколько от того, описывают ли эти события именно ту единицу отправления, которой вы фактически управляете. Событие прибытия самолёта само по себе не может сообщить покупателю, где находится его посылка и когда она будет доставлена.

Начинайте с единицы отправления, а не со способа перевозки

Авиагрузы и трансграничные посылки не являются взаимоисключающими категориями доставки. Посылка может перемещаться между странами на самолёте, а авиакомпания обрабатывает её как часть более крупного консолидированного отправления. При выборе API важно учитывать операционный объект, который отслеживается.

Видимость авиагрузов обычно строится вокруг авианакладной и соответствующего транспортного перемещения. В зависимости от источника данные могут описывать приём, отправление, прибытие, доступность груза и передачу. Видимость посылок сосредоточена на отдельных упаковках и их прохождении через этапы забора, международной перевозки, обработки в стране назначения и доставки.

Мастер-авианакладная может представлять консолидированное перемещение, включающее несколько базовых отправлений. Домашние авианакладные, этикетки посылок и номера отслеживания перевозчиков в стране назначения могут обозначать разные уровни внутри этого перемещения. Не следует предполагать, что поставщик отслеживания сможет автоматически обнаружить или связать все эти взаимосвязи.

Область принятия решенияОтслеживание авиагрузовОтслеживание трансграничных посылок
Основной объектАвианакладная, грузовая партия или транспортный участокОтдельная посылка и идентификаторы её перевозчиков
Операционные вопросыБыл ли груз принят, перевезён самолётом, прибыл или передан?Где находится посылка, что задерживает её движение и была ли она доставлена?
Сохраняемые взаимосвязиСсылки на мастер- и домашние накладные, участки маршрута, места и разделённые перемещенияСвязи между заказом и посылкой, передача между перевозчиками, замены идентификаторов и возвраты
Типичный ответственный за действиеКоманда экспедирования, перевозок или грузовых операцийКоманда операций электронной коммерции, обслуживания клиентов или управления доставкой
Основной риск интерпретацииПринятие одного участка или частичного прибытия за завершение всей отправкиПринятие передачи или неоднозначного события доставки за получение посылки покупателем

Что должен поддерживать API для отслеживания авиагрузов

Идентификация авианакладной и взаимосвязи отправления

Уточните, какие идентификаторы принимает API и что возвращает каждый запрос. Поддержка мастер-авианакладной не означает автоматической поддержки видимости на уровне домашних накладных. Если ваши операции зависят от домашних отправлений, потребуйте демонстрацию с использованием ваших собственных ссылок и авторизованных источников данных.

Модель данных должна сохранять взаимосвязи между отправлением, его транспортными участками и любыми частями, перемещающимися отдельно. Для процессов, чувствительных к количеству, уточните, доступны ли количество мест и вес на уровне отправления, события или обоих уровней. Итоговое значение на уровне отправления не заменяет информацию о том, какое количество груза достигло конкретного аэропорта.

Видимость транспортных участков и обработки

Требуйте достаточно контекста, чтобы отличать отправление из пункта отправления от отправления после пересадки, а планируемое перемещение — от фактического. Полезные поля могут включать аэропорты отправления и назначения, сведения о рейсе, места событий, а также запланированные и фактические временные метки. Их доступность зависит от источника и должна проверяться, а не предполагаться.

Также различайте перемещение самолёта и перемещение груза. Само по себе прибытие воздушного судна не доказывает, что каждая связанная с ним отправка была загружена, выгружена, обработана или стала доступной. Уточните, относится ли событие непосредственно к отправлению или оно получено из потока данных о рейсе.

Частичные перемещения и значение контрольных точек

Грузовая отправка может перемещаться частями. Ваша система не должна отмечать всю грузовую партию как прибывшую только потому, что для её части существует событие прибытия. Проверьте, как API представляет несколько рейсов, частичные количества, изменённые маршруты и исправления.

Определения контрольных точек требуют такой же тщательной проверки. Передача экспедитору или другой логистической стороне не обязательно означает доставку конечному получателю. Попросите поставщика объяснить операционное значение событий завершения и сохраните это значение во внутренней модели статусов.

Инициатива IATA ONE Record является актуальным отраслевым ориентиром для обмена данными о грузах и стандартизированных структур данных. Однако заявление о соответствии стандартам не доказывает доступ к каждой авиакомпании, обработчику, отправлению или контрольной точке. Уточните, какая реализация, взаимосвязи данных, разрешения и операционные источники фактически доступны.

Что должен поддерживать API для отслеживания трансграничных посылок

Идентификация перевозчика и непрерывность передачи

Международные маршруты посылок могут включать оператора в стране отправления, трансграничного логистического провайдера и перевозчика доставки в стране назначения. Интеграция должна помогать сохранять непрерывность, когда меняется идентификатор или ответственный перевозчик.

Проверьте, возвращает ли API последующие номера отслеживания, взаимосвязи перевозчиков или только события для отправленного вами идентификатора. Если такие взаимосвязи недоступны, определите, может ли их предоставить ваша платформа доставки, склад или логистический партнёр. Не обещайте автоматическую сквозную связь без предварительного тестирования.

Определение перевозчика также должно иметь резервный вариант. Сходные шаблоны номеров отслеживания могут создавать неоднозначность, поэтому интеграция должна допускать явный выбор перевозчика или другой документированный способ устранения неоднозначности, если он поддерживается.

Нормализованные статусы с исходными подтверждениями

Общая модель статусов упрощает автоматизацию уведомлений у разных перевозчиков. Но нормализация не должна удалять исходное описание события, место, временную метку или исходного перевозчика.

Например, общий статус исключения может означать проблему с адресом, задержку, связанную с таможней, или неудачную попытку доставки. Для этих случаев требуются разные действия. Сохраняйте исходное сообщение и используйте конкретные категории исключений только тогда, когда их подтверждает источник.

Результаты доставки и исключения, требующие действий

Командам, работающим с посылками, обычно необходимо различать события «передано курьеру для доставки», «предпринята попытка доставки», «доступно для получения», «доставлено» и события, связанные с возвратом. Уточните, какие различия предоставляет API и насколько они единообразны у используемых вами перевозчиков.

Подтверждение доставки следует рассматривать как отдельное требование. Статус «доставлено» не гарантирует наличие подписи, фотографии, имени получателя или документа. Подтвердите доступность, разрешения доступа, срок хранения и ограничения конфиденциальности для соответствующих сервисов.

Таможенная информация также имеет ограничения. Событие отслеживания с упоминанием таможни не обязательно содержит декларацию, объяснение начисленных пошлин или надёжный прогноз выпуска. Создавайте правила эскалации на основе фактического содержания события, а не предполагаемого юридического или таможенного результата.

Возможности, необходимые обоим типам API

Надёжный приём событий и восстановление

Для процессов на основе событий оцените доставку вебхуков, аутентификацию, повторные попытки, обработку дубликатов и восстановление после сбоя. Это требования к закупке, которые необходимо проверить, а не функции, наличие которых следует предполагать у каждого поставщика.

Спроектируйте обработчик так, чтобы он учитывал дублирующиеся сообщения и сообщения, поступающие не по порядку. Храните время события отдельно от времени получения обновления вашей системой. Если стабильный идентификатор события недоступен, определите документированный подход к удалению дубликатов с использованием доступных полей.

Уточните, можно ли получить историю событий отправления после пропуска уведомлений. Вебхуки полезны для запуска рабочих процессов; поддерживаемый процесс получения или сверки данных помогает восстановиться, если такой триггер был пропущен.

Актуальность, происхождение и обработка временных меток

Разделяйте три момента времени: когда произошло физическое событие, когда источник опубликовал его и когда ваше приложение получило его. Не каждый источник предоставляет все три значения, однако раздельное хранение доступных временных меток упрощает диагностику задержек.

Также различайте отсутствие нового события и неудачный запрос. Неизменившаяся история отправления может отражать законный перерыв между сканированиями, сбой источника, нераспознанный идентификатор или проблему интеграции. Вашей операционной команде нужна достаточная диагностическая информация для выбора правильной реакции.

Сохраняйте информацию о часовом поясе, если она предоставляется. Если временная метка источника не содержит часовой пояс, зафиксируйте это ограничение, а не преобразуйте её без уведомления в кажущееся точным глобальное время.

Доступ, стоимость и операционные средства контроля

Подтвердите требования к аутентификации, изоляции аккаунтов, хранению данных, процедурам удаления, ограничениям частоты запросов и поддержке промышленной эксплуатации. Данные отслеживания могут содержать персональную информацию, поэтому собирайте и предоставляйте только то, что необходимо вашему рабочему процессу.

Сопоставляйте коммерческие условия с фактической нагрузкой. Уточните, что оплачивается: зарегистрированное отправление, запрос, обновление или другая единица. Выясните, как учитываются недействительные номера, повторная регистрация, повторное отслеживание, исторические запросы и превышение лимитов. Без этих определений рекламная цена не является надёжным сравнением стоимости.

Когда использовать один API, а когда объединять источники данных

Выбирайте видимость, ориентированную на грузы, когда ваша команда работает с контрольными точками авианакладных, обработкой в аэропорту, сбоями пересадок или частичным прибытием груза. Одного отслеживания посылок недостаточно для таких процессов, если только необходимая детализация на уровне груза не продемонстрирована явно.

Выбирайте видимость, ориентированную на посылки, когда вашей команде нужны обновления доставки на уровне упаковки, уведомления клиентов, события перевозчика в стране назначения и управление исключениями доставки. Одного потока данных авианакладной недостаточно для отслеживания доставки, ориентированного на покупателя.

Объединяйте оба подхода, когда вы управляете международной магистральной перевозкой и доставкой отдельных посылок. Храните отдельные записи о консолидации и её посылках, а затем связывайте их через ссылки, предоставленные вашим собственным логистическим процессом или проверенным потоком данных партнёра.

Например, продавец может отправить консолидированную партию по воздуху, после чего в стране назначения она передаётся в сеть доставки посылок. Зафиксируйте прибытие груза относительно консолидации. Обновляйте каждую посылку только при наличии подтверждения, относящегося к ней; не превращайте прибытие партии в аэропорт в событие доставки для каждого заказа.

Роль 17TRACK

Для работы с посылками в такой архитектуре Tracking API 17TRACK подходит для оценки интеграции отслеживания у разных перевозчиков. Используйте официальную документацию API, чтобы проверить интеграцию с необходимыми идентификаторами, полями ответов, рабочим процессом уведомлений и операционными ограничениями.

Не воспринимайте оценку API для посылок как подтверждение его функциональности для авиагрузов. Если вам также нужны связи между мастер- и домашними накладными, детализация участков полёта или перемещения отдельных частей, запросите явное подтверждение и примеры ответов для этих требований. Подходящая роль продукта определяется рабочими процессами, которые он способен подтвердить, а не широтой слова «отслеживание».

Проведите проверку концепции до принятия обязательств

Используйте репрезентативные отправления от ваших фактических перевозчиков, маршрутов и типов услуг. Включите завершённые отправления с известными результатами, а также отправления, находящиеся в пути. Успешного запроса по одному простому отправлению недостаточно для проверки интеграции.

  1. Определите решение, которое должно поддерживать каждое событие. Например, расследование пропущенной пересадки груза, связь с покупателем по поводу проблемы с адресом или отправка уведомления о доставке.
  2. Сформируйте репрезентативный набор тестов. Включите передачи между перевозчиками, периоды отсутствия событий, попытки доставки, возвраты и разделённые перемещения грузов, если это актуально.
  3. Проверьте точность на уровне объекта. Подтвердите, относится ли каждое событие к рейсу, грузовой партии, части отправления или отдельной посылке.
  4. Сравните данные с операционным источником. Проверьте пропущенные контрольные точки, временные метки, места, исходные сообщения и обработку исправлений по записям перевозчика или партнёра, к которым у вас есть разрешённый доступ.
  5. Проверьте восстановление после сбоев. Протестируйте дублирующиеся и задержанные события, недействительные идентификаторы, неоднозначных перевозчиков, сбои вебхуков и сверку данных.
  6. Проверьте экономику и ответственность. Оцените стоимость на основе вашей нагрузки и распределите ответственность за проблемы исходных данных, ошибки интеграции и коммуникацию с клиентами.

Определите критерии приёмки до анализа результатов. Они должны охватывать необходимые поля, значение событий, поведение при восстановлении и допустимые задержки обновлений для каждого рабочего процесса. Для уведомления клиента и вмешательства в грузовые операции могут требоваться разные пороговые значения.

Часто задаваемые вопросы

Может ли один API отслеживания охватывать авиагрузы и посылки?

Потенциально да, но подтвердите модель данных и доступ к источникам для обоих направлений. Общая конечная точка не доказывает поддержку объёмов грузов, участков полёта, связей с домашними накладными или передач между перевозчиками. Запросите отдельные демонстрации для этих двух рабочих процессов.

Можно ли использовать номер авианакладной для отслеживания отдельной посылки?

Не обязательно. Авианакладная может идентифицировать более крупную грузовую партию, а не отдельную упаковку. Для объединения историй нужна подтверждённая связь между этой партией и идентификатором посылки.

Означает ли «отслеживание в реальном времени» непрерывное физическое местоположение?

Не следует так считать. Отслеживание может основываться на операционных событиях, публикуемых через определённые интервалы, а не на непрерывной телеметрии местоположения. Уточните, что запускает обновления, какие временные метки предоставляются и поступают ли какие-либо данные о местоположении от отдельного источника датчиков.

Вебхуки лучше опроса?

Вебхуки удобны для получения уведомлений о событиях без повторяющихся запросов статуса. Опрос или другой механизм получения данных по-прежнему может поддерживать сверку и восстановление. Выбирайте архитектуру на основе документированного поведения и ограничений поставщика, а также вашей допустимой вероятности пропущенных или задержанных обновлений.

Доказывает ли событие доставки, что покупатель получил отправление?

Не во всех случаях. Завершение грузовой операции может означать передачу логистической стороне, тогда как события доставки посылок зависят от процесса доставки перевозчика. Проверьте определение события и получите отдельное подтверждение доставки, если этого требует ваш рабочий процесс.

Источники

  • IATA — ONE Record: отраслевой ориентир для стандартизированного обмена данными о грузах; не является гарантией покрытия конкретного API.
  • 17TRACK — Tracking API: официальный источник информации о продукте для оценки интеграции отслеживания посылок.
  • 17TRACK — документация API: технический источник для проверки требований к реализации.