метод REST scope: sale

sale.propertyvariant.add

Добавить вариант свойства

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

Описание

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

Параметры

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

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

Параметр fields

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

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

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

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

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

Символьный код варианта значения свойства

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

Сортировка

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

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

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

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

Ответ

HTTP-статус: 200

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

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

result object

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

propertyVariant sale_order_property_variant

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

time time

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

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

HTTP-статус: 400

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

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

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