Интеграция сайта с Wildberries (Вайлдберриз) импорт карточек товаров, выгрузка наличия, цен, свойств

5.3.0 (11.03.2025)	Согласно изменениям в методах API для создания и обновления карточек товаров, в параметры модуля добавлено новое поле - "Вес товара с упаковкой, кг". Вес товара c упаковкой передается на сайт Wildberries в кг для всех категорий товаров! Добавлена проверка на уникальность изображений для загрузки в карточку товара на сайте Wildberries. На страницу настройки модуля добавлена информация о владельце токена для доступа к API.
5.2.1 (19.12.2024)	Отключен один из методов API Wildberries для проверки корректности токена из-за некорректной обработки на стороне сервиса, приводящее к торможению работы модуля.
5.2.0 (16.12.2024)	Внедрена возможность сохранить ссылку товара на сайте Wildberries в каталог 1С-Битрикс после создания карточки товара и прохождения ее модерации. Расширено описание кодов ошибок для методов WB API. Выполнена смена доменов для методов API в категориях "Контент" и "Маркетплейс". Прежние домены будут отключены 31 декабря 2024 года.
5.1.0 (25.10.2024)	Внедрен визуальный конструктор для построения массива фильтрации в формате JSON. Реализована система прав на доступ к модулю. Решен вопрос со свойствами каталога, не имеющими символьный код. Добавлена возможность устанавливать цену из свойства товара/ТП, если инфоблок является торговым каталогом.
5.0.1 (15.10.2024)	В функционал модуля добавлена возможность сделать фиксированную наценку на товары в русских рублях.
5.0.0 (06.03.2024)	Добавлена возможность экспортировать товары на сайт Wildberries из разных каталогов/инфоблоков сайта. Реализована поддержка нескольких профилей маркетплейса Wildberries.
4.4.1 (21.05.2024)	Небольшие изменения, связанные с выбором основного раздела товара.
4.4.0 (18.05.2024)	Добавлен флаг "Выбрать все/Снять выделение" в таблице сопоставления разделов каталога и категорий товаров Wildberries. Добавлена возможность указать основной раздел товара, отличный от системного, и на основе него формировать карточку для сайта Wildberries. Добавлена возможность настроить склад Wildberries для выгрузки остатков по умолчанию.
4.3.1 (25.04.2024)	Согласно обновлению API сервиса Wildberries от 25.04.2024 максимальное количество номенклатур, возвращаемых методами получения списка товаров на сайте Wildberries и списка товаров в корзине на сайте Wildberries за один запрос, уменьшено до 100.
4.3.0 (23.04.2024)	Исключена возможность создавать карточку товара, для раздела которого отсутствуют сопоставления в настройках модуля. Добавлена автоматическая очистка значений характеристики "Описание" от html-тегов, лишних пробелов и перехода на новую строку, согласно формату вывода характеристики на сайте Wildberries. Учтены изменения в списке характеристик для категории товаров Wildberries. Характеристики "Бренд", "Наименование", "Описание" и "Ширина/длина/высота упаковки" теперь настраиваются для всех разделов каталога. Габариты упаковки для всех категорий товаров передаются на сайт Wildberries только в см!
4.2.1 (10.04.2024)	Исправлено разделение штрихкодов товаров, остатки которых были выгружены на склад Wildberries с ошибкой.
4.2.0 (29.03.2024)	Добавлена возможность выгружать остатки товаров на несколько складов Wildberries.
4.1.0 (20.03.2024)	Внедрены актуальные методы работы с ценами на сайте Wildberries. Расширена информация в логе о результатах обновления цен на сайте Wildberries.
4.0.1 (11.03.2024)	Внедрены актуальные методы работы с изображениями на сайте Wildberries.
4.0.0 (19.01.2024)	Внедрена версия API "Контент" 3.0 сервиса Wildberries. Переработана структура таблицы сопоставления свойств каталога характеристикам категорий сервиса Wildberries. Переработана структура лог-файла для повышения его наглядности.
3.3.0 (14.11.2023)	Добавлена возможность отключить часть функционала модуля: создание новых карточек на сайте Wildberries, обновление информации о товаре на сайте Wildberries, загрузка цен на сайт Wildberries и/или обновление остатков на складе Wildberries. Исправлена ошибка загрузки изображений на сайт Wildberries.
3.2.1 (16.05.2023)	Оптимизированы запросы к БД; Оптимизированы запросы к сервисам Wildberries; Увеличена скорость загрузки страницы настроек модуля, что особенно актуально при большом количестве выбранных разделов каталога.
3.2.0 (02.05.2023)	Изменена схема запроса при обновлении цены товара на сайте Wildberries.
3.1.8 (24.04.2023)	Реализовать поиск по свойствам инфоблока/каталога при настройке модуля. Внесены изменения в механизм загрузки недостающих фотографий на сайт Wildberries. Исключена возможность загрузки отрицательного остатка товара на сайт Wildberries, что приводило к ошибке "Некорректное тело запроса". Введено ограничение количества запросов на сайт Wildberries согласно документации к API сервиса.
3.1.7 (05.04.2023)	Обеспечена совместимость модуля с PHP 8.
3.1.6 (29.03.2023)	Добавлена возможность выбрать, что делать с остатками товаров на сайте Wildberries, которые не попали в выборку при работе модуля. Доступны два варианта: не изменять и обнулять.
3.1.5 (30.01.2023)	Внесены изменения для работы со свойствами каталога, которые содержат в своем коде символы нижнего регистра. После установки обновления необходимо проверить сопоставление свойств каталога и характеристик Wildberries.
3.1.4 (27.01.2023)	Внесены изменения в формирование значений для характеристик, связанных с габаритами упаковки товара. Поскольку изменения затронули названия характеристик Wildberries, после установки обновления необходимо проверить сопоставление свойств каталога и характеристик Wildberries, касающихся габаритов упаковки.
3.1.3 (17.01.2023)	Внедрена поддержка нового метода API Wildberries для обновления остатков на складе. Поддержка прежнего метода будет прекращена 31 января 2023 года.
3.1.2 (23.11.2022)	Согласно спецификации сервиса Wildberries увеличена длина поля "Наименование" до 60 символов.
3.1.1 (16.11.2022)	Внесены изменения в функцию обновления цен товаров, чтобы скорректировать работу соответствующего метода сервиса Wildberries.
3.1.0 (10.11.2022)	Добавлена возможность выбрать склад торгового каталога для обновления остатков на сайте Wildberries Добавлена возможность сохранить автоматически генерируемый штрихкод для номенклатуры Wildberries в выбранное свойство элемента инфоблока/каталога. Добавлена возможность указать минимально допустимое значение остатков товара. Количество товаров, у которых остаток меньше, чем указанный в данной настройке, будет обнулено на сайте Wildberries Добавлена возможность отправки отчета о результате процедуры экспорта на адрес электронной почты, указанной в настройках модуля. Оптимизирована процедура обновления информации о товаре на сайте Wildberries. Важно: время web-сервера и время сервера баз данных должно совпадать!
3.0.4 (26.10.2022)	Внедрен новый метод API для получения списка товаров, загруженных на сайт Wildberries. Старый метод престанет поддерживаться сервисом Wildberries 31 октября 2022 года.
3.0.3 (11.10.2022)	Исправлен выбор значения у свойств каталога типа "Привязка к элементам" и "Привязка к разделам". Итоговое значение подставляется из поля "Название" элемента или раздела инфоблока.
3.0.2 (10.10.2022)	Добавлена поддержка характеристики Wildberries "Вес товара с упаковкой (г)" с выбором значения из торгового каталога.
3.0.1 (06.10.2022)	В список выбора категории товара на сайте Wildberries для удобства добавлено отображение родительского раздела. Добавлена процедура проверки значения полей "Наименования", "Описание" и "Цвет" на действующие ограничения при создании/обновлении карточки товара. Также значение поля "Описание" автоматически очищается от html-тегов. Внедрена возможность выбрать габариты упаковки (вес, ширина, глубина, высота), обязательные для всех категорий товаров на сайте Wildberries, из соответствующих характеристик торгового каталога. Внедрена возможность копирования настроек при сопоставлении характеристик категорий товаров на сайте Wildberries и свойств инфоблока/каталога из одного раздела в другой. Добавлена возможность выбрать свойство товара, из которого будет выбрано значение остатка на складе, если инфоблок работает в режиме торгового каталога. По умолчанию, данное значение берется из поля торгового каталога "Доступное количество".
3.0.0 (28.09.2022)	В работу модуля внедрены методы новго API сервиса Wildberries для работы с разделом "Карточка товара NEW".
2.5.0 (23.08.2022)	Добавлена частичная поддержка "Карточка товара NEW". До публикациии новых методов API для "Карточка товара NEW" доступно только обновление остатков и цен товаров, загруженных в личный кабинет поставщика WB вручную.
2.0.2 (19.08.2022)	Добавлена поддержка пользовательского типа свойства инфоблока "HTML/Текст".
2.0.1 (19.07.2022)	Добавлена поддержка торговых предложений каталога. На сайте Wildberries каждое торговое предложение формирует свою карточку товара. Добавлена валидация значений свойств разделов Wildberries перед добавлением/обновлением карточки товара/товарного предложения.
1.0.6 (14.07.2022)	Добавлена поддержка свойств типа справочник. Оптимизировано получение списка товаров с сайта Wildberries.
1.0.5 (07.06.2022)	Обнавлена система журналирования. Добавлена ротация лог-файлов. Добавлена защита от повторного запуска процедуры экспорта, если не завершен предыдущий запуск.
1.0.4 (25.05.2022)	Добавлена возможность фильтрации товаров каталога ДОбавлена возможность обновления информации о товарах, в том числе, товарах, выгруженных с ошибкой
1.0.3 (12.05.2022)	Внесены изменения в обработку значений типа справочник Добавлена возможность выгружать множественные значения параметров На страницу настройки модуля вынесены ссылки для получения необходимых для интеграции с сайтом Wildberries параметров из личного кабинета поставщика
1.0.2 (11.04.2022)	Добавлена возможность установить наценку товара в настройках модуля Добавлена поддержка младших редакций 1С-Битрик, не содержащих модуль "Интернет-магазин"

