метод REST scope: catalog

catalog.productPropertyEnum.add

Добавить значение списочного свойства

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

Описание

Метод catalog.productPropertyEnum.add добавляет значение списочного свойства.

Параметры

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 '{"fields":{"propertyId":431,"value":"Средний","xmlId":"M","def":"Y","sort":100}}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.productPropertyEnum.add

Ответ

HTTP-статус: 200

{
    "result": {
        "productPropertyEnum": {
        "def": "Y",
        "id": 1739,
        "propertyId": 431,
        "sort": 100,
        "value": "Средний",
        "xmlId": "M"
        }
    },
    "time": {
        "start": 1774279799,
        "finish": 1774279799.330864,
        "duration": 0.33086395263671875,
        "processing": 0,
        "date_start": "2026-03-23T18:29:59+03:00",
        "date_finish": "2026-03-23T18:29:59+03:00",
        "operating_reset_at": 1774280399,
        "operating": 0
    }
}

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

result object

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

productPropertyEnum catalog_product_property_enum

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

time time

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

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

HTTP-статус: 400

{
    "error": "BX_INVALID_VALUE",
    "error_description": "Запись со значением Внешний код, равным ..., уже есть в базе данных"
}
Код Описание Значение
0 Access Denied Недостаточно прав для изменения свойства инфоблока
0 productPropertyEnum does not exist. Свойство с переданным propertyId не найдено или не относится к торговому каталогу
0 Only list properties are supported Передано свойство, тип которого не Список
0 Required fields: xmlId Не передано обязательное поле xmlId
0 A value with xmlId '...' already exists. Значение с таким xmlId уже существует в рамках свойства
BX_INVALID_VALUE Запись со значением "Внешний код", равным "...", уже есть в базе данных Локализованная ошибка дубликата xmlId
0 Internal error adding enumeration value. Try adding again. Внутренняя ошибка при добавлении значения списка

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

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