метод REST scope: sale

sale.basketproperties.add

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

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

Описание

Метод sale.basketproperties.add добавляет свойство для элемента корзины в заказе.

Параметры

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

Значения полей (подробное описание приведено ниже) для создания свойства элемента (позиции) корзины:

fields: {
    basketId: "значение",
    name: "значение",
    value: "значение",
    code: "значение",
    sort: "значение",
    xmlId: "значение",
}

Параметр fields

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

Идентификатор элемента (позиции) корзины заказа.
Может быть получен методами sale.basketitem.get или sale.basketitem.list

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

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

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

Значение свойства

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

Символьный код свойства

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

Положение в списке свойств.
Если не указать, будет присвоено значение по умолчанию — 100

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

Внешний код свойства.
Если не указать, будет сгенерирован автоматически

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"basketId":6806,"name":"Артикул","value":"4653-4877","code":"ARTICUL"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.basketproperties.add

Ответ

HTTP-статус: 200

{
    "result": {
        "basketProperty": {
            "basketId": 6806,
            "code": "ARTICUL",
            "id": 17,
            "name": "Артикул",
            "value": "4653-4877",
            "xmlId": "bx_662a44cff2b81"
        }
    },
    "time": {
        "start": 1714046159.109796,
        "finish": 1714046163.282623,
        "duration": 4.1728270053863525,
        "processing": 3.4128189086914062,
        "date_start": "2024-04-25T13:55:59+02:00",
        "date_finish": "2024-04-25T13:56:03+02:00",
        "operating": 0
    }
}

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

result object

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

basketProperty sale_basket_item_property

Объект с данными созданного свойства элемента (позиции) корзины

time time

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

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

HTTP-статус: 400

{
    "error":0,
    "error_description":"error"
}
Код Описание Значение
200040300010 Недостаточно прав для добавления
200240400004 Basket item id is absent
Не указан идентификатор элемента (позиции) корзины
200240400005 Basket item id is bad
Неверный идентификатор элемента (позиции) корзины — например, строка ‘семьдесят’
200240400001, 200240400002 Не найден элемент (позиция) корзины
100 Не указан или пустой параметр fields
0 Другие ошибки (например, фатальные ошибки)

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

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