Базовая настройка модуля

После установки модуля нужно настроить его интеграцию с сайтом Wildberries. Для этого потребуется сгенерировать токен API с правами для доступа к категориям "Контент", "Маркетплейс" и "Цены и скидки". Галочка "Только для чтения" должны быть снята, чтобы модуль имел возможность редактировать данные на сайте Wildberries.

Важно! Сгенерировать токен API может только владелец личного кабинета Wildberries! Значение ключа отображается один раз – при его генерации!

Токен API указывается в поле «Ключ для работы с API» в настройках модуля.

Затем необходимо выбрать инфоблок, являющийся торговым каталогом и/или содержащий товары, и отметить галочками, операции, которые будут выполнены во время процедуры экспорта:

• Создание карточек для новых товаров (включает создание карточки товара с нуля на сайте Wildberries);
  
• Обновление информации о товаре (включает в себя обновление всех характеристик в карточке товара на сайте Wildberries, цена и остаток товара – характеристиками не являются!)
  

Важно! При обновлении информации о товаре будут перезаписаны все изменения, внесенные в карточку товара через личный кабинет поставщика WB вручную.

• Загрузка информации о ценах
  
• Загрузка информации об остатках
  

Для перехода к следующему шагу необходимо сохранить выполненные настройки.

Переходим на вкладку "Сопоставление разделов и свойств". Здесь нужно установить соответствия между свойствами каталога/инфоблока и характеристиками интернет-магазина Wildberries; выбрать разделы, элементы которых должны быть экспортированы, и сопоставить их категориям на сайте Wildberries.

