[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fproduct-sections\u002Ffields":3,"docs-tabs-entities\u002Fproduct-sections\u002Ffields":6},{"content":4,"lastmod":5},"\n## Поля раздела\n\n`GET \u002Fv1\u002Fproduct-sections\u002Ffields`\n\nВозвращает справочник полей раздела товаров с типами и признаком «только для чтения», а также список операций, доступных в [пакетном запросе](\u002Fdocs\u002Fbatch).\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproduct-sections\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproduct-sections\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\u002Fproduct-sections\u002Ffields', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\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\u002Fproduct-sections\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`data.fields` — объект, ключ которого совпадает с именем поля, а значение содержит `type` (тип поля) и `readonly` (можно ли передать поле при создании и обновлении). `data.batch` — список операций, которые принимает [пакетный запрос](\u002Fdocs\u002Fbatch).\n\n| Поле | Битрикс24 | Тип | RO | Описание |\n|------|----------|-----|:--:|---------|\n| `id` | `ID` | number | да | Идентификатор раздела |\n| `name` | `NAME` | string | | Название раздела |\n| `catalogId` | `CATALOG_ID` | number | | Идентификатор каталога. Список: `GET \u002Fv1\u002Fcatalogs` |\n| `sectionId` | `SECTION_ID` | number | | Идентификатор родительского раздела для вложенности. У корневого раздела — `null` |\n| `xmlId` | `XML_ID` | string | | Внешний идентификатор для синхронизации |\n| `sort` | `SORT` | number | | Порядок сортировки. Меньше — выше |\n| `code` | `CODE` | string | | Символьный код раздела |\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.fields.\u003Cимя>.type` | string | Тип поля: `number`, `string` |\n| `data.fields.\u003Cимя>.readonly` | boolean | `true` — поле заполняется системой и не принимается при создании и обновлении |\n| `data.batch` | string[] | Операции раздела, доступные в [пакетном запросе](\u002Fdocs\u002Fbatch): `create`, `update`, `delete` |\n\nПоле `sort` принимается при создании и обновлении, но в ответах `list`, `get` и `search` не возвращается и **по нему нельзя фильтровать** — в сортировке (`order`\u002F`sort`) оно работает. Остальные поля — `id`, `name`, `catalogId`, `sectionId`, `xmlId`, `code` — фильтруются точным равенством (и `$in`); операторы дают `400 UNSUPPORTED_FILTER`. Поля `sectionId`, `xmlId` и `code` приходят со значением `null`, если не заданы. Если `code` не передать при создании, он формируется из `name`.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": { \"type\": \"number\", \"readonly\": true },\n      \"name\": { \"type\": \"string\", \"readonly\": false },\n      \"catalogId\": { \"type\": \"number\", \"readonly\": false },\n      \"sectionId\": { \"type\": \"number\", \"readonly\": false },\n      \"xmlId\": { \"type\": \"string\", \"readonly\": false },\n      \"sort\": { \"type\": \"number\", \"readonly\": false },\n      \"code\": { \"type\": \"string\", \"readonly\": false }\n    },\n    \"batch\": [\"create\", \"update\", \"delete\"]\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа:\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| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Создать раздел](\u002Fdocs\u002Fentities\u002Fproduct-sections\u002Fcreate)\n- [Список разделов](\u002Fdocs\u002Fentities\u002Fproduct-sections\u002Flist)\n- [Разделы товаров](\u002Fdocs\u002Fentities\u002Fproduct-sections)\n- [Entity API](\u002Fdocs\u002Fentity-api)\n","2026-07-13",{}]