1. Введение

Система автоматически переносит заказы из Wildberries в МойСклад, создаёт отгрузки и поставки, а также синхронизирует остатки товаров. Всё управляется через веб-интерфейс.

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

2. Возможности и тарифы

Возможности интеграции

• Автоматическое создание заказов в МойСклад – заказы из Wildberries автоматически переносятся в МойСклад с полной детализацией.
• Автоотгрузка в МойСклад – после создания заказа автоматически формируется реализация (отгрузка).
• Автоотгрузка в Wildberries – заказы автоматически добавляются в поставки (сборочные задания) и отправляются в доставку.
• Синхронизация остатков – остатки товаров автоматически передаются на склады продавца Wildberries .
• Группировка заказов в поставки – поддержка режимов: каждый заказ отдельно, группировка по N заказов, одна поставка в день.
• Сопоставление складов – возможность привязать склады МС к конкретным складам WB.
• Суммирование остатков – автоматический выбор склада МС с ненулевым остатком для резервирования.
• Поддержка нескольких аккаунтов WB – работа с несколькими магазинами в одном интерфейсе.
• Автоматическое получение стикеров – стикеры загружаются из WB и прикрепляются к заказам в МС.
• Экспорт данных – выгрузка товаров и заказов в Excel.

Тарифы

3. Настройка API и аккаунтов

3.1. Инициализация атрибутов МойСклад

После установки приложения через магазин МойСклад токен доступа сохраняется автоматически. Для корректной работы интеграции необходимо создать в МойСклад специальные атрибуты заказов и отгрузок, а также загрузить справочники (организации, контрагенты, проекты, каналы продаж).

Атрибуты, которые будут созданы в МойСклад:

• «Этикетка WB» (тип «Ссылка») – сюда будет записываться ссылка на скачанный стикер заказа.
• «Комментарий покупателя WB» (тип «Строка») – комментарий из заказа Wildberries.
• «Номер заказа WB» (тип «Строка») – ID заказа из Wildberries.

⚠️ Перед нажатием кнопки «Обновить атрибуты» убедитесь, что в вашем МойСклад присутствуют все необходимые статусы для заказов и отгрузок.

Статусы заказа

Необходимые статусы: Новый, На сборке, Отгружен, Отменен. Они находятся в разделе «Настройки → Статусы».

Статусы заказа (часть 1)

Статусы заказа (часть 2)

Статусы отгрузки

Необходимые статусы: Новая, Собирается, Отгружено.

Статусы отгрузки (часть 1)

Статусы отгрузки (часть 2)

Если каких-то статусов нет, создайте их вручную в настройках МойСклад до нажатия кнопки «Обновить атрибуты».

Как выполнить инициализацию:

1. Перейдите в раздел «Настройки API» (меню слева).
2. В блоке «Аккаунты Wildberries» нажмите кнопку «Обновить атрибуты».
3. Дождитесь уведомления об успешном завершении.

3.2. Добавление аккаунта Wildberries

Рекомендация: перед добавлением аккаунта WB убедитесь, что вы выполнили шаг 3.1 (нажали «Обновить атрибуты»).

В блоке «Аккаунты Wildberries» заполните:

• Имя продавца – любое название для вашего удобства (например, «Магазин Одежды»).
• Токен Wildberries – API-токен, полученный в личном кабинете WB.

Нажмите «Добавить аккаунт». Если у вас несколько магазинов, повторите для каждого. Количество аккаунтов ограничено тарифом.

4. Настройка компании

Для каждого аккаунта WB перейдите в «Настройки → Компания».

Поля для заполнения:

• Организация продавца – выберите вашу организацию из списка МойСклад.
• Канал продаж – опционально, можно выбрать «Wildberries» или оставить пустым.
• Контрагент покупателя – выберите контрагента, который будет покупателем в заказе.
• Проект – опционально, для группировки заказов по проектам.

Нажмите «Сохранить».

5. Настройка заказов

Перейдите в «Настройки → Заказы» для каждого аккаунта WB.

5.1. Основные опции

