Skip to main content
ГлавнаяБлогРуководстваМожет ли Tracking API работать без транспортных этикеток? Отслеживание заказов 3Pl и Marketplace?

Может ли Tracking API работать без транспортных этикеток? Отслеживание заказов 3Pl и Marketplace?

17TRACK

Да. API отслеживания может работать без того, чтобы ваша компания создавала транспортные этикетки, при условии, что перевозчик или партнер по доставке создал отправление, доступное для отслеживания, и вы можете получить действительный номер отслеживания или другой идентификатор, поддерживаемый API. Это распространено, когда сторонний логистический оператор (3PL) или маркетплейс обрабатывает выполнение заказов. Разница заключается между тем, что вы не покупаете этикетку самостоятельно, и полным отсутствием идентификатора отправления: первый вариант обычно вполне работоспособен, а второй может оставить API без объекта для отслеживания.

Может ли API отслеживания работать без транспортных этикеток: отслеживание 3PL

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

Что требуется API отслеживания, если вы не создаете этикетку

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

  • ID заказа: Идентифицирует покупку в вашем магазине, аккаунте маркетплейса или системе управления заказами. Он может охватывать несколько товаров и несколько отправлений.
  • ID выполнения заказа или посылки: Идентифицирует действие по выполнению заказа или посылку в системе 3PL либо маркетплейса. Его формат и значение зависят от этой системы.
  • Номер отслеживания перевозчика: Идентифицирует отправление для целей отслеживания при условии, что перевозчик и сервис отслеживания принимают его.

Ваш внутренний ID заказа помогает найти нужный заказ клиента. Он автоматически не становится номером отслеживания перевозчика. Обычная схема интеграции заключается в получении номера отслеживания от 3PL или маркетплейса, регистрации или запросе этого номера через API отслеживания и сохранении полученной информации об отправлении для соответствующего заказа или посылки.

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

Отслеживание заказов, отправленных через 3PL

Когда 3PL упаковывает заказ, покупает этикетку и передает посылку перевозчику, ваша компания может вообще не увидеть саму этикетку. Однако вам по-прежнему нужны данные об отправлении, полученные в результате этого процесса. Узнайте у 3PL, какая система или канал передачи данных предоставляет номера отслеживания, информацию о перевозчике, идентификаторы посылок и ссылку на заказ, которую вы указали при запросе выполнения заказа.

Рабочий процесс с 3PL обычно выглядит так:

  1. Передайте заказ и стабильную ссылку на него в 3PL через существующий процесс выполнения заказов.
  2. Получите подтверждение выполнения, содержащее номер отслеживания на уровне посылки и, если доступно, информацию о перевозчике.
  3. Свяжите эту посылку с правильным заказом клиента и товарами.
  4. Передайте поддерживаемый идентификатор отправления в API отслеживания или используйте предусмотренный API процесс поиска.
  5. Сохраняйте обновления отслеживания для посылки, а затем представляйте представление на уровне заказа операционной команде или клиенту.

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

Заранее согласуйте с 3PL порядок передачи исправлений. Этикетки могут быть аннулированы, посылки — переупакованы, а первоначальный номер отслеживания — заменен. Ваша интеграция должна уметь связать замену с тем же заказом, не отображая оба номера как активные отправления в течение неограниченного времени.

Отслеживание заказов маркетплейса, когда маркетплейс контролирует доставку

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

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

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

Храните состояние заказа на маркетплейсе и состояние отправления в API отслеживания раздельно. Маркетплейс может описать заказ как отправленный после подтверждения выполнения, тогда как отслеживание перевозчика все еще может не показывать сканирование о приеме. Эти записи отвечают на разные вопросы и могут обновляться в разное время.

Когда отслеживание без этикетки не решит проблему

