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

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

17TRACK

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

Как поставщики услуг после покупки могут управлять отслеживанием для нескольких брендов

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

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

Что должно означать «один API» в модели с несколькими брендами

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

17TRACK API — Упростите глобальное отслеживание посылок с обновлениями от более чем 3500 перевозчиков. Подробнее →

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

17RETURNS Returns & Exchanges Solution — Сократите расходы на поддержку и сохраните больше дохода с помощью автоматизированных возвратов и обменов, поддерживаемых интеллектуальными инструментами удержания. Попробовать бесплатно →

Эта модель создаёт три границы, которые не следует смешивать:

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

Явное разделение этих границ позволяет поставщику централизовать техническую работу, сохраняя контроль на уровне бренда.

Начните с модели данных с учётом тенантов

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

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

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

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

Нормализуйте данные перевозчиков перед предоставлением брендам

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

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

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

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

Проектируйте контракт API с учётом операционных сценариев

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

В контракте следует документировать:

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

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

Отделяйте общий слой данных от интерфейса бренда

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

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

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

Создавайте мониторинг платформы, а не только отправлений

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

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

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

Используйте контролируемый процесс подключения для каждого бренда

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

  1. Определите тенант: создайте запись бренда, учётные данные, роли, окружения и требования к хранению данных.
  2. Сопоставьте идентификаторы: задокументируйте связь между заказами, записями выполнения заказов, номерами отслеживания и ссылками, видимыми клиентам.
  3. Протестируйте входные данные перевозчиков: используйте репрезентативные отправления для основных направлений и типов услуг бренда.
  4. Проверьте нормализованные статусы: сравните результаты API с доступной информацией отслеживания перевозчика и желаемой клиентом терминологией.
  5. Протестируйте сценарии сбоев: включите недействительные номера, задержанные сканирования, дублирующиеся запросы, неизвестных перевозчиков, возвраты и частичные отправления.
  6. Проведите ограниченный запуск: отслеживайте реальный трафик для контролируемой группы до включения всей клиентской базы.
  7. Документируйте владение: зафиксируйте, кто утверждает формулировки статусов, обрабатывает эскалации поддержки и рассматривает изменения платформы.

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

Распространённые ошибки, которых следует избегать

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

Практическая система принятия решений

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

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

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

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

Может ли один API обслуживать несколько брендов без совместного использования их данных?

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

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

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

Что следует протестировать до промышленного запуска?

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

Устраняет ли один API необходимость управлять различиями между перевозчиками?

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

Как поставщику следует оценивать API отслеживания?

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

Источники