• Автосборка заказа в МС – включает автоматическое создание заказа покупателя в МойСклад. Заказы, пришедшие до включения, созданы не будут (чтобы не дублировать ручные).
• Резервировать остатки – при создании заказа резервируется товар на складе.
• Снимать резерв при отгрузке – резерв снимается автоматически после отгрузки.
• Автоотгрузка МойСклад – после создания заказа сразу формируется отгрузка (реализация).
• Учитывать НДС – если включено, укажите ставку НДС.

5.2. Выбор цены для заказа

• МойСклад – цена закупки или продажи (выберите поле).
• Wildberries – цена из заказа (с учётом скидок, сумма к оплате или цена продавца).

5.3. Автоотгрузка Wildberries (поставки)

Включите опцию «Автоотгрузка Wildberries» для автоматического создания поставок (сборочных заданий).

Режимы поставок:

• На каждый заказ – для каждого заказа создаётся отдельная поставка и сразу отправляется.
• Группировать по N заказов – заказы накапливаются до указанного количества, затем поставка отправляется.
  💡 Заказы с разных складов WB не могут попасть в одну поставку – система автоматически создаёт отдельные поставки для каждого склада.
• Одна поставка в день – все заказы за день собираются в одну поставку (отдельно для каждого склада). Поставка отправляется в указанное время (МСК).

6. Настройка складов

Перейдите в «Настройки → Склады». Здесь вы определяете, с каких складов МС списывать товары и на какой склад WB отправлять остатки.

6.1. Суммирование остатков (гибкий подход)

Включите «Суммирование остатков».

• Приоритетный склад МС – основной склад, проверяется в первую очередь.
• Дополнительные склады МС – используются, если на приоритетном складе нет остатка.
• Выбрать склад WB – склад WB, на который отправляются остатки (только для синхронизации).

6.2. Сопоставление складов один к одному (жёсткая привязка)

Включите «Сопоставление складов один к одному».

• Для каждого склада МС выберите соответствующий склад WB.
• Это создаёт маппинг: склад МС ↔ склад WB.

7. Структура

В интерфейсе интеграции есть несколько ключевых таблиц, каждая из которых отображает определённые данные. Ниже описано, что означают столбцы и как работать с каждой таблицей.

7.1. Таблица «Товары МойСклад»

Отображает товары из вашего МойСклад для выбранного аккаунта WB. Столбцы:

• Чекбокс – для выбора товаров (используется для экспорта).
• Название – наименование товара в МС.
• ID товара – внутренний идентификатор МС.
• Артикул – артикул товара (используется для синхронизации).
• Штрихкоды – все штрихкоды товара.
• Код – код товара в МС.
• Закуп.цена – закупочная цена.
• Цена продажи – розничная цена.
• Остатки – общий остаток на всех складах МС.
• Синхронизация – поле для поиска и привязки товара WB.

7.2. Таблица «Товары Wildberries»

Отображает номенклатуру из выбранного аккаунта Wildberries. Столбцы:

• Чекбокс – для выбора товаров (экспорт).
• Бренд – бренд товара.
• Предмет – категория товара.
• Артикул продавца – ваш артикул (vendor code).
• Модель – модель товара.
• Артикул (nmID) – внутренний номер товара в WB.
• Баркод – штрихкод.
• Размер – размерная сетка.
• Код размера – код размера (chrt_id).
• Цена – цена товара.
• Цена со скидкой – цена с учётом скидки.
• Скидка % – размер скидки.
• Синхронизирован – есть ли связь с товаром МС (да/нет).

7.3. Таблица «Синхронизация»

Показывает все созданные связи между товарами МС и WB. Подробно описана в разделе «Синхронизация товаров» (раздел 8).

В этой таблице вы управляете отправкой остатков, выбираете режим FBS/FBO, устанавливаете минимальный остаток и можете удалить связь.

7.4. Таблица «Заказы»

Отображает все заказы из Wildberries для выбранного аккаунта. Подробно описана в разделе «Работа с заказами» (раздел 9).

7.5. Экспорт данных

В каждой таблице (кроме синхронизации) есть кнопка «Экспорт». Она позволяет выгрузить данные в Excel.

• Экспорт всех данных – просто нажмите кнопку «Экспорт», и выгрузится вся текущая таблица (с учётом поиска и фильтрации).
• Экспорт выбранных строк – отметьте нужные строки с помощью чекбоксов в первом столбце, затем нажмите «Экспорт» – будут выгружены только отмеченные записи.

8. Синхронизация товаров

