Skip to main content
ГоловнаБлогПосібникиВідстеження авіавантажів у порівнянні з транскордонними посилками: які можливості API вам потрібні?

Відстеження авіавантажів у порівнянні з транскордонними посилками: які можливості API вам потрібні?

17TRACK

Обирайте API для відстеження авіавантажів, якщо ваш застосунок має відстежувати авіанакладні, етапи польотів, контрольні точки обробки вантажу та кількість відправлень. Обирайте API для відстеження транскордонних посилок, якщо вам потрібні оновлення на рівні окремих пакунків у різних перевізників, інформація про винятки під час доставки та статус доставки на останній милі. Якщо ваші відправлення поєднують консолідовані авіавантажі з доставкою окремих посилок, вам потрібні обидва рівні видимості та надійний спосіб пов’язати їхні ідентифікатори.

Відстеження авіавантажів і транскордонних посилок: які можливості API

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

Починайте з одиниці відправлення, а не зі способу транспортування

Авіавантажі та транскордонні посилки не є взаємовиключними категоріями доставки. Посилка може подорожувати міжнародним рейсом, тоді як авіакомпанія обробляє її як частину більшого консолідованого відправлення. Вибираючи API, слід розрізняти операційний об’єкт, який відстежується.

Видимість авіавантажу зазвичай зосереджена на авіанакладній і пов’язаному з нею переміщенні. Залежно від джерела дані можуть описувати приймання, відправлення, прибуття, доступність вантажу та передачу. Видимість посилки зосереджена на окремих пакунках і їхньому проходженні через забір, міжнародне транспортування, обробку в пункті призначення та доставку.

Головна авіанакладна може представляти консолідоване переміщення, що містить кілька базових відправлень. Внутрішні авіанакладні, етикетки посилок і номери відстеження перевізників у пункті призначення можуть ідентифікувати різні рівні в межах цього переміщення. Не припускайте, що постачальник відстеження зможе автоматично виявити або поєднати всі ці взаємозв’язки.

Сфера прийняття рішенняВідстеження авіавантажуВідстеження транскордонної посилки
Основний об’єктАвіанакладна, вантаж або транспортна ділянка маршрутуОкремий пакунок та ідентифікатори його перевізників
Операційні питанняЧи прийнято вантаж, чи його відправлено, чи прибув він і чи було його передано?Де перебуває пакунок, що перешкоджає його доставці та чи доставлено його?
Взаємозв’язки, які потрібно зберігатиПосилання на головні та внутрішні накладні, ділянки маршруту, місця та розділені переміщенняЗв’язки між замовленням і пакунком, передачі між перевізниками, замінені ідентифікатори та повернення
Типовий відповідальний підрозділКоманда експедирування, транспортування або вантажних операційКоманда ecommerce-операцій, клієнтської підтримки або управління доставкою
Основний ризик інтерпретаціїВважати одну ділянку маршруту або часткове прибуття завершенням усього відправленняВважати передачу або неоднозначну подію доставки отриманням пакунка покупцем

Що має підтримувати API для відстеження авіавантажів

Ідентифікація авіанакладної та взаємозв’язки відправлення

З’ясуйте, які ідентифікатори приймає API і що повертає кожен запит. Підтримка головної авіанакладної не означає автоматичної підтримки видимості на рівні внутрішніх накладних. Якщо ваші операції залежать від внутрішніх відправлень, вимагайте демонстрацію з використанням власних посилань і авторизованих джерел даних.

Модель даних має зберігати взаємозв’язки між відправленням, його транспортними ділянками та будь-якими частинами, що переміщуються окремо. Для процесів, чутливих до кількості, з’ясуйте, чи доступні дані про кількість місць і вагу на рівні відправлення, події або на обох рівнях. Загальна кількість для всього відправлення не замінює інформацію про те, скільки вантажу прибуло до конкретного аеропорту.

Видимість транспортних ділянок і обробки

Вимагайте достатнього контексту, щоб відрізняти відправлення з пункту походження від відправлення після пересадки, а заплановане переміщення — від фактичного. Корисними полями можуть бути аеропорти відправлення та призначення, дані про рейс, місця подій і заплановані та фактичні часові позначки. Їхня доступність залежить від джерела, тому її потрібно перевіряти, а не припускати.

Також розрізняйте рух літака та рух вантажу. Сам факт прибуття літака не доводить, що кожне пов’язане відправлення було завантажено, розвантажено, оброблено або зроблено доступним. З’ясуйте, чи є подія специфічною для відправлення, чи її отримано з даних про рейс.

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

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

Визначення контрольних точок також потребують ретельної перевірки. Передача експедитору або іншій логістичній стороні не обов’язково означає доставку кінцевому одержувачу. Попросіть постачальника пояснити операційне значення подій завершення та збережіть це значення у своїй внутрішній моделі статусів.

Ініціатива IATA ONE Record є актуальним галузевим орієнтиром для обміну даними про вантажі та стандартизованих структур даних. Однак твердження про відповідність стандартам не доводить доступ до кожної авіакомпанії, обробника, відправлення чи контрольної точки. З’ясуйте, які саме реалізація, взаємозв’язки даних, дозволи та операційні джерела фактично доступні.

Що має підтримувати API для відстеження транскордонних посилок

Ідентифікація перевізника та безперервність передачі

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