Для всех разделов каталога/инфоблока настраиваются следующие параметры:

• Артикул продавца. Данный параметр служит для технических целей и отображается ТОЛЬКО в личном кабинете поставщика WB. Если каталог содержит торговые предложения (ТП), то поля будет два: в одном нужно указать свойство для простого товара, в другом - для ТП. Значение артикула должно быть уникально для каждого товара/ТП в пределах продавца WB. После создания карточки товара на сайте Wildberries изменить значение данного параметра нельзя!
  

• Наименование. Название товара на сайте Wildberries. Максимальная длина наименования – 60 символов.
  

• Штрихкод товара. Каждая позиция товара на сайте Wildberries должна обладать уникальным штрихкодом. Если в фирме зарегистрированы собственные штрихкоды, то можно выбрать свойство каталога/инфоблока, которое содержит соответствующее значение. Если собственных штрикодов нет, то их можно сгенерировать автоматически, выбрав значение «Автоматическая генерация».
  

• Бренд. Фабричная марка или торговый знак. Обязательный параметр, поэтому не должен содержать пустого значения. Если товар не имеет бренда, то необходимо указать значение «Нет бренда».
  

• Описание. Максимальное количество символов для описания зависит от категории товаров, и изменяется от 1000 символов до 5000. Параметр "Описание" не поддерживает абзацы, HTML-теги и спецсимволы.
  

• Длина/ширина/высота упаковки. Обязательные параметры для создания/обновления карточки товар. Все значения указываются в см.
  

