[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fproducts\u002Ffields":3,"docs-tabs-entities\u002Fproducts\u002Ffields":6},{"content":4,"lastmod":5},"\n## Поля товара\n\n`GET \u002Fv1\u002Fproducts\u002Ffields`\n\nВозвращает схему полей товара: 21 стандартное поле и пользовательские свойства каталога вида `PROPERTY_\u003CN>`, настроенные на портале. Для каждого поля указаны тип и признак «только для чтения».\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproducts\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproducts\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\u002Fproducts\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\u002Fproducts\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Каждое поле описано объектом `{ type, readonly }` и возвращается в camelCase в ответах `list`, `get`, `search`, `create`, `update`.\n\n| Поле | Битрикс24 | Тип | RO | Описание |\n|------|----------|-----|:--:|---------|\n| `id` | `ID` | number | да | Идентификатор товара |\n| `name` | `NAME` | string | | Название товара |\n| `active` | `ACTIVE` | boolean | | Активен ли товар |\n| `price` | `PRICE` | number | | Цена товара |\n| `currency` | `CURRENCY_ID` | string | | Валюта цены. Список: `GET \u002Fv1\u002Fcurrencies` |\n| `sectionId` | `SECTION_ID` | number | | Раздел каталога. Список: `GET \u002Fv1\u002Fproduct-sections` |\n| `catalogId` | `CATALOG_ID` | number | | Идентификатор каталога. Список: `GET \u002Fv1\u002Fcatalogs` |\n| `measure` | `MEASURE` | number | | Идентификатор единицы измерения |\n| `description` | `DESCRIPTION` | string | | Описание товара |\n| `descriptionType` | `DESCRIPTION_TYPE` | string | | Формат описания — `text` или `html` |\n| `sort` | `SORT` | number | | Порядок сортировки. Меньшее значение — выше |\n| `code` | `CODE` | string | | Символьный код товара |\n| `xmlId` | `XML_ID` | string | | Внешний идентификатор для синхронизации |\n| `vatId` | `VAT_ID` | number | | Идентификатор ставки НДС |\n| `vatIncluded` | `VAT_INCLUDED` | boolean | | Включён ли НДС в цену |\n| `previewPicture` | `PREVIEW_PICTURE` | object | да | Изображение для списка |\n| `detailPicture` | `DETAIL_PICTURE` | object | да | Изображение для карточки |\n| `createdBy` | `CREATED_BY` | number | да | Идентификатор создателя. Список: `GET \u002Fv1\u002Fusers` |\n| `modifyBy` | `MODIFIED_BY` | number | да | Идентификатор последнего редактора. Список: `GET \u002Fv1\u002Fusers` |\n| `createdAt` | `DATE_CREATE` | datetime | да | Дата создания |\n| `updatedAt` | `TIMESTAMP_X` | datetime | да | Дата последнего изменения |\n\n## Пользовательские свойства\n\nСвойства каталога приходят дополнительными ключами вида `PROPERTY_\u003CN>` с типом `product_property`. Каждое описано объектом `{ type, readonly, label }`, где `label` — название свойства на языке портала. Набор свойств зависит от настроек каталога: один портал может вернуть «Артикул», «Производитель», «Цвет», другой — собственный список. Значения этих свойств возвращаются в ответе [`GET \u002Fv1\u002Fproducts\u002F:id`](\u002Fdocs\u002Fentities\u002Fproducts\u002Fget).\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.fields` | object | Карта полей. Ключ — имя поля, значение — `{ type, readonly }`, для свойств дополнительно `label` |\n\n## Пример ответа\n\nПоказана часть полей. Реальное количество свойств `PROPERTY_\u003CN>` зависит от настроек каталога на портале.\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": { \"type\": \"number\", \"readonly\": true },\n      \"name\": { \"type\": \"string\", \"readonly\": false },\n      \"active\": { \"type\": \"boolean\", \"readonly\": false },\n      \"price\": { \"type\": \"number\", \"readonly\": false },\n      \"currency\": { \"type\": \"string\", \"readonly\": false },\n      \"sectionId\": { \"type\": \"number\", \"readonly\": false },\n      \"catalogId\": { \"type\": \"number\", \"readonly\": false },\n      \"vatIncluded\": { \"type\": \"boolean\", \"readonly\": false },\n      \"createdAt\": { \"type\": \"datetime\", \"readonly\": true },\n\n      \"PROPERTY_301\": { \"type\": \"product_property\", \"readonly\": false, \"label\": \"Артикул\" },\n      \"PROPERTY_303\": { \"type\": \"product_property\", \"readonly\": false, \"label\": \"Производитель\" },\n      \"PROPERTY_307\": { \"type\": \"product_property\", \"readonly\": false, \"label\": \"Цвет\" }\n    }\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**Тот же товар в каталоге имеет больше полей.** Товар с тем же `id` доступен через [`GET \u002Fv1\u002Fcatalog-products`](\u002Fdocs\u002Fentities\u002Fcatalog-products), где у него шире набор полей — остатки, склад и вариации.\n\n## Смотрите также\n\n- [Получить товар](\u002Fdocs\u002Fentities\u002Fproducts\u002Fget)\n- [Список товаров](\u002Fdocs\u002Fentities\u002Fproducts\u002Flist)\n- [Агрегация товаров](\u002Fdocs\u002Fentities\u002Fproducts\u002Faggregate)\n- [Entity API](\u002Fdocs\u002Fentity-api)\n- [Товары каталога](\u002Fdocs\u002Fentities\u002Fcatalog-products)\n","2026-06-19",{}]