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

Подключим Wildberries к NWMS на примере работы по FBS. Товар хранится на вашем складе, а WMS получает задания маркетплейса, учитывает доступный остаток и помогает подготовить заказы к отгрузке.
Это инструкция для Wildberries. Если вы подключаете другую площадку, вернитесь к выбору маркетплейса.
Что подготовить
Перед подключением убедитесь, что у вас есть:
- Аккаунт NWMS и доступ к разделу «Интеграции → Wildberries».
- Внутренний магазин WMS, которому будут принадлежать товары и заказы, и физический склад WMS.
- Кабинет продавца Wildberries с настроенным складом продавца для FBS.
- Доступ владельца кабинета WB для создания API-токена. Для повседневной работы в NWMS токен повторно вводить не нужно.
Если магазин и склад ещё не подготовлены, сначала прочитайте инструкции «Склады в NWMS» и «Магазины в NWMS».
Токен Wildberries
- В кабинете продавца WB откройте «Профиль → Интеграции по API» и начните создание токена.
- Выберите тип доступа, подходящий вашей установке. Для облачного сервиса используются Базовый или Сервисный токены. Сервисный токен привязан к выбранному сервису; Персональный предназначен для собственной локальной системы продавца.
- Для FBS нужны категории «Контент» и «Маркетплейс». Если в WMS будете загружать оценочную стоимость из цен WB, добавьте «Цены и скидки».
- Для первоначальной загрузки данных достаточно чтения. Для публикации остатков и управления FBS понадобится уровень «Чтение и запись».
- Создайте токен и скопируйте его полностью в форму подключения NWMS.
Выбор типа токена сверяйте с полем «Режим установки» и подсказкой в форме вашей WMS. У сервиса и локальной установки продавца требования к типу доступа различаются.
Актуальные действия в кабинете WB описаны в официальной инструкции Wildberries по токенам.

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

Нажмите «Сохранить подключение». Откроется карточка интеграции с вкладками. Само сохранение не загружает товары и не включает автоматическую отправку данных в Wildberries.
Проверка доступа
Нажмите «Проверить доступ» и дождитесь завершения проверки. На вкладке «Подключение» проверьте:
- Состояние: «Активна». При ошибке сначала прочитайте поле «Диагностика».
- Среду: рабочий кабинет для реальных заказов; тестовый доступ не заменяет рабочий.
- Категории и уровень доступа: есть нужные разделы WB и права на запланированные операции.
- Срок действия: токен действителен. Данные продавца, полученные после проверки, относятся к нужному кабинету.
После добавления кабинета откройте «Обмен данными» и оставьте включённым «Безопасный режим — ничего не отправлять в Wildberries» на время настройки. Получение данных можно включать отдельно.

Если команда недоступна или состояние остаётся «Выключена», проверьте права и состояние подключения. Не переходите к отправке данных, пока проверка не завершилась успешно.
Склады и правила остатка
Откройте вкладку «Склады» и нажмите «Загрузить или обновить склады Wildberries». WMS прочитает список складов продавца; эта команда не создаёт новые склады в кабинете WB.
У нужной строки нажмите «Сопоставить» или «Настроить». В разделе «Связь складов» выберите соответствующий физический склад WMS и сохраните настройки.

Затем откройте раздел «Остатки» настроек этого склада:
- Доля доступного остатка, %: какая часть доступного количества участвует в публикации.
- Оставить на складе не менее: количество, которое нужно сохранить вне публикуемого остатка.
- Дополнительный резерв: дополнительное уменьшение после применения процента и ограничений.
- Использовать сопоставление для расчёта: включение этой связи для расчётов.
- Только рассчитывать, ничего не отправлять: возможность проверить правила без публикации для этого склада.

Число в примере показывает работу правил, а не фактический остаток в WB. Настройки действуют для выбранного склада. В разделах «Ассортимент» и «Лимит заказов в сутки» можно дополнительно ограничить набор товаров и объём работы.
Каталог и сопоставление
На вкладке «Обмен данными» включите «Загружать каталог товаров из Wildberries» и сохраните настройки. Затем перейдите в «Товары». Для первого полного чтения используйте «Полностью перечитать каталог»; для последующих изменений — «Загрузить новые и изменённые товары».
Дождитесь завершения операции. Карточка WB может содержать несколько размеров: сопоставление выполняется на уровне конкретного варианта, а не только общего названия товара.
Если товары уже заведены в WMS
Выберите «Поля сопоставления»: штрихкод, артикул продавца, товарную серию и размер. Используйте признаки, которые действительно совпадают в обеих системах. Несколько выбранных признаков должны давать однозначное совпадение. Сохраните настройки и нажмите «Повторно проверить сопоставления».

