Перейти к основному содержимому

Кабинеты Wildberries

Раздел: Общие возможности

Что это​

Кабинет WB в «Оптиме» — это подключение вашего личного кабинета продавца Wildberries через API-ключ (токен) из seller.wildberries.ru. Все модули работают от имени конкретного кабинета, поэтому подключить хотя бы один кабинет нужно сразу после регистрации. Можно подключить несколько кабинетов и переключаться между ними.

«Оптима» хранит ключ только в зашифрованном виде и использует его исключительно для запросов к API Wildberries. Обратно ключ не показывается — в интерфейсе видны лишь его последние 4 символа.

Где найти​

  • Боковое меню → «Настройки» → «Кабинеты WB» (/app/settings/accounts).
  • Переключатель «Кабинет WB» в шапке приложения — выбор кабинета, с которым вы сейчас работаете. После выбора модули открываются по адресам вида /app/wb/<кабинет>/<раздел>.

Как пользоваться​

1. Получите API-ключ Wildberries​

  1. Войдите в личный кабинет продавца на seller.wildberries.ru.
  2. Откройте «Настройки» → «Доступ к API» и создайте токен.
  3. Отметьте категории, нужные модулям «Оптимы», которыми вы будете пользоваться (таблица ниже). Проще всего выдать один токен на все эти категории.
  4. Не включайте режим «только чтение», если планируете менять данные в WB из «Оптимы»: цены и скидки, ставки рекламы, ответы на отзывы, фото карточек в A/B-тестах.
  5. Скопируйте токен — Wildberries показывает его один раз.
Модуль «Оптимы»Категории токена WB
Каталог товаров, A/B-тесты карточекКонтент
Цены и скидки, репрайсер, синхронизация цен каталогаЦены и скидки
Оцифровка продажСтатистика, Финансы
РНПАналитика, Продвижение, Финансы
АвтобиддерПродвижение
Автоответы на отзывы и вопросыВопросы и отзывы
Товарный учётАналитика
Бронировщик поставокПоставки (справочник складов); коэффициенты приёмки читаются из раздела тарифов WB

Если у токена нет нужной категории, соответствующая синхронизация будет получать отказ от WB, а вы — уведомление «Проверьте API-ключ Wildberries».

2. Добавьте кабинет​

  1. В разделе «Кабинеты WB» нажмите «Добавить кабинет».
  2. Укажите «Название» (1–100 символов, видно только в «Оптиме», например «Основной магазин»).
  3. Вставьте «API-ключ» (от 16 символов) и нажмите «Добавить кабинет».
  4. Кабинет появится в списке со статусом «Не проверен».

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

3. Проверьте ключ​

Нажмите «Проверить ключ» в карточке кабинета. «Оптима» делает пробный запрос к WB и обновляет статус:

  • Активен — ключ принят, кабинет готов к работе;
  • Не работает — WB отклонил ключ (отозван, истёк, нет прав) или запрос не прошёл; причина показывается в карточке. Создайте новый токен и замените ключ;
  • Не проверен — кабинет добавлен или ключ заменён, но проверку ещё не запускали.

Проверка обязательна. Плановые фоновые синхронизации (оцифровка, РНП, остатки, каталог) работают только для кабинетов в статусе «Активен», а модули бронировщика, товарного учёта и юр. блока показывают подсказку «Проверьте API-ключ кабинета», пока кабинет не активен.

4. Работайте с кабинетом​

Кнопка «Dashboard» в карточке открывает главную страницу кабинета. Переключаться между кабинетами можно в шапке; приложение запоминает последний выбранный.

Изменить название или ключ​

Кнопка «Изменить» открывает «Настройки кабинета». Поле «Новый API-ключ» оставьте пустым, если ключ не меняется. При замене ключа статус сбрасывается в «Не проверен» (нужно снова нажать «Проверить ключ»), а загрузка каталога запускается повторно.

Удалить кабинет​

Кнопка «Удалить» → «Подтвердить удаление». Кабинет исчезает из списка и из всех модулей. Запись не стирается физически — она сохраняется для истории и аудита, но восстановить кабинет через интерфейс нельзя: при необходимости добавьте его заново.

Посмотреть лимиты запросов WB​

Wildberries ограничивает число запросов к API для каждого кабинета. «Оптима» сама соблюдает эти лимиты: распределяет запросы и при отказе WB «слишком много запросов» откладывает задачу и повторяет позже, не тратя попытки. Кнопка «Лимиты WB» в карточке кабинета показывает текущие окна лимитов: раздел и метод WB, сколько запросов израсходовано из доступных («5 из 6») и через сколько секунд окно сбросится. «Сейчас нет активных окон лимитов» — значит, в последнее время запросов не было.

Фоновые задачи одного кабинета выполняются по очереди, а задачи, запущенные вами вручную (например, импорт в оцифровке), получают приоритет перед плановыми.

Кто что видит​

  • Селлер и Менеджер — только кабинеты, которые подключили сами.
  • Администратор — все кабинеты всех пользователей инсталляции; может проверять, изменять и удалять любой из них.

Подробнее — «Роли и доступ».

Безопасность​

  • Ключ хранится зашифрованным (AES-256-GCM) и расшифровывается только на сервере в момент запроса к WB. В логи, ответы API и журнал аудита он не попадает.
  • В интерфейсе видна только маска «•••• 1234» — по ней можно отличить ключи, но не восстановить.
  • Добавление, изменение, проверка и удаление кабинета записываются в журнал аудита.
  • Если ключ скомпрометирован — отзовите его в ЛК Wildberries, создайте новый и замените ключ в «Оптиме».

Ограничения​

  • Один кабинет — один токен. Раздельные токены по категориям для одного кабинета не поддерживаются.
  • Статус кабинета меняется только по кнопке «Проверить ключ». Если WB начнёт отклонять ключ во время фоновой синхронизации, статус останется «Активен», но владелец кабинета получит уведомление «Проверьте API-ключ Wildberries» (не чаще раза в сутки на кабинет).
  • Срок действия токена задаёт Wildberries; заранее «Оптима» о его истечении не предупреждает.
  • Первичная загрузка каталога запускается «по возможности»: если она не стартовала (например, из-за сбоя сервера), каталог заполнится ближайшей плановой синхронизацией.

Связанные страницы​

Для интеграторов​