Skip to main content
ГоловнаБлогПосібникиЯк обрати API для відстеження відправлень у Великій Британії: охоплення перевізників та інтеграція

Як обрати API для відстеження відправлень у Великій Британії: охоплення перевізників та інтеграція

17TRACK

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

Як обрати API для відстеження відправлень у Великій Британії: охоплення перевізників

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

Починайте з асортименту ваших відправлень, а не з кількості перевізників у постачальника

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

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

Створіть таблицю вимог із такими полями:

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

До переліку обов’язкового охоплення можуть входити Royal Mail, Parcelforce Worldwide, Evri або DPD — залежно від ваших договорів. Це приклади для перевірки, а не твердження про те, що будь-який конкретний API підтримує всі служби, які пропонують ці перевізники.

Що на практиці має означати охоплення перевізників

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

Перевіряйте охоплення на рівні служби та маршруту

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

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

Окремо тестуйте міжнародні передачі

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

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

Перевіряйте визначення перевізника та неоднозначні номери

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

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

Вибір між прямими інтеграціями перевізників і мультикур’єрським API

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

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

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

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

Оцініть модель подій до створення клієнтських робочих процесів

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

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

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

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

Проєктуйте систему для збоїв webhook, а не лише для успішних запитів

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

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

До реалізації дайте відповіді на такі запитання:

  • Як ваша кінцева точка перевіряє, що запит надійшов від постачальника?
  • Що відбувається, коли ваша кінцева точка перевищує час очікування або повертає помилку?
  • Чи можуть доставки дублюватися або надходити не по порядку?
  • Чи можна отримати або повторно відтворити пропущені оновлення?
  • Як змінюються облікові дані без переривання роботи служби?
  • Що відбувається, коли під час відновлення досягнуто обмежень швидкості?

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

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

Проведіть перевірку концепції з чіткими критеріями проходження

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

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

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

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

Порівняйте загальну вартість, обробку даних і підтримку

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

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

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

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

Зробіть запуск оборотним

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

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

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

FAQ

Чи потрібен бізнесу у Великій Британії API відстеження, розміщений у Великій Британії?

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

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

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

Чи завжди webhook кращі за опитування?

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

Що робити, коли сторінка перевізника та API не збігаються?

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

Sources

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

  • 17TRACK Tracking API — офіційний опис продукту API, розглянутого в цьому посібнику.
  • 17TRACK API documentation — офіційний технічний довідник для перевірки вимог інтеграції до реалізації.