Quad.Wiki
Bitrix API: Выгрузка торговых предложений
- Ruslan
Для выгрузки торговых предложений у вас в программе должна быть настроена работа с модификациями товаров Модификации товаров
Для настройки вам нужен будет код поля “ID родителя”, а так же коды полей, через которые вы заполняли атрибуты модификаций.
Набор характеристик для Торговых предложений
Для выгрузки ТП нужно создать новый набор характеристик Наборы характеристик
Справа должен быть выбран прайс с типом Основной, остальные настройки могут быть любыми.
В наборе добавить вручную характеристики, которые будут соответствовать атрибутам торговых предложений. Характеристики добавлять в общий тип товаров “Товары”.
Дальше понадобится ИД этих характеристик, выделенный желтым на скриншете.
В настройках характеристик в колонке “Назв. поля” нужно указать Внешний код характеристики с сайта (т.е. эти свойства должны быть уже созданы на сайте).
Если колонки “Внешний код” не видно в таблице, то отобразите ее через кнопку с шестеренкой.
Действие Quad.Magic для заполнения характеристик из поля
В Quad.Magic добавить действие с типом “Заполнить характеристику из поля” Заполнить характеристику из поля . Действие должно быть в группе действий подготовки и выгрузки описаний на сайт. Можно добавить после действия с типом “Обработка фото и описаний”.
В Настройка 1 действия указать настройки копирования информации из пользовательских полей, в которых заполнены атрибуты модификаций, в свойства, добавленные на предыдущем шаге.
Если вы добавили какой-то новый атрибут (пользовательское поле), то вам нужно добавить и соответствующую характеристику в программе (в предыдущем пункте инструкции) и на сайте (вручную через админку сайта), а так же добавить копирование из поля в характеристику.
Шаблон экспорта
Добавьте новый шаблон экспорта, для отбора товаров, выгружаемых в торговые предложения. Настройки колонок в шаблоне можно не указывать.
В настройках Автозаполнения нужно добавить 2 правила, для отбора товаров в этот шаблон экспорта.
Первым правилом убираются все товары.
Вторым правилом добавляются товары используя SQL-фильтр в кнопке “Другие условия”
В фильтр ввести текст:
(p.КодПоляИДродителя <> '')где КодПоляИДродителя - ваш код поля, в котором сохраняется ИД родителя для модификаций.
Выполните эти 2 правила.
Если вы работаете с Торговыми предложениями, то нужно так же добавить условия отбора и для выгрузки товаров в основной инфоблок.
((p.КодПоляИДродителя = '') or (p.КодПоляИДродителя is null))данный фильтр отбирает только товары, у которых не заполнено поле “ИД родителя”.
Выполните и эти правила или группу автозаполнения целиком.
Действие Sync.X для выгрузки
Добавьте действие Sync.X с типом “Синхронизация Bitrix”, которым будут выгружаться торговые предложения. Если у вас уже настроена выгрузка обычных товаров, то можете скопировать это действие.
Если у вас еще нет действия выгрузки обычных товаров, то сначала настройте его и проверьте работу, а затем уже выгрузку торговых предложений.
Ниже будет описание настроек. Если какая-то вкладка не упоминается, то значит настройки на ней можно оставлять любые и она не нужна для выгрузки.
Вкладка “Выгрузка API”
Здесь указываются настройки подключения такие же, как в действии выгрузки товаров
ID шаблона экспорта - указывается ИД нового шаблона, добавленного по этой инструкции, с помощью которого отбираются торговые предложения.
ID инфоблока - указывается ИД инфоблока торговых предложений.
Выбираются следующие выгрузки:
Вкладка “Группы”
Указать ИД инфоблока торговых предложений, остальные настройки оставить такими же как и в выгрузке контента.
Вкладка “Товары”
Здесь настройки должны быть такие же, как и в выгрузке контента. Либо можно что-то изменить, если вдруг название, описание или какие-то другие поля из этой вкладки у вас должны отличаться для торговых предложений. Как настраивать вкладку можно посмотреть здесь
Вкладка “Поля”
В этой вкладке можно указать свойства торговых предложений, которые не являются характеристикой товара. Например, свойство Артикул, если у вас такое есть на сайте.
Вкладка “Свойства”
Указать настройки такие же как на скриншете.
Выгружать характеристики - По id характеристики
В ID параметров указать ИД набора характеристик, который вы добавили для торговых предложений по этой инструкции.
Вкладка “ТП”
Здесь нужно указать:
ID инфоблока родителя - ИД инфоблока, в котором у вас на сайте размещены товары (основной каталог товаров).
Поле с QID родителя - код поля в котором у товаров-модификаций указан ИД товара родителя (QID, ид товара в программе).
Поле с Внешн. кодом родителя - код поля, в котором у товаров-родителей указан Внешний код товара на сайте.
ID свойства CML2_LINK - ИД свойства на сайте из инфоблока с торговыми предложениями, в котором указывается связь с товаром из основного каталога.
Вкладка “Цены и остатки”
здесь настройки такие же как и действии выгрузки цен, если у вас такое есть , либо действии выгрузки контента.
Отличаться может только фильтр товаров
Нужно указать его с ИД шаблона экспорта, который вы создали для выгрузки торговых предложений.
Что нужно заполнять у ТП в программе
Для того, чтобы товар считался Торговым предложением, в программе у него должно быть заполнено:
Поле ID родителя - здесь указывается QID товара родителя в программе
Одно из полей атрибутов, которые отличают модификации товаров на сайте.
Как добавить новое свойство-атрибут для торгового предложения
1. Добавить пользовательское поле, через которое вы будете заполнять новый атрибут.
Для удобство задавайте всем таким полям одинаковый цвет и сортировку, чтобы они отображались в карточке товара выше остальных полей.
2. Добавить свойство в наборе характеристик для торговых предложений
Тип товара для всех характеристик в торговых предложениях должен быть “Товары”.
В колонке “Назв. поля / Внешний код” нужно указать внешний код свойства на сайте.
Если на сайте еще нет такого свойства, то вам нужно его предварительно добавить на сайте.
3. Добавить новую характеристику и поле в действие Quad.Magic заполнения характеристик из поля (см. пункт “Действие Quad.Magic для заполнения характеристик из поля” этой инструкции)