NWMS CLOUD WMS
  1. Главная
  2. Обучение
  3. Интеграции с маркетплейсами

Документация NWMS

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

Интеграции с маркетплейсами Все материалы
Учебный материал

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

Подключение Wildberries — иллюстрация
Интеграции с маркетплейсами

Подключим Wildberries к NWMS на примере работы по FBS. Товар хранится на вашем складе, а WMS получает задания маркетплейса, учитывает доступный остаток и помогает подготовить заказы к отгрузке.

Это инструкция для Wildberries. Если вы подключаете другую площадку, вернитесь к выбору маркетплейса.

Что подготовить

Перед подключением убедитесь, что у вас есть:

  • Аккаунт NWMS и доступ к разделу «Интеграции → Wildberries».
  • Внутренний магазин WMS, которому будут принадлежать товары и заказы, и физический склад WMS.
  • Кабинет продавца Wildberries с настроенным складом продавца для FBS.
  • Доступ владельца кабинета WB для создания API-токена. Для повседневной работы в NWMS токен повторно вводить не нужно.

Если магазин и склад ещё не подготовлены, сначала прочитайте инструкции «Склады в NWMS» и «Магазины в NWMS».

Скриншоты — учебные примеры из локальной WMS. Названия клиентов и складов обезличены, идентификаторы скрыты, действующих ключей на изображениях нет. Ваши настройки могут отличаться; поля «Домен» и «Кому доступно подключение» зависят от прав пользователя.

Токен Wildberries

  1. В кабинете продавца WB откройте «Профиль → Интеграции по API» и начните создание токена.
  2. Выберите тип доступа, подходящий вашей установке. Для облачного сервиса используются Базовый или Сервисный токены. Сервисный токен привязан к выбранному сервису; Персональный предназначен для собственной локальной системы продавца.
  3. Для FBS нужны категории «Контент» и «Маркетплейс». Если в WMS будете загружать оценочную стоимость из цен WB, добавьте «Цены и скидки».
  4. Для первоначальной загрузки данных достаточно чтения. Для публикации остатков и управления FBS понадобится уровень «Чтение и запись».
  5. Создайте токен и скопируйте его полностью в форму подключения NWMS.

Выбор типа токена сверяйте с полем «Режим установки» и подсказкой в форме вашей WMS. У сервиса и локальной установки продавца требования к типу доступа различаются.

Актуальные действия в кабинете WB описаны в официальной инструкции Wildberries по токенам.

Токен — ключ доступа к кабинету. Не публикуйте его в переписке, инструкциях или скриншотах. В настройках сохранённого подключения WMS показывает маску; действующий токен не нужен для иллюстрации этой статьи.
Поле токена доступа Wildberries
Вставьте токен полностью. В учебном примере поле оставлено пустым. Открыть крупнее ↗

Подключение кабинета

Войдите в российский сервер NWMS. Откройте «Интеграции → Wildberries» и нажмите «Подключить аккаунт».

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

Нажмите «Сохранить подключение». Откроется карточка интеграции с вкладками. Само сохранение не загружает товары и не включает автоматическую отправку данных в Wildberries.

Результат: кабинет добавлен в WMS, выбран его внутренний магазин. Теперь нужно проверить доступ.

Проверка доступа

Нажмите «Проверить доступ» и дождитесь завершения проверки. На вкладке «Подключение» проверьте:

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

После добавления кабинета откройте «Обмен данными» и оставьте включённым «Безопасный режим — ничего не отправлять в Wildberries» на время настройки. Получение данных можно включать отдельно.

Безопасный режим интеграции Wildberries
Этот переключатель блокирует изменения в WB. Перед первичной настройкой включите его. Открыть крупнее ↗

Если команда недоступна или состояние остаётся «Выключена», проверьте права и состояние подключения. Не переходите к отправке данных, пока проверка не завершилась успешно.

Склады и правила остатка

Откройте вкладку «Склады» и нажмите «Загрузить или обновить склады Wildberries». WMS прочитает список складов продавца; эта команда не создаёт новые склады в кабинете WB.

У нужной строки нажмите «Сопоставить» или «Настроить». В разделе «Связь складов» выберите соответствующий физический склад WMS и сохраните настройки.

Выбор соответствующего склада WMS для склада Wildberries
От выбранного склада WMS зависит, откуда брать товар для FBS и рассчитывать доступное количество. Открыть крупнее ↗
Это две разные сущности. Склад продавца WB — направление продаж на площадке. Склад WMS — физическое место хранения вашего товара. Пункт сдачи WB и название склада продавца меняются в кабинете Wildberries.

