метод REST scope: catalog

catalog.section.update

Изменить раздел торгового каталога

Кто может выполнять: администратор

Описание

Метод catalog.section.update изменяет раздел торгового каталога.

Параметры

id catalog_section.id обязательный

Идентификатор раздела каталога

fields object обязательный

Значения полей для обновления раздела каталога

Параметр fields

iblockId catalog_catalog.id обязательный

Идентификатор инфоблока.

Для получения существующих идентификаторов необходимо использовать catalog.catalog.list

iblockSectionId catalog_section.id необязательный

Идентификатор родительского раздела.

Для получения существующих идентификаторов необходимо использовать catalog.section.list

name string обязательный

Название раздела каталога

xmlId string необязательный

Внешний идентификатор.

Можно использовать для синхронизации текущего раздела каталога с аналогичной позицией во внешней системе

code string необязательный

Код раздела каталога. Должен быть уникальным

sort integer необязательный

Сортировка

active string необязательный

Индикатор активности раздела каталога:
- Y — активен
- N — неактивен

description string необязательный

Описание раздела каталога

descriptionType string необязательный

Тип описания. Доступные типы: text, html

Примеры запроса

-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "id": 32,
    "fields": {
        "iblockId": 14,
        "name": "Детские игрушки",
        "description": "<H1>Детские игрушки</H1> <p>Товары для детей</p>",
        "descriptionType": "html"
    }
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.section.update

Ответ

HTTP-статус: 200

{
"result": {
    "section": {
    "active": "Y",
    "code": "toys1",
    "description": "<H1>Детские игрушки</H1> <p>Товары для детей</p>",
    "descriptionType": "html",
    "iblockId": 14,
    "iblockSectionId": 13,
    "id": 32,
    "name": "Детские игрушки",
    "sort": 100,
    "xmlId": "myXmlId"
}
},
"time": {
    "start": 1712327086.69665,
    "finish": 1712327086.95303,
    "duration": 0.256376028060913,
    "processing": 0.0112268924713135,
    "date_start": "2024-04-05T16:24:46+02:00",
    "date_finish": "2024-04-05T16:24:46+02:00",
    "operating": 0
}
}

Возвращаемые данные

result object

Корневой элемент ответа

section catalog_section

Объект с информацией об обновленном разделе каталога

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":0,
    "error_description":"Required fields: name"
}
Код Описание Значение
200040300040 Нет доступа к редактированию
200700300010 Ошибки при обновлении, например, идентификатор инфоблока обновляемого раздела не совпадает с идентификатором инфоблока раздела-родителя
200700300030 Раздела каталога с таким идентификатором не существует
200700300040 Нарушение уникальности поля code
200700300050 Инфоблока с заданным iblockId не существует
100 Не указан параметр id
100 Не указан или пустой параметр fields
0 Не переданы обязательные поля структуры fields
0 Другие ошибки (например, фатальные ошибки)

Что будем искать? Например,Продвижение

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