метод REST scope: crm Устаревший

crm.quote.update

Изменить коммерческое предложение

Устаревший метод. Развитие метода остановлено. Используйте crm.item.update.

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

Описание

Метод crm.quote.update обновляет существующее коммерческое предложение.

Параметры

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

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

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

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

Объект формата:

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

где:
- field_n — название поля
- value_n — новое значение поля

Передавайте в fields только те поля, которые нужно изменить.

Неизвестные поля в fields игнорируются.

Список основных полей для обновления — ниже.

Полный список полей и типов можно получить методом crm.quote.fields

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

Объект дополнительных параметров (подробное описание)

Параметр fields

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

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

Ограничение длины — до 255 символов.

Если передать значение длиннее 255, система обрежет его до 255 символов

STATUS_ID crm_status необязательный

Стадия предложения.

Список доступных стадий можно получить методом crm.status.list с фильтром ENTITY_ID = QUOTE_STATUS

CURRENCY_ID crm_currency необязательный

Валюта суммы предложения

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

Сумма предложения

ASSIGNED_BY_ID user необязательный

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

COMPANY_ID crm_company необязательный

Идентификатор компании-клиента

CONTACT_IDS crm_contact[] необязательный

Массив идентификаторов контактов клиента.

Поле изменяется полностью

MYCOMPANY_ID crm_company необязательный

Идентификатор «вашей компании» для реквизитов продавца

OPENED char необязательный

Доступно ли предложение для всех. Возможные значения:
- Y — да
- N — нет

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

Идентификатор типа клиента

BEGINDATE date необязательный

Дата выставления

CLOSEDATE date необязательный

Срок действия предложения

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

Название клиента, до 255 символов

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

Адрес клиента, до 255 символов

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

Email клиента, до 255 символов

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

Телефон клиента, до 255 символов

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

Комментарий

PARENT_ID_... crm_entity необязательный

Поля связей со смарт-процессами.

Например, PARENT_ID_136 — связь со смарт-процессом entityTypeId = 136

Параметр params

REGISTER_HISTORY_EVENT boolean необязательный

Создавать ли запись в истории изменения. Возможные значения:
- Y — да
- N — нет

По умолчанию — Y

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":43,"fields":{"STATUS_ID":"SENT","COMMENTS":"Уточнены условия и сроки"},"params":{"REGISTER_HISTORY_EVENT":"Y"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.quote.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1773410167,
        "finish": 1773410167.690598,
        "duration": 0.6905980110168457,
        "processing": 0,
        "date_start": "2026-03-13T16:56:07+03:00",
        "date_finish": "2026-03-13T16:56:07+03:00",
        "operating_reset_at": 1773410767,
        "operating": 0.26904988288879395
    }
}

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

result boolean

Корневой элемент ответа, возвращает true в случае успеха

time time

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

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Quote is not found"
}
Код Описание Значение
Parameter 'fields' must be array. В fields передан не объект
Parameter 'params' must be array. В params передан не объект
ID is not defined or invalid. Передан некорректный id
Access denied. У пользователя нет прав на изменение коммерческих предложений
Quote is not found Коммерческое предложение с переданным id не найдено

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

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