В этом разделе вы связываете товары МойСклад с товарами Wildberries и управляете передачей остатков. Для каждого аккаунта WB доступна отдельная таблица синхронизации.

8.1. Как создать связь товаров

1. Перейдите в раздел «Товары МойСклад» для нужного аккаунта WB.
2. В верхней таблице («Товары МойСклад») найдите нужный товар (поиск по названию, артикулу или коду).
3. В последнем столбце таблицы («Синхронизация») есть поле ввода. Начните вводить артикул продавца или артикул из Wildberries – система предложит подходящие варианты.
4. Выберите нужный товар – связь будет создана, и он появится в нижней таблице («Синхронизация»).

8.2. Управление синхронизированными товарами

В нижней таблице отображаются все созданные связи. Для каждого товара доступны следующие настройки (столбцы):

🔹 Столбец «Отправлять остатки»

• Включите – остатки этого товара будут передаваться на Wildberries согласно выбранному режиму.
• Выключите – остатки не передаются (синхронизация для товара отключена).

🔹 Столбец «FBO / FBS»

Здесь вы выбираете, как именно будут отправляться остатки на Wildberries. Активна только одна кнопка.

🟢 Режим FBS (кнопка «FBS»)

• Каждую синхронизацию система отправляет на Wildberries текущий остаток товара с вашего склада МойСклад в соответствии с выбранном порядком в разделе Настройки - Склады.
• Остатки отправляются всегда, без каких-либо ограничений.
• Этот режим подходит, если вы храните товар на своём складе и хотите, чтобы остатки на Wildberries всегда совпадали с вашими фактическими остатками.

🔵 Режим FBO (кнопка «FBO»)

• Каждую синхронизацию система проверяет текущий остаток товара на складе Wildberries.
• Если минимальный остаток выключен (или не задан):
• Если остаток на складе WB больше 0 (на складе WB есть товар) – система отправляет остаток равный 0 для склада FBS по выбранному товару.
• Если остаток на складе WB равен 0 (склад WB пуст) – система отправляет остаток для склада FBS в соответствии с выбранным складом в разделе Настройки - Склады.
• Если минимальный остаток включён и задано пороговое значение N:
• Если остаток на складе WB больше N – система отправляет 0.
• Если остаток на складе WB меньше либо равен N – система отправляет Остаток с соответствующего привязанного склада МС на склад FBS WB .
• Таким образом, система не позволяет превысить нужный уровень остатков на складе Wildberries, отправляя 0, когда запас на WB уже достаточен. Это помогает избежать переполнения склада WB и лишних затрат на хранение.
• FBO доступен только на тарифе «Бизнес». На других тарифах кнопка FBO неактивна.

🔹 Столбец «Минимальный остаток» (только для FBO)

• Включите чекбокс и введите число (порог N).
• Выключите – порог считается равным 0, и отправка остатка происходит только когда Остаток WB FBS == 0.

8.3. Примеры работы

8.4. Удаление синхронизированных товаров

Если связь между товарами больше не нужна, её можно удалить.

1. В таблице «Синхронизация» отметьте нужные товары (поставьте галочки в первом столбце).
2. В правом верхнем углу таблицы появится кнопка «Удалить выбранные».
3. Нажмите её, чтобы удалить все отмеченные связи.

8.5. Важные замечания

• Режимы FBS и FBO влияют только на синхронизацию остатков. Обработка заказов (создание заказов в МС, резервирование, отгрузки) происходит одинаково, независимо от выбранного режима.
• Списание заказов (сначала со склада WB, потом со склада продавца) настраивается в личном кабинете Wildberries, а не в нашей системе.
• Лимит товаров с отправкой остатков определяется вашим тарифом (см. раздел «Возможности и тарифы»).

8.6. Автосинхронизация и массовое управление настройками

Автосинхронизация товаров Wildberries

В таблице «Товары Wildberries» есть кнопка «Автосинхронизация». Она позволяет автоматически создать связи между всеми товарами Wildberries и товарами МойСклад, используя один из двух способов сопоставления:

• По артикулу – система ищет товар МС с таким же артикулом, как у товара WB.
  ⚠️ Если в МойСклад есть несколько товаров с одинаковым артикулом, автосинхронизация по артикулу не сможет определить, какой именно товар нужно привязать – такие товары будут пропущены (не синхронизированы). Для них потребуется ручная синхронизация через таблицу «Товары МойСклад».