Если номенклатуру нужно создать из WB
Включите «Создавать номенклатуру WMS из Wildberries» и сохраните настройку. Для варианта без связи и без кандидатов WMS может создать отдельный товар. Найденные существующие товары связываются вместо создания дубля; конфликтные варианты требуют проверки.
В таблице разберите состояния «Конфликты», «Есть предложение» и «Не сопоставлено». При ручном сопоставлении проверяйте артикул, штрихкод и размер: размер M и размер L нельзя случайно связать с одним и тем же товаром WMS.
В блоке «Загрузка данных товара из WB» можно выбрать поля для обновления и нажать «Обновить». Выбранные поля существующих товаров WMS будут заменены данными каталога WB — заранее определите, какая система является источником этих данных. Автоматическая синхронизация товаров раз в сутки настраивается отдельно.
Остатки и обмен
Сначала убедитесь, что товар принят на склад и привязан к местам хранения. Наличие карточки товара само по себе не означает наличие доступного запаса.
- На вкладке «Обмен данными» включите «Рассчитывать остатки для Wildberries» и сохраните настройки.
- На вкладке «Остатки» запустите «Рассчитать и сверить остатки».
- Сравните рассчитанное количество со значением «Сейчас в WB», проверьте склад, резервы, ограничения и несопоставленные варианты.
- Для начала можно ограничить публикацию несколькими артикулами через режим «Только товары из списка» в блоке «Ограничение товаров для остатков».
- Когда расчёты проверены, разрешите «Отправлять остатки в Wildberries» и выключите безопасный режим. Проверьте, что выбранный склад не оставлен в режиме «Только рассчитывать».
Отправка возможна только при действующем доступе, нужных правах токена и разрешениях интеграции и склада. Для дальнейшей работы можно включить «Точечно синхронизировать изменившиеся остатки» и «Выполнять суточную фоновую сверку».
FBS-заказы и маркировка
Для получения заданий включите «Получать новые FBS-заказы» на вкладке «Обмен данными» и сохраните настройки. На вкладке «Заказы FBS» можно вручную запустить «Получить новые заказы и сверить статусы».
Получение заданий создаёт заказы и резервы внутри WMS, но само по себе не подтверждает и не отправляет заказы в Wildberries. Если вариант товара не сопоставлен или требует проверки, задание может остаться фантомом — сначала разберите причину и связь товара.
Разрешения для обработки FBS
В «Обмене данными» каждое направление включается отдельно. Выбирайте только операции вашего складского процесса:
- «Управлять поставками FBS»: создание поставок, добавление заказов и работа с коробами.
- «Передавать коды маркировки»: отправка отсканированных кодов маркированного товара.
- «Передавать сроки годности при их наличии»: передача срока фактически собранной партии, если WB допускает эти метаданные; требуется разрешённая передача маркировки.
- «Разрешить отмену FBS-заданий»: отдельное разрешение отменять задания со стороны продавца.
- «Разрешить передачу поставки в доставку»: отдельное разрешение финального действия с поставкой; требует включённого управления поставками.
Автоматически созданную службу доставки WMS для этого подключения WB добавьте в нужную очередь маркировки и накладную отгрузки. Во вкладке «Настройки маркировки» выберите подходящий режим подготовки. Для печати через WMS проверьте формат этикеток PNG или SVG и размер 58 × 40 либо 40 × 30 мм.
Сопоставление статусов доставки находится в кнопке «Статусы заказов» на странице всех подключений. Оно задаётся отдельно от разрешения отправлять данные: фактические статусы доставки поступают из WB.
Проверка перед запуском
Перед полноценным обменом проверьте один выбранный склад и несколько сопоставленных товаров:
- Подключение активно, токен действителен и относится к нужному продавцу.
- Выбран правильный магазин WMS; нужные склады сопоставлены.
- Варианты и размеры товаров связаны однозначно.
- Рассчитанный остаток соответствует фактическому доступному запасу и заданным ограничениям.
- После публикации данные действительно появились в WB; в истории операций нет незавершённой ошибки.
- Полученное FBS-задание стало корректным заказом WMS; фантомы и отмены разобраны.
- Для работы с поставками настроены служба доставки, маркировка и печать.
Ход заданий проверяйте во вкладках «История операций» и «Журнал изменений». Операции могут выполняться в очереди: сообщение о запуске ещё не означает завершение обмена.
Если что-то не работает
| Что происходит | Что проверить |
|---|---|
| Проверка доступа не проходит | Полноту токена, его срок, тип, категории и уровень доступа. Подробную причину смотрите в «Диагностике». |
| Состояние «Ожидает оплату WB API» | Условия доступа к API в кабинете WB. После устранения причины повторите проверку; не пытайтесь заменить настройки складов вместо решения доступа. |
| Не видны команды настройки | Права вашей роли и состояние подключения. Часть команд доступна только для активного кабинета. |
| Товары не сопоставились | Штрихкоды, артикулы и размеры. После исправления карточек WMS повторно проверьте сопоставления и разберите конфликты. |
| Остаток рассчитан, но в WB не меняется | Безопасный режим, разрешение отправки, права токена, режим выбранного склада и результат операции в истории. |
| Заказ есть в WB, но не стал заказом WMS | Получение FBS-заказов, сопоставление склада и товара, фантомы и очередь операций. |
| Этикетка или поставка не подготовилась | Настройки маркировки, службу доставки в очереди и накладной, формат этикетки и разрешения на FBS-поставки. |
Если причина остаётся непонятной, обратитесь в поддержку NWMS: укажите название подключения, склад, время операции и номер заказа или задания. Токен доступа в сообщение не включайте.