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

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

17TRACK

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

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

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

Почніть із доставок, які ваша компанія фактично здійснює

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

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

Складіть матрицю перевізників на основі нещодавніх замовлень. Залежно від вашої компанії, вона може містити послуги, пов’язані з Colissimo, Chronopost або Mondial Relay. Це приклади, які слід перевірити за власними записами про відправлення, а не твердження про те, що певний API підтримує всі послуги, які вони пропонують.

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

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

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

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

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

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

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

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

Напрям оцінюванняЩо потрібно перевіритиЧому це важливо
Ідентифікація перевізникаРозпізнавання ваших реальних номерів і можливість виправляти неоднозначні збігиПравдоподібний, але неправильний збіг може призвести до оманливих результатів.
Охоплення послугПодії для конкретних внутрішніх і міжнародних послуг, які ви купуєтеСамої назви перевізника недостатньо для підтвердження охоплення на рівні послуги.
Події в пунктах видачіОкреме опрацювання прибуття, доступності для отримання та отримання клієнтомПосилка, що очікує отримання, не повинна спричиняти повідомлення про завершену доставку.
Міжнародні передачіБезперервність між перевізником у місці відправлення та мережею доставки в місці призначенняКлієнтам потрібна інформація після переходу посилки між мережами.
Деталізація подійОригінальні описи, нормалізовані статуси, місця та часові позначки, якщо доступніКомандам підтримки потрібен контекст, що виходить за межі загального статусу.

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

Перевірте, чи призводять події французької доставки до правильних дій

Пункти видачі та поштомати

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

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

Спроби доставки та винятки

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

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

Мова та час

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

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

Оцініть доставку оновлень і поведінку під час відновлення

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

Попросіть постачальників пояснити ці етапи та будь-які задокументовані зобов’язання щодо обслуговування. Уникайте порівняння заяв про «відстеження в реальному часі» без спільного визначення цього терміна.

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

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

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

Перевірте захист даних перед передаванням реальної інформації про клієнтів

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

Офіційний текст GDPR містить правове посилання, зокрема на статті 5, 28 і 32 та розділ V. Розглядайте запевнення постачальника як відправну точку для перевірки, а не як заміну перевірці запропонованої схеми обробки.

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

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

Порівняйте тарифну одиницю з життєвим циклом вашого відправлення

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

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

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

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

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

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

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

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

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

FAQ

Чи може один API для відстеження обробляти всі доставки до Франції?

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

Чи купує API для відстеження етикетки або організовує доставку?

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

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

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

Чи можемо ми обіцяти дату доставки на основі подій відстеження?

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

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

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

Джерела

  • 17TRACK Tracking API — офіційна сторінка продукту для оцінювання варіанта API, розглянутого в цьому посібнику.
  • Документація 17TRACK API — офіційний технічний довідник для перевірки вимог до інтеграції та підтримуваної поведінки перед реалізацією.
  • Регламент (ЄС) 2016/679, Загальний регламент про захист даних — основне правове джерело щодо принципів захисту даних, обов’язків обробника, вимог безпеки та механізмів міжнародного передавання, розглянутих вище.