[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Frequisite-presets\u002Fpreset-fields\u002Fschema":3,"docs-tabs-entities\u002Frequisite-presets\u002Fpreset-fields\u002Fschema":6},{"content":4,"lastmod":5},"\n## Схема поля шаблона\n\n`GET \u002Fv1\u002Frequisite-presets\u002F:presetId\u002Ffields\u002Fschema`\n\nВозвращает структуру строки поля шаблона реквизитов: типы, обязательность, флаги доступа. Используйте, чтобы узнать допустимые типы и правила перед `POST \u002Fv1\u002Frequisite-presets\u002F:presetId\u002Ffields` или `PATCH \u002Fv1\u002Frequisite-presets\u002F:presetId\u002Ffields\u002F:id`.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `presetId` (path) | number | да | ID шаблона реквизитов. Получить список шаблонов: `GET \u002Fv1\u002Frequisite-presets` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Frequisite-presets\u002F1\u002Ffields\u002Fschema\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Frequisite-presets\u002F1\u002Ffields\u002Fschema\" \\\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\u002Frequisite-presets\u002F1\u002Ffields\u002Fschema', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Frequisite-presets\u002F1\u002Ffields\u002Fschema', {\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| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | object | Объект с описанием схемы |\n| `data.fields` | object | Словарь полей строки шаблона. Ключи — в camelCase: `id`, `fieldName` и другие |\n| `data.fields.id` | object | Идентификатор строки поля. Только для чтения |\n| `data.fields.fieldName` | object | Имя поля реквизита, например `RQ_INN`. Обязательно при создании. При обновлении передавать не нужно — текущее значение подставляется автоматически |\n| `data.fields.fieldTitle` | object | Заголовок поля в печатной форме. Не обязателен |\n| `data.fields.sort` | object | Порядок сортировки поля в шаблоне |\n| `data.fields.inShortList` | object | Флаг отображения поля в кратком списке. В API представлен как `true`\u002F`false` |\n\nКаждое поле в `data.fields` описано объектом со следующими ключами:\n\n| Ключ | Тип | Описание |\n|------|-----|---------|\n| `type` | string | Тип значения: `integer`, `string`, `char` |\n| `isRequired` | boolean | Обязательно ли поле при создании |\n| `isReadOnly` | boolean | Только для чтения — нельзя задать при записи |\n| `isImmutable` | boolean | Нельзя изменить после создания |\n| `isMultiple` | boolean | Допускает несколько значений |\n| `isDynamic` | boolean | Динамическое (пользовательское) поле |\n| `title` | string | Название поля для отображения, на языке портала |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": {\n        \"type\": \"integer\",\n        \"isRequired\": false,\n        \"isReadOnly\": true,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"ID\"\n      },\n      \"fieldName\": {\n        \"type\": \"string\",\n        \"isRequired\": true,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Имя\"\n      },\n      \"fieldTitle\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Название в шаблоне\"\n      },\n      \"sort\": {\n        \"type\": \"integer\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Сортировка\"\n      },\n      \"inShortList\": {\n        \"type\": \"char\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Показывать в кратком списке\"\n      }\n    }\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'crm' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PRESET_ID` | Переданный `presetId` не является положительным целым числом |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Поле `inShortList` описано в схеме типом `char`, но API работает с булевым значением.** При записи через `POST` или `PATCH` передавайте `true`\u002F`false`, в ответах чтения поле приходит как `true`\u002F`false`.\n\n**Схема объявляет `fieldName` обязательным (`isRequired: true`), но при обновлении его передавать не нужно.** При `PATCH` без `fieldName` Вайбкод получает текущее значение из Битрикс24 и подставляет его автоматически. Обязательным `fieldName` остаётся при создании через `POST`.\n\n## Смотрите также\n\n- [Поля, доступные для добавления](\u002Fdocs\u002Fentities\u002Frequisite-presets\u002Fpreset-fields\u002Favailable)\n- [Добавить поле в шаблон](\u002Fdocs\u002Fentities\u002Frequisite-presets\u002Fpreset-fields\u002Fcreate)\n- [Обновить поле шаблона](\u002Fdocs\u002Fentities\u002Frequisite-presets\u002Fpreset-fields\u002Fupdate)\n- [Шаблоны реквизитов](\u002Fdocs\u002Fentities\u002Frequisite-presets)\n","2026-07-15",{}]