NEOIT 
Wildberries открывает продавцу официальный интерфейс - WB API. Через него внешняя система читает карточки, остатки, заказы и отчёты кабинета и, если разрешено, записывает обратно остатки и цены. Доступ к API выдаётся токеном: это длинная строка, которую продавец создаёт сам в кабинете и сам же может отозвать в любой момент.
NeoIT Hub работает только так. Логин и пароль от кабинета не запрашиваются, автоматизация браузера, cookies и неофициальные способы доступа не применяются. Один токен - и кабинет Wildberries становится каналом в общей системе: остаток уходит на все площадки из одного места, цены считает репрайсер, заказы FBS собираются в одном окне, там же вводятся коды маркировки.
Токен создаётся в кабинете продавца seller.wildberries.ru, раздел «Интеграции по API» (прежнее название - «Настройки → Доступ к API», старый адрес перенаправляет туда же). Кнопка «+ Создать токен» открывает форму с двумя вкладками: «Для сервиса из каталога» и «Для интеграции вручную» - нужна вторая. Дальше выбираются тип токена, название, категории доступа и уровень доступа к данным; после нажатия «Создать» Wildberries показывает готовый токен один раз - кнопка «Скопировать и закрыть». Повторно посмотреть его в кабинете нельзя, только выпустить новый. Одновременно у продавца может быть до 20 токенов.
На вкладке «Для интеграции вручную» Wildberries предлагает три типа. Базовый токен - «Для сторонних решений»: именно он нужен для NeoIT Hub и любого другого облачного сервиса. Персональный - «Только для своих решений»: по правилам Wildberries он предназначен для собственных программ продавца и не передаётся облачным сервисам. Тестовый - «Только для разработчика»: работает только с песочницей WB API и реальных данных магазина не видит. Четвёртый тип, сервисный, создаётся на первой вкладке под конкретный сервис из Каталога решений Wildberries - к NeoIT Hub он не относится.
Wildberries выдаёт токен с набором категорий. Каждая открывает свою группу методов, и если категории нет - соответствующая часть работы просто не заработает, причём ошибка проявится не сразу, а при первой синхронизации. Для NeoIT Hub нужны:
| Категория токена | Что она открывает | Нужна ли |
|---|---|---|
| Контент | карточки товаров - каталог в системе | да |
| Маркетплейс | склады продавца, остатки на них, заказы FBS | да - без неё не определится склад |
| Цены и скидки | управление ценами из репрайсера | да |
| Статистика | основные отчёты: продажи, заказы | да |
| Аналитика | аналитика и данные, отчёты об остатках и о товарах с маркировкой | да |
| Поставки | поставки FBW | если пользуетесь модулем поставок |
| Возвраты | возвраты покупателями | если пользуетесь модулем возвратов |
| Вопросы и отзывы | вопросы, отзывы | если пользуетесь модулем отзывов |
Названия - как в форме создания токена на 12.09.2026. В памятке «Как подключить» и справке NeoIT категории пока названы по‑старому, парами: «Статистика и Аналитика», «Поставки и Возвраты покупателями» - в кабинете это уже четыре отдельных флажка. Категории «Финансы», «Продвижение», «Чат с покупателем», «Документы» системе не нужны, а «Пользователи» базовому токену недоступна по правилам Wildberries - отметить её и не получится. Уровень доступа к данным - «Чтение и запись».
В форме создания токена есть переключатель «Уровень доступа к данным»: «Чтение и запись» или «Только чтение». Токен «Только чтение» позволит загрузить данные из кабинета, но система не сможет отправлять остатки и цены обратно. Если задача - единый остаток на всех площадках, выбирайте «Чтение и запись». Право записи в самой системе включается отдельно (раздел про публикацию ниже), но обойти ограничение токена оно не может.
| Направление | Что передаётся | От чего зависит |
|---|---|---|
| Wildberries → NeoIT | карточки (категория «Контент»), заказы FBS и склады («Маркетплейс»), продажи и отчёты («Статистика и Аналитика») | категории токена; каталог целиком загружается, если Wildberries выбран основным источником |
| NeoIT → Wildberries | остатки - единый свободный остаток из модуля «Склады»; цены - из репрайсера | токен без «Только чтение» + переключатель «Публикация остатков» на карточке Wildberries в «Интеграциях» |
Заказы и остатки идут в разные стороны, и это нормально. Заказ FBS приходит из кабинета и удерживает единицу товара; обратно в кабинет уходит уже пересчитанный свободный остаток - тот же, что и на Ozon, Яндекс Маркет и сайт. Как именно считается «свободный остаток» и почему в кабинет попадает не всё, что лежит на складе, - в материале о единых остатках.
Откройте карточку Wildberries
Раздел «Интеграции» → карточка Wildberries → «Подключить» (у уже подключённого кабинета - «Настроить»). Откроется страница подключения; справа - короткая памятка «Как подключить», подробный FAQ - в меню «Поддержка» в шапке, пункт «Вопросы и ответы» по этой странице.
Вставьте токен
Поле «API‑токен» - единственное обязательное; вставьте в него базовый токен, созданный в кабинете. «Название подключения» видно только вам и помогает различать кабинеты, если их несколько.
Проверьте, что склад определился
Блок «Склад» заполняется автоматически: система запрашивает список складов продавца по токену. Один склад - он выбирается сам; несколько - появится список выбора. Если список получить не удалось, появятся поля для ручного ввода идентификатора и названия склада - и это почти всегда значит, что у токена нет категории «Маркетплейс».
Не вводить склад руками, а выпустить новый токен с категорией «Маркетплейс»: без неё не будут работать и заказы FBS, и публикация остатков.
Выберите основной источник каталога
Переключатель «Основной источник каталога»: Wildberries - каталог загружается из кабинета, карточки появятся в системе автоматически и остатки дальше ведёт этот канал; Виртуальный склад - каталог и остатки вы ведёте у себя, а Wildberries остаётся каналом продаж. Основной источник в компании один: выбрать Wildberries здесь значит снять эту роль с прежнего источника.
Нажмите «Подключить»
Настройки сохраняются, включается регулярный обмен. Токен после сохранения показывается замаскированным - видны только первые и последние символы, а рядом со статусом «Подключено» появляется счётчик: сколько дней токену осталось действовать.
Право системы записывать остатки в кабинет - отдельная настройка на карточке Wildberries в разделе «Интеграции». Переключатель показывает текущее состояние: «Публикация остатков включена» - система перезаписывает остатки в кабинете своими значениями ближайшим циклом; «Только чтение» - данные из Wildberries загружаются, но обратно ничего не отправляется. Над карточками строка сводки перечисляет, в какие каналы публикация сейчас разрешена.
Признак на токене и переключатель на карточке - не одно и то же. Переключатель можно включить в любой момент, а ограничение токена снимается только выпуском нового токена. Если публикация включена, а остатки в кабинет не уходят, - первым делом проверьте, не выпущен ли токен «Только чтение».
Токен Wildberries действует 180 дней после создания, дальше его нужно выпустить заново. Чтобы это не стало сюрпризом, NeoIT Hub показывает счётчик оставшихся дней на карточке подключения и на Главной: пока запас большой - спокойный цвет, ближе к концу срока - тревожный. Истёкший токен означает остановку обмена: заказы не загружаются, остатки не публикуются.
Wildberries напоминает о конце срока сам: за 3 дня до истечения владельцу кабинета приходит уведомление на портале WB Partners. Wildberries рекомендует обновлять токен за 7-14 дней до срока кнопкой «Дублировать» у существующего токена в «Интеграциях по API» - она открывает окно создания нового токена с теми же категориями и уровнем доступа; старый удаляется после того, как новый проверен в работе. Продлить токен технически нельзя. Отдельный случай - смена номера телефона владельца кабинета: для всех токенов начинается карантин, интеграции работают с ошибками, а после карантина токены отзываются - их нужно перевыпустить и заменить в сервисах.
- Заменить токен. Выпустите новый в кабинете Wildberries с теми же категориями, откройте страницу подключения, вставьте его в поле «API‑токен» и сохраните. Если оставить поле как есть, сохранённый токен не изменится.
- Отозвать доступ. Отзовите токен в кабинете Wildberries - доступ прекратится сразу - и отключите интеграцию кнопкой «Отключить» на карточке.
- Отключить интеграцию. Обмен с Wildberries прекратится: новые заказы, товары и остатки загружаться не будут; уже загруженные данные останутся в системе. Если Wildberries был основным источником, сначала выберите другой.
| Состояние | Что означает | Что делать |
|---|---|---|
| Не подключено | токен не сохранён | «Подключить» |
| Подключено | токен сохранён, регулярный обмен идёт | следить за счётчиком дней и переключателем публикации |
| Основной | этот кабинет - источник каталога и остатков для всей компании | менять через «Сделать основным» у другого источника или «Переключить источник» у виртуального склада |
| Ошибка | канал отвечает с ошибками - истёк или отозван токен, не хватает категории, площадка недоступна | прочитать текст ошибки в блоке диагностики, устранить причину, нажать «Сбросить ошибки» |
- Не работает с тестовым токеном. Он открывает только песочницу WB API; для кабинета нужен базовый токен.
- Не создаёт карточки на Wildberries. Карточки заводятся в кабинете; система сопоставляет их со своими товарами и работает с остатками, ценами и заказами.
- Не хранит логин и пароль. В системе лежит только токен, и он показывается замаскированным.
- Не обходит ограничения токена. Нет категории - нет данных; «Только чтение» - нет публикации.
- Не продлевает токен. Через 180 дней новый токен выпускает продавец; система только напоминает счётчиком.
Какой тип токена Wildberries выбрать для NeoIT Hub?
Базовый - в форме создания он подписан «Для сторонних решений». Персональный по правилам Wildberries нельзя передавать облачным сервисам, тестовый работает только с песочницей, сервисный выпускается под сервисы из Каталога решений Wildberries.
Кабинет уже подключён персональным токеном. Нужно ли что‑то менять?
Технически обмен идёт, но правила Wildberries запрещают использовать персональный токен в облачных сервисах. При ближайшем перевыпуске создайте базовый токен с теми же категориями и вставьте его на странице подключения - остальные настройки останутся.
Где посмотреть уже созданный токен Wildberries?
Нигде: после кнопки «Скопировать и закрыть» токен в кабинете больше не показывается. Если он не сохранён, выпустите новый (кнопка «Дублировать» у существующего токена повторит его настройки) и замените на странице подключения.
Можно ли подключить один кабинет Wildberries к нескольким сервисам?
Да, для каждого сервиса создаётся свой токен - так его можно отозвать отдельно, не трогая остальные интеграции.
Токен создан, но на странице подключения появились поля для ручного ввода склада. Почему?
Система не смогла получить список складов по токену - как правило, у него нет категории «Маркетплейс». Выпустите токен заново с этой категорией.
Публикация остатков включена, а остатки в кабинете не меняются. В чём дело?
Проверьте по порядку: токен без признака «Только чтение»; товар сопоставлен с карточкой Wildberries; в модуле «Склады» публикация не остановлена общим стоп‑краном компании. Подробно ограничения разобраны в материале о единых остатках.
Что произойдёт с заказами, если токен истёк?
Новые заказы FBS перестанут загружаться, пока не будет сохранён новый токен. Уже загруженные заказы и товары останутся в системе.
Нужно ли переподключать кабинет после замены токена?
Нет. Вставьте новый токен на странице подключения и сохраните - остальные настройки, включая склад и основной источник, остаются.
Чем отличаются базовый, персональный и сервисный токены Wildberries и какой из них «обычный»?
По инструкции Wildberries (28.05.2026): персональный - для собственных программ и систем on-premise на ваших серверах (коробочная 1С, ERP, CRM), даёт дополнительные категории вроде управления пользователями и запрещён к передаче облачным сервисам; сервисный - только для облачного сервиса из Каталога решений Wildberries, категории заполняются автоматически; базовый - для всех остальных случаев, в том числе для облачного сервиса вне каталога, категории и уровень доступа выбираете сами, а часть категорий ему недоступна; тестовый - только песочница. «Обычного» типа в кабинете нет - так обычно называют базовый.
Как выглядит API-токен Wildberries?
Длинная строка из трёх частей, разделённых точками (формат JWT). Внутри зашит срок действия - NeoIT Hub читает дату окончания прямо из токена, не обращаясь к Wildberries, и показывает счётчик дней. В кабинете токен показывается один раз при создании; в его карточке в «Интеграциях по API» потом видны название, срок, уровень доступа и категории, но не сама строка.
Сервис пишет: «Ограничения базового токена не позволяют использовать его для интеграции - укажите токен другого типа». Что делать?
Это значит, что подключаемой интеграции нужен другой тип токена: сервису из Каталога решений Wildberries - сервисный, собственной программе или коробочной 1С на ваших серверах - персональный. Для NeoIT Hub, облачного сервиса вне каталога, подходит базовый токен с категориями из таблицы выше; категории, которые базовому токену недоступны (например «Пользователи»), системе не нужны.
Пришло уведомление, что срок действия токена заканчивается. Что делать?
Wildberries присылает его за 3 дня до истечения 180 дней. В «Интеграциях по API» нажмите «Дублировать» у токена - создастся новый с теми же категориями; скопируйте его (показывается один раз), вставьте в поле «API-токен» на странице подключения Wildberries в NeoIT и сохраните - переподключать кабинет не нужно. Старый токен удалите, когда убедитесь, что обмен идёт. Продлить существующий токен нельзя.
Какой токен и какая категория нужны для заказов FBS Wildberries?
Базовый токен с категорией «Маркетплейс» - она открывает заказы FBS, склады продавца и остатки на них. Для отчётов о продажах нужна «Статистика», для карточек - «Контент», для цен - «Цены и скидки».
Через какую категорию токена система получает скидку WB (СПП)?
Через две: «Маркетплейс» - в новых заказах FBS приходят цена продавца и цена покупателя, откуда считается скидка по заказу; «Статистика» - в финансовом отчёте по строке реализации есть процент скидки площадки. Текущую скидку на карточке до продажи API продавца не отдаёт - ни одна категория её не даст. Подробнее - в материале о скидке WB (СПП).
Можно ли давать персональный токен стороннему сервису?
Нет. По правилам Wildberries персональный токен нельзя передавать третьим лицам и использовать в облачных сервисах - при его создании кабинет требует принять предупреждение об ответственности. Для сервисов предназначены базовый и сервисный токены.
В диагностике подключения ошибка «access token withdrawn». Что это значит?
Токен отозван - удалён в кабинете Wildberries в разделе «Интеграции по API», и обмен остановлен. Выпустите новый токен с теми же категориями и замените его на странице подключения.
Сколько токенов можно создать и кто может это делать?
До 20 активных токенов на один магазин; создавать и удалять их может только владелец кабинета. Wildberries рекомендует отдельный токен для каждой интеграции - тогда доступ конкретного сервиса отзывается, не трогая остальные.
- NeoIT Hub - справка «Wildberries»: где взять токен, какие категории нужны, признак «Только чтение», определение склада, основной источник, замена и отзыв токена, отключение neoit.ru
- NeoIT Hub - страница подключения Wildberries (integration-wb.html) и раздел «Интеграции»: названия полей, кнопок и состояний проверены на production 12.09.2026 neoit.ru
- Wildberries - документация WB API, раздел «Авторизация»: токен действует 180 дней; типы токенов (персональный - только для собственных программ, сервисный - для сервисов из Каталога, базовый - для остальных случаев, тестовый - песочница); категории токенов; порядок создания dev.wildberries.ru
- Wildberries - кабинет продавца, раздел «Интеграции по API»: форма «Создайте токен» (вкладка «Для интеграции вручную», типы «Базовый - для сторонних решений», «Персональный - только для своих решений», «Тестовый - только для разработчика»), категории и уровень доступа - проверено 12.09.2026 seller.wildberries.ru
- NeoIT Hub - База знаний: «Единые остатки для Wildberries, Ozon и Яндекс Маркета» neoit.ru
- NeoIT Hub - База знаний: «Репрайсер для Wildberries, Ozon и Яндекс Маркета» neoit.ru
- NeoIT Hub - База знаний: «Вывод из оборота при продаже на маркетплейсах по FBS» neoit.ru
- Wildberries - справочный центр продавца, «Как подключиться по API через токен» (обновлено 28.05.2026): типы токенов и их назначение, срок 180 дней, правила безопасности, карантин при смене номера seller.wildberries.ru
- Wildberries - справочный центр продавца, «Как создать, обновить или удалить токен WB API» (обновлено 18.05.2026): уведомление за 3 дня, кнопка «Дублировать», до 20 токенов, продлить нельзя seller.wildberries.ru
Материал подготовлен NeoIT Hub. Источники сверены 12.09.2026. Это не юридическая консультация.