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

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

После установки модуля нужно настроить его интеграцию с сайтом 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] Просмотр всех данных модуля" на модуль "Главный модуль"