Главная → Wildberries → Настройка модуля

Настройка интеграции Wildberries FBS

Пошаговый запуск от нового токена до тестовой выгрузки остатков и получения FBS-заказов. Настраивайте интеграцию именно в указанной последовательности: сначала чтение и проверка, затем небольшой разрешённый перечень товаров, и только после этого — запись в Wildberries.

Менеджер склада Администратор Путь: Интеграции → Wildberries

Почему подключение настраивают по шагам

Wildberries хранит задания продавца, а NWMS организует их физическое исполнение. Связи товаров и складов определяют, какой запас публикуется и где собирается заказ. Поэтому сначала проверяют кабинет и соответствия, затем разрешают обмен.

Например, у продавца два склада с одинаковыми артикулами. Неверная связь может показать покупателю товар другой площадки. Проверка небольшого согласованного набора позволяет заметить ошибку до массовой публикации.

Раздел предназначен менеджеру интеграции. Складскому сотруднику после настройки нужна глава Маркировка WB.

Карта текущего подключения Wildberries

Подключение / Замена токенаОсновные параметры и отдельная безопасная процедура замены секрета. После замены повторно проверяются права, а операции записи не включаются сами.
Склады / Товары / ОстаткиВнешние снимки, подтверждённые сопоставления, параметры публикации и результат последней сверки.
Заказы FBS / Поставки FBSВходящие задания и локальные/удалённые поставки с их составом, QR, коробами и ошибками.
Настройки маркировкиУчёт коробов, проверка физической WB-этикетки, режим предзагрузки буфера и дополнительная пользовательская этикетка.
Обмен даннымиБезопасный режим и отдельные переключатели чтения, расчётов, отправки остатков, статусов, Честного знака, сроков и управления поставками.
История операций / Лог измененийПервая показывает выполнение обмена и ошибки, второй — кто и когда менял настройки подключения.

Над вкладками доступны рабочие переходы: статистика FBS, буфер маркировки, статистика остатков и API-аналитика. Это операционные экраны; они не заменяют настройки подключения.

Что подготовить до начала

  • рабочий кабинет продавца Wildberries;
  • токен продавца с доступом к разделам Контент и Маркетплейс;
  • токен не должен быть «только для чтения», если планируются остатки, маркировка и поставки;
  • магазин WMS, которому принадлежат товары;
  • клиентский склад WMS, с которого будут собираться FBS-заказы;
  • сведения о продавце для проверки принадлежности подключённого кабинета;
  • 5–10 тестовых товаров с подтверждёнными штрихкодами и остатками.

Не начинайте с полного каталога. Для первого реального теста используйте режим «Только товары из списка» и несколько проверенных ШК. Это ограничение применяется к расчёту и отправке остатков, но не отбрасывает входящие FBS-заказы.

1. Создайте подключение

Интеграции → Wildberries → Подключить Wildberries

  1. Введите понятное внутреннее название подключения.
  2. Выберите домен и владельца подключения, если эти поля доступны вашей роли.
  3. Выберите магазин, которому принадлежат товары и будущие заказы. Склады сопоставляются после подключения.
  4. Проверьте режим установки, показанный в форме: он задаётся администратором сервера и определяет допустимый тип токена.
  5. Вставьте токен Wildberries полностью и сохраните подключение.
  6. На открывшейся странице нажмите «Проверить доступ к Wildberries».
  7. Дождитесь статуса «Активно» и убедитесь, что ИНН, тип токена и разрешённые разделы определились верно.
Базовый токен (Base)Используется SaaS-версией в пределах базовых лимитов WB. Сервисный секрет для него не нужен, и NWMS не добавляет сервисную разметку к запросу.
Сервисный токенИспользуется только после отдельного оформления сервисного доступа/платных лимитов. Сервисный секрет вводится и применяется явно.
Персональный токенИспользуется on-premise-решением. Сервисная разметка также не требуется.
Состояние подключенияАктивно означает, что кабинет подтверждён. «Черновик» — проверка ещё не завершена.
Разрешённые разделыДля FBS нужны как минимум «Контент» и «Маркетплейс». Дополнительные разделы используются отдельными операциями.
Уровень доступа«Только чтение» годится для загрузки, но блокирует остатки, коды маркировки, поставки и передачу в доставку.
Замена токенаПосле замены все операции записи автоматически выключаются. Повторно проверьте доступ и включите нужные разрешения осознанно.
Фрагмент новой формы WB: режим установки задан сервером, поле токена пустое. На вашем сервере режим может отличаться.
Фрагмент новой формы WB: режим установки задан сервером, поле токена пустое. На вашем сервере режим может отличаться.

2. Загрузите и сопоставьте склады

Откройте вкладку «Склады».

  1. Нажмите «Загрузить или обновить склады Wildberries».
  2. Для каждого рабочего склада WB нажмите «Сопоставить».
  3. Выберите клиентский склад WMS, чей товар должен публиковаться и отбираться на соответствующем ФФ-складе.
  4. Установите процент публикации и страховой резерв в штуках.
  5. Оставьте безопасный режим склада включённым на время проверки.
  6. Включите сопоставление и сохраните.

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