Затем откройте раздел «Остатки» настроек этого склада:

  • Доля доступного остатка, %: какая часть доступного количества участвует в публикации.
  • Оставить на складе не менее: количество, которое нужно сохранить вне публикуемого остатка.
  • Дополнительный резерв: дополнительное уменьшение после применения процента и ограничений.
  • Использовать сопоставление для расчёта: включение этой связи для расчётов.
  • Только рассчитывать, ничего не отправлять: возможность проверить правила без публикации для этого склада.
Правила публикации остатков склада Wildberries
Учебный расчёт: при доступных 80 шт., доле 100% и запасе 3 шт. к публикации рассчитано 77 шт. Открыть крупнее ↗

Число в примере показывает работу правил, а не фактический остаток в WB. Настройки действуют для выбранного склада. В разделах «Ассортимент» и «Лимит заказов в сутки» можно дополнительно ограничить набор товаров и объём работы.

Результат: нужный склад WB связан со складом WMS, ограничения проверены и сохранены.

Каталог и сопоставление

На вкладке «Обмен данными» включите «Загружать каталог товаров из Wildberries» и сохраните настройки. Затем перейдите в «Товары». Для первого полного чтения используйте «Полностью перечитать каталог»; для последующих изменений — «Загрузить новые и изменённые товары».

Дождитесь завершения операции. Карточка WB может содержать несколько размеров: сопоставление выполняется на уровне конкретного варианта, а не только общего названия товара.

Если товары уже заведены в WMS

Выберите «Поля сопоставления»: штрихкод, артикул продавца, товарную серию и размер. Используйте признаки, которые действительно совпадают в обеих системах. Несколько выбранных признаков должны давать однозначное совпадение. Сохраните настройки и нажмите «Повторно проверить сопоставления».

Правила сопоставления товаров Wildberries с номенклатурой WMS
Выберите признаки сопоставления. Создание новых товаров из WB включается отдельным переключателем. Открыть крупнее ↗

Если номенклатуру нужно создать из WB

Включите «Создавать номенклатуру WMS из Wildberries» и сохраните настройку. Для варианта без связи и без кандидатов WMS может создать отдельный товар. Найденные существующие товары связываются вместо создания дубля; конфликтные варианты требуют проверки.

В таблице разберите состояния «Конфликты», «Есть предложение» и «Не сопоставлено». При ручном сопоставлении проверяйте артикул, штрихкод и размер: размер M и размер L нельзя случайно связать с одним и тем же товаром WMS.

В блоке «Загрузка данных товара из WB» можно выбрать поля для обновления и нажать «Обновить». Выбранные поля существующих товаров WMS будут заменены данными каталога WB — заранее определите, какая система является источником этих данных. Автоматическая синхронизация товаров раз в сутки настраивается отдельно.

Результат: рабочие варианты WB однозначно сопоставлены с товарами WMS, конфликты разобраны.

Остатки и обмен

Сначала убедитесь, что товар принят на склад и привязан к местам хранения. Наличие карточки товара само по себе не означает наличие доступного запаса.

  1. На вкладке «Обмен данными» включите «Рассчитывать остатки для Wildberries» и сохраните настройки.
  2. На вкладке «Остатки» запустите «Рассчитать и сверить остатки».
  3. Сравните рассчитанное количество со значением «Сейчас в WB», проверьте склад, резервы, ограничения и несопоставленные варианты.
  4. Для начала можно ограничить публикацию несколькими артикулами через режим «Только товары из списка» в блоке «Ограничение товаров для остатков».
  5. Когда расчёты проверены, разрешите «Отправлять остатки в Wildberries» и выключите безопасный режим. Проверьте, что выбранный склад не оставлен в режиме «Только рассчитывать».

Отправка возможна только при действующем доступе, нужных правах токена и разрешениях интеграции и склада. Для дальнейшей работы можно включить «Точечно синхронизировать изменившиеся остатки» и «Выполнять суточную фоновую сверку».

Расчёт и публикация — разные действия. После отправки дождитесь успешного результата операции и убедитесь, что количество действительно изменилось в кабинете WB. Кнопку массового обнуления не используйте как обычный шаг первоначального запуска.

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: укажите название подключения, склад, время операции и номер заказа или задания. Токен доступа в сообщение не включайте.

← Все интеграции с маркетплейсами · План запуска склада