• По штрихкоду – система ищет товар МС с таким же штрихкодом, как у товара WB. Если штрихкод уникален в МС, связь будет создана. Если штрихкод повторяется у нескольких товаров МС, такие товары также пропускаются. Если у товара несколько штрихкодов, то проверяется каждый и синхронизация происходит при первом совпадении.

После выбора способа нажмите кнопку в диалоге – система выполнит синхронизацию и покажет результат (сколько товаров синхронизировано, сколько пропущено).

Массовое управление настройками синхронизированных товаров

В таблице «Синхронизация» в заголовках столбцов «Отправлять остатки», «FBO/FBS» и «Минимальный остаток» есть стрелки ▼. При нажатии на них открывается небольшое меню, позволяющее применить соответствующее действие ко всем синхронизированным товарам сразу.

• Отправлять остатки – в меню можно включить или выключить отправку остатков для всех товаров. При включении система проверяет, не превышен ли лимит товаров с отправкой остатков (согласно вашему тарифу). Если лимит будет превышен, операция не выполнится, и вы увидите сообщение.
• FBO/FBS – в меню можно выбрать режим FBS или FBO для всех товаров. Если ваш тариф не поддерживает FBO, кнопка FBO будет неактивна.
• Минимальный остаток – в меню можно ввести число (порог N) и нажать «Применить». Тогда для всех товаров будет включена опция «Минимальный остаток» с указанным порогом. Это работает только для товаров в режиме FBO.

Все массовые действия применяются мгновенно и сопровождаются подтверждением. После выполнения таблица автоматически обновляется.

9. Работа с заказами

Все заказы из Wildberries для выбранного аккаунта отображаются в таблице «Заказы». В этом разделе вы можете отслеживать все этапы обработки заказов – от получения до создания в МойСклад и поставок в Wildberries.

9.1. Откуда берутся заказы

Заказы автоматически подгружаются из Wildberries через API. Система запрашивает новые заказы и обновляет статусы уже существующих.

• Частота обновления: каждую минуту.
• Принцип: при каждом обновлении система загружает заказы со статусом «новые» и обновляет статусы для всех активных заказов (не отменённых и не завершённых).
• Отбор: загружаются только заказы, у которых артикул WB синхронизирован с товаром в МойСклад. Если товар не синхронизирован, заказ не будет отображаться в таблице «Заказы».

9.2. Статусы заказов

В таблице «Заказы» отображаются два основных статуса:

• Статус продавца – статус в системе продавца. Возможные значения:
  • Новое сборочное задание – заказ поступил, ожидает обработки.
  • На сборке – заказ передан в сборку (в МС создан заказ, отгрузка).
  • В доставке – заказ отправлен (отгрузка создана, поставка отправлена).
  • Отменено продавцом – продавец отменил заказ.
  • Отменено перевозчиком – заказ отменён перевозчиком.
• Статус WB – статус из Wildberries. Возможные значения:
  • Сборочное задание в работе – заказ принят, ожидает сборки.
  • Сборочное задание отсортировано – собран и упакован.
  • Заказ получен покупателем – доставлен.
  • Отмена сборочного задания – отменён.
  • Покупатель отменил заказ при получении – отказ от товара.
  • Отмена заказа по причине брака – брак.
  • Заказ прибыл на ПВЗ – ожидает в пункте выдачи.
  • Передано в доставку в стране продавца – передано перевозчику.
  • Отправлено на склад службы доставки – на складе перевозчика.
  • Отменено перевозчиком – отмена перевозчиком.
  • Доставка отложена – перенесена.

Оба статуса обновляются автоматически при каждом обновлении заказов.

9.3. Синхронизация статусов с МойСклад

Если для заказа включена «Автосборка заказа в МС» (раздел 5.1), то при поступлении нового заказа система автоматически создаёт заказ покупателя в МойСклад, а затем (если включена автоотгрузка) – отгрузку. После этого статус в МС будет изменяться в соответствии с изменениями статуса заказа в Wildberries.

