Когда продавец подключает сервис аналитики или систему управления магазином, данные не появляются в ней сами по себе. Нужно организовать обмен информацией с маркетплейсом.
Для этого используется API — программный интерфейс, через который разные системы передают друг другу данные и команды.
Проще говоря, API позволяет не заходить вручную в личный кабинет ради каждой выгрузки. Внешняя программа запрашивает нужную информацию и получает её в установленном формате.
На Wildberries через WB API можно подключать сторонние сервисы и собственные программы продавца. Доступ выдаётся с помощью токена или OAuth, а набор доступных данных зависит от выбранных разрешений.
Какие задачи решает интеграция
API используется не только для аналитики. Возможности зависят от площадки и конкретного метода подключения, но обычно интеграция нужна для нескольких типов работы.
Первый — получение данных. Система загружает сведения о продажах, заказах, остатках, товарах, рекламе или финансовых операциях.
Второй — передача информации. Например, обновление остатков, цен или данных о товарах.
Третий — выполнение действий. Внешний сервис может создавать или изменять объекты в личном кабинете, если площадка поддерживает такую возможность и продавец выдал нужные права.
Для обычного пользователя всё это выглядит как единый кабинет. Но внутри постоянно работают запросы между сервисом и маркетплейсом.
Доступ на чтение и изменение
При подключении важно разделять два уровня доступа.
Первый позволяет только получать информацию. Сервис видит данные магазина, но не может изменить цену, карточку или рекламные настройки.
Второй уровень даёт право на действия. Такой доступ требуется, если система должна не только анализировать, но и вносить изменения.
Начинать безопаснее с чтения. Продавец проверяет, правильно ли сопоставляются товары, совпадают ли показатели и насколько полезны рекомендации.
Право на изменение подключается позже и только для конкретных задач. Например, сервису для финансовой аналитики не обязательно разрешать редактировать карточки.
Чем меньше лишних разрешений, тем проще контролировать интеграцию.
Почему важно сопоставить артикулы
Одна из самых частых проблем возникает не в API, а в справочнике товаров.
У одного товара может быть внутренний артикул компании, отдельный код на Wildberries и другой идентификатор на Ozon. Если они сопоставлены неверно, система объединит данные разных позиций.
Тогда продажи одного товара сравниваются с себестоимостью другого, а остатки попадают не в ту строку.
Перед запуском нужно создать таблицу соответствий. У каждого товара должен быть единый внутренний идентификатор, к которому привязаны коды на маркетплейсах.
Особое внимание требуется размерам, цветам и комплектам. Они могут считаться отдельными вариантами и иметь собственные остатки.
Данные обновляются не одновременно
Пользователь ожидает, что после продажи или изменения цены информация сразу появится во внешней системе. На практике разные категории данных обновляются с разной скоростью.
Поэтому в интерфейсе важно показывать время последней синхронизации. Менеджер должен понимать, видит он данные на текущий момент или состояние несколько часов назад.
Нельзя сравнивать показатели, полученные за разные периоды. Например, продажи уже обновились, а рекламные расходы ещё нет. Временный расчёт покажет слишком хорошую эффективность кампании.
Надёжная система либо ждёт загрузки всех нужных данных, либо предупреждает пользователя о неполной информации.
Что происходит при ошибке
Интеграция должна быть готова к временным сбоям. Маркетплейс может не ответить, изменить формат данных или ограничить количество запросов.
Если система просто пропустит загрузку, пользователь получит неполный отчёт и может не заметить проблему.
Поэтому нужны:
- журнал обмена;
- повторные попытки загрузки;
- уведомление об ошибке;
- проверка полноты данных;
- защита от повторного выполнения команды;
- возможность восстановить предыдущее состояние.
Особенно важна защита операций на изменение. Если запрос отправился дважды, система не должна два раза выполнить одно и то же действие.
Как проверить внешний сервис
Перед подключением стоит выяснить, какие данные нужны сервису и зачем. Необходимо понимать, какие права запрашиваются и можно ли ограничить их.
Также полезно узнать:
- как часто обновляются данные;
- хранится ли история синхронизации;
- что происходит при ошибке;
- можно ли отключить доступ;
- кто имеет доступ внутри команды;
- фиксируются ли действия пользователей;
- как сервис сопоставляет товары.
Не следует передавать токены в переписке или хранить их в общих таблицах. Доступ должен находиться только там, где он используется.
При увольнении сотрудника или отказе от сервиса старые подключения нужно отключать.
Зачем объединять несколько API
Если продавец работает на Wildberries и Ozon, интеграция помогает собрать данные в одном месте. Не приходится отдельно выгружать отчёты и сводить их вручную.
Однако показатели двух площадок нельзя просто складывать. У них могут различаться структура отчётов, статусы заказов и состав расходов.
Внешняя система должна привести данные к общей логике, но сохранить возможность открыть исходную информацию по каждому маркетплейсу.
В Berkuz интеграция используется для работы AI-специалистов с данными магазина. Они анализируют отдельные направления и готовят рекомендации для продавца.
API в такой схеме остаётся техническим каналом. Пользователю важен результат: актуальные данные, понятные уведомления и меньше ручной работы с отчётами.