• Сохранить штрихкод WB. При автоматической генерации штрихкода его значение можно сохранить в одном из свойств каталога/инфоблока с типом "Строка".
  

• Остаток товара на складе. В данном параметре необходимо указать источник значения остатков товаров для обновления их на складе Wildberries. Для торгового каталога доступны следующие варианты: общее доступное количество, количество на определенном складе или значение одного из свойств товара/ТП. Для простого инфоблока доступно только значение свойства элемента инфоблока.
  

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

• При установленном флаге "Обнулить остаток, если количество товаров меньше n шт." на сайте Wildberries остаток товара будет принудительно обнулен, если значение в указанном выше параметре, будет меньше, чем число n.
  

• Список товаров, выбранных из каталога/инфоблока при работе модуля, может не совпадать со списком товаров, загруженных на сайт Wildberries. Параметр "Остаток товаров на сайте WB, которые не попали в выборку" позволяет определить поведение модуля при обновлении остатков.
  

1. Значение "Не изменять" означает, что на сайте Wildberries будут обновлены только те остатки, товары/элементы которых попали в выборку модуля. Остальные товары затронуты не будут.
   
2. Значение "Обнулять" позволяет принудительно установить нулевой остаток у тех товаров, которые загружены на сайт Wildberries, но не попали в выборку модуля.
   

• Цена. Если выбранный инфоблок является торговым каталогом, то из выпадающего списка нужно выбрать тот тип цены, значения которого будут участвовать в расчете стоимости товара на сайте Wildberries. Если инфоблок торговым каталогом не является, то нужно выбрать свойство, в котором указаны цены товаров в рублях. Обратите внимание, что интернет-магазин Wildberries требует указывать цену в русских рублях и без копеек, поэтому при экспорте товаров значения цен будут округлены по математическим правилам!
  

• К выбранной цене можно установить наценку на товары в процентах. Для этого установите флаг «Увеличить стоимость товара на n %» и укажите нужное значение.
  

• Изображение товара. Укажите свойство, в котором содержится главное изображение товара или массив изображений. Обратите внимание, товары БЕЗ изображений будут выгружены в личный кабинет поставщика WB, но на сайте Wildberries отображаться НЕ БУДУТ!
  

• Дополнительные изображения. Укажите свойство, содержащие дополнительные изображения товара. Не обязательный параметр.
  

• Массив фильтрации в формате JSON. При необходимости добавить дополнительные условия фильтрации товаров, например, по цене, по доступности и/или по значению одного из свойств, можно составить массив фильтрации в формате JSON. Начиная с версии модуля 5.1.0, доступен визуальный конструктор фильтра.
  

Визуальный конструктор фильтра

Визуальный конструктор позволяет сформировать одноуровневый массив для фильтрации элементов инфоблока и/или товаров/ТП каталога для экспорта на сайт Wildberries. Окно конструктора открывается при клике на кнопку «Изменить фильтр».

Фильтр состоит из блоков, каждый из которых имеет набор
определенных условий, связанных между собой так называемой логикой.

Система 1С-Битрикс поддерживает два типа связей (логики):

• Связь И. Будут выбраны только те элементы, которые удовлетворяют сразу всем условиям блока.
  
• Связь ИЛИ. Будут выбраны только те элементы, для которых выполняется хотя бы одно из условий блока.
  

Например, блок содержит два условия:

1. Свойство инфоблока «Цвет товара» равен «Черный»
   
2. Свойство инфоблока «Цвет товара» равен «Белый»
   

Если используется логика И будут выбраны только те товары, которые имеют одновременно оба значения свойства «Цвет»: и «Черный», и «Белый». При логике ИЛИ будут выбраны товары, которые имеют хотя бы одно из выбранных значение свойства «Цвет»: или «Белое», или «Черное».

Между собой блоки связаны логикой И.

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

Подробнее о массиве фильтрации можно узнать в документации 1С-Битрикс. Примеры наиболее часто-встречаемых фильтром можно посмотреть на сайте разработчика.

Сопоставление разделов и свойств инфоблока/каталога категориям и характеристикам Wildberries

Теперь нужно добавить и настроить разделы каталога/инфоблока, товары которых будут экспортированы на сайт Wildberries.

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



Чтобы товары раздела попали в выборку модуля, нужно:

1. Установить флаг в поле «Экспорт»;
   
2. В поле "Название на WB" начать вводить название категории на сайте Wildberries. В выпадающем списке будут отображаться категории, доступные на сайте Wildberries и содержащие введенные символы. Выбираем нужную категорию и сохраняем конфигурацию.
   

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



