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

Работа с каталогом и товарами в Битрикс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.

Каталог v3: создать вариацию
Техническое имя create_catalog_v3_offer
Создаёт вариацию товара; запись после подтверждения.
Текст для ИИ

Создать вариацию (catalog.product.offer.add). confirm=true.

Каталог v3: создать услугу
Техническое имя create_catalog_v3_service
Создаёт услугу каталога; запись после подтверждения.
Текст для ИИ

Создать услугу (catalog.product.service.add). confirm=true.

Каталог v3: создать головной товар
Техническое имя create_catalog_v3_sku
Создаёт головной товар (SKU); запись после подтверждения.
Текст для ИИ

Создать головной товар (catalog.product.sku.add). 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.

Каталог v3: удалить вариацию
Техническое имя delete_catalog_v3_offer
Удаляет вариацию; запись после подтверждения.
Текст для ИИ

Удалить вариацию (catalog.product.offer.delete). confirm=true.

Каталог v3: удалить услугу
Техническое имя delete_catalog_v3_service
Удаляет услугу; запись после подтверждения.
Текст для ИИ

Удалить услугу (catalog.product.service.delete). confirm=true.

Каталог v3: удалить головной товар
Техническое имя delete_catalog_v3_sku
Удаляет головной товар; запись после подтверждения.
Текст для ИИ

Удалить головной товар (catalog.product.sku.delete). confirm=true.

Скачать файл товара
Техническое имя download_catalog_product_file
Скачивает файл/изображение товара каталога.
Текст для ИИ

Скачать файл товара (catalog.product.download), если метод доступен.

Документ каталога
Техническое имя get_catalog_document
Карточка складского документа каталога.
Текст для ИИ

Складской документ (catalog.document.get).

Поля и свойства каталога
Техническое имя 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 (общее количество).

Каталог v3: каталог
Техническое имя get_catalog_v3_catalog
Карточка торгового каталога через REST 3.0 / classic.
Текст для ИИ

Торговый каталог REST 3.0 (catalog.catalog.get) со sticky classic fallback.

Каталог v3: вариация
Техническое имя get_catalog_v3_offer
Карточка вариации товара.
Текст для ИИ

Вариация (catalog.product.offer.get).

Каталог v3: товар
Техническое имя get_catalog_v3_product
Карточка товара каталога через REST 3.0 / classic fallback.
Текст для ИИ

Товар каталога REST 3.0 (catalog.product.get) со sticky classic fallback.

Каталог v3: раздел
Техническое имя get_catalog_v3_section
Карточка раздела каталога через REST 3.0 / classic.
Текст для ИИ

Раздел каталога REST 3.0 (catalog.section.get) со sticky classic fallback.

Каталог v3: услуга
Техническое имя get_catalog_v3_service
Карточка услуги каталога.
Текст для ИИ

Услуга (catalog.product.service.get).

Каталог v3: головной товар
Техническое имя get_catalog_v3_sku
Карточка головного товара (SKU).
Текст для ИИ

Головной товар (catalog.product.sku.get).

Документы каталога
Техническое имя list_catalog_documents
Складские документы торгового каталога (чтение).
Текст для ИИ

Складские документы read-only (catalog.document.list).

Единицы измерения
Техническое имя list_catalog_measures
Справочник единиц измерения каталога.
Текст для ИИ

Единицы измерения (catalog.measure.list).

Типы цен
Техническое имя list_catalog_price_types
Типы цен торгового каталога.
Текст для ИИ

Типы цен (catalog.pricetype.list). Prefer v3, classic fallback.

Цены товаров
Техническое имя list_catalog_prices
Цены товаров торгового каталога Bitrix24.
Текст для ИИ

Цены товаров (catalog.price.list). Prefer v3, classic fallback; soft-fail если метода нет.

Изображения товара
Техническое имя list_catalog_product_images
Список изображений товара каталога.
Текст для ИИ

Изображения товара (catalog.productImage.list); downloadUrl в ответе.

Каталог v3: каталоги
Техническое имя list_catalog_v3_catalogs
Список торговых каталогов (iblock) через REST 3.0 / classic.
Текст для ИИ

Список торговых каталогов REST 3.0 (catalog.catalog.list) со sticky classic fallback.

Каталог v3: вариации
Техническое имя list_catalog_v3_offers
Список вариаций (offer) каталога.
Текст для ИИ

