метод REST scope: crm

crm.item.productrow.set

Сохранить товарную позицию объекта CRM

Кто может выполнять: требуется право на изменение объекта CRM, товарная позиция которого устанавливается

Описание

Метод сохраняет товарную позицию объекта CRM. Обратите внимание, что метод перезапишет все уже существующие товарные позиции, привязанные к объекту. Таким образом, метод заменяет уже существующие товарные позиции на те, что были присланы.

Параметры

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

Идентификатор объекта CRM

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

Идентификатор типа объекта CRM. Передавайте Краткий символьный код типа

productRows object[] обязательный

Массив объектов с информацией о товарных позициях, которые нужно сохранить в объекте

Параметр productRows

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

Идентификатор товара из каталога

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

Название товара в товарной позиции.
Если не передано и передано значение productId, то используется название товара из каталога товаров

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

Цена за единицу товарной позиции с учетом скидок и налогов

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

Количество товара.
По умолчанию — 1

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

Тип скидки.
Возможные значения:
- 1 — абсолютное значение
- 2 — процентное значение
По умолчанию — 2

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

Значение скидки в процентах (если используется тип скидки с процентным значением)

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

Абсолютное значение скидки (если используется тип скидки с абсолютным значением)

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

Ставка налога в процентах

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

Индикатор того, включен ли налог в стоимость.
Возможные значения:
- Y – налог включен
- N – налог не включен
По умолчанию - N

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

Код единицы измерения.
Если не передано и передано значение productId, то используется единица измерения из каталога товаров

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

Сортировка

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ownerType":"D","ownerId":13143,"productRows":[{"productId":9621,"price":99999.99,"quantity":1,"sort":10},{"productId":9623,"price":15900,"quantity":2,"sort":10}]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.productrow.set

Ответ

HTTP-статус: 200

{
   "result":{
      "productRows":[
         {
            "id":17654,
            "ownerId":13143,
            "ownerType":"D",
            "productId":9621,
            "productName":"iphone 14",
            "price":99999.99,
            "priceAccount":99999.99,
            "priceExclusive":99999.99,
            "priceNetto":99999.99,
            "priceBrutto":99999.99,
            "quantity":1,
            "discountTypeId":2,
            "discountRate":0,
            "discountSum":0,
            "taxRate":null,
            "taxIncluded":"N",
            "customized":"Y",
            "measureCode":796,
            "measureName":"шт",
            "sort":10,
            "xmlId":"",
            "type":4
         },
         {
            "id":17655,
            "ownerId":13143,
            "ownerType":"D",
            "productId":9623,
            "productName":"iphone 10xs",
            "price":15900,
            "priceAccount":15900,
            "priceExclusive":15900,
            "priceNetto":15900,
            "priceBrutto":15900,
            "quantity":2,
            "discountTypeId":2,
            "discountRate":0,
            "discountSum":0,
            "taxRate":null,
            "taxIncluded":"N",
            "customized":"Y",
            "measureCode":796,
            "measureName":"шт",
            "sort":10,
            "xmlId":"",
            "type":4
         }
      ]
   },
   "time":{
      "start":1716895718.887229,
      "finish":1716895719.316293,
      "duration":0.4290640354156494,
      "processing":0.20114707946777344,
      "date_start":"2024-05-28T14:28:38+03:00",
      "date_finish":"2024-05-28T14:28:39+03:00"
   }
}

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

result object

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

productRow crm_item_product_row[]

Массив объектов, содержащий информацию о всех товарных позициях объекта CRM

time time

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

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

HTTP-статус: 400

{
   "error":"OWNER_NOT_FOUND",
   "error_description":"Owner was not found"
}
Код Описание Значение
ENTITY_TYPE_NOT_SUPPORTED Работа с данным типом объектов не поддерживается
ACCESS_DENIED Доступ запрещен
OWNER_NOT_FOUND Переданный объект CRM не найден
100 Не переданы обязательные параметры
0 Другие ошибки (например, фатальные ошибки)

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

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