Товарный каталог
Работа с каталогом и товарами в Битрикс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: изменить поля товара каталога. |