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, который проходит проверки ваших самых объёмных и наиболее рискованных рабочих процессов при приемлемых затратах и объёме обслуживания. Если ни один вариант не проходит проверку, ограничьте запуск подтверждёнными услугами или сохраните отдельную интеграцию для проблемного перевозчика. Контролируемый частичный запуск предпочтительнее представления ненадёжной информации о доставке как полного покрытия.

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

Может ли один API отслеживания обрабатывать все доставки во Францию?

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

Покупает ли API отслеживания этикетки или организует доставку?

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

Следует ли использовать вебхуки вместо опроса?

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

Можем ли мы обещать дату доставки на основе событий отслеживания?

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

Что делать, если API и сайт перевозчика показывают разные данные?

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

Источники

  • 17TRACK Tracking API — официальная страница продукта для оценки варианта API, рассматриваемого в этом руководстве.
  • Документация 17TRACK API — официальный технический справочник для проверки требований к интеграции и поддерживаемого поведения до внедрения.
  • Регламент (ЕС) 2016/679, Общий регламент по защите данных — основной правовой источник по принципам защиты данных, обязанностям обработчиков, требованиям безопасности и правилам международной передачи, рассмотренным выше.