SellerAgent

Тема

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

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

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

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

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

  1. Зайдите в WB Seller: https://seller.wildberries.ru/
  2. Откройте Профиль (логотип в правом верхнем углу) → Настройки → Доступ к API.
  3. Нажмите «Создать новый токен».
  4. Заполните название (например, SellerAgent).
  5. Обязательно отметьте категории (это самое важное — без них синк не сможет тянуть нужные данные):
    • Контент — карточки товаров.
    • Статистика — заказы и FBW.
    • Аналитика — остатки и отчёты.
    • Финансы — финансовый отчёт реализации.
    • Маркетплейс — нужна для FBS: сборочные задания, остатки со складов продавца и справочник складов. Без неё синхронизируется только FBW — FBS-этапы просто пропускаются, не прерывая остальную синхронизацию.
  6. Срок жизни токена — до 180 дней. Дольше нельзя; запланируйте напоминание перевыпустить.
  7. Скопируйте токен — это длинная строка из ≥100 символов. WB показывает её только один раз.

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

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

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

Если токен принят — карточка станет «подключённой»: зелёный бейдж, маска токена, кнопки синхронизации.

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

Нажмите «Синхронизировать». В верхней панели появится индикатор стадий:

Wildberries: синхронизация · карточки → остатки → заказы → отчёт реализации → связка дат

Первый прогон — 1–5 минут. Можно закрыть вкладку — синк продолжится в фоне.

Когда увидите «Синхронизировано N мин назад» — можно открывать ABC.

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

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

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

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

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

Для Ozon и Яндекс.Маркета этого ограничения нет — у них API отдают историю на годы назад.

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

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

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

После синка появился красный баннер «Последняя синхронизация завершилась с ошибкой: токен не имеет нужной категории». Это значит, что при выпуске токена вы не отметили все нужные категории. Перевыпустите токен в ЛК WB с галочками Контент / Статистика / Аналитика / Финансы и сохраните новое значение в карточке подключения (нажмите «Отключить» → введите новый токен → «Подключить»). Если торгуете по FBS, добавьте также Маркетплейс — без неё сборочные задания и остатки со склада продавца не подтянутся. Баннер исчезнет после следующего успешного синка.

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

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

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

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