Как бренды электронной коммерции по подписке могут отслеживать регулярные отправления с помощью API отслеживания
Чтобы отслеживать повторяющиеся отправления с помощью API отслеживания, создавайте запись об отправлении для каждой физической посылки, связывайте её с заказом на выполнение для соответствующего цикла подписки и регистрируйте её трек-номер, когда его предоставляет ваш склад или партнёр по выполнению заказов. Используйте обновления отслеживания API, чтобы показывать клиентам местонахождение посылки и отмечать исключения доставки для вашей команды. Храните ID подписки как ссылку между циклами, а не как идентификатор посылки.

Отслеживайте посылку, а не подписку
Подписка сообщает, что клиент должен получать с течением времени. Заказ на выполнение сообщает, что необходимо отправить в рамках одного цикла. Трек-номер сообщает о конкретной посылке. Раздельное хранение этих записей не позволит задержке отправления в одном цикле отображаться на странице отслеживания следующего цикла.
Например, предположим, что майская коробка по подписке разделена на две посылки, а июньская коробка отправляется, пока одна из майских посылок всё ещё находится в пути. Клиент должен видеть две посылки в рамках майского заказа и отдельную посылку в рамках июньского заказа. Позднее обновление по майской посылке должно изменять только данные майской посылки. Если вы отправляете замену, создайте новую запись об отправлении и свяжите её с исходной, чтобы служба поддержки видела причину существования обеих записей.
- Подписка: Храните ID подписки, чтобы служба поддержки могла найти историю отправлений клиента.
- Цикл и заказ: Записывайте идентификатор цикла или запланированную дату выполнения, ID заказа и все необходимые ID выполнения для сопоставления посылок с правильным заказом. Не определяйте цикл по дате поступления события отслеживания.
- Отправление: Присваивайте каждой посылке внутренний ID отправления. Храните перевозчика и трек-номер, соответствующую ссылку на выполнение и любой ID регистрации отслеживания, возвращённый провайдером. Не показывайте отменённые этикетки и заменённые трек-номера в активном представлении клиента, но сохраняйте историю для службы поддержки.
На странице заказа показывайте ход доставки на уровне посылок наряду с общей информацией о заказе. Если одна посылка доставлена, а другая находится в пути, укажите это. Показывайте весь заказ как доставленный только после прибытия всех посылок, необходимых для его выполнения, с учётом отменённых отправлений и замен.
Подключите выполнение заказов к API отслеживания
- Регистрируйте отправление по событию выполнения. Запускайте регистрацию, когда система выполнения, склад или сторонний логистический партнёр передаёт перевозчика и трек-номер. Платёж за продление подписки поступает слишком рано: заказ всё ещё может ожидать отправки, а трек-номер может отсутствовать.
- Сохраняйте отправление до вызова API. Сохраняйте внутреннюю запись об отправлении и помещайте запрос на регистрацию в очередь. Если одно и то же сообщение о выполнении поступает дважды, используйте существующую запись, а не создавайте ещё одну посылку. Если вызов API завершается по тайм-ауту, проверьте, был ли успешным исходный запрос, прежде чем повторять его, если провайдер предоставляет такую возможность.
- Сопоставляйте обновления с зарегистрированной посылкой. Используйте идентификатор регистрации провайдера, если он возвращается в обновлениях. В противном случае выполняйте сопоставление по идентификаторам, указанным в документации провайдера, и проверяйте результат по своим записям об отправлениях. Если обновление может относиться более чем к одной записи, отправьте его на проверку, а не применяйте к последнему заказу.
- Разделяйте создание этикетки и перемещение перевозчиком. Трек-номер может существовать до того, как перевозчик зафиксирует получение посылки. Используйте сообщение вроде «Подготовка к передаче перевозчику», если у вас есть только этикетка. Используйте статус «В пути» только при наличии подтверждающей информации от перевозчика.
API отслеживания 17TRACK — один из вариантов для такой настройки. Его документация для разработчиков является справочным источником для регистрации трек-номеров и получения обновлений отслеживания. Используйте эти обновления для поддержки записи о посылке в своей системе; правила назначения цикла, завершения заказа и уведомления клиентов храните в приложении электронной коммерции. Перед запуском протестируйте систему на посылках из фактических маршрутов перевозчиков и от реальных партнёров по выполнению заказов, а не полагайтесь только на список перевозчиков.
Сделайте обновления безопасными для повторной обработки
Если провайдер поддерживает вебхуки, используйте их для получения обновлений без постоянного опроса каждой посылки. Вебхук — это HTTP-запрос, который провайдер отправляет вашему приложению. Соблюдайте требования провайдера к проверке, надёжно сохраняйте принятые данные и подтверждайте запросы в соответствии с описанными им правилами ответов. Выполняйте более медленные операции, такие как обновление представлений заказов или отправка электронных писем, за пределами обработчика запроса.
Постройте процесс обработки так, чтобы повторное обновление не имело дополнительного эффекта. Если провайдер предоставляет стабильные ID событий, используйте их для распознавания повторов. Если он отправляет снимки состояния отслеживания, а не отдельные события, сравнивайте входящее состояние и историю сканирования с уже имеющимися данными перед выполнением действий. Дедуплицируйте сообщения клиентам отдельно: уведомление о доставке, которое уже было отправлено, не должно отправляться повторно только потому, что одни и те же данные об отправлении были обработаны дважды.
Храните отдельно время выполнения сканирования и время получения его вашим приложением. Поздно поступившее сканирование посылки в пути может быть добавлено в историю посылки, не заменяя более новый статус доставки. Однако не предполагайте, что каждое корректное изменение продвигает посылку вперёд. Исправление перевозчика или обновление о возврате отправителю может потребовать изменения отображаемой информации. Если новые данные конфликтуют с сохранённым состоянием и невозможно определить, какие из них верны, поместите отправление в очередь на проверку.
Периодически проверяйте открытые отправления, которым может потребоваться внимание: регистрации, всё ещё ожидающие завершения, посылки без первого сканирования после ожидаемой передачи и отправления, по которым давно не было обновлений отслеживания. Если API поддерживает поиск или обновление, используйте их выборочно в пределах ограничений провайдера. Перед эскалацией проверяйте закономерности по перевозчикам и складам. Если обновления одновременно прекращаются для множества несвязанных отправлений, исследуйте интеграцию, прежде чем открывать отдельные дела по доставке.
Превратите данные отслеживания в полезные сообщения для клиентов
Клиентам редко нужно электронное письмо после каждого сканирования. Начните с сообщений, связанных с тем, что им необходимо знать или сделать: посылка вошла в сеть перевозчика, попытка доставки требует действий или перевозчик сообщает о доставке. Показывайте ссылку на заказ и соответствующую коробку или цикл, чтобы подписчики понимали, о каком отправлении идёт речь. Для разделённого заказа указывайте посылку и ясно сообщайте, находится ли остальная часть заказа ещё в пути.
- Этикетка создана, сканирования нет: Сверьте ожидаемую передачу с записями склада. Если срок передачи истёк, попросите службу выполнения подтвердить, покинула ли посылка объект, прежде чем сообщать клиенту о задержке в пути.
- Отслеживание не обновляется: Используйте пороговые значения, учитывающие маршрут и тип услуги, а не один таймер для всех посылок. Для международных отправлений изучите последнее событие перевозчика, прежде чем решать, связаться ли с клиентом или передать вопрос на следующий уровень.
- Неудачная попытка или требуется получение: Сообщите клиенту, какие действия необходимы, если перевозчик предоставляет чёткие инструкции. Если событие сформулировано неоднозначно, направьте дело в службу поддержки, а не угадывайте дату повторной доставки или место получения.
- Отмечено как доставленное, но не получено: Сохраните статус, указанный перевозчиком, и откройте отдельное обращение в службу поддержки. Ваш процесс поддержки должен различать сообщение клиента и исправление перевозчика.
Предоставьте сотрудникам службы поддержки единое представление о цикле, заказе, истории посылок и уже отправленных сообщениях. Для каждого исключения назначайте ответственного и следующий шаг. Служба выполнения может расследовать отсутствие передачи, логистика — связаться с перевозчиком по поводу исключения, а служба поддержки — общаться с клиентом. Статус отслеживания описывает посылку; он не определяет, полагается ли замена или возврат средств.
Проверьте пересечение циклов перед запуском
Начните с одного партнёра по выполнению заказов и набора отправлений, отражающего его фактический способ отправки заказов. Включите цикл с несколькими посылками, аннулированную этикетку, замену и более старое отправление, которое всё ещё открыто при отправке следующего цикла. Затем намеренно повторно воспроизведите дублирующий вебхук и доставьте старое событие после нового. Проверьте запись о посылке, страницу заказа клиента, представление для службы поддержки и журнал уведомлений. Тест, проверяющий только успешный ответ API, может пропустить самую дорогостоящую ошибку: обновление неправильного заказа или отправку сообщения не тому клиенту.
Отслеживайте сбои регистрации, долю успешно зарегистрированных подходящих посылок, первые сканирования, выполненные позже ожидаемого срока, и несопоставленные обновления. Если вы отслеживаете задержку обновлений, различайте время между событием перевозчика и его получением и время, которое вашей собственной системе требуется для обработки. Это поможет решить, нужно ли исследовать канал данных перевозчика, конечную точку вебхука или очередь внутри приложения.
Расширяйте охват на другие маршруты, когда сможете ответить на три вопроса по любой посылке: к какому циклу она относится? Что в последний раз сообщил перевозчик? Кто должен действовать, если обновление отсутствует или неверно? Если какой-либо ответ неясен, исправьте сопоставление записей или процесс обработки исключений, прежде чем добавлять новые правила уведомлений.
Часто задаваемые вопросы
Может ли API отслеживания сообщить клиентам, когда будет отправлена их следующая коробка по подписке?
Используйте расписание подписки и систему выполнения заказов для определения следующей запланированной даты отправки. API отслеживания предназначен для конкретной посылки после появления информации для отслеживания. Запланированная дата отправки, расчётная дата доставки перевозчика и подтверждённая доставка — разные факты, которые следует обозначать отдельно.
Что делать, если склад заменил трек-номер после отправки электронного письма?
Пометьте старую этикетку как заменённую и свяжите новый трек-номер с тем же заказом. Если в электронном письме указана ссылка на страницу отслеживания на уровне заказа, обновите эту страницу, чтобы клиент мог найти активную посылку без исходной ссылки перевозчика. Отправьте исправление, если изменение затрагивает информацию, необходимую клиенту для действий.
Что делать, если партнёр по выполнению заказов отправляет трек-номера без кодов перевозчиков?
Попросите партнёра использовать единое поле перевозчика или предоставить сопоставление кодов его служб доставки. Если ваш API предлагает определение перевозчика, проверьте его работу с этикетками партнёра, прежде чем полагаться на него. Направляйте неоднозначные совпадения на проверку, а не выбирайте перевозчика только по трек-номеру.
Нужны ли записи отслеживания для приостановленных или пропущенных подписок?
Для цикла, который никогда не отправляется, запись о посылке не требуется. Если предыдущее отправление всё ещё открыто, продолжайте его отслеживать, даже если подписка приостановлена, пропущена или отменена. Состояние подписки управляет будущим выполнением; оно не сообщает, что произошло с посылкой, которая уже покинула склад.
Источники
- API отслеживания 17TRACK — обзор продукта для интеграции отслеживания посылок в бизнес-системы.
- Документация API отслеживания 17TRACK — справочник по регистрации трек-номеров и получению данных отслеживания.
- Документация вебхуков Stripe — справочник по общим практикам работы с вебхуками, таким как обработка дублирующихся событий и отказ от предположений о порядке доставки. Соблюдайте собственные правила провайдера отслеживания для проверки и подтверждения запросов.


