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 с теми же категориями, откройте страницу подключения, вставьте его в поле «API‑токен» и сохраните. Если оставить поле как есть, сохранённый токен не изменится.
- Отозвать доступ. Отзовите токен в кабинете Wildberries — доступ прекратится сразу — и отключите интеграцию кнопкой «Отключить» на карточке.
- Отключить интеграцию. Обмен с Wildberries прекратится: новые заказы, товары и остатки загружаться не будут; уже загруженные данные останутся в системе. Если Wildberries был основным источником, сначала выберите другой.
| Состояние | Что означает | Что делать |
|---|---|---|
| Не подключено | токен не сохранён | «Подключить» |
| Подключено | токен сохранён, регулярный обмен идёт | следить за счётчиком дней и переключателем публикации |
| Основной | этот кабинет — источник каталога и остатков для всей компании | менять через «Сделать основным» у другого источника или «Переключить источник» у виртуального склада |
| Ошибка | канал отвечает с ошибками — истёк или отозван токен, не хватает категории, площадка недоступна | прочитать текст ошибки в блоке диагностики, устранить причину, нажать «Сбросить ошибки» |
- Не работает с тестовым токеном. Он открывает только песочницу WB API; для кабинета нужен базовый токен.
- Не создаёт карточки на Wildberries. Карточки заводятся в кабинете; система сопоставляет их со своими товарами и работает с остатками, ценами и заказами.
- Не хранит логин и пароль. В системе лежит только токен, и он показывается замаскированным.
- Не обходит ограничения токена. Нет категории — нет данных; «Только чтение» — нет публикации.
- Не продлевает токен. Через 180 дней новый токен выпускает продавец; система только напоминает счётчиком.
Какой тип токена Wildberries выбрать для NeoIT Hub?
Базовый — в форме создания он подписан «Для сторонних решений». Персональный по правилам Wildberries нельзя передавать облачным сервисам, тестовый работает только с песочницей, сервисный выпускается под сервисы из Каталога решений Wildberries.
Кабинет уже подключён персональным токеном. Нужно ли что‑то менять?
Технически обмен идёт, но правила Wildberries запрещают использовать персональный токен в облачных сервисах. При ближайшем перевыпуске создайте базовый токен с теми же категориями и вставьте его на странице подключения — остальные настройки останутся.
Где посмотреть уже созданный токен Wildberries?
Нигде: после кнопки «Скопировать и закрыть» токен в кабинете больше не показывается. Если он не сохранён, выпустите новый (кнопка «Дублировать» у существующего токена повторит его настройки) и замените на странице подключения.
Можно ли подключить один кабинет Wildberries к нескольким сервисам?
Да, для каждого сервиса создаётся свой токен — так его можно отозвать отдельно, не трогая остальные интеграции.
Токен создан, но на странице подключения появились поля для ручного ввода склада. Почему?
Система не смогла получить список складов по токену — как правило, у него нет категории «Маркетплейс». Выпустите токен заново с этой категорией.
Публикация остатков включена, а остатки в кабинете не меняются. В чём дело?
Проверьте по порядку: токен без признака «Только чтение»; товар сопоставлен с карточкой Wildberries; в модуле «Склады» публикация не остановлена общим стоп‑краном компании. Подробно ограничения разобраны в материале о единых остатках.
Что произойдёт с заказами, если токен истёк?
Новые заказы FBS перестанут загружаться, пока не будет сохранён новый токен. Уже загруженные заказы и товары останутся в системе.
Нужно ли переподключать кабинет после замены токена?
Нет. Вставьте новый токен на странице подключения и сохраните — остальные настройки, включая склад и основной источник, остаются.
- 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
Материал подготовлен NeoIT Hub. Источники сверены 12.09.2026. Это не юридическая консультация.