метод REST scope: catalog

catalog.productProperty.update

Изменить свойство товаров или вариаций

Кто может выполнять: пользователь с правом на просмотр каталога

Описание

Метод catalog.productProperty.update изменяет поля свойства товара или вариации.

Параметры

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

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

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

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

Набор полей для обновления свойства (подробное описание)

Параметр fields

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

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

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

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

Название свойства

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

Базовый тип свойства. Изменять нельзя

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

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

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

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

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

Символьный код свойства. Код свойства может состоять из латинских символов, цифр и знака подчеркивания. Первый символ не может быть цифрой

defaultValue text необязательный

Значение свойства по умолчанию

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

Пользовательский тип свойства. Изменять нельзя

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

Число строк поля ввода

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

Число колонок поля ввода

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

Внешний вид списка. Допустимые значения:
- L — выпадающий список
- C — набор флажков

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

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

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

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

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

Список расширений файлов для свойства типа F

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

Число полей для ввода множественных значений

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

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

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

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

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

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

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

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

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

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

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

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

Подсказка к полю

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

Настройки пользовательского типа. Поддерживаются только скалярные значения и вложенные объекты из скалярных значений.

Если указан userType, но не указан userTypeSettings, настройки не валидируются методом дополнительно

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"id":115,"fields":{"iblockId":19,"name":"Размер","propertyType":"L","isRequired":"Y","active":"Y"}}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.productProperty.update

Ответ

HTTP-статус: 200

{
    "result": {
        "productProperty": {
            "active": "Y",
            "code": null,
            "colCount": 30,
            "defaultValue": null,
            "fileType": null,
            "filtrable": "Y",
            "hint": null,
            "iblockId": 19,
            "id": 115,
            "name": "Размер",
            "isRequired": "Y",
            "linkIblockId": null,
            "listType": "L",
            "multiple": "N",
            "multipleCnt": null,
            "propertyType": "L",
            "rowCount": 1,
            "searchable": "N",
            "sort": 500,
            "timestampX": "2026-03-19T20:46:43+03:00",
            "userType": null,
            "userTypeSettings": null,
            "withDescription": null,
            "xmlId": null
        }
    },
    "time": {
        "start": 1773946003,
        "finish": 1773946003.953583,
        "duration": 0.9535830020904541,
        "processing": 0,
        "date_start": "2026-03-19T21:46:43+03:00",
        "date_finish": "2026-03-19T21:46:43+03:00",
        "operating_reset_at": 1773946603,
        "operating": 0
    }
}

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

result object

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

productProperty catalog_product_property

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

time time

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

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

HTTP-статус: 400

{
    "error": "0",
    "error_description": "Required fields: iblockId"
}
Код Описание Значение
400 0 Required fields: iblockId
400 0 Access Denied
400 Пустое значение productProperty does not exist
400 0 The specified property does not belong to a product catalog
400 0 Invalid property type specified
400 0 Invalid custom property type settings specified
400 0 Код свойства не может начинаться с цифры
400 0 Неверный код информационного блока
400 100 Invalid value {...} to match with parameter {id}. Should be value of type int
400 0 Wrong format of field ...
400 0 Error updating product property

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

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