метод REST scope: crm

crm.item.productrow.add

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

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

Описание

Метод добавляет товарную позицию в объект CRM.

Параметры

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

Объект, содержащий значения полей для добавления товарной позиции в объект CRM

Параметр fields

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

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

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

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

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 '{"fields":{"ownerId":13142,"ownerType":"D","productId":9621,"price":80000,"quantity":2,"discountTypeId":2,"discountRate":20,"taxRate":20,"taxIncluded":"Y","measureCode":796,"sort":10}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.productrow.add

Ответ

HTTP-статус: 200

{
   "result":{
      "productRow":{
         "id":17647,
         "ownerId":13142,
         "ownerType":"D",
         "productId":9621,
         "price":80000,
         "quantity":2,
         "discountTypeId":2,
         "discountRate":20,
         "taxRate":20,
         "taxIncluded":"Y",
         "measureCode":796,
         "sort":10,
         "type":4,
         "productName":"iphone 14",
         "priceAccount":80000,
         "priceExclusive":66666.67,
         "priceNetto":83333.34,
         "priceBrutto":100000.01,
         "discountSum":16666.67,
         "customized":"Y",
         "measureName":"шт",
         "xmlId":""
      }
   },
   "time":{
      "start":1716887721.77879,
      "finish":1716887723.259695,
      "duration":1.4809050559997559,
      "processing":1.2986550331115723,
      "date_start":"2024-05-28T12:15:21+03:00",
      "date_finish":"2024-05-28T12:15:23+03:00"
   }
}

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

result object

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

productRow crm_item_product_row

Объект, содержащий информацию о добавленной товарной позиции

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 Другие ошибки (например, фатальные ошибки)

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

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