Интеграция с Яндекс Маркетом по API

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

После установки модуля штатными средствами 1С-Битрикс необходимо настроить его интеграцию с сайтом Яндекс Маркет. Для этого в личном кабинете продавца требуется сгенерировать токен авторизации. Минимально необходимые права доступа: «Просмотр товаров и карточек», «Управление товарами и карточками», «Просмотр цен» и «Управление ценами». Инструкция по созданию токена доступна по ссылке.

Настройка модуля выполняется на странице административного раздела «DOBROsite» > «Интеграция с Яндекс Маркетом».

Внесите значение токена авторизации в соответствующее поле и выберите кабинет Яндекс Маркета из выпадающего списка.

Настройка каталога

На вкладке «Настройка каталога» необходимо указать параметры каталога для экспорта товаров на сайт Яндекс Маркета:

• Идентификатор каталога или инфоблока, который содержит товары.
  
• Артикул товара / торгового предложения — идентификатор товара в системе Яндекс Маркет. Обязательное поле для работы модуля. Значение артикула должно быть уникальным в пределах продавца. По этому параметру производится сопоставление товаров / торговых предложений из каталога вашего сайта с товарами на сайте Яндекс Маркет. Если каталог поддерживает торговые предложения, то будут доступны два поля: одно для простого товара, другое — для торгового предложения.
  
• Выбор этапов экспорта: «Загружать информацию о ценах» и/или «Загружать информацию об остатках».
  

Ограничить список товаров / торговых предложений для экспорта можно с помощью массива фильтрации в формате JSON.

Массив фильтрации в формате JSON

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

В конструкторе фильтр формируется из одного или нескольких блоков логики, каждый из которых содержит одно или несколько условий. В системе 1С-Битрикс поддерживаются два вида логики: И и ИЛИ.

• Логика И позволяет выбрать только те товары, которые удовлетворяют сразу всем условиям блока. Блок окрашен в зелёный цвет. Такой блок может быть только один и должен содержать хотя бы одно условие.
  
• Логика ИЛИ позволяет выбрать товары, соответствующие хотя бы одному из условий (например, товары указанных брендов или товары из определённых разделов каталога). Блок окрашен в синий цвет. В фильтре может быть несколько блоков ИЛИ, каждый из которых должен содержать минимум два условия.
  

Между собой все блоки фильтра объединяются логикой И.

Каждое условие блока включает:

• свойство каталога, по которому выполняется фильтрация;
  
• оператор сравнения (больше, меньше, равно и т. д.);
  
• значение свойства.
  

Набор доступных свойств зависит от структуры каталога:

• для простого инфоблока доступны все его свойства;
  
• для торгового каталога без торговых предложений — свойства инфоблока-каталога, список типов цен, список доступных складов, а также свойства торгового каталога (доступность, общее количество, вес и габариты упаковки);
  
• для торгового каталога с поддержкой торговых предложений — свойства инфоблока торговых предложений, типы цен, доступные склады и свойства торгового каталога (доступность, общее количество, вес и габариты упаковки).
  

Каждое условие может содержать только одно значение свойства.

Если требуется более сложная структура фильтра, чем позволяет сформировать конструктор, поле «Массив фильтрации в формате JSON» можно заполнить вручную. Для этого необходимо составить массив $arFilter и сконвертировать его в JSON-формат. Подробнее о массиве $arFilter можно узнать в документации 1С-Битрикс.

Цены товаров

Вкладка «Цены» предназначена для управления ценами товаров на сайте Яндекс Маркет.

Зачёркнутая цена — цена товара до применения скидки. Если выбранный инфоблок является торговым каталогом, из выпадающего списка нужно выбрать тип цены или свойство товара / торгового предложения, значение которого будет сконвертировано в валюту Яндекс Маркета и округлено до целого числа по математическим правилам. Для простого инфоблока доступны только его свойства — они также округляются до целого числа.

Базовая цена (для всех магазинов) — цена, на основе которой рассчитывается стоимость товара, отображаемая покупателю на витрине Яндекс Маркета. Если выбранный инфоблок является торговым каталогом, из выпадающего списка нужно выбрать тип цены или свойство товара / торгового предложения. Для простого инфоблока доступны только его свойства. Также предусмотрена возможность использовать зачёркнутую цену для расчёта базовой.

На цены можно установить наценку или скидку как в процентах, так и в рублях.

Остатки товаров на складе Яндекс Маркета

Вкладка «Остатки» предназначена для управления остатками товаров на складах Яндекс Маркета (FBS, Экспресс и DBS).

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

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

При установленном флаге «Обнулить остаток, если количество товаров меньше n шт.» на сайте Яндекс Маркета остаток будет принудительно обнулён, если фактическое значение окажется меньше указанного числа n.

Список товаров, выбранных из каталога / инфоблока при работе модуля, может не совпадать со списком товаров, загруженных в каталог Яндекс Маркета. Параметр «Остатки товаров, которые не попали в выборку модуля» определяет поведение модуля в этом случае:

• Не изменять — на складе Яндекс Маркета будут обновлены только те товары / элементы, которые попали в выборку модуля. Остальные товары затронуты не будут.
  
• Обнулять — позволяет принудительно установить нулевой остаток для товаров, которые загружены в каталог Яндекс Маркета, но не попали в выборку модуля.
  

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

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

• экспортировать товары из нескольких каталогов / инфоблоков 1С-Битрикс на сайт Яндекс Маркета;
  
• одновременно работать с несколькими кабинетами / магазинами Яндекс Маркета.
  

Каждый профиль содержит настройки для одного каталога / инфоблока 1С-Битрикс и одного кабинета / магазина Яндекс Маркета.

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

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

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

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

Пример настройки cron для параллельного запуска двух профилей:

0 1 * * * /usr/bin/php/home/bitrix/www/bitrix/modules/dobrosite.exportym/tools/cron_export_ym.php 0
0 2 * * * /usr/bin/php/home/bitrix/www/bitrix/modules/dobrosite.exportym/tools/cron_export_ym.php 1>

В этом примере экспорт профиля с идентификатором 0 запускается ежедневно в 1:00, а профиля с идентификатором 1 — ежедневно в 2:00.

Информация о последнем запуске cron отображается на странице настройки модуля в параметре «Последний запуск утилиты cron» для каждого профиля индивидуально. Если информация отсутствует или дата / время запуска неактуальны, значит настройка cron выполнена некорректно.

Результаты экспорта и возникшие ошибки можно просмотреть на вкладке «Лог», выбрав нужную дату.