API-токены Wildberries и Ozon: как создать и выбрать разрешения

Сначала определите, что приложение будет делать

Для подключения Wildberries нужен API-токен. Для Ozon Seller API нужны два значения: Client ID и API key. Это разные реквизиты, их нельзя заменять друг другом. Рекламное подключение Ozon Performance настраивается отдельно.

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

Инструкция относится к проверенным API-вызовам локального приложения Excellen на 1 октября 2026 года. Это не универсальный набор для любой интеграции. У таблиц и облачных скриптов может быть другая схема подключения. Ключи не вводятся на этом сайте и не нужны для чтения статей.

Как создать токен Wildberries для локального приложения

1. Откройте кабинет WB Партнёры и раздел «Интеграции по API».
2. Нажмите «Создать токен». Для локальной установки на своём компьютере выберите «Для интеграции вручную» и персональный токен, если этот вариант соответствует вашей схеме использования.
3. Назовите подключение понятно, например «Excellen на рабочем ПК». Выберите категории под нужные функции из списка ниже.
4. Для аналитики выберите «Только чтение». «Чтение и запись» включайте, только если намерены выполнять изменения через приложение.
5. Сохраните токен в надёжном месте и введите его в настройках локального приложения. Проверьте срок действия в карточке токена.

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

Источник: инструкция Wildberries по созданию токена.

Какие категории WB использует Excellen

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

• Контент: загрузка списка карточек и характеристик товаров.
• Статистика: заказы и продажи, которые приложение получает из статистических методов.
• Аналитика: воронка продаж и данные об остатках на складах WB.
• Цены и скидки: текущие цены и календарь акций. Отправка новой цены требует записи.
• Маркетплейс: склады продавца и остатки FBS. Изменение остатков требует записи; при работе только с FBW эта категория нужна не для всех сценариев.
• Продвижение: кампании и рекламная статистика WB. Изменение ставок требует записи.
• Финансы: детализации отчётов реализации для финансового раздела.

Не пропустите «Финансы». Наличие «Статистики» само по себе не даёт доступ к новому финансовому методу /api/finance/v1/sales-reports/detailed, который использует приложение. WB указывает для него категорию «Финансы». См. документацию финансовых отчётов WB.

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

Доступ к пользователям, чатам, отзывам и прочим неиспользуемым категориям для перечисленных задач не требуется. Не добавляйте его «на всякий случай».

Как создать ключ Ozon Seller API

1. В Ozon Seller откройте Настройки → Seller API.
2. Найдите Client ID вашего кабинета и нажмите «Сгенерировать ключ».
3. Укажите название подключения. Выберите роли с учётом задач, а не все пункты списка.
4. Сохраните API key и введите в Excellen вместе с Client ID из того же кабинета.
5. Проверьте каталог, нужную схему FBO/FBS, финансы и акции по отдельности.

Admin и Admin read only — не одно и то же. В описаниях ролей Ozon Admin разрешает работу со всеми методами Seller API, а Admin read only ограничивает доступ информационными методами. Наличие роли с названием read only рядом с Admin не превращает весь ключ в ключ только для чтения.

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

Путь создания ключа и использование Admin read only для читающей интеграции также описаны в официальной инструкции Яндекс Товаров. Это подтверждение сценария чтения, а не готовая матрица прав для всех функций Excellen.

Какие роли Ozon проверять и какие не включать автоматически

В окне «Доступные роли и методы» раскройте нужную роль и проверьте конкретные методы. Названия ниже помогают ориентироваться, но не заменяют эту проверку.

• Product read-only: кандидат для чтения каталога и товарных данных. Для отправки цен или остатков прав только на чтение недостаточно.
• Warehouse, Posting FBS read-only, Posting FBO: проверяйте для складов и отправлений по используемым схемам. Не считайте Posting FBO автоматически ролью только на чтение по одному названию.
• Report: приложение использует создание отчёта по отправлениям и получение результата. Нужные методы /v1/report/postings/create и /v1/report/info должны быть доступны. Не исключайте роль только потому, что итоговая задача выглядит как просмотр отчёта.
• Actions read-only: проверяйте для просмотра акций. Для добавления и исключения товаров из акций нужны соответствующие методы записи, обычно в роли Actions.
• Product: проверяйте состав этой роли, если нужны методы изменения цены /v1/product/import/prices и остатков /v2/products/stocks. Не выдавайте её для одного просмотра каталога.
• Pricing strategy и Pricing strategy read-only: вызовов управления ценовыми стратегиями в проверенной версии Excellen не найдено. Отправка обычной цены товара сама по себе не повод включать эти роли.

Кроме перечисленного, приложение запрашивает начисления, аналитику и остатки. Перед удалением широких ролей нужно проверить доступ и к этим методам. Один набор Product + Posting + Actions не следует объявлять достаточным для финансового раздела без проверки.

Граница проверки: API-вызовы Excellen сверены по коду; проверка нового ограниченного ключа на реальном кабинете не проводилась. Полную актуальную матрицу «метод → роль» Ozon при подготовке материала получить не удалось. Поэтому здесь нет обещания, что одна короткая комбинация ролей гарантированно включает все функции. Состав проверяйте в кабинете и документации Seller API, а не выдавайте Admin при первой ошибке.

Реклама Ozon подключается отдельно

Для рекламных функций Ozon в Excellen предусмотрено отдельное подключение Performance API с Client ID и Client Secret. Это не та же пара, что Client ID и API key продавца.

Откройте в рекламном кабинете Ozon раздел доступа к Performance API и следуйте его текущей процедуре. Внесите полученные реквизиты в отдельные настройки рекламного подключения Excellen, затем выполните проверку соединения. Наличие Admin у ключа Seller API не заменяет это подключение.

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

Как проверить новый ключ и убрать лишние права

1. Создайте отдельный ключ для Excellen с ограниченными правами. Не изменяйте вслепую общий ключ нескольких интеграций.
2. Подключите его в приложении и последовательно проверьте нужные разделы: товары, цены, остатки, продажи, финансы, акции и рекламу.
3. Для ошибок сохраните название операции, код и текст ответа без ключей и данных магазина. 401 часто связан с авторизацией, 403 может указывать на недостаток доступа; ограничения тарифа API и лимиты запросов тоже проверяйте отдельно.
4. Если нужны операции записи, проверьте разрешённые методы в кабинете. Факт наличия кнопки или предварительного просмотра не доказывает, что ключ допускает изменение. Реальную отправку выполняйте только как осознанное рабочее действие с подтверждением, а не как случайный тест.
5. После проверки замените старое подключение и отзовите ненужный ключ, убедившись, что другие системы от него не зависят. При подозрении на утечку не откладывайте отзыв ради такого теста.

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

Что нельзя отправлять в поддержку или публиковать

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

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

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