После сохранения конфигурации в правой колонке выбранного раздела появиться ссылка «Свойства». При клике на нее откроется панель для сопоставления характеристик товара данной категории на сайте Wildberries и свойств каталога / инфоблока. Для каждой категории товаров на сайте Wildberries набор характеристик свой. Обратите внимание на характеристики со звездочкой - они обязательны для заполнения! Для любой характеристики можно задать фиксированное значение, которое будут иметь все товары/элементы раздела, либо сопоставить со свойством каталога / инфоблока, выбрав его из выпадающего списка. Сохраняем изменения, кликнув на кнопку «Сохранить конфигурацию».



Чтобы быстро настроить сопоставление свойств каталога и характеристик Wildberries у всех разделов, используйте кнопки «Скопировать настройки» и «Вставить настройки». Для этого заполните один из разделов «эталонными» значениями и нажмите на кнопку «Скопировать настройки». Затем перейдите в секцию настройки свойств и характеристик другого раздела и нажмите кнопку «Вставить настройки». Таблица сопоставления для текущего раздела будет заполнена «эталонными» значениями для тех характеристик, названия которых полностью совпадают с «эталонными» характеристиками. Просмотрите таблицу, заполните те параметры, которые необходимы, но которых не было в «эталонном» разделе и перейдите к следующему.

Просим обратить внимание на свойства системы 1С-Битрикс типа справочник: значение для экспорта товаров выбирается из поля highload-блока с кодом UF_NAME. Если данное поле отсутствует, то значение выбирается из поля по умолчанию - UF_XML_ID.

Работа с профилями модуля

Использование дополнительных профилей модуля позволяет:

• Экспортировать товары из нескольких каталогов/инфоблоков 1С-Битрикс на сайт Wildberries.
  
• Одновременно работать с несколькими личными кабинетами поставщика WB.
  

Каждый профиль содержит настройку для одного каталога/инфоблока 1С-Битрикс и одного личного кабинета поставщика WB. Управление профилями осуществляется на странице настройки модуля, где можно добавить новый профиль, изменить его или удалить.



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

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

Запуск процедуры экспорта

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

1. Активировать агент. Для этого нужно установить флаг "Добавить агента" и указать время запуска на вкладке «Основные настройки». Для каждого профиля модуля агент будет свой.  

Дополнительную информацию по нюансам работы с агентами системы 1С-Битрикс можно посмотреть на странице разработчика.

2. Добавить исполняемый файл в расписание серверной утилиты Cron. Путь к исполняемому файлу указан на странице настройки модуля на вкладке «Основные настройки. Как правильно настраивать cron, можно узнать в техподдержке хостинга сайта.



Если исполняемый файл будет добавлен без аргументов, то все профили модуля будут выполняться поочередно. При больших объемах информации это может занят достаточно продолжительное время. Чтобы запустить экспорт для каждого профиля одновременно (параллельные процессы), нужно добавить исполняемый файл для каждого профиля отдельно, указав в качестве аргумента идентификатор профиля. Идентификатор профиля указан в начале его названия в квадратных скобках.



Например, на сайте используется два профиля с идентификаторами 0 и 1.



Настройка утилиты Cron для параллельного запуска процедуры экспорта обоих профилей будет выглядеть примерно так:

0 1 * * * /usr/bin/php /home/bitrix/www/bitrix/modules/dobrosite.exportwb/tools/cronExportToWB.php 0

0 2 * * * /usr/bin/php /home/bitrix/www/bitrix/modules/dobrosite.exportwb/tools/cronExportToWB.php 1

Таким образом, экспорт товаров для профиля «Профиль 1» будет запускаться ежедневно в 1 ночи, а для профиля «WB Галерея игр» - ежедневно в 2 часа ночи.

Результаты экспорта и ошибки можно посмотреть на вкладке "Лог" для каждого отдельного профиля.



Права модуля

Модуль имеет три уровня прав, регулирующие доступ к его настройкам:

• Доступ закрыт
  
• Чтение
  
• Полный доступ
  

Поскольку страница настройки модуля является частью Административного раздела системы 1С-Битрикс, то для обеспечения к ней доступа минимально необходимы следующие условия:

1. Право не ниже "Чтение" на папку /bitrix/admin/
   
2. Право не ниже "[R] Просмотр всех данных модуля" на модуль "Главный модуль"
   

Вопросы по работе модуля, запросы на техническую поддержку модуля ждем на support@dobrosite.com или через форму обратной связи на сайте dobro-site.ru