[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Factivities\u002Ffields":3,"docs-tabs-entities\u002Factivities\u002Ffields":6},{"content":4,"lastmod":5},"\n## Поля дела\n\n`GET \u002Fv1\u002Factivities\u002Ffields`\n\nВозвращает полный список доступных полей дела.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log('Полей:', Object.keys(data).length)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | RO | Описание |\n|------|-----|:--:|---------|\n| `id` | number | да | ID дела |\n| `typeId` | number | | Тип: `1` — встреча, `2` — звонок, `3` — задача, `4` — письмо, `5` — действие, `6` — пользовательское действие (**обязательно** при создании) |\n| `ownerTypeId` | number | | Тип родительской сущности: `1` — лид, `2` — сделка, `3` — контакт, `4` — компания |\n| `ownerId` | number | | ID родительской сущности. Поиск зависит от `ownerTypeId`: `GET \u002Fv1\u002Fdeals`, `GET \u002Fv1\u002Fleads`, `GET \u002Fv1\u002Fcontacts`, `GET \u002Fv1\u002Fcompanies` |\n| `associatedEntityId` | number | да | ID связанной сущности (звонок\u002Fписьмо\u002Fвстреча в b24-модуле). Заполняется автоматически после создания дела соответствующим провайдером |\n| `subject` | string | | Тема дела (**обязательно** при создании) |\n| `communications` | object[] | | Коммуникации дела (**обязательно** при создании). Массив объектов: `[{ \"value\": \"+7…\", \"entityTypeId\": 3, \"entityId\": 17 }]` — вложенные ключи в camelCase или ВЕРХНЕМ регистре Битрикс24. Подробнее — [Создать дело](\u002Fdocs\u002Fentities\u002Factivities\u002Fcreate) |\n| `description` | string | | Описание |\n| `descriptionType` | number | | Тип описания: `1` — plain text, `3` — BBCode\u002FHTML |\n| `responsibleId` | number | | Ответственный. Список: `GET \u002Fv1\u002Fusers` |\n| `authorId` | number | да | Автор записи. Заполняется b24 на основании текущего пользователя при создании |\n| `editorId` | number | да | Последний редактор. Обновляется b24 при каждом изменении |\n| `priority` | number | | Приоритет: `1` — низкий, `2` — средний, `3` — высокий |\n| `direction` | number | | Направление: `1` — входящее, `2` — исходящее |\n| `location` | string | | Место проведения (для встреч) |\n| `completed` | boolean | | Завершена |\n| `status` | number | | Статус дела: `1` — ожидается, `2` — завершено, `3` — завершено автоматически |\n| `startTime` | datetime | | Дата начала |\n| `endTime` | datetime | | Дата окончания |\n| `deadline` | datetime | | Крайний срок. У дел без срока возвращается значение-заглушка `9999-12-30T21:00:00.000Z` — не реальная дата. Фильтр по меньшей дате `filter[\u003Cdeadline]=\u003Cдата>` такие дела не выбирает, просроченными они не считаются |\n| `createdAt` | datetime | да | Дата создания |\n| `updatedAt` | datetime | да | Дата изменения |\n| `notifyType` | number | | Тип напоминания: `0` — выкл., `1` — за минуты, `2` — за часы, `3` — за дни |\n| `notifyValue` | number | | Значение напоминания (в единицах из `notifyType`) |\n| `providerId` | string | | ID провайдера дела (`CRM_CALL_LIST`, `IMOL`, `CRM_REQUEST` и т.п.) |\n| `providerTypeId` | string | | Подтип провайдера (зависит от `providerId`) |\n| `providerGroupId` | string | | Идентификатор группы провайдера (например, по треду e-mail) |\n| `providerParams` | object | | Произвольные параметры провайдера (структура зависит от `providerId`) |\n| `providerData` | string | | Сериализованные данные провайдера (XML\u002FJSON в строке) |\n| `settings` | object | | Дополнительные настройки дела (структура зависит от `typeId` и `providerId`) |\n| `originId` | string | | Внешний ID, если дело пришло из стороннего канала (CTI, email) |\n| `originatorId` | string | | ID источника-инициатора (приложение\u002Fконнектор) |\n| `resultStatus` | number | | Статус результата дела (числовой код) |\n| `resultStream` | number | | Поток обработки результата |\n| `resultSourceId` | string | | Источник результата |\n| `resultMark` | number | | Оценка\u002Fмаркер результата |\n| `resultValue` | number | | Численное значение результата |\n| `resultSum` | number | | Сумма по результату (например, чек) |\n| `resultCurrencyId` | string | | Валюта результата (`RUB`, `USD`, …) |\n| `autocompleteRule` | number | | Правило автозавершения дела (числовой код) |\n| `isIncomingChannel` | boolean | да | Дело пришло из входящего канала (open-line\u002Fзвонок\u002Fписьмо). Только чтение |\n| `bindings` | object | | Дополнительные привязки дела к сущностям CRM. Управление привязками после создания — через `\u002Fv1\u002Factivities\u002F:activityId\u002Fbindings` |\n| `files` | object | | Прикреплённые файлы диска. Возвращается только при явном указании в `select` |\n| `webdavElements` | object | | Прикреплённые файлы диска (устаревший WebDAV). Возвращается только при явном указании в `select` |\n| `originVersion` | string | | Версия синхронизации с внешней системой — защищает от случайной перезаписи данных внешней интеграцией |\n\n> **Обязательные при создании** (`POST \u002Fv1\u002Factivities`): `subject`, `typeId`, `communications`. Поля помечены `required: true` в ответе `\u002Ffields`. Плюс **привязка** к CRM-сущности — через `ownerTypeId` + `ownerId` **или** через `entityTypeId`\u002F`entityId` внутри `communications`. Детали — [Создать дело](\u002Fdocs\u002Fentities\u002Factivities\u002Fcreate).\n\n## Значения typeId\n\n| Значение | Тип дела |\n|----------|---------------|\n| `1` | Встреча |\n| `2` | Звонок |\n| `3` | Задача |\n| `4` | Письмо |\n| `5` | Действие |\n| `6` | Пользовательское действие |\n\n## Значения ownerTypeId\n\n| Значение | Родительская сущность | Поиск |\n|----------|----------------------|-------|\n| `1` | Лид | `GET \u002Fv1\u002Fleads` |\n| `2` | Сделка | `GET \u002Fv1\u002Fdeals` |\n| `3` | Контакт | `GET \u002Fv1\u002Fcontacts` |\n| `4` | Компания | `GET \u002Fv1\u002Fcompanies` |\n\n\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": { \"type\": \"number\", \"readonly\": true, \"label\": \"ID\", \"description\": \"Уникальный числовой идентификатор дела.\" },\n      \"subject\": { \"type\": \"string\", \"readonly\": false, \"required\": true, \"label\": \"Тема\", \"description\": \"Тема дела. Обязательна при создании.\" },\n      \"communications\": { \"type\": \"object\", \"readonly\": false, \"required\": true, \"label\": \"Коммуникации\", \"description\": \"Коммуникации дела. Обязательны при создании. Массив объектов с ключами в ВЕРХНЕМ регистре: [{ \\\"VALUE\\\": \\\"+7…\\\", \\\"ENTITY_TYPE_ID\\\": 3, \\\"ENTITY_ID\\\": 17 }].\" },\n      \"responsibleId\": { \"type\": \"number\", \"readonly\": false, \"label\": \"Ответственный\", \"description\": \"ID пользователя, ответственного за дело.\" }\n    },\n    \"batch\": [\"create\", \"update\", \"delete\"]\n  }\n}\n```\n\nПоказаны 3 из множества полей. Полный список в таблице выше.\n\n## Пример ответа при ошибке\n\n404 — не найден:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ENTITY_NOT_FOUND\",\n    \"message\": \"Элемент не найден\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Создать дело](\u002Fdocs\u002Fentities\u002Factivities\u002Fcreate) — какие поля передавать\n- [Entity API](\u002Fdocs\u002Fentity-api) — select для выборки полей\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-07-23",{}]