Установить товарные позиции предложения crm.quote.productrows.set

Scope: crm

Кто может выполнять метод: пользователь с правом «изменения» коммерческих предложений

DEPRECATED

Развитие метода остановлено. Используйте crm.item.productrow.*.

Метод crm.quote.productrows.set создает или обновляет товарные позиции коммерческого предложения.

Чтобы изменить только одну позицию, используйте методы crm.item.productrow.*.

Параметры метода

Обязательные параметры отмечены *

Название
тип

Описание

id*
integer

Идентификатор коммерческого предложения.

Идентификатор можно получить с помощью методов crm.quote.list или crm.quote.add

rows
object[]

Массив товарных позиций.

Формат элемента массива:

{
            "field_1": "value_1",
            "field_2": "value_2",
            "...": "..."
        }

где:

field_n — название поля товарной позиции
value_n — значение поля

Список основных полей описан ниже

Список доступных полей у товарных позиций

Название `тип`	Описание
PRODUCT_ID `integer`	Идентификатор товара в каталоге. Список товаров можно получить методом catalog.product.list. Если `PRODUCT_ID = 0`, позиция создается как «произвольная»
PRODUCT_NAME `string`	Наименование товарной позиции
PRODUCT_DESCRIPTION `string`	Описание товарной позиции
PRICE `double`	Итоговая стоимость товара за единицу
QUANTITY `double`	Количество единиц товара
DISCOUNT_TYPE_ID `integer`	Тип скидки: `1` — абсолютная `2` — процентная
DISCOUNT_RATE `double`	Значение скидки в процентах
DISCOUNT_SUM `double`	Абсолютное значение скидки
TAX_RATE `double`	Ставка налога в процентах
TAX_INCLUDED `char`	Включен ли налог в стоимость: `Y` — да `N` — нет
MEASURE_CODE `catalog_measure.code`	Код единицы измерения
MEASURE_NAME `string`	Текстовое представление единицы измерения
SORT `integer`	Сортировка

Полный список полей товарной позиции и типов можно получить методом crm.productrow.fields.

Примеры кода

Как использовать примеры в документации

Установить две товарные позиции для предложения с id = 1.

cURL (Webhook)

cURL (OAuth)

PHP

BX24.js

PHP CRest

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":1,"rows":[{"PRODUCT_ID":459,"PRICE":3000,"QUANTITY":1,"DISCOUNT_TYPE_ID":2,"DISCOUNT_RATE":0,"TAX_RATE":0,"TAX_INCLUDED":"Y","MEASURE_CODE":796,"MEASURE_NAME":"шт","SORT":10},{"PRODUCT_NAME":"Услуга сопровождения","PRICE":1500,"QUANTITY":2,"DISCOUNT_TYPE_ID":2,"DISCOUNT_RATE":0,"TAX_RATE":0,"TAX_INCLUDED":"Y","MEASURE_CODE":796,"MEASURE_NAME":"шт","SORT":20}]}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.quote.productrows.set

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":1,"rows":[{"PRODUCT_ID":459,"PRICE":3000,"QUANTITY":1,"DISCOUNT_TYPE_ID":2,"DISCOUNT_RATE":0,"TAX_RATE":0,"TAX_INCLUDED":"Y","MEASURE_CODE":796,"MEASURE_NAME":"шт","SORT":10},{"PRODUCT_NAME":"Услуга сопровождения","PRICE":1500,"QUANTITY":2,"DISCOUNT_TYPE_ID":2,"DISCOUNT_RATE":0,"TAX_RATE":0,"TAX_INCLUDED":"Y","MEASURE_CODE":796,"MEASURE_NAME":"шт","SORT":20}],"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.quote.productrows.set

