[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fsmart-processes\u002Ffields":3,"docs-tabs-entities\u002Fsmart-processes\u002Ffields":6},{"content":4,"lastmod":5},"\n## Поля типа смарт-процесса\n\n`GET \u002Fv1\u002Fsmart-processes\u002Ffields`\n\nВозвращает описание полей типа смарт-процесса: какие можно передавать при создании и обновлении, какие доступны только на чтение.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fsmart-processes\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fsmart-processes\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\u002Fsmart-processes\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log('Полей:', Object.keys(data.fields).length)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fsmart-processes\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| `entityTypeId` | number | | ID типа сущности. Передаётся в `\u002Fv1\u002Fitems\u002F:entityTypeId` для работы с элементами. Если не передан при создании — Битрикс24 назначает свободное значение автоматически |\n| `title` | string | | Название типа смарт-процесса |\n| `code` | string \\| null | | Символьный код типа (для программной идентификации). `null`, если не задан |\n| `customSectionId` | number \\| null | | ID цифрового рабочего места, к которому привязан тип. `null`, если не привязан. Записывается при создании, но не обновляется |\n| `isCategoriesEnabled` | boolean | | Использовать в смарт-процессе свои воронки и туннели продаж |\n| `isStagesEnabled` | boolean | | Использовать в смарт-процессе свои стадии и канбан |\n| `isBeginCloseDatesEnabled` | boolean | | Поля «Дата начала» и «Дата завершения» |\n| `isClientEnabled` | boolean | | Поле «Клиент» с привязкой к контактам и компаниям |\n| `isLinkWithProductsEnabled` | boolean | | Привязка товаров каталога |\n| `isMycompanyEnabled` | boolean | | Поле «Реквизиты вашей компании» |\n| `isObserversEnabled` | boolean | | Поле «Наблюдатели» |\n| `isSourceEnabled` | boolean | | Поля «Источник» и «Дополнительно об источнике» |\n| `isAutomationEnabled` | boolean | | Роботы и триггеры |\n| `isBizProcEnabled` | boolean | | Дизайнер бизнес-процессов |\n| `isDocumentsEnabled` | boolean | | Печать документов |\n| `isRecyclebinEnabled` | boolean | | Использование корзины |\n| `isSetOpenPermissions` | boolean | | Делать новые воронки доступными для всех |\n| `isUseInUserfieldEnabled` | boolean | | Использовать смарт-процесс в пользовательском поле |\n| `isRecurringEnabled` | boolean | | Поле «Регулярность» |\n| `isPaymentsEnabled` | boolean | | Онлайн-оплата |\n| `isCountersEnabled` | boolean | | Счётчики (уведомления и бейджи) |\n| `isInitialized` | boolean | да | Тип полностью инициализирован в портале |\n| `createdBy` | number | да | Кем создан. Поиск: `GET \u002Fv1\u002Fusers` |\n| `updatedBy` | number | да | Кем изменён. Поиск: `GET \u002Fv1\u002Fusers` |\n| `createdTime` | datetime | да | Дата создания |\n| `updatedTime` | datetime | да | Дата изменения |\n\nОтвет также содержит массив `aggregatable` — поля, по которым доступна группировка в [агрегации](\u002Fdocs\u002Fentities\u002Fsmart-processes\u002Faggregate), и массив `batch` со списком операций, доступных для пакетной обработки: `create`, `update`, `delete`.\n\n> **Формат datetime.** `createdTime`\u002F`updatedTime` приходят в ISO 8601, но конкретное представление (со смещением `+03:00` либо UTC `…Z` с миллисекундами) зависит от портала — парсьте как ISO 8601, не сравнивайте строки побайтно.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": { \"type\": \"number\", \"readonly\": true },\n      \"entityTypeId\": { \"type\": \"number\", \"readonly\": false },\n      \"title\": { \"type\": \"string\", \"readonly\": false },\n      \"isCategoriesEnabled\": { \"type\": \"boolean\", \"readonly\": false },\n      \"isStagesEnabled\": { \"type\": \"boolean\", \"readonly\": false },\n      \"isLinkWithProductsEnabled\": { \"type\": \"boolean\", \"readonly\": false },\n      \"code\": { \"type\": \"string\", \"readonly\": false },\n      \"createdBy\": { \"type\": \"number\", \"readonly\": true },\n      \"customSectionId\": { \"type\": \"number\", \"readonly\": false },\n      \"createdTime\": { \"type\": \"datetime\", \"readonly\": true }\n    },\n    \"aggregatable\": [\"customSectionId\", \"createdBy\", \"updatedBy\", \"isCategoriesEnabled\", \"isStagesEnabled\", \"isAutomationEnabled\", \"isBizProcEnabled\", \"isPaymentsEnabled\", \"isCountersEnabled\", \"isLinkWithProductsEnabled\"],\n    \"batch\": [\"create\", \"update\", \"delete\"]\n  }\n}\n```\n\nПоказаны 10 полей из 27. Полный список — в таблице выше.\n\n## Пример ответа при ошибке\n\n401 — ключ не передан:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_API_KEY\",\n    \"message\": \"API key required. Pass via X-Api-Key header.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 401 | `MISSING_API_KEY` | Заголовок `X-Api-Key` не передан |\n| 401 | `INVALID_API_KEY` | Ключ не найден или отозван |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Вложенные структуры.** При создании и обновлении можно передавать поля `relations` (связи с другими типами CRM) и `linkedUserFields` (связанные пользовательские поля). Они не описаны в ответе `\u002Ffields`, но принимаются и сохраняются Битрикс24 без изменений. Подробнее — в [Создать тип](\u002Fdocs\u002Fentities\u002Fsmart-processes\u002Fcreate).\n\n**Отличие от `GET \u002Fv1\u002F{entity}\u002Ffields` у стандартных сущностей.** Этот эндпоинт описывает поля **типа смарт-процесса** (`crm.type.*`), а не элементов внутри него. Для полей элементов используйте `GET \u002Fv1\u002Fitems\u002F:entityTypeId\u002Ffields`.\n\n## Смотрите также\n\n- [Список типов](\u002Fdocs\u002Fentities\u002Fsmart-processes\u002Flist)\n- [Создать тип](\u002Fdocs\u002Fentities\u002Fsmart-processes\u002Fcreate)\n- [Обновить тип](\u002Fdocs\u002Fentities\u002Fsmart-processes\u002Fupdate)\n- [Элементы смарт-процессов](\u002Fdocs\u002Fentities\u002Fitems)\n- [Поля элементов](\u002Fdocs\u002Fentities\u002Fitems\u002Ffields)\n- [Пользовательские поля](\u002Fdocs\u002Fuserfields)\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization)\n","2026-07-07",{}]