API вместо передачи пароля
ИИ агенты в личный кабинет селлера обычно не входят так, как это делает человек. Сервис обращается к официальному API площадки по отдельному ключу или токену. Wildberries позволяет создать токен с выбранными категориями доступа. Для Ozon Seller API используются идентификатор клиента и API-ключ, а для отдельных блоков могут действовать свои способы авторизации.
Такой подход разделяет основной аккаунт и интеграцию. Продавец не сообщает пароль от кабинета и может в любой момент отозвать конкретный ключ. Права определяют, какие данные доступны агенту и может ли он выполнять действия. Если сервису разрешено только чтение, он подготовит аналитику, но не изменит цену или настройку кампании.
Путь данных до отчёта
После авторизации AI агент в кабинетах маркетплейсов запускает запросы по расписанию. Он получает товары, заказы, продажи, остатки, рекламу и другие разрешённые сущности. Сырые ответы API сохраняются или преобразуются в рабочую структуру. Затем система связывает записи по артикулам, датам, кампаниям и складам.
На этом этапе особенно важна нормализация. Wildberries и Ozon используют разные идентификаторы, статусы и названия показателей. Один товар продавца нужно связать с карточкой на каждой площадке через внутренний SKU или таблицу соответствия. Периоды, возвраты и рекламную атрибуцию также приводят к единой методике. Без этого общая аналитика будет выглядеть убедительно, но сравнивать несопоставимые значения.
Рабочий поток включает несколько этапов:
- запрос данных через разрешённые методы API;
- проверку ответа и времени последнего обновления;
- сопоставление товаров и справочников;
- расчёт производных показателей;
- поиск отклонений и связей;
- подготовку рекомендации с исходными цифрами.
Почему данные могут отличаться
Цифры в AI-сервисе и личном кабинете иногда расходятся. Чаще всего причина связана не с ошибкой агента, а с разным временем обновления или методикой. Кабинет может показывать текущий день, а отчёт — завершённые сутки. Заказы могут учитываться по дате оформления, продажи — по дате выкупа, а возвраты приходить позднее. Рекламные заказы зависят от принятого окна атрибуции.
Поэтому перед использованием рекомендаций проводят контрольную сверку. Берут несколько артикулов, один период и одинаковый статус операции. В хорошем сервисе видно, когда данные обновились и как рассчитана метрика. Если расхождение сохраняется, сначала проверяют настройки периода и права ключа, а затем обращаются в поддержку.
От данных к действию
Получение информации — только техническая основа. Полезный ИИ агент для кабинета ВБ или Ozon должен учитывать правила бизнеса: себестоимость, минимальную маржу, срок поставки, страховой запас и рекламные цели. Эти сведения не всегда есть у маркетплейса, поэтому продавец добавляет их отдельно.
В Беркуз Селлер кабинеты подключаются по официальным API-ключам, а профильные агенты работают с общей моделью магазина. Совместный анализ объединяет сигналы по SEO, рекламе, финансам, конкурентам, отзывам и запасам. Продавец получает объяснимый список действий, но сохраняет контроль над правами и режимом выполнения.
Частота обновления и задержки
Не все показатели обновляются одинаково быстро. Остатки и заказы могут приходить с одной периодичностью, финансовые начисления и возвраты — с другой. Ограничения API также влияют на частоту запросов. Поэтому в отчёте важно видеть время последней синхронизации. Агент не должен сравнивать свежий остаток со старой рекламной статистикой без предупреждения.
Для оперативных сигналов выбирают данные, которые доступны достаточно быстро. Финансовые выводы разумно перепроверять после закрытия периода, когда учтены поздние операции. Такое разделение снижает число ложных тревог и помогает использовать каждую метрику в подходящем для неё ритме.