Skip to main content
ГлавнаяБлогРуководстваКак 3Pl и фулфилмент-провайдеры используют API отслеживания отправлений в аккаунтах клиентов

Как 3Pl и фулфилмент-провайдеры используют API отслеживания отправлений в аккаунтах клиентов

17TRACK

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

Как провайдеры 3PL и фулфилмента используют API отслеживания отправлений

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

Базовый рабочий процесс: зарегистрировать, получить, направить, принять меры

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

  1. Зарегистрировать отправление. Когда создается этикетка или посылка передается перевозчику, провайдер сохраняет номер отслеживания, информацию о перевозчике, если она доступна, идентификатор учетной записи клиента, ссылку на заказ и любой внутренний идентификатор отправления. Он передает данные об отслеживании в свою интеграцию отслеживания с использованием задокументированного метода провайдера.
  2. Получать обновления. Интеграция получает новые данные об отслеживании через методы, которые фактически поддерживаются API. В зависимости от сервиса и конфигурации это может включать запросы текущего статуса, уведомления об изменениях или оба варианта.
  3. Направлять и интерпретировать. Провайдер сопоставляет возвращенную запись об отслеживании со своим внутренним идентификатором отправления и учетной записью клиента. Он сохраняет сообщение перевозчика и сопоставляет его с ограниченным набором операционных состояний, не отбрасывая полезные подробности.
  4. Принимать меры. Правильный клиент может просматривать ход доставки, служба поддержки — отвечать на запросы, а операционная команда — расследовать исключения. Обновления для покупателей должны использовать одобренные этим клиентом каналы и правила обмена сообщениями.

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

Отделяйте владельца клиента от идентификатора отслеживания

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

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

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

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

Преобразуйте сообщения перевозчика в понятный статус для клиента

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

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

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

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

Проектируйте обработку исключений с учетом того, кто может решить проблему

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

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

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

Что проверять при выборе или внедрении API

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

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

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

Небольшой пилот показывает больше, чем список функций

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

Отслеживайте каждое отправление от записи на складе до регистрации отслеживания и представления для клиента. Задавайте конкретные вопросы: правильная ли учетная запись владеет записью? Может ли другая учетная запись увидеть ее через панель, поиск, экспорт или уведомление? Правильно ли старое сканирование размещено во временной шкале событий? Что произойдет, если сервис отслеживания временно отклонит запрос или не вернет новой информации? Сможет ли специалист поддержки по-прежнему определить исходную формулировку перевозчика?

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

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

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

Может ли 3PL использовать одну интеграцию API отслеживания для нескольких клиентов?

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

Должны ли учетные записи клиентов использовать одну и ту же панель отслеживания?

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

Что делать, если номер отслеживания не сразу возвращает обновления?

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

Достаточно ли API отслеживания для отправки брендированных обновлений о доставке?

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

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

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

Источники