Подключение Wildberries

Как привязать WB Seller к SellerAgent: выпустить API-токен с нужными категориями в ЛК Wildberries и сохранить его в карточке подключения.

Что вам понадобится

• Доступ к личному кабинету WB Seller с правами на выпуск API-токенов.
• 3–5 минут.
• Роль «Владелец» в SellerAgent.

Шаг 1. Выпустить токен в Wildberries

1. Зайдите в WB Seller: https://seller.wildberries.ru/

2. Откройте Профиль (логотип в правом верхнем углу) → Настройки → Доступ к API. Прямая ссылка: https://seller.wildberries.ru/api-integrations.

3. Нажмите «Создать новый токен».

4. Заполните название (например, SellerAgent).

5. Отметьте категории — все шесть обязательны, без любой из них токен не сохранится. Четыре закрывают основу отчётов:

   • Контент — карточки товаров.

   • Статистика — заказы FBW (продажи со складов Wildberries).

   • Аналитика — остатки на складах WB и их история.

   • Финансы — финансовый отчёт реализации: комиссия, логистика, хранение, штрафы. Без него не считается прибыль.

   • Маркетплейс — нужна для FBS: сборочные задания, остатки со складов продавца и справочник складов. Отмечайте её, даже если торгуете только со складов Wildberries: галочка доступна любому продавцу, а без неё FBS-данные просто не появятся, и заметить это можно очень нескоро.

   • Поставки — раздел «Поставки»: ваши поставки FBW, справочник складов приёмки и автопоиск слотов.

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

   Отдельной категории для календаря коэффициентов приёмки и тарифов коробов (подсказка «Дорогой склад») не существует — они работают с любым токеном. Остальные категории Wildberries — «Цены и скидки», «Продвижение», «Отзывы и вопросы», «Чат», «Возвраты», «Документы» — SellerAgent не использует, отмечать их не нужно.

6. Флажок «Только на чтение» можно оставить включённым. SellerAgent ничего не меняет в вашем кабинете: не правит карточки, цены и остатки, не переводит заказы по статусам — только читает данные. Флажок «Тестовый контур», наоборот, включать нельзя: такой токен отдаёт ненастоящие данные.

7. Важно: токен должен быть «Персональным» (или «Сервисным») — не «Базовым» и не тестовым. Тип токена — отдельная от категорий вещь, и галочки категорий его не меняют. С базовым токеном Wildberries отклоняет запрос остатков («base token is not allowed»), а финансовый отчёт разрешает запрашивать всего пару раз в сутки — синхронизация не сможет работать, даже если все категории отмечены. Если не уверены в типе — раскодируйте токен на https://dev.wildberries.ru/jwt либо просто выпустите новый в профиле продавца.

8. Срок жизни токена — до 180 дней. Дольше нельзя; запланируйте напоминание перевыпустить.

   Если хоть одной обязательной категории не окажется, SellerAgent не сохранит токен и покажет, каких именно категорий не хватает и что без них не заработает. То же — для «Базового» токена и для токена с истёкшим сроком. Это сделано специально: раньше такой токен сохранялся, магазин выглядел подключённым, а часть данных (чаще всего финансовый отчёт) не собиралась месяцами.

9. Скопируйте токен — это длинная строка из ≥100 символов. WB показывает её только один раз.

Подробная справка WB: https://dev.wildberries.ru/openapi/api-information (ссылка «Где получить токен» есть и в самой форме подключения).

Шаг 2. Ввести токен в SellerAgent

1. В SellerAgent откройте Подключения.
2. Если это первый WB-магазин, заполните стартовую форму в блоке Wildberries. Если WB-магазины уже есть, нажмите «Добавить магазин» в заголовке блока.
3. В карточке Wildberries заполните форму:
   • API-токен — одна длинная строка. Поле — типа «пароль», содержимое скрыто.
   • Название магазина — обязательное короткое имя магазина (например, Основной — оно и подставлено по умолчанию). Название уникально внутри WB; такое же название в Ozon или Яндекс.Маркете допустимо.
