Интеграция с Wildberries
Краткое описание
Модуль синхронизирует товары, цены, остатки и изображения с Wildberries.
Для чего нужен
- выгружать карточки товаров на WB;
- поддерживать актуальные цены и остатки;
- сопоставлять категории и характеристики.
Основные возможности
- Карты соответствия категорий и характеристик WB.
- Выгрузка карточек, цен, скидок и изображений.
- Синхронизация остатков по складам.
- Логи ошибок выгрузки.
Как работает
- При установке создаёт таблицы для категорий, характеристик и складов WB.
- При обновлении товара формирует данные и отправляет в WB API.
- Дополнительно обновляет цены, изображения и остатки.
Где находится в админке
- Маркетинг → Синхронизация (
sync_data.update) — сопоставления и выгрузка. - Товары → Редактирование товара — флаг выгрузки.
Примечания
- Требуется API‑ключ WB.
- Подробная инструкция — в
INSTRUCTION.md.
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Владельцам
- English
- Русский
- 4.18.X
- 4.17.X
- 4.16.X
После скачивания модуля, его установка производится штатными средствами CS-Cart на странице Панель администратора → Модули → Управление модулями → Загрузить и установить модуль (+).
Для версии CS-Cart 4.13.1 и выше Панель администратора → Модули → Управление модулями → Кнопка Шестеренка → Ручная установка.

Общие настройки синхронизации
Для доступа к настройкам синхронизации, после установки модуля необходимо открыть раздел Администрирование → Синхронизация данных → MS: Интеграция с Wildberries.

В вкладке Общие находятся основные настройки синхронизации;
-
API-ключ (токен)
В данное поле необходимо ввести токен созданный в личном кабинете Wildberries

Токен в личном кабинете Wildberries создается в разделе Настройки → Доступ к API → Создать новый токен

-
Заполните поле Имя токена;
-
Отметьте категории Контент, Маркетплейс, Цены и скидки;

-
Нажмите Создать токен.
-
Созданный токен необходимо вставить в поле API-ключ (токен) в настройках синхронизации;
-
Нажмите Сохранить.
-
-
Выгружать в WB только новые
Если данный чекбокс отмечен, при изменении и сохранении товара в CS-Cart будет происходить проверка наличия данного товара в Wildberries, если данный товар уже существует, то повторной загрузки или обновления не будет происходить.
- Выводить уведомления о статусе выгрузки
Если данный чекбокс отмечен, при выгрузке товара в Wildberries будут отображаться уведомления о статусе выгрузки.
- Пароль для cron и команда для cron
Использование команды для планировщика задач позволит автоматически обновлять цены и остатки товаров в Wildberries, для товаров у которых отмечен чекбокс Выгружать в WB.
В вкладке Категории находятся настройки сопоставления категорий CS-Cart и Wildberries;
-
Нажмите Обновить категории;

-
Выберите категорию или подкатегорию в которой находятся товары, которую необходимо сопоставить с категорией Wildberries;

-
Напротив выбранной категории CS-Cart необходимо выбрать требуемую категорию из списка дочерних категорий Wildberries;

-
Нажмите Сохранить после сопоставления категорий.
В вкладке Характеристики находятся настройки сопоставления характеристик товаров CS-Cart и Wildberries;

-
Штрих код;
В данном поле можно сопоставить Штрих код Wildberries с характеристикой CS-Cart
Если данное поле оставить пустым, при выгрузке товара в Wildberries штрих код будет сгенерирован системой Wildberries автоматически.
-
Габариты товара (ДxШxВ);
В данном поле можно сопоставить Габариты товара Wildberries с характеристикой CS-Cart
Если данное поле оставить пустым, при выгрузке будут использоваться габариты из вкладки Параметры доставки в карточке товара CS-Cart.
-
Миллиметров в заданной единице габаритов;
Данное поле актуально если габариты в CS-Cart измеряются не в см. Если габариты измеряются в мм, то в данном поле нужно ввести “1”, в этом случае произойдет пересчет в см так как Wildberries ведет учет габарит в см.
-
Вес с упаковкой;
В данном поле можно сопоставить Вес товара Wildberries с характеристикой CS-Cart
Если данное поле оставить пустым, при выгрузке будут использоваться вес из вкладки Параметры доставки в карточке товара CS-Cart.
-
Граммов в заданной единице веса;
Данное поле актуально если вес в CS-Cart измеряются не в кг. Если вес измеряются в гр, то в данном поле нужно ввести “1”, в этом случае произойдет пересчет в кг так как Wildberries ведет учет габарит в кг.
-
Обновить характеристики;
Данную кнопку следует активировать, если в вкладке Категории были проведены новые сопоставления, и необходимо загрузить обновленные данные для дальнейшего сопоставления характеристик на платформе Wildberries.
-
В таблице ниже, слева отображаются характеристики Wildberries, справа список характеристик CS-Cart с которыми можно провести сопоставления.