Перевірте, чи повертає API подальші номери відстеження, взаємозв’язки між перевізниками або лише події для наданого вами ідентифікатора. Якщо такі взаємозв’язки недоступні, визначте, чи може їх надати ваша платформа доставки, склад або логістичний партнер. Не обіцяйте автоматичний наскрізний зв’язок без його перевірки.

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

Нормалізовані статуси з оригінальними доказами

Спільна модель статусів спрощує автоматизацію сповіщень між перевізниками. Але нормалізація не повинна стирати оригінальний опис події, місце, часову позначку або перевізника-джерело.

Наприклад, загальний статус винятку може означати проблему з адресою, затримку, пов’язану з митницею, або невдалу спробу доставки. Для кожного випадку потрібні різні дії. Зберігайте оригінальне повідомлення та використовуйте конкретні категорії винятків лише тоді, коли їх підтримує джерело.

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

Командам, які працюють із посилками, зазвичай потрібно розрізняти події «передано на доставку», «здійснено спробу доставки», «доступно для отримання», «доставлено» та події, пов’язані з поверненням. З’ясуйте, які відмінності розкриває API і чи є вони узгодженими між використовуваними вами перевізниками.

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

Митна інформація також має обмеження. Подія відстеження зі згадкою про митницю не обов’язково містить запис декларації, пояснення щодо мит або надійний прогноз випуску. Створюйте правила ескалації на основі фактичного змісту події, а не припущеного юридичного чи митного результату.

Можливості, необхідні обом типам API

Надійне отримання подій і відновлення

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

Спроєктуйте обробник так, щоб він працював із дубльованими повідомленнями та повідомленнями, що надійшли не в порядку. Зберігайте час події окремо від часу отримання оновлення системою. Якщо стабільний ідентифікатор події недоступний, визначте задокументований підхід до усунення дублікатів із використанням доступних полів.

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

Актуальність, походження та обробка часових позначок

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

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

Зберігайте інформацію про часовий пояс, якщо її надано. Якщо часовій позначці джерела бракує часового поясу, зафіксуйте це обмеження, а не перетворюйте її мовчки на нібито точний глобальний час.

Доступ, вартість та операційні засоби контролю

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

Порівнюйте комерційні умови з фактичним робочим навантаженням. З’ясуйте, що саме оплачується: зареєстроване відправлення, запит, оновлення або інша одиниця. Уточніть, як обробляються недійсні номери, дубльовані реєстрації, повторне відстеження, історичні запити та перевищення лімітів. Без цих визначень заявлена ціна не є надійною основою для порівняння вартості.

Коли використовувати один API, а коли поєднувати джерела даних

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

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

Поєднуйте обидва підходи, коли керуєте міжнародним магістральним перевезенням і доставкою окремих посилок. Зберігайте окремі записи для консолідації та її пакунків, а потім пов’язуйте їх за допомогою посилань, наданих вашим власним логістичним процесом або перевіреним партнерським потоком даних.

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

Місце 17TRACK у цій схемі

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

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

Проведіть перевірку концепції перед прийняттям рішення

Використовуйте репрезентативні відправлення від ваших фактичних перевізників, маршрутів і типів послуг. Додайте завершені відправлення з відомими результатами, а також активні відправлення. Успішного запиту для одного простого відправлення недостатньо для перевірки інтеграції.

  1. Визначте рішення, яке має підтримувати кожна подія. Приклади: розслідування пропущеної пересадки вантажу, зв’язок із покупцем через проблему з адресою або надсилання сповіщення про доставку.
  2. Створіть репрезентативний набір тестів. Додайте передачі між перевізниками, періоди без оновлень, спроби доставки, повернення та розділені переміщення вантажу, якщо це актуально.
  3. Перевірте точність на рівні об’єкта. Підтвердьте, чи стосується кожна подія рейсу, вантажу, його частини або окремого пакунка.
  4. Порівняйте з операційним джерелом. Перевірте пропущені контрольні точки, часові позначки, місця, оригінальні повідомлення та обробку виправлень за записами перевізника або партнера, до яких ви маєте дозвіл доступу.
  5. Перевірте відновлення після збоїв. Протестуйте дубльовані події, затримані події, недійсні ідентифікатори, неоднозначних перевізників, збої вебхуків і узгодження даних.
  6. Перевірте економіку та відповідальність. Оцініть вартість на основі робочого навантаження та призначте відповідальних за проблеми даних джерела, збої інтеграції й комунікацію з клієнтами.

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

FAQ

Чи може один API для відстеження охоплювати авіавантажі та посилки?

Потенційно так, але підтвердьте модель даних і доступ до джерел для обох напрямів. Спільна кінцева точка не доводить підтримку кількості вантажу, ділянок рейсу, взаємозв’язків внутрішніх накладних або передачі посилок. Вимагайте окремі демонстрації для двох процесів.

Чи можна використовувати номер авіанакладної для відстеження окремої посилки?

Не обов’язково. Авіанакладна може ідентифікувати більший вантаж, а не окремий пакунок. Для поєднання історій потрібен перевірений зв’язок між цим вантажем та ідентифікатором посилки.

Чи означає «відстеження в реальному часі» безперервне фізичне місцезнаходження?

Не припускайте цього. Відстеження може ґрунтуватися на операційних подіях, що публікуються через певні проміжки часу, а не на безперервній телеметрії місцезнаходження. З’ясуйте, що запускає оновлення, які часові позначки доступні та чи надходять дані про місцезнаходження з окремого джерела датчиків.

Чи вебхуки кращі за опитування?

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

Чи доводить подія доставки, що покупець отримав відправлення?

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

Джерела

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