Bitrix API: Выгрузка торговых предложений

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

Для настройки вам нужен будет код поля “ID родителя”, а так же коды полей, через которые вы заполняли атрибуты модификаций.

Набор характеристик для Торговых предложений

Для выгрузки ТП нужно создать новый набор характеристик Наборы характеристик

Open

Справа должен быть выбран прайс с типом Основной, остальные настройки могут быть любыми.

В наборе добавить вручную характеристики, которые будут соответствовать атрибутам торговых предложений. Характеристики добавлять в общий тип товаров “Товары”.

Open

Дальше понадобится ИД этих характеристик, выделенный желтым на скриншете.

В настройках характеристик в колонке “Назв. поля” нужно указать Внешний код характеристики с сайта (т.е. эти свойства должны быть уже созданы на сайте).

Если колонки “Внешний код” не видно в таблице, то отобразите ее через кнопку с шестеренкой.

Действие Quad.Magic для заполнения характеристик из поля

В Quad.Magic добавить действие с типом “Заполнить характеристику из поля” Заполнить характеристику из поля . Действие должно быть в группе действий подготовки и выгрузки описаний на сайт. Можно добавить после действия с типом “Обработка фото и описаний”.

В Настройка 1 действия указать настройки копирования информации из пользовательских полей, в которых заполнены атрибуты модификаций, в свойства, добавленные на предыдущем шаге.

Шаблон экспорта

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

В настройках Автозаполнения нужно добавить 2 правила, для отбора товаров в этот шаблон экспорта.

Первым правилом убираются все товары.

Вторым правилом добавляются товары используя SQL-фильтр в кнопке “Другие условия”

В фильтр ввести текст:

где КодПоляИДродителя - ваш код поля, в котором сохраняется ИД родителя для модификаций.

Выполните эти 2 правила.

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

данный фильтр отбирает только товары, у которых не заполнено поле “ИД родителя”.

Выполните и эти правила или группу автозаполнения целиком.

Действие Sync.X для выгрузки

Добавьте действие Sync.X с типом “Синхронизация Bitrix”, которым будут выгружаться торговые предложения. Если у вас уже настроена выгрузка обычных товаров, то можете скопировать это действие.

Ниже будет описание настроек. Если какая-то вкладка не упоминается, то значит настройки на ней можно оставлять любые и она не нужна для выгрузки.

Вкладка “Выгрузка API”

Здесь указываются настройки подключения такие же, как в действии выгрузки товаров Bitrix API: Выгрузка контента из программы на сайт

ID шаблона экспорта - указывается ИД нового шаблона, добавленного по этой инструкции, с помощью которого отбираются торговые предложения.

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

Выбираются следующие выгрузки:

Вкладка “Группы”

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

Вкладка “Товары”

Здесь настройки должны быть такие же, как и в выгрузке контента. Либо можно что-то изменить, если вдруг название, описание или какие-то другие поля из этой вкладки у вас должны отличаться для торговых предложений. Как настраивать вкладку можно посмотреть здесь Bitrix API: Выгрузка контента из программы на сайт

Вкладка “Поля”

В этой вкладке можно указать свойства торговых предложений, которые не являются характеристикой товара. Например, свойство Артикул, если у вас такое есть на сайте.

Вкладка “Свойства”

Указать настройки такие же как на скриншете.

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

Вкладка “ТП”

Здесь нужно указать:

ID инфоблока родителя - ИД инфоблока, в котором у вас на сайте размещены товары (основной каталог товаров).

Поле с QID родителя - код поля в котором у товаров-модификаций указан ИД товара родителя (QID, ид товара в программе).

Поле с Внешн. кодом родителя - код поля, в котором у товаров-родителей указан Внешний код товара на сайте.

ID свойства CML2_LINK - ИД свойства на сайте из инфоблока с торговыми предложениями, в котором указывается связь с товаром из основного каталога.

Вкладка “Цены и остатки”

здесь настройки такие же как и действии выгрузки цен, если у вас такое есть Bitrix API: Выгрузка цен и остатков из программы на сайт , либо действии выгрузки контента.

Отличаться может только фильтр товаров

Нужно указать его с ИД шаблона экспорта, который вы создали для выгрузки торговых предложений.

Что нужно заполнять у ТП в программе

Для того, чтобы товар считался Торговым предложением, в программе у него должно быть заполнено:

Поле ID родителя - здесь указывается QID товара родителя в программе

Одно из полей атрибутов, которые отличают модификации товаров на сайте.

Как добавить новое свойство-атрибут для торгового предложения

1. Добавить пользовательское поле, через которое вы будете заполнять новый атрибут.

Добавление пользовательского поля

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

2. Добавить свойство в наборе характеристик для торговых предложений

Наборы характеристик

Тип товара для всех характеристик в торговых предложениях должен быть “Товары”.

В колонке “Назв. поля / Внешний код” нужно указать внешний код свойства на сайте.

Если на сайте еще нет такого свойства, то вам нужно его предварительно добавить на сайте.

3. Добавить новую характеристику и поле в действие Quad.Magic заполнения характеристик из поля (см. пункт “Действие Quad.Magic для заполнения характеристик из поля” этой инструкции)