> **Методы в процессе раскатки — появились в обновлении `crm 26.1700.0`.** Облачная доступность зависит от включения возможности Битрикс24. Пока она не открыта для портала, API отвечает `422 METHOD_NOT_YET_AVAILABLE` с `error.release`.

# Именованные раскладки карточки CRM

Храните несколько наборов разделов и полей карточки и выбирайте текущую раскладку для сотрудника.

Битрикс24 API: `crm.<entity>.detailpagelayout.*`
Скоуп: `crm`

## Операции

- [Создать раскладку карточки CRM](/docs/entities/crm-card-layouts/add) — `POST /v1/crm/card-layouts/:entityType`
- [Список раскладок карточки CRM](/docs/entities/crm-card-layouts/list) — `GET /v1/crm/card-layouts/:entityType`
- [Получить раскладку карточки CRM](/docs/entities/crm-card-layouts/get) — `GET /v1/crm/card-layouts/:entityType/:layoutId`
- [Изменить раскладку карточки CRM](/docs/entities/crm-card-layouts/update) — `PATCH /v1/crm/card-layouts/:entityType/:layoutId`
- [Удалить раскладку карточки CRM](/docs/entities/crm-card-layouts/delete) — `DELETE /v1/crm/card-layouts/:entityType/:layoutId`
- [Выбрать текущую раскладку CRM](/docs/entities/crm-card-layouts/setcurrent) — `PUT /v1/crm/card-layouts/:entityType/current`
- [Получить ID общей раскладки CRM](/docs/entities/crm-card-layouts/getcommonlayoutid) — `GET /v1/crm/card-layouts/:entityType/common-id`
- [Получить ID личной раскладки CRM](/docs/entities/crm-card-layouts/getpersonallayoutid) — `GET /v1/crm/card-layouts/:entityType/personal-id`

## Ключевые поля

| Поле | Описание |
|---|---|
| `id` | Непрозрачная строка, включая системные ID. Источник — [список раскладок](/docs/entities/crm-card-layouts/list), [ID общей раскладки](/docs/entities/crm-card-layouts/getcommonlayoutid) или [ID личной раскладки](/docs/entities/crm-card-layouts/getpersonallayoutid). |
| `name` | Название. У системных раскладок может быть `null`. |
| `configuration` | Разделы с названиями и массивами элементов. |
| `audience` | Сотрудники и группы доступа `{type,id}`. Может быть `null`. ID сотрудника — из [списка сотрудников](/docs/entities/users/list). |

## Что нужно знать перед работой

1. `entityType`: `company`, `contact`, `deal`, `lead`, `quote`, `smartinvoice`, `smartprocess<N>`. Номер смарт-процесса — из [списка смарт-процессов](/docs/entities/smart-processes).
2. Категория обязательна во всех запросах. Источник — [`GET /v1/categories`](/docs/entities/categories), `0` допустим.
3. Создание возвращает числовой ID. Для последующих запросов преобразуйте его в строку.
4. Права на аудиторию, сотрудника и системную раскладку проверяет Битрикс24. Для записи нужен `READWRITE`.
5. Текущая конфигурация карточки — отдельный раздел [Раскладка карточки CRM](/docs/entities/crm-card-config).

## Типичный сценарий

1. [Список раскладок карточки CRM](/docs/entities/crm-card-layouts/list).
2. [Создать раскладку карточки CRM](/docs/entities/crm-card-layouts/add).
3. [Изменить раскладку карточки CRM](/docs/entities/crm-card-layouts/update).
4. [Выбрать текущую раскладку CRM](/docs/entities/crm-card-layouts/setcurrent).
5. [Удалить раскладку карточки CRM](/docs/entities/crm-card-layouts/delete).

## Лимиты

Список читает одну страницу с `limit` и `offset`. Общего количества и `hasMore` нет. Допустимые значения и ограничения полей проверяет Битрикс24. Пустые массивы могут быть отклонены как отсутствующие поля. Изменение переданного массива заменяет его целиком.

## Смотрите также

- [Раскладка карточки CRM](/docs/entities/crm-card-config)
- [Ошибки](/docs/errors)