Skip to main content
ГлавнаяБлогРуководстваКак поставщики услуг после покупки используют данные отслеживания, чтобы обслуживать несколько брендов с помощью одного API

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

17TRACK

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

Как поставщики услуг после покупки используют данные отслеживания для обслуживания клиентов

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

Что на самом деле делает общее API

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

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

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

Проследите одно отправление от регистрации до действия клиента

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

  1. Зарегистрируйте отправление. Получите идентификатор бренда, ссылку на заказ, номер отслеживания и любые другие разрешённые сведения, необходимые для сопоставления. Проверяйте входные данные до запроса информации об отслеживании. По возможности храните учётные данные и контактную информацию клиентов отдельно от общих записей о событиях отслеживания.
  2. Собирайте и сохраняйте исходное обновление. Получайте информацию об отслеживании через внешнее API, используя документированные методы. Сохраняйте исходный статус, описание события, отметку времени и местоположение, если они предоставлены. Не заменяйте исходное собыие только упрощённой меткой: командам поддержки может понадобиться исходная формулировка для расследования исключения.
  3. Нормализуйте данные осторожно. Сопоставляйте исходные события с небольшим внутренним набором состояний, например «в пути», «передано курьеру для доставки», «доставлено» или «исключение». Сохраняйте исходное событие вместе с этим сопоставлением. Общее состояние удобно для автоматизации, но оно может скрывать различия, важные для клиента или сотрудника поддержки.
  4. Применяйте правила бренда. Один продавец может хотеть отправлять электронное письмо о передаче отправления курьеру, а другой — только обновлять страницу заказа. Определяйте право на действие с учётом конфигурации бренда, предпочтений клиента по коммуникациям, актуальности события и истории уже отправленных сообщений.
  5. Фиксируйте результат. Сохраняйте, какое событие вызвало какое действие, какая политика бренда была применена и успешно ли сообщение доставлено в конечный канал. Это создаёт журнал для устранения проблем с дублирующими уведомлениями и жалобами клиентов.

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

Проектные решения, определяющие масштабируемость

Явно указывайте владельца-арендатора

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

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

Рассматривайте события отслеживания как обновления, а не гарантированные команды

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

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

Планируйте опрос, обратные вызовы и сбои

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

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

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

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

  • Приём отправлений: Какие идентификаторы и сведения о перевозчике обязательны? Как сообщается о недействительных или дублирующих отправках? Может ли приложение связать собственный номер заказа или арендатора с запросом либо эта связь должна полностью храниться в его базе данных?
  • Доставка обновлений: Обновления для соответствующего тарифного плана извлекаются, передаются или используются оба варианта? Каковы документированные ограничения запросов, требования к повторам, методы аутентификации и ответы об ошибках? Проверяйте это по актуальной документации, а не предполагайте, что функция, описанная в общих чертах, доступна в каждой конфигурации.
  • Качество событий: Какие исходные поля возвращаются и как следует интерпретировать отметки времени, названия перевозчиков, местоположения и события, связанные с доставкой? Тестируйте реальные примеры отправлений продавцов, которых вы подключаете.
  • Операции с арендаторами: Может ли поставщик разделять доступ, учёт использования и расследования поддержки по клиентам в собственной системе? Если требуется разделение внешних учётных записей, подтвердите, поддерживается ли оно и каким образом, прежде чем утверждать архитектуру.
  • Обработка данных: Какие сведения о клиентах или отправлениях необходимо передавать внешнему поставщику? Обсудите с ответственными за эти данные сторонами требования к хранению, удалению, безопасности и договорам. Руководства по безопасности API, включая OWASP API Security Project, дают полезную основу для анализа рисков авторизации и доступа.

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

Что поставщик должен контролировать самостоятельно

Данные отслеживания могут помогать формировать опыт после покупки, но не должны диктовать его целиком. Поставщик должен управлять сопоставлением отправления с продавцом, правилами контакта с клиентом и формулировками, используемыми при неопределённом обновлении. Если событие сообщает лишь о прибытии посылки на объект, брендированное сообщение не должно обещать дату доставки. Если отслеживание прекращает обновляться, система должна отличать отсутствие новой информации от доказательства утраты посылки.

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

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

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

Означает ли одно API отслеживания, что все бренды используют одну и ту же страницу отслеживания?

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

Может ли номер отслеживания сам по себе определить нужный бренд?

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

Должен ли поставщик отправлять уведомление о каждом новом событии отслеживания?

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

Что нужно протестировать перед добавлением нового продавца?

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

Источники