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

Для команды, занимающейся операциями возвратов или продуктом, полезный вопрос заключается не просто в том, может ли API отображать статус отслеживания. Важно понять, способна ли интеграция надежно определить нужное отправление возврата, интерпретировать полученные события и предотвратить ситуацию, когда обновление отслеживания вызывает неправильное сообщение клиенту или действие по возврату средств.
Место отслеживания в процессе возврата
Возврат начинается как бизнес-запись: клиент просит вернуть товар, а продавец решает, что разрешить. Запись отслеживания описывает другое: перемещение посылки. Связывание этих двух записей позволяет платформе возвратов отвечать на такие вопросы, как: передал ли клиент посылку перевозчику, движется ли она к месту возврата и было ли зарегистрировано событие доставки.
Эта связь должна быть явной. Заказ может содержать несколько товаров, клиент может оформить несколько возвратов по одному заказу, а один возврат может включать несколько посылок. Исходный номер отслеживания отправления клиенту нельзя принимать за номер отслеживания возврата. Практическая модель данных хранит отдельные идентификаторы заказа, разрешения на возврат, посылки возврата, перевозчика и записи отслеживания, а также связи между ними.
У отслеживания также есть четкая граница. Событие доставки, зарегистрированное перевозчиком, может указывать на то, что посылка достигла адреса или объекта. Но оно не подтверждает, что склад получил ожидаемый товар, что товар прошел проверку или что возврат средств должен быть выполнен. Для этих решений нужны собственные доказательства и правила.
Процесс интеграции: от разрешения до получения
1. Создайте запись о возврате до начала отслеживания посылки
Сначала платформа возвратов фиксирует запрос, соответствующие товары, разрешенный адрес назначения и допустимый вариант решения. Если для возврата используется этикетка, выданная продавцом, платформа может связать идентификатор отслеживания этикетки с посылкой возврата. Если клиент самостоятельно организует отправку, платформе может потребоваться способ получить и проверить перевозчика и номер отслеживания до начала мониторинга.
Это первая точка, в которой качество данных влияет на видимость. Номер отслеживания без надежной связи посылки с возвратом может привести к совершенно точному обновлению от перевозчика, относящемуся не к тому возврату. Командам также следует решить, как обрабатывать исправленные номера отслеживания, замененные этикетки и клиентов, которые дважды отправляют один и тот же идентификатор.
2. Зарегистрируйте отправление или найдите его
Платформа отправляет выбранному поставщику отслеживания необходимую информацию, чтобы создать или получить запись об отправлении. Точные поля и последовательность запроса зависят от документации поставщика. Как минимум, реализация должна надежно связывать ссылку на отправление у поставщика с собственной записью посылки возврата. Если требуется идентификация перевозчика, платформа должна заранее выяснить, как обрабатываются неоднозначные или неподдерживаемые данные о перевозчике, а не считать, что одного номера отслеживания всегда достаточно.
Сохраняйте ответ поставщика, ошибки интеграции и дату начала мониторинга платформой. Принятый запрос не обязательно означает, что перевозчик отсканировал посылку. До первого сканирования отображаемый для клиента статус может указывать, что отслеживание ожидается, а не что возврат находится в пути.
3. Получайте обновления, не теряя исходное событие
В зависимости от API обновления могут поступать через вебхук, запрашиваться путем периодического опроса или передаваться другим описанным в документации способом. Интеграция должна сохранять исходную информацию о событии от поставщика вместе с упрощенным статусом, отображаемым на платформе возвратов. Полезные поля могут включать описание события, время события, местоположение при наличии, ссылку на перевозчика и время получения обновления платформой.
Эти два момента времени отвечают на разные вопросы. Временная метка события показывает, когда, согласно сообщению, произошла активность; временная метка получения показывает, когда платформа возвратов узнала о ней. В противном случае задержки, повторные доставки и сообщения, поступившие не по порядку, могут создать впечатление, что возврат движется назад. Если поставщик предоставляет идентификаторы событий, используйте их для устранения дубликатов. Если нет, определите осторожный метод дедупликации и протестируйте его на реальных примерах интеграции.
4. Преобразуйте события отслеживания в статусы возврата
Описания событий перевозчика не являются политикой возврата. Обычно платформа возвратов преобразует их в небольшой набор операционных статусов, например ожидается передача перевозчику, в пути, доставка зарегистрирована или требуется проверка. При таком преобразовании следует учитывать неизвестные события, а не молча считать каждое нераспознанное обновление признаком продвижения.
Например, первого сканирования перевозчиком может быть достаточно, чтобы сообщить клиенту, что его посылка, вероятно, уже в пути. Но этого может быть недостаточно для обещания даты возврата средств. Событие доставки может помочь складу определить приоритет сопоставления посылки, однако правило возврата средств может по-прежнему требовать физического получения и проверки. Команды должны закрепить эти различия в рабочем процессе до того, как свяжут статусы с автоматическими действиями.
5. Замкните цикл с помощью складских доказательств
После прибытия посылки склад или объект обработки возвратов может отсканировать внутренний штрихкод, сопоставить посылку с разрешением на возврат, проверить ее содержимое и записать результат. Это события управления возвратами, а не события отслеживания перевозчика. Если обе системы подключены, платформа может показать более полезную последовательность: перемещение отправления, доставка, зарегистрированная перевозчиком, получение посылки объектом и завершение обработки.
Такая последовательность также помогает разрешать исключения. Если отслеживание сообщает о доставке, но запись о получении на складе отсутствует, оператор может проверить адрес назначения, событие перевозчика, очередь приемки объекта и идентификатор посылки, прежде чем делать заявление для клиента. Если склад получил посылку без пригодной истории отслеживания, физическое получение все равно можно зарегистрировать; отсутствие данных отслеживания не должно стирать независимые складские доказательства.
Что API отслеживания может и не может сообщить платформе
API отслеживания отправлений может сделать доступными для другого приложения данные о перемещении, зарегистрированном перевозчиком, с учетом задокументированного покрытия поставщика, доступности событий и особенностей интеграции. Сам по себе API не может проверить содержимое возврата или решить, выполнены ли условия политики продавца. До первого сканирования перевозчиком у него также может не быть обновлений для передачи.
Это различие важно при проектировании автоматизации. Статусы следует рассматривать как сигналы с определенным назначением, а не как взаимозаменяемые доказательства. Событие передачи перевозчику может вызвать уведомление о продвижении. Событие доставки может создать задачу для склада. Подтвержденное получение на складе может перевести возврат к проверке. Решение о возврате средств или обмене должно соответствовать фактическим правилам продавца и требуемым этими правилами доказательствам.
Текст для клиента должен отражать ту же границу. Формулировка «Перевозчик сообщает, что ваш возврат доставлен» точнее, чем «Мы одобрили ваш возврат средств», если проверка еще не проводилась. Аналогично, фраза «Мы ожидаем первое обновление от перевозчика» информативнее, чем необъяснимо пустая страница отслеживания.
Проверки проектирования, предотвращающие ошибки отслеживания возвратов
- Сопоставляйте на уровне посылки. Тестируйте разделенные возвраты, несколько посылок по одному разрешению, замененные этикетки и повторные возвраты по одному заказу. Для каждой посылки должна существовать однозначная связь с собственной записью отслеживания.
- Определите приоритет статусов. Решите, что произойдет, если более старое событие «в пути» поступит после события доставки. Сохраняйте историю событий, не понижая автоматически отображаемый статус возврата.
- Отделяйте ошибки поставщика от отсутствия сообщений перевозчика. Ошибка аутентификации, отклоненный запрос или сбой обработки вебхука являются проблемой интеграции. Отсутствие сканирования — другое условие, о котором следует сообщать иначе.
- Планируйте дубликаты и повторные попытки. Обновление о доставке может поступить повторно. Сделайте получение событий безопасным для повторной обработки и не отправляйте одно и то же уведомление клиенту и не создавайте одну и ту же задачу дважды.
- Защищайте данные клиента и отправления. Ограничьте доступ к учетным данным отслеживания, храните только необходимые рабочему процессу данные и до запуска изучите задокументированные требования поставщика к аутентификации и безопасности.
- Сохраняйте ручной путь. Для некоторых возвратов данные отслеживания будут неполными, поступят с задержкой или не будут соответствовать действительности. Операторам нужен способ проверить и исправить запись о возврате, не выдумывая события перевозчика.
Эти проверки наиболее полезны при тестировании на конкретных сценариях, а не на одной успешно доставленной посылке. Небольшой набор тестов должен включать отсутствие первого сканирования, неправильный номер отслеживания, дублированное событие, событие не по порядку, сообщение о доставке без получения на складе и получение на складе без соответствующего сообщения о доставке. Для каждого случая следует заранее определить ожидаемое сообщение клиенту и действие оператора.
Выбор API и определение распределения обязанностей
Начните с направлений возвратов и перевозчиков, которыми компания действительно пользуется. Затем по актуальной документации поставщика проверьте, как выполняется регистрация отправлений, какие идентификаторы обязательны, как доставляются обновления, какие данные событий доступны и как обрабатываются ошибки и повторные попытки. Подтвердите нужных перевозчиков и маршруты возврата напрямую, а не делайте выводы из общего заявления о покрытии перевозчиков. Протестируйте работу на типичных отправлениях, прежде чем использовать сопоставленные статусы для общения с клиентами или автоматизации.
17TRACK публикует обзор Tracking API и документацию API; его страница продукта 17RETURNS посвящена управлению возвратами. Это подходящие отправные точки для команды, оценивающей видимость отслеживания совместно с процессом возвратов. Наличие обеих продуктовых областей не следует считать доказательством доступности конкретной интеграции, перевозчика, события или автоматического правила возврата средств. Проверьте точный рабочий процесс в актуальной документации и, если необходимо, у поставщика.
При закупке или создании proof of concept попросите команду, отвечающую за политику возвратов и складские операции, вместе с инженерами проверить сопоставление статусов. Инженеры могут подтвердить, предоставляет ли API пригодные для использования события; операционная команда — подтверждают ли эти события предлагаемое действие. Успешная интеграция помогает сотрудникам и клиентам отслеживать посылку, сохраняя разрешение, получение, проверку и решение отдельными этапами.
Часто задаваемые вопросы
Нужен ли для возврата номер отслеживания, отличный от номера исходного заказа?
Платформа должна хранить отдельные записи об исходном и возвратном отправлениях. Возврат обычно перемещается как отдельное отправление, поэтому его идентификатор отслеживания должен быть связан с посылкой возврата, а не считаться идентификатором исходного отправления заказа. Точный набор доступных идентификаторов зависит от способа отправки возврата.
Может ли API отслеживания подтвердить необходимость возврата средств?
Нет. Одно событие отслеживания не подтверждает, что возвращенный товар соответствует условиям возврата средств продавца. Платформа может использовать события перевозчика как входные данные рабочего процесса, но право на возврат средств также может зависеть от разрешения, физического получения, проверки и политики продавца.
Что делать, если отслеживание показывает доставку, но склад не может найти посылку?
Храните отдельно событие доставки, сообщенное перевозчиком, и запись о получении на складе. Проверьте указанный адрес назначения и сведения о событии, затем изучите процесс приемки и сопоставления на объекте. Не преобразуйте молча доставку перевозчиком в подтвержденное получение на складе.
Обязательны ли вебхуки для отслеживания возвратных отправлений?
Не обязательно. Метод обновления зависит от выбранного поставщика и описанных им вариантов. Если вебхуки доступны, предусмотрите аутентификацию, повторные попытки, дублированные доставки и сбои обработки. Если используется опрос, выберите интервал и правило остановки, соответствующие рабочему процессу возврата и требованиям поставщика.
Когда клиент должен увидеть первое обновление отслеживания?
Это зависит от того, когда перевозчик сообщит о событии и когда интеграция его получит. Создание этикетки или регистрация отправления могут произойти до сканирования перевозчиком. Четко отображайте это различие, чтобы клиенты не воспринимали ожидание первого обновления как подтвержденное перемещение.