В вкладке Ценообразование находятся настройки цен и налогов для сопоставления с Wildberries;

-
Использовать цену для группы пользователей;
Данная функция позволяет выбирать, какие цены из системы CS-Cart использовать при выгрузке товаров в Wildberries
-
Надбавка;
Данная функция позволяет вводить процентное значение, которое будет применено в качестве надбавки к ценам товаров при их выгрузке на платформу Wildberries.
-
Налоги.
Данная функция позволяет выбрать ставку НДС при выгрузке товаров в Wildberries.
В вкладке Склады предусмотрена настройка выбора склада по умолчанию;

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

Если изображение в карточке CS-Cart не соответствует указанным параметрам, автоматически будет выполнена конвертация изображения.
Локальные настройки товара
Перейдите в раздел Товары → Товары → Откройте товар для настройки → Перейдите во вкладку Модули → Найдите блок MS: Интеграция с Wildberries.

-
Выгружать в WB;
Если данный чекбокс отмечен, то при сохранении товара в CS-Cart, будет происходить выгрузка и обновление товара в Wildberries
Если в настройках синхронизации отмечен чекбокс Выгружать в WB только новые, то чекбокс в локальных настройках товара будет игнорироваться.
-
Обновить товар в WB.
При нажатии данной кнопки, происходит принудительная выгрузка и обновление товара в Wildberries.
Игнорируются чекбоксы Выгружать в WB и Выгружать в WB только новые.
Через обновление товаров в CS-Cart:
-
Открыть раздел Товары → Товары;
-
Выберите необходимые товары;
-
Нажмите Редактировать выбранные;

-
Выбрать поле для редактирования;

-
Нажать Редактировать выбранные;
-
Ввести новые значения для выбранного поля; Значение Выгружать в WB
Y - Да
N - Нет

-
Нажать Сохранить.
Через экспорт импорт товаров:
-
Открыть раздел Администрирование → Экспорт данных → Товары;
-
Переместить из списка доступных полей в экспортируемые пол Выгружать в WB. Данное поле отобразится в табличном файле для редактирования;

-
Нажать Экспорт;
-
В табличном файле внести необходимые изменения и сохранить;
-
Открыть раздел Администрирование → Импорт данных → Товары;
-
Нажать кнопку +;
-
Выбрать табличный файл;
-
Перейти на следующий шаг Сопоставление полей;
-
Сопоставить поля как изображено ниже:

