метод REST scope: sale

sale.basketitem.update

Изменить позицию корзины существующего заказа

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

Описание

Метод sale.basketitem.update изменяет позицию корзины существующего заказа.

Параметры

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

Идентификатор позиции заказа

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

Значения изменяемых полей

Параметр fields

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

Положение в списке позиций заказа

price double необязательный

Цена с учетом наценок и скидок

basePrice double необязательный

Исходная цена без учета наценок и скидок

discountPrice double необязательный

Величина итоговой скидки или наценки

quantity double необязательный

Количество товара

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

Внешний код позиции корзины

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

Название товара

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

Вес товара

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

Размеры товара (сериализованный массив)

measureCode catalog_measure.code необязательный

Код единицы измерения товара

measureName catalog_measure.symbol необязательный

Название единицы измерения

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

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

vatRate double необязательный

Ставка налога долей от единицы: 0.1 — это 10 %. Для указания
ставки «Без НДС» нужно передать пустую строку

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

Флаг того, включен ли НДС или налог в цену товара. Возможные значения:
- Y — да
- N — нет

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

Внешний код каталога товаров

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

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":6791,"fields":{"quantity":7,"price":10,"discountPrice":990}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.basketitem.update

Ответ

HTTP-статус: 200

{
    "result": {
        "basketItem": {
            "basePrice": 1000,
            "canBuy": "Y",
            "catalogXmlId": "",
            "currency": "RUB",
            "customPrice": "Y",
            "dateInsert": "2024-04-23T18:51:28+02:00",
            "dateUpdate": "2024-04-24T14:02:25+02:00",
            "dimensions": "a:3:{s:5:\"WIDTH\";i:244;s:6:\"HEIGHT\";i:100;s:6:\"LENGTH\";i:31;}",
            "discountPrice": 990,
            "id": 6791,
            "measureCode": "768",
            "measureName": "шт",
            "name": "Пробный товар",
            "orderId": 5147,
            "price": 10,
            "productId": 0,
            "productXmlId": "ProductKey",
            "properties": [],
            "quantity": 7,
            "reservations": [],
            "sort": 400,
            "type": null,
            "vatIncluded": "Y",
            "vatRate": 10,
            "weight": 40,
            "xmlId": "BasketPositionId"
        }
    },
    "total": 1,
    "time": {
        "start": 1713960144.842687,
        "finish": 1713960146.089664,
        "duration": 1.2469770908355713,
        "processing": 0.5501749515533447,
        "date_start": "2024-04-24T14:02:24+02:00",
        "date_finish": "2024-04-24T14:02:26+02:00",
        "operating": 0
    }
}

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

result object

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

basketItem sale_basket_item

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

total integer

Число обработанных записей

time time

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

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

HTTP-статус: 400

{
    "error":0,
    "error_description":"error"
}
Код Описание Значение
200140400001 basket item is not exists

Не найдена позиция корзины

200140400008 Required fields: fields[ORDER_ID]

Не указан идентификатор заказа

200140400009 Order not found

Заказ не найден

200140400011 Currency must be the currency of the order

Валюта позиции не совпадает с валютой заказа

200040300010 Недостаточно прав для изменения
100 Не указаны обязательные параметры
0 Другие ошибки (например, фатальные ошибки)

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

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