метод REST scope: catalog

catalog.productPropertyEnum.update

Изменить значение списочного свойства

Кто может выполнять: пользователь с правом «Просмотр каталога товаров» и правом на изменение инфоблока свойства

Описание

Метод catalog.productPropertyEnum.update изменяет значение списочного свойства.

Параметры

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

Идентификатор значения списочного свойства.

Идентификатор можно получить методом catalog.productPropertyEnum.list

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

Набор полей обновляемого значения списка (подробное описание)

Параметр fields

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

Идентификатор свойства товара или вариации.

Идентификаторы свойств можно получить методом catalog.productProperty.list

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

Значение элемента списка

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

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

def char необязательный

Признак значения по умолчанию. Допустимые значения:
- Y — по умолчанию
- N — не по умолчанию

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

Индекс сортировки

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"id":1739,"fields":{"propertyId":431,"value":"Средний","xmlId":"M","def":"N","sort":110}}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.productPropertyEnum.update

Ответ

HTTP-статус: 200

{
    "result": {
        "productPropertyEnum": {
        "def": "N",
        "id": 1739,
        "propertyId": 431,
        "sort": 110,
        "value": "Средний",
        "xmlId": "M"
        }
    },
    "time": {
        "start": 1774339029,
        "finish": 1774339030.119726,
        "duration": 1.1197259426116943,
        "processing": 1,
        "date_start": "2026-03-24T10:57:09+03:00",
        "date_finish": "2026-03-24T10:57:10+03:00",
        "operating_reset_at": 1774339629,
        "operating": 0.1804349422454834
    }
}

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

result object

Корневой объект ответа

productPropertyEnum catalog_product_property_enum

Объект обновленного значения списочного свойства

time time

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

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

HTTP-статус: 400

{
    "error": "0",
    "error_description": "productPropertyEnum does not exist."
}
Код Описание Значение
0 Access Denied Недостаточно прав для изменения свойства инфоблока
0 productPropertyEnum does not exist. Значение списочного свойства с переданным id не найдено или не относится к торговому каталогу
0 The specified property does not belong to a product catalog Свойство с переданным propertyId не относится к торговому каталогу
0 Required fields: xmlId Не передано обязательное поле xmlId
0 Internal error updating enumeration value. Try updating again. Внутренняя ошибка при обновлении значения списка
100 Could not find value for parameter {id} Не передан обязательный параметр id

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

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