# crm.deal.productrows.set URL: https://chugunov.pro/api-bitrix24/crm/deals/crm-deal-productrows-set/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Установить товары в сделку Scope: `crm` Кто может выполнять метод: пользователь с правом «изменения» сделки > Устаревший метод. Развитие метода остановлено. Используйте crm.item.productrow.. ## Описание Метод `crm.deal.productrows.set` создает или обновляет товарные позиции сделки. Существующие позиции, не переданные в метод, будут удалены из сделки. Чтобы изменить только одну позицию, используйте методы [crm.item.productrow.*](https://chugunov.pro/api-bitrix24/crm/universal/product-rows/). #| || **Название** `тип` | **Описание** || || **id^*^** [`integer`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Идентификатор сделки. Можно получить с помощью метода получения списка сделок: [`crm.deal.list`](https://chugunov.pro/api-bitrix24/crm/deals/crm-deal-list/) или при создании сделки: [`crm.deal.add`](https://chugunov.pro/api-bitrix24/crm/deals/crm-deal-add/) || || **rows** [`object[]`](#parameter-rows) | Товарные позиции Массив объектов, вида: ``` { field_1: value_1, field_2: value_2, ..., field_n: value_n, } ``` где - `field_n` — название поля товарной позиции - `value_n` — значение данного поля Список доступных полей описан [ниже](#parameter-rows) || |# ### Список доступных полей у товарных позиций #| || **Название** `тип` | **Описание** || || **PRODUCT_ID** [`integer`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Идентификатор товара в каталоге. Можно получить список товаров с помощью метода [`catalog.product.list`](https://chugunov.pro/api-bitrix24/catalog/product/catalog-product-list/) `0` если не из каталога По умолчанию - `0` || || **PRODUCT_NAME** [`string`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Наименование товарной позиции. Если передан `PRODUCT_ID`, то название будет взято у товара Если поля `PRODUCT_ID` и `PRODUCT_NAME` не переданы, то `PRODUCT_NAME` будет равен `[{id}]`, где `{id}` - Идентификатор созданной товарной позиции || || **PRICE** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Итоговая стоимость товара за единицу По умолчанию - `0.0` || || **PRICE_EXCLUSIVE** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Стоимость за единицу с учетом скидок, без учета налогов || || **PRICE_NETTO** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Стоимость за единицу без учета скидок и налогов || || **PRICE_BRUTTO** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Стоимость за единицу без учета скидок, но с учетом налогов || || **QUANTITY** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Количество единиц товара По умолчанию - `1.0` || || **DISCOUNT_TYPE_ID** [`integer`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Тип скидки Возможные типы: - `1` - Абсолютный - `2` - Процентный По умолчанию - `2` || || **DISCOUNT_RATE** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Значение скидки в процентах (если используется тип скидки с процентным значением) По умолчанию - `0.0` || || **DISCOUNT_SUM** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Абсолютное значение скидки (если используется тип скидки с абсолютным значением) По умолчанию - `0.0` || || **TAX_RATE** [`double`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Ставка налога в процентах || || **TAX_INCLUDED** [`char`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Индикатор того, включен ли налог в стоимость Возможные значения: - `Y` – налог включен - `N` – налог не включен По умолчанию - `N` || || **MEASURE_CODE** [`catalog_measure.code`](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_measure) | Код единицы измерения Если передан `PRODUCT_ID`, то по умолчанию будет взято значение из товара, иначе `0` || || **MEASURE_NAME** [`string`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Текстовое представление единицы измерения (например - шт, кг, м, л и т.д.) Если передан `PRODUCT_ID`, то по умолчанию будет взято значение из товара, иначе `""` || || **SORT** [`integer`](https://apidocs.bitrix24.ru/api-reference/data-types.html) | Сортировка По умолчанию - `0` || |# ## Ответ HTTP-статус: 200 ```json { "result": true, "time": { "start": 1735134795.171273, "finish": 1735134796.404978, "duration": 1.2337050437927246, "processing": 0.9462978839874268, "date_start": "2024-12-25T15:53:15+02:00", "date_finish": "2024-12-25T15:53:16+02:00", "operating": 0 } } ``` ### Возвращаемые данные - `result` `boolean`. Корневой элемент ответа, содержит `true` в случае успеха - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error": "ERROR_CORE", "error_description": "Discount Sum (DISCOUNT_SUM) is required if Percentage Discount Type (DISCOUNT_TYPE_ID) is defined and Discount Rate (DISCOUNT_RATE) is 100%
" } ``` - `The parameter id is invalid or not defined` — В параметр `id` передано некорректное значение - `Access denied` — У пользователя нет прав на «изменение» сделки - `Not found` — Сделка с переданным `id` не найдена - `Discount Rate (DISCOUNT_RATE) is required if Percentage Discount Type (DISCOUNT_TYPE_ID) is defined` — Было передано `DISCOUNT_TYPE_ID = 2` и не передано `DISCOUNT_RATE` - `Discount Sum (DISCOUNT_SUM) is required if Percentage Discount Type (DISCOUNT_TYPE_ID) is defined and Discount Rate (DISCOUNT_RATE) is 100%` — Было передано `DISCOUNT_RATE = 100` и `DISCOUNT_TYPE_ID = 2` и не передано `DISCOUNT_SUM` - `Discount Sum (DISCOUNT_SUM) is required if Monetary Discount Type (DISCOUNT_TYPE_ID) is defined` — Было передано `DISCOUNT_TYPE_ID = 1` и не передано `DISCOUNT_SUM` ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"id":5,"rows":[{"PRODUCT_ID":456,"PRICE":1000,"QUANTITY":10,"DISCOUNT_TYPE_ID":1,"DISCOUNT_SUM":100,"TAX_RATE":13,"MEASURE_CODE":796,"MEASURE_NAME":"шт","SORT":10},{"PRODUCT_NAME":"Товар #2","PRICE":500,"QUANTITY":5,"DISCOUNT_TYPE_ID":2,"DISCOUNT_RATE":10,"TAX_RATE":10,"MEASURE_CODE":166,"MEASURE_NAME":"кг","SORT":20}]}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.deal.productrows.set ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"id":5,"rows":[{"PRODUCT_ID":456,"PRICE":1000,"QUANTITY":10,"DISCOUNT_TYPE_ID":1,"DISCOUNT_SUM":100,"TAX_RATE":13,"MEASURE_CODE":796,"MEASURE_NAME":"шт","SORT":10},{"PRODUCT_NAME":"Товар #2","PRICE":500,"QUANTITY":5,"DISCOUNT_TYPE_ID":2,"DISCOUNT_RATE":10,"TAX_RATE":10,"MEASURE_CODE":166,"MEASURE_NAME":"кг","SORT":20}],"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/crm.deal.productrows.set ``` ### JS (TS) ```ts // This snippet is an ES module: top-level await requires type="module" or a bundler. // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide). import { Text } from '@bitrix24/b24jssdk' import type { B24Frame } from '@bitrix24/b24jssdk' declare const $b24: B24Frame try { const response = await $b24.actions.v2.call.make({ method: 'crm.deal.productrows.set', params: { id: 5, rows: [ { PRODUCT_ID: 456, PRICE: 1000, QUANTITY: 10, DISCOUNT_TYPE_ID: 1, DISCOUNT_SUM: 100, TAX_RATE: 13, MEASURE_CODE: 796, MEASURE_NAME: 'pcs', SORT: 10, }, { PRODUCT_NAME: 'Product #2', PRICE: 500, QUANTITY: 5, DISCOUNT_TYPE_ID: 2, DISCOUNT_RATE: 10, TAX_RATE: 10, MEASURE_CODE: 166, MEASURE_NAME: 'kg', SORT: 20, }, ], }, requestId: Text.getUuidRfc4122() }) // The payload is available only on a successful response if (!response.isSuccess) { console.error(response.getErrorMessages().join('; ')) } else { const result = response.getData()!.result console.info('Product rows set:', result) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException try: bitrix_response = client.crm.deal.productrows.set( bitrix_id=123, rows=[ {"PRODUCT_ID": 1001, "PRICE": 1200, "QUANTITY": 2, "CURRENCY_ID": "USD", "TAX_RATE": 20}, {"PRODUCT_NAME": "Implementation Service", "PRICE": 5000, "QUANTITY": 1, "CURRENCY_ID": "USD", "TAX_RATE": 0}, ], ).response result = bitrix_response.result print(result) except BitrixAPIError as error: print( "Ошибка Bitrix API", f"error: {error.error}", f"error_description: {error.error_description}", sep="\n", ) except BitrixSDKException as error: print(f"Ошибка Bitrix SDK: {error.message}") except Exception as error: print(f"Непредвиденная ошибка: {error}") ``` ### PHP ```php try { $response = $b24Service ->core ->call( 'crm.deal.productrows.set', [ 'id' => 5, 'rows' => [ [ 'PRODUCT_ID' => 456, 'PRICE' => 1000, 'QUANTITY' => 10, 'DISCOUNT_TYPE_ID' => 1, 'DISCOUNT_SUM' => 100, 'TAX_RATE' => 13, 'MEASURE_CODE' => 796, 'MEASURE_NAME' => "шт", 'SORT' => 10, ], [ 'PRODUCT_NAME' => "Товар #2", 'PRICE' => 500, 'QUANTITY' => 5, 'DISCOUNT_TYPE_ID' => 2, 'DISCOUNT_RATE' => 10, 'TAX_RATE' => 10, 'MEASURE_CODE' => 166, 'MEASURE_NAME' => "кг", 'SORT' => 20, ], ], ] ); $result = $response ->getResponseData() ->getResult(); if ($result->error()) { error_log($result->error()); echo 'Error: ' . $result->error(); } else { echo 'Success: ' . print_r($result->data(), true); } } catch (Throwable $e) { error_log($e->getMessage()); echo 'Error setting deal product rows: ' . $e->getMessage(); } ``` ### BX24.js ```js BX24.callMethod( 'crm.deal.productrows.set', { id: 5, rows: [ { PRODUCT_ID: 456, PRICE: 1000, QUANTITY: 10, DISCOUNT_TYPE_ID: 1, DISCOUNT_SUM: 100, TAX_RATE: 13, MEASURE_CODE: 796, MEASURE_NAME: "шт", SORT: 10, }, { PRODUCT_NAME: "Товар #2", PRICE: 500, QUANTITY: 5, DISCOUNT_TYPE_ID: 2, DISCOUNT_RATE: 10, TAX_RATE: 10, MEASURE_CODE: 166, MEASURE_NAME: "кг", SORT: 20, }, ], }, (result) => { result.error() ? console.error(result.error()) : console.info(result.data()) ; }, ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'crm.deal.productrows.set', [ 'id' => 5, 'rows' => [ [ 'PRODUCT_ID' => 456, 'PRICE' => 1000, 'QUANTITY' => 10, 'DISCOUNT_TYPE_ID' => 1, 'DISCOUNT_SUM' => 100, 'TAX_RATE' => 13, 'MEASURE_CODE' => 796, 'MEASURE_NAME' => "шт", 'SORT' => 10, ], [ 'PRODUCT_NAME' => "Товар #2", 'PRICE' => 500, 'QUANTITY' => 5, 'DISCOUNT_TYPE_ID' => 2, 'DISCOUNT_RATE' => 10, 'TAX_RATE' => 10, 'MEASURE_CODE' => 166, 'MEASURE_NAME' => "кг", 'SORT' => 20, ], ] ] ); echo '
';
print_r($result);
echo '
'; ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "crm.deal.productrows.set", b24.Params{ "id": 5, "rows": []b24.Params{ { "PRODUCT_ID": 456, "PRICE": 1000, "QUANTITY": 10, "DISCOUNT_TYPE_ID": 1, "DISCOUNT_SUM": 100, "TAX_RATE": 13, "MEASURE_CODE": 796, "MEASURE_NAME": "шт", "SORT": 10, }, { "PRODUCT_NAME": "Товар #2", "PRICE": 500, "QUANTITY": 5, "DISCOUNT_TYPE_ID": 2, "DISCOUNT_RATE": 10, "TAX_RATE": 10, "MEASURE_CODE": 166, "MEASURE_NAME": "кг", "SORT": 20, }, }, }) if err != nil { return fmt.Errorf("crm.deal.productrows.set: %w", err) } var ok bool if err := json.Unmarshal(res.Result, &ok); err != nil { return fmt.Errorf("разбор ответа: %w", err) } fmt.Println("выполнено:", ok) ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/crm/deals/crm-deal-productrows-set.html