• При изменении статуса WB (например, с «Новое сборочное задание» на «На сборке») система обновляет соответствующий статус в МойСклад (заказ и отгрузка).
• Синхронизация происходит автоматически в рамках ежеминутного обновления заказов.
• Если автосборка выключена, заказ остаётся в таблице «Заказы», но не создаётся в МС.

9.4. Что отображается в таблице «Заказы»

Кроме статусов, в таблице доступна подробная информация по каждому заказу:

• ID заказа – номер заказа в WB.
• ID транзакции и Уникальный ID заказа – технические идентификаторы.
• Дата создания – дата и время заказа (время отображается по МСК).
• Планируемая дата доставки и Рекомендуемая дата доставки СГТ.
• Артикул, Артикул продавца, Код размер, Штрихкод – данные о товаре.
• Цены (с учётом скидок, сумма к оплате, цена продавца).
• Тип доставки – fbs / fbo.
• Адрес, ID склада продавца, комментарий и другие поля.
• Статусы (продавца и WB).
• Цена приёмки – используется при FBO.
• ID заказа в МС – ссылка на созданный заказ в МойСклад (если создан).
• Номер заказа покупателя МС – номер заказа в МС.
• Номер отгрузки МС – номер отгрузки (если создана).
• Номер поставки WB – номер поставки (если заказ добавлен в поставку).

9.5. Экспорт заказов

Вы можете выгрузить заказы в Excel:

• Экспорт всех заказов – нажмите кнопку «Экспорт».
• Экспорт выбранных заказов – отметьте нужные строки чекбоксами и нажмите «Экспорт».

10. Поставки Wildberries

При включённой автоотгрузке WB система автоматически создаёт поставки (сборочные задания) и добавляет в них заказы в соответствии с выбранным режимом. Система НЕ отправляет поставки в доставку автоматически – это действие остаётся за пользователем. Вы должны самостоятельно перейти в личный кабинет Wildberries и отправить поставку в доставку.

Доступны три режима управления поставками:

• На каждый заказ – для каждого заказа создаётся отдельная поставка. Заказ добавляется в неё, и поставка остаётся в статусе «активна» до ручной отправки.
• Группировать по N заказов – заказы накапливаются в одной поставке до указанного количества N. Когда набирается N заказов, поставка считается заполненной, и новые заказы идут в новую поставку.
  ⚠️ Важно: Не отправляйте поставку вручную до её заполнения. Если отправить поставку раньше, оставшиеся заказы не смогут быть добавлены в эту поставку (WB вернёт ошибку) и пойдут в новую, что нарушит группировку.
• Одна поставка в день – все заказы за день собираются в одну поставку. Поставка создаётся для каждого дня отдельно.
  ⚠️ Критическое предупреждение для режима «Одна поставка в день»: Не отправляйте поставку в доставку до наступления времени, указанного в настройках как «Время отправки поставки (МСК)». Если вы отправите поставку раньше этого времени, то последующие заказы, поступившие в этот день до времени отправки, не смогут попасть в эту поставку (она уже будет отправлена) и система создаст новую поставку для того же дня, что нарушит логику «одна поставка в день». Дождитесь указанного времени, чтобы поставка считалась собранной за день, и только после этого отправляйте её вручную.
  💡 Рекомендация: установите время отправки, например, на конец рабочего дня (19:00). После этого времени все заказы за текущий день уже собраны, и вы можете безопасно отправить поставку вручную. Заказы, поступившие после этого времени, автоматически пойдут в поставку на следующий день.

11. Частые проблемы и решения

❌ Заказ не создаётся в МС, «Не заполнены настройки компании»

Причина: не заполнена организация или контрагент в настройках компании.

Решение: перейдите в «Настройки → Компания» и заполните оба поля.

❌ Заказ не создаётся, «Нет подходящего склада»

Причина: не настроены склады либо на всех указанных складах нет остатка.

Решение: настройте склады в разделе «Склады»; проверьте наличие остатков.

❌ Поставка WB не создаётся, ошибка 409 Conflict

Причина: в одну поставку пытаются добавить заказы с разных складов WB.

Решение: используйте режимы группировки или ежедневной поставки – они автоматически разделяют заказы по складам.

❌ Старые заказы не создаются после включения автосборки

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

Решение: создайте их вручную или проигнорируйте. Если нужно автоматически – удалите из МС и дайте системе пересоздать (рискованно).