-
Нажать Импорт.
**v1.15.3** [!] Передача веса, алгоритм передачи изменен [+] Добавлена ставка НДС 22% **v1.15.2** от 02.06.2025 [\*] Передача веса в API изменена **v1.15.1** от 11.04.2025 [\*] Изменены домены на некоторые методы API **v1.15.0** от 10.03.2025 [!] По умолчанию склад нельзя было сопоставить со складом WB, исправлено [!] Для характеристики типа флажок, подставляется название характеристики [!] Для множественного типа подставляется первый выбранный вариант для выгрузки в WB **v1.14.0** от 24.02.2025 [!] Удален устаревший домен к доступу API **v1.13.1** от 18.09.2024 [!] Не отображались категории при синхронизации с WB, исправлено **v1.13.0** от 17.09.2024 [+] Поддержка модуля Склады [+] Возможность сопоставление складов WB со складами CS-Cart **v1.12.0** от 29.07.2024 [+] Добавлена настройка для указания главной витрины, после указания настройки, будут доступны в режиме "Все витрины" в редактировании товара(-ов) [\*] Поправлена ссылка на cron **v1.11.0** от 26.04.2024 [+] Добавлено передача пачкой для обновление остатков и цен в WB при кроне [\*] Уменьшен лимит товаров при выборки при кроне **v1.10.0** от 15.03.2024 [+] Обновлено API загрузки изображений и цен [+] Обрезка название товара если количество символов превышает 60 символов [+] Отложенная загрузка изображений, цен и остатков при создании товара в WB [+] Если при кроне у товара в wb нет изображений, то подтянет автоматически **v1.9.5** от 20.02.2024 [!] Неправильно рассчитывалась цена со скидкой, исправлено **v1.9.4** от 12.02.2024 [\*] Визуальное отображение id витрины в кроне [\*] На странице сопоставления категорий, пикер отображает только полный путь [!] На странице сопоставления категорий, пикер не загружал доп. информацию при скролле, исправлено **v1.9.3** от 11.02.2024 [\*] Сортировка по алфавиту у пикера **v1.9.2** от 11.02.2024 [!] Убрано очистка поля у пикера **v1.9.1** от 06.02.2024 [\*] Для новых настроек значения выставлены по умолчанию **v1.9.0** от 06.02.2024 [+] Выгрузка вторичной цены и скидки, включая через cron [+] У крона добавлен параметр company_id для выгрузки в зависимости от витрины **v1.8.0** от 30.01.2024 [+] Поле бренд берется с отдельного сопоставленного поля [+] Уведомление об успешной и выгрузке с ошибками **v1.7.1** от 29.01.2024 [+] Стандартизация модуля [!] Если был выбран Штрихкод характеристика с вариантами, не бралось значение из выбора, а только значение, исправлено [!] Если не выбраны размеры, при выгрузке вызывала нотисы исправлено [!] Перевод основных размеров из мм в см **v1.7.0** от 12.01.2024 [+] Лог ошибок при создании/редактировании товара [+] Вывод даты последнего обновления и количество выгруженных цен и остатков по cron **v1.6.0** от 11.01.2024 [+] Адаптирование модуля под новую версию API WB **v1.5.1** от 09.01.2024 [!] Преобразование HTML символа пробела приводило к удалению символа, исправлено **v1.5.0** от 09.01.2024 [+] Преобразование HTML-сущностей в символы, в описании товара **v1.4.0** от 09.01.2024 [+] Возможность указывать размер изображения для выгрузки в WB **v1.3.1** от 25.12.2023 [+] Для габаритов с плавающей точкой, происходит округление в большую сторону [!] Вес некорректно передавался при переводе в дробное значение, исправлено **v1.3.0** от 21.12.2023 [+] Выгрузка размеров и веса в заданных единицах измерения характеристик WB **v1.2.1** от 20.12.2023 [!] При массовом редактировании товаров не проходила выгрузка в WB, исправлено **v1.2.0** от 07.12.2023 [+] Добавлен cron для выгрузки цен и остатков в WB, если выставлена у товара опция "Выгружать в WB" [+] Добавлены отдельные настройки для выгрузки размеров и веса в WB [+] Добавлены вкладка для выбора склада из WB, и последующей выгрузки остатков [!] Выгрузка товара через кнопку "Обновить товар в WB" влияла на настройку "Выгружать в WB только новые", исправлено [\*] Изменена логика обновления категорий и характеристик из WB [+] Если выбранная ранее категория или характеристика отсутствует, выводится предупреждение [!] Убрано обновление ajax при переходе ранее на ту же вкладку Категории или Характеристики [\*] Во вкладке Характеристики, исключены некоторый выбор характеристик, т.к. они заполняются по умолчанию [\*] Характеристика "Вес" переименован на "Вес с упаковкой" **v1.1.0** от 30.11.2023 [+] Добавлен метод выгрузки цены при обновлении товара в WB [!] Во вкладке Категории нельзя раскрыть подкатегории, и делать сопоставление, исправлено **v1.0.0** от 29.11.2023 [+] Первое издание *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.