Вариации (catalog.product.offer.list).

Каталог v3: поля товара
Техническое имя list_catalog_v3_product_fields
Схема полей товара торгового каталога REST 3.0.
Текст для ИИ

Поля товара catalog.product.field.list (fallback: getFieldsByFilter).

Каталог v3: список товаров
Техническое имя list_catalog_v3_products
Список товаров через REST 3.0 со sticky fallback на classic.
Текст для ИИ

Список товаров каталога REST 3.0 (catalog.product.list) со sticky classic fallback. apiSource=v3|classic_fallback.

Каталог v3: разделы
Техническое имя list_catalog_v3_sections
Список разделов каталога через REST 3.0 / classic.
Текст для ИИ

Разделы каталога REST 3.0 (catalog.section.list) со sticky classic fallback.

Каталог v3: услуги
Техническое имя list_catalog_v3_services
Список услуг торгового каталога.
Текст для ИИ

Услуги (catalog.product.service.list).

Каталог v3: головные товары
Техническое имя list_catalog_v3_skus
Список головных товаров (SKU) каталога.
Текст для ИИ

Головные товары (catalog.product.sku.list).

Ставки НДС
Техническое имя list_catalog_vats
Справочник ставок НДС каталога.
Текст для ИИ

Ставки НДС (catalog.vat.list).

Список торговых каталогов
Техническое имя list_catalogs
Какие торговые каталоги есть на портале и их идентификаторы.
Текст для ИИ

Список торговых каталогов портала (catalog.catalog.list). iblockId берётся отсюда для catalog.* write. Каталог с productIblockId/skuPropertyId — торговые предложения, не для create_catalog_product.

Задать цену товара
Техническое имя set_catalog_price
Устанавливает цену товара; запись после подтверждения.
Текст для ИИ

Задать цену товара (catalog.price.add или catalog.price.update). confirm=true обязателен. Soft-fail если метода нет на портале.

Изменить товар каталога
Техническое имя update_catalog_product
Обновляет поля существующего товара торгового каталога.
Текст для ИИ

Обновляет поля простого товара (catalog.product.update). Только изменяемые ключи. List-свойства: {value} / {valueId,value}. Требуется confirm=true.

Изменить раздел каталога
Техническое имя update_catalog_section
Обновляет раздел торгового каталога Bitrix24.
Текст для ИИ

Обновляет раздел торгового каталога (catalog.section.update). Требуется confirm=true.

Каталог v3: обновить вариацию
Техническое имя update_catalog_v3_offer
Обновляет вариацию; запись после подтверждения.
Текст для ИИ

Обновить вариацию (catalog.product.offer.update). confirm=true.

Каталог v3: обновить услугу
Техническое имя update_catalog_v3_service
Обновляет услугу; запись после подтверждения.
Текст для ИИ

Обновить услугу (catalog.product.service.update). confirm=true.

Каталог v3: обновить головной товар
Техническое имя update_catalog_v3_sku
Обновляет головной товар; запись после подтверждения.
Текст для ИИ

Обновить головной товар (catalog.product.sku.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.

Гайд: каталог REST 3.0
Адрес ресурса bitrix24://catalog/v3/usage-guide
Dual-path каталога, цены и apiSource для агента.
Текст для ИИ

Dual-path catalog v3: filter/fallback/apiSource, цены и порядок вызовов.

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

НазваниеОписание
Создать товар каталога
Техническое имя catalog_create_product
Сценарий: завести простой товар. Цену продажи этот сценарий не задаёт.
Текст для ИИ

Playbook: создать простой товар каталога без цены продажи.

Создать раздел каталога
Техническое имя catalog_create_section
Сценарий: найти каталог и создать в нём раздел.
Текст для ИИ

Playbook: создать раздел торгового каталога.

Удалить товар или раздел
Техническое имя catalog_delete_item
Сценарий: скрыть или удалить товар либо раздел каталога.
Текст для ИИ

Playbook: удалить товар или раздел либо скрыть active=N.

Задать цену товара
Техническое имя catalog_set_product_price
Playbook: найти товар, выбрать тип цены и задать цену.
Текст для ИИ

Playbook: задать цену продажи товара через catalog.price.* / set_catalog_price.

Изменить товар каталога
Техническое имя catalog_update_product
Сценарий: посмотреть карточку товара и обновить поля.
Текст для ИИ

Playbook: изменить поля товара каталога.