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

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