Не сопоставляйте один склад WB со случайным складом WMS «для теста». От этого зависят и остатки, и склад создаваемого FBS-заказа.

3. Загрузите каталог и проверьте связи товаров

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

4. Ограничьте товары для пилотного запуска

Вкладка «Обмен данными», блок «Ограничение товаров для остатков».

Все сопоставленные товарыВ расчёте и публикации участвует весь подтверждённый каталог. Для первого теста не рекомендуется.
Только товары из спискаРазрешающий перечень. Любой товар вне списка исключён из расчёта и отправки.
Все, кроме товаров из спискаЗапрещающий перечень. Подходит для точечного отключения проблемных товаров.

Какие значения можно вставлять

По одному значению в строке, либо через запятую или точку с запятой. Сравнение всегда точное.

  • штрихкод/ШК Wildberries, включая любой ШК размера;
  • артикул продавца Wildberries;
  • nmID Wildberries;
  • штрихкод товара WMS;
  • артикул, SKU или внешний ID товара WMS.

Можно использовать 13-значные товарные штрихкоды. Если такой код сохранён у варианта WB либо в штрихкодах сопоставленного товара WMS, он найдёт товар и пропустит его через разрешающий перечень.

Если выбран режим «Только товары из списка», а поле пустое, не пройдёт ни один товар. После изменения перечня обязательно запустите новый безопасный расчёт остатков.

5. Проверьте и выгрузите остатки

Разрешённый перечень→ Безопасный расчёт→ Проверка разницы→ Реальная отправка
  1. Включите «Рассчитывать остатки для Wildberries».
  2. Оставьте главный и складские безопасные режимы включёнными.
  3. На вкладке «Остатки» нажмите «Запустить безопасную проверку».
  4. Сверьте по каждой строке: остаток WMS, процент, резерв, рассчитанное значение, текущий остаток WB и разницу.
  5. Исправьте сопоставления или параметры, если рассчитанное количество неожиданно.
  6. Включите «Отправлять остатки в Wildberries».
  7. Выключите безопасный режим только у тестовых складов и затем главный безопасный режим интеграции.
  8. Сохраните настройки и запустите выгрузку остатков.
  9. Проверьте завершение операции во вкладке «История операций» и фактическое количество в кабинете WB.

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

6. Включите получение FBS-заказов

  1. Включите «Получать новые FBS-заказы» и сохраните.
  2. Убедитесь, что автоматически созданная служба доставки WMS для WB доступна складу.
  3. На вкладке «Заказы FBS» нажмите «Получить новые заказы и сверить статусы» для первого теста.
  4. Проверьте, что тестовое задание получило товар, склад и локальный заказ WMS.
  5. В дальнейшем новые задания читаются по включённому расписанию обмена. Проверяйте время последнего успешного запуска в своём подключении.

Одно задание Wildberries создаёт один однотоварный заказ WMS. Если товар или склад не определены, запись остаётся в явном состоянии «Нужно сопоставить», а не создаёт случайный товар.

Если товар или склад ещё не сопоставлены

  1. Откройте товары заказа. Вместо пустой строки отображается фантомная позиция с nmID, артикулом продавца, ШК, размером, ценой и изображением WB.
  2. Нажмите сопоставление прямо в заказе и выберите существующий товар WMS. Фантом не создаёт карточку каталога и не меняет остаток.
  3. Если указано, что не найден склад, сопоставьте внешний склад WB на вкладке «Склады».
  4. После любого сопоставления NWMS автоматически повторяет обработку задания. Проверьте новый статус и локальный заказ.
  5. Откройте лог заказа: в нём фиксируются импорт, причина ожидания, сопоставление, повторная обработка и итог.

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

Дальнейшая обработка описана в двух сценариях:

Маркировка WB

Единое рабочее место для позаказных и батч-заказов: скан товара или Честного знака, подбор задания, этикетка и журнал.

Обратная батч-маркировка

Много однотоварных заказов собираются одной агрегированной волной и распределяются по скану товара.

7. Разрешите маркировку и поставки для реальной работы

Вкладка «Обмен данными», блок «Что разрешено отправлять».

Передавать коды маркировкиНужно для товаров с Честным знаком/DataMatrix.
Управлять поставками FBSРазрешает системе автоматически создавать технические поставки, добавлять задания и работать с коробами.
Передать поставку в доставкуОтдельное разрешение на необратимую финальную передачу при закрытии накладной.
Разрешить отмену FBS-заданийНужно только если сотрудники должны отменять задания со стороны продавца из WMS.

Для автоматической печати выберите PNG или SVG. Доступные размеры этикетки задания: 58 × 40 или 40 × 30 мм. ZPL не используется в автоматической подготовке FBS.

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

Настройте маркировку и буфер

