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

crm.deal.details.configuration.set

Установить параметры карточки сделки

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

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

Описание

Метод crm.deal.details.configuration.set устанавливает настройки карточки сделки. Метод записывает личные настройки карточки указанного пользователя или общие настройки для всех пользователей.

Настройки карточки сделок в разных воронках могут отличаться. Для выбора воронки используйте параметр extras.dealCategoryId.

Параметры

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

Область применения настроек.

Возможные значения:
- P — личные настройки
- C — общие настройки

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

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

Идентификатор пользователя. Нужен только при установке личных настроек другого пользователя.

Если не задан, берется текущий

data section[] обязательный

Список section, описывающий конфигурацию разделов карточки сделки. Структура section описана ниже

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

Дополнительные параметры (подробное описание)

Параметр extras

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

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

Если не указан, используется воронка по умолчанию для сделок

Параметр section

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

Уникальное название раздела

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

Название раздела

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

Тип раздела

На данный момент доступно только значение section

elements section_element[] необязательный

Список выводимых в карточке полей с дополнительными настройками

Параметр section_element

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

Идентификатор поля. Список доступных полей можно узнать с помощью crm.deal.fields

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

Нужно ли показывать поле всегда:
- 1 — да
- 0 — нет

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

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

Дополнительные опции поля. Состав зависит от поля

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"scope":"P","userId":1,"extras":{"dealCategoryId":32},"data":[{"name":"main","title":"О сделке","type":"section","elements":[{"name":"TITLE"},{"name":"OPPORTUNITY_WITH_CURRENCY"},{"name":"STAGE_ID"},{"name":"CLOSEDATE"},{"name":"CLIENT"}]},{"name":"additional","title":"Дополнительно","type":"section","elements":[{"name":"TYPE_ID"},{"name":"SOURCE_ID"},{"name":"SOURCE_DESCRIPTION"},{"name":"OPENED"},{"name":"ASSIGNED_BY_ID"},{"name":"COMMENTS"}]},{"name":"products","title":"Товары","type":"section","elements":[{"name":"PRODUCT_ROW_SUMMARY"}]}]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.deal.details.configuration.set

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1773311825,
        "finish": 1773311825.969825,
        "duration": 0.969825029373169,
        "processing": 0,
        "date_start": "2026-03-12T13:37:05+03:00",
        "date_finish": "2026-03-12T13:37:05+03:00",
        "operating_reset_at": 1773312425,
        "operating": 0
    }
}

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

result boolean

Корневой элемент ответа. Возвращает true в случае успешной записи настроек

time time

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

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Access denied."
}
Код Описание Значение
400 Пустое значение Access denied
400 Пустое значение Parameter 'data' must be array
400 Пустое значение There are no data to write
400 Пустое значение The data must be indexed array
400 Пустое значение Section at index i have type data[i].type. The expected type is 'section'
400 Пустое значение Section at index i does not have name
400 Пустое значение Section at index i does not have title
400 Пустое значение Element at index j in section at index i does not have name

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

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