try
        {
        	const response = await $b24.callMethod(
        		'crm.quote.productrows.set',
        		{
        			id: 1,
        			rows: [
        				{
        					PRODUCT_ID: 459,
        					PRICE: 3000,
        					QUANTITY: 1,
        					DISCOUNT_TYPE_ID: 2,
        					DISCOUNT_RATE: 0,
        					TAX_RATE: 0,
        					TAX_INCLUDED: 'Y',
        					MEASURE_CODE: 796,
        					MEASURE_NAME: 'шт',
        					SORT: 10,
        				},
        				{
        					PRODUCT_NAME: 'Услуга сопровождения',
        					PRICE: 1500,
        					QUANTITY: 2,
        					DISCOUNT_TYPE_ID: 2,
        					DISCOUNT_RATE: 0,
        					TAX_RATE: 0,
        					TAX_INCLUDED: 'Y',
        					MEASURE_CODE: 796,
        					MEASURE_NAME: 'шт',
        					SORT: 20,
        				},
        			],
        		}
        	);
        
        	const result = response.getData().result;
        	console.info(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }

try {
            $response = $b24Service
                ->core
                ->call(
                    'crm.quote.productrows.set',
                    [
                        'id' => 1,
                        'rows' => [
                            [
                                'PRODUCT_ID' => 459,
                                'PRICE' => 3000,
                                'QUANTITY' => 1,
                                'DISCOUNT_TYPE_ID' => 2,
                                'DISCOUNT_RATE' => 0,
                                'TAX_RATE' => 0,
                                'TAX_INCLUDED' => 'Y',
                                'MEASURE_CODE' => 796,
                                'MEASURE_NAME' => 'шт',
                                'SORT' => 10,
                            ],
                            [
                                'PRODUCT_NAME' => 'Услуга сопровождения',
                                'PRICE' => 1500,
                                'QUANTITY' => 2,
                                'DISCOUNT_TYPE_ID' => 2,
                                'DISCOUNT_RATE' => 0,
                                'TAX_RATE' => 0,
                                'TAX_INCLUDED' => 'Y',
                                'MEASURE_CODE' => 796,
                                'MEASURE_NAME' => 'шт',
                                'SORT' => 20,
                            ],
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Updated: ' . ($result ? 'true' : 'false');
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error setting quote product rows: ' . $e->getMessage();
        }

BX24.callMethod(
            'crm.quote.productrows.set',
            {
                id: 1,
                rows: [
                    {
                        PRODUCT_ID: 459,
                        PRICE: 3000,
                        QUANTITY: 1,
                        DISCOUNT_TYPE_ID: 2,
                        DISCOUNT_RATE: 0,
                        TAX_RATE: 0,
                        TAX_INCLUDED: 'Y',
                        MEASURE_CODE: 796,
                        MEASURE_NAME: 'шт',
                        SORT: 10,
                    },
                    {
                        PRODUCT_NAME: 'Услуга сопровождения',
                        PRICE: 1500,
                        QUANTITY: 2,
                        DISCOUNT_TYPE_ID: 2,
                        DISCOUNT_RATE: 0,
                        TAX_RATE: 0,
                        TAX_INCLUDED: 'Y',
                        MEASURE_CODE: 796,
                        MEASURE_NAME: 'шт',
                        SORT: 20,
                    },
                ],
            },
            (result) => {
                result.error()
                    ? console.error(result.error())
                    : console.info(result.data())
                ;
            },
        );

require_once('crest.php');
        
        $result = CRest::call(
            'crm.quote.productrows.set',
            [
                'id' => 1,
                'rows' => [
                    [
                        'PRODUCT_ID' => 459,
                        'PRICE' => 3000,
                        'QUANTITY' => 1,
                        'DISCOUNT_TYPE_ID' => 2,
                        'DISCOUNT_RATE' => 0,
                        'TAX_RATE' => 0,
                        'TAX_INCLUDED' => 'Y',
                        'MEASURE_CODE' => 796,
                        'MEASURE_NAME' => 'шт',
                        'SORT' => 10,
                    ],
                    [
                        'PRODUCT_NAME' => 'Услуга сопровождения',
                        'PRICE' => 1500,
                        'QUANTITY' => 2,
                        'DISCOUNT_TYPE_ID' => 2,
                        'DISCOUNT_RATE' => 0,
                        'TAX_RATE' => 0,
                        'TAX_INCLUDED' => 'Y',
                        'MEASURE_CODE' => 796,
                        'MEASURE_NAME' => 'шт',
                        'SORT' => 20,
                    ],
                ],
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
            "result": true,
            "time": {
                "start": 1773416018,
                "finish": 1773416018.877651,
                "duration": 0.8776509761810303,
                "processing": 0,
                "date_start": "2026-03-13T18:33:38+03:00",
                "date_finish": "2026-03-13T18:33:38+03:00",
                "operating_reset_at": 1773416618,
                "operating": 0.5666530132293701
            }
        }

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

Название
тип

Описание

result
boolean

Корневой элемент ответа. Содержит:

true — товарные позиции успешно сохранены
false — товарные позиции не сохранены

time
time

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

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

HTTP-статус: 400

{
            "error": "",
            "error_description": "Not found."
        }

Название `тип`	Описание
error `string`	Строковый код ошибки. Может состоять из цифр, латинских букв и знака подчеркивания
error_description `error_description`	Текстовое описание ошибки. Описание не предназначено для показа конечному пользователю в необработанном виде

Возможные коды ошибок

Код	Описание	Значение
`-`	`The parameter id is invalid or not defined.`	В параметр `id` не передано значение или передано невалидное значение
`-`	`The parameter rows must be array.`	В параметр `rows` передан не массив
`-`	`Access denied.`	У пользователя нет прав на изменение коммерческого предложения
`-`	`Not found.`	Коммерческое предложение с переданным `id` не найдено
`-`	Текст ошибки проверки прав каталога	Ошибка проверки прав на товары каталога и/или ограничения каталога для переданных позиций

Статусы и коды системных ошибок

HTTP-статус: 20x, 40x, 50x

Описанные ниже ошибки могут возникнуть при вызове любого метода

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`405`	`ERROR_BATCH_METHOD_NOT_ALLOWED` Method is not allowed for batch usage	Текущий метод не разрешен для вызова с помощью batch
`400`	`ERROR_BATCH_LENGTH_EXCEEDED` Max batch length exceeded	Превышена максимальная длина параметров, переданных в метод batch
`401`	`NO_AUTH_FOUND` Wrong authorization data	Неверный access-токен или код вебхука
`400`	`INVALID_REQUEST` Https required	Для вызовов методов требуется использовать протокол HTTPS
`503`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24
`403`	`ACCESS_DENIED` REST API is available only on commercial plans	REST API доступен только на коммерческих планах
`403`	`INVALID_CREDENTIALS` Invalid request credentials	У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав
`404`	`ERROR_MANIFEST_IS_NOT_AVAILABLE` Manifest is not available	Манифест недоступен
`403`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более высоких привилегий, чем предоставляет токен вебхука
`401`	`expired_token` The access token provided has expired	Предоставленный access-токен доступа истек
`403`	`user_access_error` The user does not have access to the application	Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям
`500`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Получить товарные позиции предложения

Обзор методов

Установить товарные позиции предложения crm.quote.productrows.set

Параметры методаПараметры метода

Список доступных полей у товарных позицийСписок доступных полей у товарных позиций

Примеры кодаПримеры кода

Обработка ответаОбработка ответа

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

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

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

Продолжите изучениеПродолжите изучение