Skip to main content
ГоловнаБлогПосібникиЯк вибрати API для відстеження відправлень для доставки в Європі

Як вибрати API для відстеження відправлень для доставки в Європі

17TRACK

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

Як обрати API для відстеження відправлень у європейських доставках

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

Визначте, що саме API має допомогти робити вашій команді

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

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

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

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

Оцінюйте європейські маршрути доставки, а не лише охоплення країн

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

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

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

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

Перевірте значення даних відстеження

Зберігайте стандартизовані статуси та оригінальні події

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

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

Розрізняйте час події та час оновлення

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

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

Обережно працюйте з оцінками та перекладами

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

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

Тестуйте інтеграцію під час збоїв, а не лише успішної роботи

Успішна відповідь API доводить, що спрацював один запит. Вона не доводить, що ваша програма залишатиметься синхронізованою під час повторних спроб, затриманих подій або збою.

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

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

  • Реєстрація: Перевірте дубльовані подання, недійсні ідентифікатори та відправлення, зареєстровані до першого сканування перевізником.
  • Порядок подій: Перевірте, чи не може із затримкою надійшла стара подія помилково замінити новіший стан відправлення.
  • Відновлення: Переривайте роботу приймача та підтвердьте, як після цього можна відновити оновлення.
  • Безпека: Перегляньте ротацію облікових даних, контроль доступу, безпеку передавання та будь-який задокументований механізм перевірки вебхуків.
  • Життєвий цикл: Визначте, коли відстеження припиняється, як довго доступна історія та чи можна за потреби знову відстежувати відправлення.
  • Керування змінами: Запитайте, як повідомляється про версії API, критичні зміни та інциденти, пов’язані з перевізниками.

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

Зробіть вимоги щодо конфіденційності частиною закупівель

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

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

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

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

Порівнюйте загальну вартість за однакового навантаження

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

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

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

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

Місце 17TRACK у процесі оцінювання

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

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

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

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

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

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

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

Часті запитання

Чи означає більший список перевізників краще європейське відстеження?

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

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

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

Чи потрібні мені вебхуки, опитування або обидва варіанти?

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

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

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

Що має заблокувати запуск у робочому середовищі?

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

Джерела