[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities-index":3,"docs-tabs-entities-index":6},{"content":4,"lastmod":5},"# Справочник сущностей\n\nПолный перечень сущностей и специализированных API с доступными операциями. Для каждой сущности указан путь, набор операций и требуемый скоуп. Описание общего формата запросов и ответов — в разделе [Обзор API](\u002Fdocs\u002Fentity-api).\n\n## Сущности по разделам\n\n### CRM\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Сделки](\u002Fdocs\u002Fentities\u002Fdeals) | `\u002Fv1\u002Fdeals` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` `products` | `crm` |\n| [Контакты](\u002Fdocs\u002Fentities\u002Fcontacts) | `\u002Fv1\u002Fcontacts` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Компании](\u002Fdocs\u002Fentities\u002Fcompanies) | `\u002Fv1\u002Fcompanies` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Лиды](\u002Fdocs\u002Fentities\u002Fleads) | `\u002Fv1\u002Fleads` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` `products` | `crm` |\n| [Предложения](\u002Fdocs\u002Fentities\u002Fquotes) | `\u002Fv1\u002Fquotes` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` `products` | `crm` |\n| [Счета](\u002Fdocs\u002Fentities\u002Finvoices) | `\u002Fv1\u002Finvoices` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` `products` | `crm` |\n| [Воронки сделок](\u002Fdocs\u002Fentities\u002Fdeal-categories) | `\u002Fv1\u002Fdeal-categories` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Воронки](\u002Fdocs\u002Fentities\u002Fcategories) | `\u002Fv1\u002Fcategories\u002F:entityTypeId` | `list` `get` `create` `update` `delete` `fields` | `crm` |\n| [Дела](\u002Fdocs\u002Fentities\u002Factivities) | `\u002Fv1\u002Factivities` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Привязки дел](\u002Fdocs\u002Fentities\u002Factivities\u002Fbindings) | `\u002Fv1\u002Factivities\u002F:activityId\u002Fbindings` | `list` `bind` `unbind` `move` | `crm` |\n| [Конфигурируемые дела](\u002Fdocs\u002Fentities\u002Factivities\u002Fconfigurable) | `\u002Fv1\u002Factivity-configurable` | `create` `get` `update` | `crm` |\n| [Расшифровки звонков CRM](\u002Fdocs\u002Fentities\u002Factivities\u002Ftranscript) | `\u002Fv1\u002Factivities\u002F:activityId\u002Ftranscript` | `get` | `crm` |\n| [Товары CRM](\u002Fdocs\u002Fentities\u002Fproducts) | `\u002Fv1\u002Fproducts` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Разделы товаров](\u002Fdocs\u002Fentities\u002Fproduct-sections) | `\u002Fv1\u002Fproduct-sections` | `list` `get` `create` `update` `delete` `fields` `search` | `crm` |\n| [Статусы и стадии](\u002Fdocs\u002Fentities\u002Fstatuses) | `\u002Fv1\u002Fstatuses` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Валюты](\u002Fdocs\u002Fentities\u002Fcurrencies) | `\u002Fv1\u002Fcurrencies` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Реквизиты](\u002Fdocs\u002Fentities\u002Frequisites) | `\u002Fv1\u002Frequisites` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `crm` |\n| [Шаблоны реквизитов](\u002Fdocs\u002Fentities\u002Frequisite-presets) | `\u002Fv1\u002Frequisite-presets` | `list` `get` `create` `update` `delete` `fields` `search` | `crm` |\n| [Банковские реквизиты](\u002Fdocs\u002Fentities\u002Fbank-details) | `\u002Fv1\u002Fbank-details` | `list` `get` `create` `update` `delete` `fields` `search` | `crm` |\n| [Адреса](\u002Fdocs\u002Fentities\u002Faddresses) | `\u002Fv1\u002Faddresses`, `\u002Fv1\u002Faddresses\u002F:typeId\u002F:entityTypeId\u002F:entityId` | `list` `get` `create` `update` `delete` `fields` `search` | `crm` |\n| [Связи реквизитов](\u002Fdocs\u002Fentities\u002Frequisite-links) | `\u002Fv1\u002Frequisite-links`, `\u002Fv1\u002Frequisite-links\u002F:entityTypeId\u002F:entityId` | `list` `get` `register` `unregister` `fields` `search` | `crm` |\n| [Комментарии таймлайна](\u002Fdocs\u002Fentities\u002Ftimelines) | `\u002Fv1\u002Ftimelines` | `list` `get` `create` `update` `delete` `fields` `search` | `crm` |\n| [Раскладка карточки CRM](\u002Fdocs\u002Fentities\u002Fcrm-card-config) | `\u002Fv1\u002Fcrm\u002Fcard-config\u002F:entityTypeId` | `get` `set` `reset` `force-common` | `crm` |\n\n### Смарт-процессы\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Смарт-процессы](\u002Fdocs\u002Fentities\u002Fsmart-processes) | `\u002Fv1\u002Fsmart-processes` | `list` `get` `create` `update` `delete` `fields` `search` | `crm` |\n| [Элементы смарт-процессов](\u002Fdocs\u002Fentities\u002Fitems) | `\u002Fv1\u002Fitems\u002F:entityTypeId` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` `products` | `crm` |\n\n### Задачи\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Задачи](\u002Fdocs\u002Fentities\u002Ftasks) | `\u002Fv1\u002Ftasks` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `tasks` |\n| [Комментарии к задачам](\u002Fdocs\u002Fentities\u002Ftask-comments) | `\u002Fv1\u002Ftasks\u002F:taskId\u002Fcomments` | `list` `get` `create` `update` `delete` | `task` |\n| [Учёт времени задач](\u002Fdocs\u002Fentities\u002Ftasks\u002Ftime) | `\u002Fv1\u002Ftasks\u002F:taskId\u002Ftime` | `list` `get` `create` `update` `delete` | `task` |\n| [Чат задачи](\u002Fdocs\u002Fentities\u002Ftasks\u002Fchat) | `\u002Fv1\u002Ftasks\u002F:taskId\u002Fchat\u002Fmessages` | `get` | `task` |\n| [История изменений задачи](\u002Fdocs\u002Ftask-history) | `\u002Fv1\u002Ftasks\u002F:taskId\u002Fhistory` | `get` | `task` |\n| [Стадии канбана задач](\u002Fdocs\u002Ftask-stages) | `\u002Fv1\u002Ftasks\u002Fstages\u002F:entityId` | `get` | `task` |\n| [Scrum (эпики + размещение)](\u002Fdocs\u002Fscrum) | `\u002Fv1\u002Fscrum\u002Fepics`, `\u002Fv1\u002Fscrum\u002Ftasks\u002F:taskId` | `list` `get` `create` `update` | `task` |\n\n### Календарь\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [События календаря](\u002Fdocs\u002Fentities\u002Fcalendar-events) | `\u002Fv1\u002Fcalendar-events` | `list` `get` `create` `update` `delete` `fields` | `calendar` |\n\n### Диск\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Файлы](\u002Fdocs\u002Fentities\u002Ffiles) | `\u002Fv1\u002Ffiles` | `list` `get` `update` `delete` `fields` `search` `upload` `download` `moveto` `copyto` | `disk` |\n| [Папки](\u002Fdocs\u002Fentities\u002Ffolders) | `\u002Fv1\u002Ffolders` | `list` `get` `create` `update` `delete` `fields` `search` | `disk` |\n| [Хранилища](\u002Fdocs\u002Fentities\u002Fstorages) | `\u002Fv1\u002Fstorages` | `list` `get` `fields` `search` | `disk` |\n\n### Пользователи и соцсеть\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Сотрудники](\u002Fdocs\u002Fentities\u002Fusers) | `\u002Fv1\u002Fusers` | `list` `get` `create` `invite` `update` `delete` `fields` `search` `aggregate` | `user` |\n| [Отделы](\u002Fdocs\u002Fentities\u002Fdepartments) | `\u002Fv1\u002Fdepartments` | `list` `get` `create` `update` `delete` `fields` `search` | `department` |\n| [Рабочие группы](\u002Fdocs\u002Fentities\u002Fworkgroups) | `\u002Fv1\u002Fworkgroups` | `list` `get` `create` `update` `delete` `search` `fields` | `sonet_group` |\n\n### Торговый каталог\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Каталоги](\u002Fdocs\u002Fentities\u002Fcatalogs) | `\u002Fv1\u002Fcatalogs` | `list` `get` `search` `fields` | `catalog` |\n| [Товары каталога](\u002Fdocs\u002Fentities\u002Fcatalog-products) | `\u002Fv1\u002Fcatalog-products` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `catalog` |\n| [Свойства товаров каталога](\u002Fdocs\u002Fentities\u002Fcatalog-product-properties) | `\u002Fv1\u002Fcatalog-product-properties` | `list` `get` `create` `update` `delete` `search` `fields` | `catalog` |\n| [Разделы каталога](\u002Fdocs\u002Fentities\u002Fcatalog-sections) | `\u002Fv1\u002Fcatalog-sections` | `list` `get` `create` `update` `delete` `search` `aggregate` | `catalog` |\n| [Цены каталога](\u002Fdocs\u002Fentities\u002Fcatalog-prices) | `\u002Fv1\u002Fcatalog-prices` | `list` `get` `create` `update` `delete` `search` `fields` | `catalog` |\n| [Склады](\u002Fdocs\u002Fentities\u002Fwarehouses) | `\u002Fv1\u002Fwarehouses` | `list` `get` `create` `update` `delete` `stock` | `catalog` |\n\n### Интернет-магазин\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Заказы](\u002Fdocs\u002Fentities\u002Forders) | `\u002Fv1\u002Forders` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `sale` |\n| [Оплаты](\u002Fdocs\u002Fentities\u002Fpayments) | `\u002Fv1\u002Fpayments` | `list` `get` `create` `update` `delete` `search` `aggregate` | `sale` |\n| [Позиции корзины](\u002Fdocs\u002Fentities\u002Fbasket-items) | `\u002Fv1\u002Fbasket-items` | `list` `get` `create` `update` `delete` `search` `aggregate` | `sale` |\n| [Статусы заказов](\u002Fdocs\u002Fentities\u002Forder-statuses) | `\u002Fv1\u002Forder-statuses` | `list` `get` `create` `update` `delete` `search` `aggregate` | `sale` |\n\n### Сайты\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Сайты](\u002Fdocs\u002Fentities\u002Fsites) | `\u002Fv1\u002Fsites` | `list` `get` `create` `update` `delete` `search` `fields` `aggregate` | `landing` |\n| [Страницы](\u002Fdocs\u002Fentities\u002Fpages) | `\u002Fv1\u002Fpages` | `list` `get` `create` `update` `delete` `search` `fields` `aggregate` | `landing` |\n\n### Генератор документов\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Шаблоны документов](\u002Fdocs\u002Fentities\u002Fdoc-templates) | `\u002Fv1\u002Fdoc-templates` | `list` `get` `create` `update` `delete` `fields` `search` `aggregate` | `documentgenerator` |\n| [Документы](\u002Fdocs\u002Fentities\u002Fdocuments) | `\u002Fv1\u002Fdocuments` | `list` `get` `create` `update` `delete` `fields` `search` | `documentgenerator` |\n| [Документы по CRM-сущности](\u002Fdocs\u002Fentities\u002Fdocuments\u002Fcrm-list) | `\u002Fv1\u002Fcrm-documents` | `list` | `crm` |\n\n### Бронирование\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Бронирования](\u002Fdocs\u002Fentities\u002Fbookings) | `\u002Fv1\u002Fbookings` | `list` `get` `create` `update` `delete` `search` `fields` | `booking` |\n\n### Бизнес-процессы\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Шаблоны бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-templates) | `\u002Fv1\u002Fbizproc-templates` | `list` `create` `update` `delete` `search` `aggregate` | `bizproc` |\n| [Действия бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-activities) | `\u002Fv1\u002Fbizproc-activities` | `list` `create` `update` `delete` `search` `aggregate` | `bizproc` |\n| [Роботы](\u002Fdocs\u002Fentities\u002Fbizproc-robots) | `\u002Fv1\u002Fbizproc-robots` | `list` `create` `update` `delete` `search` `aggregate` | `bizproc` |\n\n### Открытые линии\n\n| Сущность | Путь | Операции | Скоуп |\n|----------|------|----------|-------|\n| [Конфигурации открытых линий](\u002Fdocs\u002Fentities\u002Fopenline-configs) | `\u002Fv1\u002Fopenline-configs` | `list` `get` `create` `update` `delete` `search` `fields` `aggregate` | `imopenlines` |\n\n## Специализированные API\n\nЭти API имеют собственные эндпоинты, выходящие за рамки стандартного CRUD:\n\n| API | Путь | Скоуп | Описание |\n|-----|------|-------|----------|\n| Боты | `\u002Fv1\u002Fbots` | `imbot` | Платформа ботов (imbot.v2): регистрация, сообщения, чаты, команды, файлы |\n| Чаты | `\u002Fv1\u002Fchats` | `im` | IM Chat API: чаты CRM-сущностей, сообщения, групповые чаты |\n| Бизнес-процессы | `\u002Fv1\u002Fworkflows` | `bizproc` | Запуск, список, завершение процессов, события |\n| [Уведомления](\u002Fdocs\u002Fnotifications) | `\u002Fv1\u002Fnotifications` | `im` | Уведомления сотрудникам Битрикс24 |\n| [Телефония](\u002Fdocs\u002Ftelephony) | `\u002Fv1\u002Fcalls`, `\u002Fv1\u002Ftelephony-lines`, `\u002Fv1\u002Fvoximplant-lines` | `telephony` | Регистрация внешних звонков в CRM, исходящие звонки, линии, статистика |\n| Триггеры | `\u002Fv1\u002Ftriggers` | `crm` | Триггеры CRM-автоматизации: запуск триггера по сделке\u002Fлиду |\n| Лог таймлайна | `\u002Fv1\u002Ftimeline-logs` | `crm` | Таймлайн CRM: действия, заметки, закрепление, привязка к сущностям |\n| Посты | `\u002Fv1\u002Fposts` | `log` | Живая лента: объявления, комментарии |\n| Пользовательские поля | `\u002Fv1\u002Fuserfields` | `crm` | Пользовательские поля CRM: сделки, лиды, контакты, компании, предложения |\n| [История стадий](\u002Fdocs\u002Fstage-history) | `\u002Fv1\u002Fstage-history` | `crm` | История переходов по стадиям CRM |\n| [Дубликаты](\u002Fdocs\u002Fduplicates) | `\u002Fv1\u002Fduplicates\u002Ffind` | `crm` | Поиск дубликатов по телефону\u002Femail |\n| [Scrum](\u002Fdocs\u002Fscrum) | `\u002Fv1\u002Fscrum` | `task` | Эпики и скрам-размещение задач: создание\u002Fпереименование эпиков, привязка задачи к эпику, авто-бэклог |\n| [Чат задачи](\u002Fdocs\u002Fentities\u002Ftasks\u002Fchat) | `\u002Fv1\u002Ftasks\u002F:taskId\u002Fchat\u002Fmessages` | `task` | Чтение чата задачи (newest-first, курсорная пагинация); ключу нужен B24-скоуп `im` |\n| [Расшифровки звонков CRM](\u002Fdocs\u002Fentities\u002Factivities\u002Ftranscript) | `\u002Fv1\u002Factivities\u002F:activityId\u002Ftranscript` | `crm` | Готовая AI-расшифровка звонка клиента по `activityId` дела-звонка |\n| Рабочий день | `\u002Fv1\u002Fworkday` | `timeman` | Учёт рабочего времени: открытие\u002Fзакрытие дня, статус, настройки |\n| Пакетные запросы | `\u002Fv1\u002Fbatch` | `*` | До 50 вызовов сущностей в одном запросе (1 единица рейт-лимита) |\n\n## Общие возможности\n\nВсе эндпоинты сущностей поддерживают:\n\n- **[Фильтрация](\u002Fdocs\u002Ffiltering):** `?filter[stageId]=NEW` или `?filter[$gte][amount]=1000` (MongoDB-операторы)\n- **Сортировка:** `?sort=-createdAt` (префикс `-` для сортировки по убыванию)\n- **Пагинация:** `?limit=50&offset=100` (автопагинация при limit > 50)\n- **Выбор полей:** `?select=id,title,amount`\n- **Трансформация полей:** camelCase-имена автоматически конвертируются в имена полей Битрикс24\n- **Метаданные полей:** `GET \u002Fv1\u002F{entity}\u002Ffields` возвращает описание полей, включая пользовательские UF-поля с подписями. Для полей-перечислений возвращается массив `items` с доступными значениями\n- **Поиск:** `POST \u002Fv1\u002F{entity}\u002Fsearch` — расширенный поиск с автоматическим разбиением по датам для больших наборов данных\n- **Агрегация:** `POST \u002Fv1\u002F{entity}\u002Faggregate` — подсчёт, сумма, среднее, минимум, максимум по полям\n- **Товарные позиции:** для CRM-сущностей с товарами (сделки, лиды, предложения, счета, элементы смарт-процессов) доступны маршруты `GET\u002FPOST\u002FPUT\u002FPATCH\u002FDELETE \u002Fv1\u002F{entity}\u002F{id}\u002Fproducts`\n- **[Связанные данные (include)](\u002Fdocs\u002Fincludes):** `?include=company,contact` загружает связанные сущности в одном запросе\n","2026-07-15",{}]