«Мы не создавали этикетку» не является препятствием. Проблемами могут быть следующие ситуации:

  • Отправление не создано: До того как выполнение заказа сформирует пригодный для использования идентификатор, может не существовать отправления перевозчика, которое можно запросить. Одного подтверждения заказа недостаточно, чтобы считать посылку находящейся в пути.
  • Идентификатор недоступен вам: 3PL или маркетплейс может хранить номер, не предоставляя его через авторизованный вами процесс. Решите эту проблему доступа к данным в источнике.
  • Идентификатор не поддерживается: Ссылочный номер, код, используемый только маркетплейсом, или неподдерживаемый формат перевозчика могут не работать с выбранным API. Проверьте допустимые входные данные в документации и на тестовом отправлении.
  • По посылке еще нет нового сканирования: Номер может существовать до того, как перевозчик зарегистрирует событие приема. Рассматривайте пустой или неизменившийся результат как состояние, требующее проверки, а не как автоматическое доказательство недействительности номера.
  • Отслеживание ограничено или неполно: Перевозчик, сервис или процесс отправки может не предоставлять события, необходимые для вашего клиентского сценария. Проверьте фактическое качество событий на типичных отправлениях.

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

Как оценить API для этого рабочего процесса

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

Перед выбором или внедрением поставщика создайте небольшой набор тестов. Включите заказ 3PL с номером перевозчика, заказ маркетплейса, для которого ваш аккаунт предоставляет номер, заказ с несколькими посылками, номер, созданный до первого сканирования, и отправление с более поздним событием доставки. Если замены или международная передача отправлений являются обычной практикой, включите и их. Тест должен отвечать на операционные вопросы, а не только показывать, возвращает ли запрос успешный HTTP-ответ:

  • Можете ли вы передавать фактически получаемые идентификаторы без их ручного переписывания?
  • Можете ли вы надежно привязать каждую запись отслеживания к правильному заказу и посылке?
  • Достаточны ли описания событий, временные метки и информация о перевозчике для сообщений клиентам и рабочих процессов поддержки?
  • Как ваша система будет обрабатывать дублирующиеся обновления, отсутствующие события, изменения номеров и неудачные запросы?
  • Соответствует ли предполагаемое использование данных маркетплейса и клиентов условиям доступа, применимым к этим данным?

Для самой интеграции сохраняйте и исходную запись источника, и запись API отслеживания. Храните ссылку на заказ, ссылку на посылку, переданный номер отслеживания, информацию о перевозчике, если она доступна, и время получения каждого обновления. Это упрощает расследование несоответствий и не позволяет представить событие API как полную историю выполнения заказа. Если API предлагает выбор между проверкой по расписанию и получением обновлений через поддерживаемый механизм доставки, выбирайте на основе документированного поведения и вашей потребности в своевременных обновлениях; ни один из этих подходов не устраняет необходимость обработки ошибок.

Практическое решение

Используйте API отслеживания без создания этикеток, когда другая сторона отправляет посылку и предоставляет вам поддерживаемый идентификатор отправления, который вы уполномочены использовать. Сначала обеспечьте надежный канал передачи данных о посылках от 3PL или маркетплейса. Затем проверьте идентификаторы и события отслеживания в API и вашей логике сопоставления заказов. Если у вас есть только ID заказа или статус маркетплейса, устраните этот пробел в исходных данных до инвестирования в интеграцию отслеживания перевозчика.

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

Могу ли я отслеживать заказ, используя только номер заказа в моем магазине?

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

Нужно ли мне разрешение 3PL на использование его номеров отслеживания?

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

Почему API не показывает движения после того, как 3PL отправил номер?

Номер мог быть создан до первого зарегистрированного сканирования перевозчика. Проверьте правильность идентификатора и перевозчика, не была ли заменена первоначальная этикетка и не появляются ли события при более позднем запросе. Не приравнивайте «сканирования еще нет» к «не отправлено», не проверив запись о выполнении заказа.

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

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

Источники

  • API отслеживания 17TRACK — информация о продукте для оценки интеграции отслеживания отправлений.
  • Документация API 17TRACK — технический справочник для проверки допустимых входных данных и поведения интеграции.