Товарный каталог

Работа с каталогом и товарами в Битрикс24

Что может делать ассистент

Название	Описание
Создать товар каталога Техническое имя `create_catalog_product`	Создаёт простой товар в торговом каталоге Bitrix24. Текст для ИИ Создаёт простой товар торгового каталога (catalog.product.add). Поля — opaque dict; коды из bitrix24://catalog/product-fields/{iblock_id}. iblock_id обязателен (без default). Не задаёт цену продажи и не принимает file/picture. Требуется confirm=true.
Создать раздел каталога Техническое имя `create_catalog_section`	Создаёт раздел в торговом каталоге Bitrix24. Текст для ИИ Создаёт раздел торгового каталога (catalog.section.add). iblock_id обязателен. Родитель — fields.iblockSectionId. Требуется confirm=true.
Удалить товар каталога Техническое имя `delete_catalog_product`	Удаляет товар из торгового каталога Bitrix24. Текст для ИИ Удаляет товар каталога (catalog.product.delete, hard delete). Альтернатива скрыть: update active=N. Требуется confirm=true.
Удалить раздел каталога Техническое имя `delete_catalog_section`	Удаляет раздел торгового каталога Bitrix24. Текст для ИИ Удаляет раздел каталога (catalog.section.delete). Раздел с детьми может вернуть ошибку Bitrix. Требуется confirm=true.
Поля и свойства каталога Техническое имя `get_catalog_fields_and_properties`	Справочник полей и свойств торгового каталога Bitrix24. Текст для ИИ Возвращает список полей и свойств торгового каталога (по умолчанию iblock_id=21). Собирает данные из двух методов API: catalog.product.getFieldsByFilter (поля) и catalog.product.property.list (свойства). Для свойств с типом 'L' (список) дополнительно запрашивает значения через catalog.product.property.enum.get. Параметры: iblock_id (ID инфоблока торгового каталога, по умолчанию 21), auth_data. Возвращает items (список полей и свойств с ID, name, code, type и values для 'L'), count (общее количество).
Карточка товара Техническое имя `get_catalog_product`	Карточка товара торгового каталога Bitrix24 по ID. Текст для ИИ Возвращает информацию о товаре по его ID. Использует метод catalog.product.get. Параметры: product_id (ID товара в торговом каталоге), auth_data. Возвращает список fields_and_properties (поля и свойства товара с ID, name, code, value).
Список товаров Техническое имя `get_catalog_products_list`	Список товаров торгового каталога Bitrix24 с фильтром. Текст для ИИ Возвращает список товаров торгового каталога по фильтру (по умолчанию iblock_id=21). Использует метод catalog.product.list. Параметры: iblock_id (ID инфоблока торгового каталога, по умолчанию 21), filter, select, order, auth_data. В select дожны быть всегда переданы по-умолчанию поля id и iblockId. Все остальные поля и свойства передаются по требованию и должны быть в camelCaseВозвращает items (список товаров с ID, name и списком fields_and_properties), count (общее количество).
Карточка раздела каталога Техническое имя `get_catalog_section`	Карточка раздела торгового каталога Bitrix24 по ID. Текст для ИИ Карточка раздела торгового каталога по ID (catalog.section.get). Параметры: section_id.
Разделы каталога Техническое имя `get_catalog_sections`	Список разделов торгового каталога Bitrix24. Текст для ИИ Возвращает список разделов торгового каталога (по умолчанию iblock_id=21). Использует метод catalog.section.list. Параметры: iblock_id (ID инфоблока торгового каталога, по умолчанию 21), auth_data. Возвращает items (список разделов с ID, name и iblockSectionId (привязка к родительскому разделу)), count (общее количество).
Список торговых каталогов Техническое имя `list_catalogs`	Какие торговые каталоги есть на портале и их идентификаторы. Текст для ИИ Список торговых каталогов портала (catalog.catalog.list). iblockId берётся отсюда для catalog.* write. Каталог с productIblockId/skuPropertyId — торговые предложения, не для create_catalog_product.
Изменить товар каталога Техническое имя `update_catalog_product`	Обновляет поля существующего товара торгового каталога. Текст для ИИ Обновляет поля простого товара (catalog.product.update). Только изменяемые ключи. List-свойства: {value} / {valueId,value}. Требуется confirm=true.
Изменить раздел каталога Техническое имя `update_catalog_section`	Обновляет раздел торгового каталога Bitrix24. Текст для ИИ Обновляет раздел торгового каталога (catalog.section.update). Требуется confirm=true.

Справочники и гайды

Название	Описание
Поля каталога Адрес ресурса `bitrix24://catalog/catalog-fields`	Компактный справочник полей торгового каталога Bitrix24. Текст для ИИ Справочник полей торгового каталога Bitrix24.
Поля товара Адрес ресурса `bitrix24://catalog/product-fields`	Компактный справочник полей карточки товара в торговом каталоге. Текст для ИИ Справочник полей товаров каталога Bitrix24.
Поля товара по каталогу Адрес ресурса `bitrix24://catalog/product-fields/{iblock_id}`	Справочник полей карточки товара для выбранного инфоблока каталога. Текст для ИИ Справочник полей товаров каталога Bitrix24 по iblockId.
Поля раздела каталога Адрес ресурса `bitrix24://catalog/section-fields`	Справочник полей раздела торгового каталога Bitrix24. Текст для ИИ Справочник полей раздела торгового каталога Bitrix24.
Гайд: торговый каталог Адрес ресурса `bitrix24://catalog/usage-guide`	Порядок работы с товарами и разделами торгового каталога Bitrix24. Текст для ИИ Порядок работы агента с торговым каталогом Bitrix24: list_catalogs, поля, create/update/delete.

Готовые сценарии

Название	Описание
Создать товар каталога Техническое имя `catalog_create_product`	Сценарий: завести простой товар. Цену продажи этот сценарий не задаёт. Текст для ИИ Playbook: создать простой товар каталога без цены продажи.
Создать раздел каталога Техническое имя `catalog_create_section`	Сценарий: найти каталог и создать в нём раздел. Текст для ИИ Playbook: создать раздел торгового каталога.
Удалить товар или раздел Техническое имя `catalog_delete_item`	Сценарий: скрыть или удалить товар либо раздел каталога. Текст для ИИ Playbook: удалить товар или раздел либо скрыть active=N.
Изменить товар каталога Техническое имя `catalog_update_product`	Сценарий: посмотреть карточку товара и обновить поля. Текст для ИИ Playbook: изменить поля товара каталога.