4. Нажмите «Подключить».

Токен проверяется прямо при сохранении: SellerAgent обращается к Wildberries и убеждается, что токен действует. Если токен принят — карточка станет «подключённой»: зелёный бейдж «Подключено» и строка прав токена под шапкой — и сразу начнётся первая загрузка данных (см. шаг 3). Если WB токен не принял — увидите понятное сообщение об ошибке, и токен не сохранится.

Что именно проверяется при сохранении

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

• При сохранении SellerAgent делает один запрос в Wildberries — за карточкой вашего продавца. Он отвечает ровно на один вопрос: токен рабочий или нет. Если WB отвечает отказом (токен отозван, истёк, оборвался при копировании) — токен не сохраняется. Категории проверяются здесь же, прямо из токена: если не хватает хотя бы одной из шести, токен не сохранится и SellerAgent покажет, каких категорий нет и что без них не заработает. Так же отклоняются «Базовый» токен и токен с истёкшим сроком.
• Сразу после сохранения под шапкой карточки появляется строка прав. Wildberries устроен так, что токен сам «несёт» свои права внутри себя, поэтому SellerAgent читает их прямо из токена, ничего дополнительно не запрашивая, и показывает ✓ или ⚠ по шести категориям, которые использует: Контент, Статистика, Аналитика, Финансы, Маркетплейс, Поставки — все обязательные, без любой из них токен не сохранится. Рядом — срок действия токена, а также метки «Только чтение» и — если токен выпущен неподходящего типа — «Базовый токен». Кнопка «Обновить» перечитывает права после замены токена.
• Если категории всё-таки не хватило, синхронизация не падает целиком: недоступный кусок помечается ошибкой на своей стадии, остальное загружается. В карточке появится красный баннер, который прямо называет недостающую категорию, например «Нет доступа: токен выпущен без категории „Финансы“».

Все шесть категорий обязательны, поэтому подключить магазин с неполным токеном не получится — SellerAgent скажет, чего не хватает. Если неполный токен остался с прежних времён (уже подключённые магазины мы не перепроверяем), последствия разные по тяжести: без Маркетплейса или Поставок просто не будет соответствующих данных, а без Статистики или Финансов не будет заказов или прибыли, и сервис будет каждую ночь заново пытаться догрузить недостающую историю — до тех пор, пока вы не замените токен. Не оставляйте магазин в таком состоянии надолго.

Шаг 3. Проверить, что данные потекли

Сразу после подключения SellerAgent автоматически запускает первую загрузку данных — нажимать ничего не нужно. Ход виден в карточке магазина: блок «Синхронизация в процессе» с текущей стадией и прогрессом (карточки → склады и остатки → заказы → финансовый отчёт → поставки).

Глубина первой загрузки зависит от тарифа: на бесплатном — заказы и финансы за последние ~4 месяца (120 дней), на платных — вся история, которую отдаёт Wildberries (про её ограничение — ниже). Первый прогон — 1–5 минут. Можно закрыть вкладку — загрузка продолжится в фоне.

Когда в карточке обновится время «Последняя синхронизация» — можно открывать ABC.

Что SellerAgent получает из Wildberries

• Карточки товаров — название, артикул продавца, бренд, категория, штрихкоды, размеры. Карточки из корзины тоже загружаются, иначе их продажи остались бы без названия.
• Остатки FBW и FBS — отчёт остатков на складах WB плюс остатки со складов продавца. При первом подключении дополнительно подтягивается история остатков за последние месяцы.
• Заказы FBW и FBS — выкупы, отмены, возвраты; сборочные задания со склада продавца.
• Отчёт реализации — финансовый отчёт за 28-дневные периоды (комиссии, логистика, хранение, штрафы). Из него же считаются возвраты покупателей — отдельная категория токена для них не нужна.
• Поставки FBW — питают раздел «Поставки». Нужна категория «Поставки»; без неё пропускаются только они.

