метод REST scope: catalog

catalog.price.modify

Обновить коллекцию цен товара

Кто может выполнять: пользователь с правом «Изменение цены продажи товара»

Описание

Метод catalog.price.modify изменяет коллекцию цен товара. Позволяет добавлять, обновлять и удалять разные цены товара за один запрос.

Параметры

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

Объект с данными для модификации цен (подробное описание)

Параметр fields

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

Данные товара и его цен (подробное описание)

Параметр product

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

Идентификатор товара, можно получить методами catalog.product.list, catalog.product.offer.list, catalog.product.service.list, catalog.product.sku.list

prices array обязательный

Массив цен товара (подробное описание)

Параметр prices

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

Идентификатор цены. Если указан, то цена будет обновлена. Если не указан, то будет создана новая цена. Цена, идентификатор которой не был передан, будет удалена. Получить идентификаторы цен можно методом catalog.price.list

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

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

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

Значение цены

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

Идентификатор валюты, можно получить методом crm.currency.list

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"product":{"id":8,"prices":[{"catalogGroupId":1,"currency":"RUB","price":2001},{"catalogGroupId":3,"currency":"RUB","price":2001},{"catalogGroupId":5,"currency":"RUB","price":2001,"id":122}]}}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.price.modify

Ответ

HTTP-статус: 200

{
    "result": {
        "prices": [
            {
                "catalogGroupId": 1,
                "currency": "RUB",
                "extraId": null,
                "id": 123,
                "price": 2001,
                "priceScale":2001,
                "productId": 8,
                "quantityFrom": null,
                "quantityTo": null,
                "timestampX": "2024-05-27T16:29:35+02:00"
            },
            {
                "catalogGroupId": 3,
                "currency": "RUB",
                "extraId": null,
                "id": 124,
                "price": 2001,
                "priceScale":2001,
                "productId": 8,
                "quantityFrom": null,
                "quantityTo": null,
                "timestampX": "2024-05-27T16:29:35+02:00"
            },
            {
                "catalogGroupId": 5,
                "currency": "RUB",
                "extraId": null,
                "id": 122,
                "price": 2001,
                "priceScale":2001,
                "productId": 8,
                "quantityFrom": null,
                "quantityTo": null,
                "timestampX": "2024-05-27T16:29:35+02:00"
            }
        ]
    },
    "time": {
        "start": 1712327086.69665,
        "finish": 1712327086.95303,
        "duration": 0.256376028060913,
        "processing": 0.0112268924713135,
        "date_start": "2024-05-27T16:29:35+02:00",
        "date_finish": "2024-05-27T16:29:35+02:00",
        "operating": 0
    }
}

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

result object

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

prices catalog_price[]

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

time time

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

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

HTTP-статус: 400

{
    "error": 0,
    "error_description": "Required fields: price, currency"
}
Код Описание Значение
200040300020 Access Denied Недостаточно прав на редактирование цены
200040300030 Access Denied Недостаточно прав на редактирование товара
100 Could not find value for parameter {fields} Не указан или пустой параметр fields
0 Required fields: Не переданы обязательные поля
0 Validate price error. Catalog price group is wrong Неправильный тип цены
0 Validate price error. Catalog product is allowed has only single price without ranges in price group Дублирование типа цены. Были переданы в массиве prices две или более записей с одинаковым catalogGroupId
0 Другие ошибки

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

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