Вкладка «Настройки маркировки» влияет непосредственно на работу оператора.

Учёт коробовВключайте, если пункт сдачи/схема WB требует распределять задания по коробам и печатать QR короба.
Проверять WB-этикеткуПосле печати оператор сканирует физическую этикетку и подтверждает, что на посылке именно код текущего задания. Без этой опции успешный скан может завершать заказ автоматически.
Предзагрузка буфераВыключена, ручная, при резерве или после сборки. Чем раньше предзагрузка, тем быстрее рабочее место, но тем важнее контроль отмен и актуальности задания.
Дополнительная этикеткаПечатается по пользовательскому шаблону с разрешёнными тегами заказа, товара, клиента и поставки. Проверьте тестовый макет до массовой печати.

Работа оператора и аналитика описаны в инструкции «Маркировка WB».

Как работают поставки FBS

  1. Локальный черновик поставки не изменяет кабинет Wildberries и может использоваться для проверки состава.
  2. Явная синхронизация создаёт/находит поставку WB и переводит совместимые задания в состояние «На сборке».
  3. Система не смешивает несовместимые задания: учитываются склад/офис WB, тип груза, crossborder и B2B/B2C.
  4. При учёте коробов QR короба создаётся и хранится отдельно; QR поставки печатается для всей удалённой поставки.
  5. Перед закрытием накладной проверьте число заданий, отмены, обязательные коды, QR и последнюю подтверждённую операцию WB.

Не добавляйте и не удаляйте задания вручную в кабинете WB параллельно с работой NWMS. Сначала выполните сверку поставки и разберите конфликт в истории операций.

Контрольная проверка перед рабочим запуском

ПодключениеСтатус «Активно», ИНН совпадает, токен не только для чтения.
СкладыКаждый используемый склад WB сопоставлен с правильным складом WMS.
ТоварыТестовые варианты подтверждённо сопоставлены; конфликтов нет.
ФильтрДля пилота выбран режим «Только товары из списка», ШК вставлены без лишних символов.
ОстаткиБезопасный расчёт проверен; процент и резерв дают ожидаемый результат.
ЗаказыПолучение FBS-заказов включено; тестовый заказ создан и зарезервирован.
МаркировкаВключены коды маркировки и управление поставками; формат этикетки PNG/SVG.
ОтгрузкаФинальная передача поставки включается только перед реальным закрытием накладной.

Частые ошибки

Токен только для чтенияСоздайте новый токен с правом записи и замените его. После замены повторно включите операции записи.
Проверка доступа не пройденаПроверьте срок токена, разделы «Контент»/«Маркетплейс» и совпадение ИНН.
Base token отклоняетсяНе добавляйте сервисный секрет. Повторно проверьте сам токен, его категории/режим чтения, срок, ИНН и доступность нужного метода WB.
Операция «Ожидает запуска»Обратитесь к администратору сервера: должны работать Horizon, подключение очереди WB и очереди catalog/orders/stock.
Товар не попал в остаткиПроверьте точное значение идентификатора, подтверждённое сопоставление, режим списка и включённое сопоставление склада.
Товар попал неожиданноОдин из его идентификаторов совпал со списком: проверьте ШК WB и WMS, артикулы, SKU, внешний ID и nmID.
«Выключите главный безопасный режим»Сначала проверьте расчёт, затем выключите безопасный режим склада и главный предохранитель интеграции.
Заказ требует сопоставленияСопоставьте фантомную позицию прямо в заказе и внешний склад на вкладке «Склады». Повторная обработка запускается автоматически.
В фильтре несколько служб WBАктуальна служба текущего подключения. Осиротевшие дубликаты отключаются, но не удаляются, чтобы старые заказы сохранили историю.

Точное сопоставление и отозванный токен

Автоматическое сопоставление использует выбранные поля как точные ключи. Единственный точный результат может быть подтверждён автоматически. Неоднозначные или противоречивые результаты остаются для ручной проверки: не выбирайте первый похожий товар.

  1. Выберите поля, которые действительно совпадают между каталогами.
  2. Проверьте артикул/SKU/штрихкод на одном известном товаре.
  3. Просмотрите неоднозначные результаты и сопоставьте вручную только после сверки владельца и упаковки.
  4. После сопоставления проверьте нужный склад и свободный остаток до пилотной публикации.

При явном отзыве токена Wildberries кабинет отключается с причиной. Ответственный за интеграцию создаёт замену в WB, сохраняет её в WMS и проверяет подключение. Обычная ошибка авторизации не всегда означает отзыв. Ключи не включайте в обращения и скриншоты.

Как проверить результат и продолжить

Подключение проверено, склады и товары сопоставлены, расчёт понятен, отправленное значение подтверждено в WB, а тестовый заказ связан с правильным товаром.

Если что-то пошло не так

СитуацияЧто сделать
Ключ заменёнПовторно проверьте доступ и нужные разрешения записи.
Остаток не совпалСверьте размещение, обязательства, процент, резерв и время удалённой проверки.