Схема FBS синхронизируется через раздел «Маркетплейс» API Wildberries: SellerAgent получает сборочные задания, остатки складов продавца и справочник складов. Нужен токен с категорией Маркетплейс; без неё эти данные пропускаются, а FBW и финансы синхронизируются как обычно. Заказы DBS пока не синхронизируются.

Глубина истории WB и сравнение год к году

API заказов Wildberries отдаёт примерно последние 6 месяцев — глубже загрузить нельзя, даже на платном тарифе (там автоматически подтягивается всё, что WB отдаёт). Это значит, что сравнение год к году в ABC-отчёте для WB станет возможным только через 6+ месяцев после подключения магазина — когда у нас накопится локальная история. Подробнее — в Сравнении год к году.

Для Ozon и Яндекс.Маркета этого ограничения нет — у них API отдают историю на годы назад, и на платном тарифе она загружается автоматически (до 4 лет).

Налоговая ставка

Налог задаётся один раз на всё пространство (ИП), а не в карточке WB-магазина. Откройте «Финансы» → «Налоговые ставки»: выберите режим налогообложения на год и проставьте ставки основного налога и НДС по месяцам (по умолчанию УСН «Доходы» 6 %, без НДС). Если у вас другой режим — выберите его и задайте ставки. Подробности — в Финансы → Налоговые ставки.

Частые вопросы

Появился красный баннер «Нет доступа: токен выпущен без категории „…“». При выпуске токена не отмечена названная в баннере категория. Перевыпустите токен в ЛК WB с категориями Контент / Статистика / Аналитика / Финансы (для FBS — ещё Маркетплейс, для раздела «Поставки» — Поставки) и сохраните новое значение кнопкой «Заменить токен» в карточке подключения. Строка прав покажет ✓ по нужным категориям сразу, ещё до конца синхронизации; сама синхронизация запустится автоматически, и баннер исчезнет после её успеха.

Появился баннер «Срок действия WB-токена истёк …». Токену больше 180 дней. Выпустите новый и сохраните его кнопкой «Заменить токен» — см. вопрос про истечение ниже.

В строке прав жёлтая метка напротив «Финансы» (или другой категории). Токен выпущен без этой категории. Перевыпустите его в ЛК WB, добавив недостающую, и сохраните кнопкой «Заменить токен» — история и данные магазина сохранятся. Затем нажмите «Обновить» в строке прав, чтобы метки перечитались.

Все категории отмечены, а остатки всё равно не подтягиваются. Почти наверняка у токена неподходящий тип — «Базовый» вместо «Персонального». WB отвечает на запрос остатков «base token is not allowed», а финансовый отчёт для таких токенов ограничен настолько, что синхронизация упирается в лимиты. Галочки категорий тип не меняют: перевыпустите токен как «Персональный» — см. шаг 1, пункт 7. Если SellerAgent сумел определить тип, в строке прав будет метка «Базовый токен».

Токен скоро истечёт — что делать? Выпустите новый токен в ЛК WB (с теми же категориями), затем в карточке WB нажмите «Заменить токен» и вставьте новое значение — магазин не отключается, история продолжается без перерыва, а сразу после замены автоматически пройдёт проверочная синхронизация. Новый токен должен быть того же продавца — чужой токен сервис отклонит. SellerAgent сам напоминает о сроке: в строке прав карточки появляется метка «Истекает через N дн.».

Срок жизни токена — почему всего 180 дней? Это политика WB API, мы на неё не влияем. Поставьте напоминание в календарь раз в полгода — выпуск нового занимает 1–2 минуты.

WB показывает у меня магазинов несколько — как их подключить? Можно подключить несколько WB-магазинов в одном рабочем пространстве. В блоке Wildberries нажмите «Добавить магазин» и сохраните токен следующего кабинета с отдельным названием. Каждый магазин будет отдельной карточкой со своим токеном, состоянием синхронизации и данными. Налоговая ставка при этом общая на всё пространство (ИП).

Связанные разделы

• Подключения — общий обзор, права, налоговая ставка.
• Синхронизация данных — как и когда данные обновляются автоматически.
• Сравнение год к году — почему YoY для WB сначала пустой.