метод REST scope: sale

sale.propertyvariant.update

Обновить поля варианта свойства

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

Описание

Метод sale.propertyvariant.update обновляет вариант значения свойства. Метод актуален только для свойств с типом ENUM.

Параметры

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

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

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

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

Параметр fields

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

Название варианта значения свойства

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

Значение (код) варианта значения свойства

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

Сортировка

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

Описание варианта значения свойства

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":5,"fields":{"name":"Красный","value":"red","sort":10,"description":"Новое описание значения для красного цвета"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.propertyvariant.update

Ответ

HTTP-статус: 200

{
    "result":{
        "propertyVariant":{
            "description":"Новое описание значения для красного цвета",
            "id":5,
            "name":"Красный",
            "orderPropsId":49,
            "sort":10,
            "value":"red"
        }
    },
    "time":{
        "start":1711630589.257634,
        "finish":1711630589.527446,
        "duration":0.26981210708618164,
        "processing":0.010741949081420898,
        "date_start":"2024-03-28T15:56:29+03:00",
        "date_finish":"2024-03-28T15:56:29+03:00"
    }
}

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

result object

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

propertyVariant sale_order_property_variant

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

time time

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

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

HTTP-статус: 400

{
    "error":0,
    "error_description":"Required fields: name"
}
Код Описание Значение
201540400001 Обновляемый вариант значения свойства не найден
200040300020 Недостаточно прав для обновления варианта значения свойства
100 Не указан параметр id
100 Не указан или пустой параметр fields
0 Не переданы обязательные поля структуры fields
0 Другие ошибки (например, фатальные ошибки)
ERROR_NO_VALUE Передано пустое значение символьного кода значения варианта свойства
ERROR_NO_NAME Передано пустое значение названия значения варианта свойства

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

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