[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Frequisites\u002Fcreate":3,"docs-tabs-entities\u002Frequisites\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать реквизит\n\n`POST \u002Fv1\u002Frequisites`\n\nСоздаёт новый реквизит и привязывает его к контакту или компании CRM.\n\n## Обязательные поля\n\nБитрикс24 требует четыре поля для создания реквизита:\n\n| Поле | Тип | Допустимые значения | Описание |\n|------|-----|--------------------|---------|\n| `entityTypeId` | number | `3` (контакт), `4` (компания) | Тип родительской сущности |\n| `entityId` | number | любой существующий ID | ID родительской сущности. Поиск: `GET \u002Fv1\u002Fcontacts` или `GET \u002Fv1\u002Fcompanies` |\n| `presetId` | number | любой существующий ID шаблона | ID [шаблона реквизита](\u002Fdocs\u002Fentities\u002Frequisite-presets) (определяет набор полей). Источник: `GET \u002Fv1\u002Frequisite-presets` |\n| `name` | string | непустая строка | Название реквизита. Без него Битрикс24 отклоняет создание: 422 `BITRIX_ERROR` «Не заполнено обязательное поле „Название\"» |\n\n## Популярные поля\n\nВсе поля в camelCase. Полный список — [`GET \u002Fv1\u002Frequisites\u002Ffields`](.\u002Ffields.md).\n\n### Общие\n\n| Параметр | Тип | По умолч. | Описание |\n|----------|-----|-----------|---------|\n| `active` | boolean | `true` | Активен ли реквизит |\n| `sort` | number | `500` | Порядок сортировки (чем меньше — тем выше) |\n| `code` \u002F `xmlId` \u002F `originatorId` | string | — | Внешние идентификаторы для синхронизации |\n| `addressOnly` | boolean | `false` | Признак «только адрес» (для адресных справочников) |\n\n### Юрлица\n\n| Параметр | Тип | Описание |\n|----------|-----|---------|\n| `rqName` | string | Полное наименование |\n| `rqCompanyName` | string | Сокращённое название |\n| `rqCompanyFullName` | string | Полное название юрлица |\n| `rqCompanyRegDate` | date | Дата регистрации |\n| `rqInn` | string | ИНН |\n| `rqKpp` | string | КПП |\n| `rqOgrn` | string | ОГРН |\n| `rqOgrnip` | string | ОГРНИП (для ИП) |\n| `rqOkpo` \u002F `rqOkved` \u002F `rqOktmo` | string | Классификаторы |\n| `rqDirector` | string | ФИО директора |\n| `rqAccountant` | string | ФИО главного бухгалтера |\n| `rqCeoName` \u002F `rqCeoWorkPos` | string | ФИО и должность руководителя |\n| `rqContact` \u002F `rqEmail` \u002F `rqPhone` \u002F `rqFax` | string | Контакты организации |\n| `rqVatPayer` | boolean | Плательщик НДС |\n| `rqVatId` | string | ИНН для НДС (иностранные) |\n| `rqBaseDoc` | string | Документ-основание деятельности (например, «Устав») |\n| `rqResidenceCountry` | string | Страна регистрации |\n\n### Физлица\n\n| Параметр | Тип | Описание |\n|----------|-----|---------|\n| `rqFirstName` \u002F `rqLastName` \u002F `rqSecondName` | string | Имя \u002F Фамилия \u002F Отчество |\n| `rqIdentDocType` | string | Название документа, удостоверяющего личность |\n| `rqIdentDocSer` \u002F `rqIdentDocNum` | string | Серия \u002F Номер документа |\n| `rqIdentDocDate` | date | Дата выдачи |\n| `rqIdentDocIssuedBy` | string | Кем выдан |\n| `rqIdentDocDepCode` | string | Код подразделения |\n\n### Международные шаблоны\n\nПоля шаблонов других стран — `rqEdrpou`, `rqKbe`, `rqRegon`, `rqSiret`, `rqCnpj` — передаются в camelCase, как остальные поля схемы. Заполняются на реквизитах соответствующего странового шаблона.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Frequisites\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"entityTypeId\": 4,\n    \"entityId\": 15,\n    \"presetId\": 1,\n    \"name\": \"Основной\",\n    \"rqName\": \"ООО «Ромашка»\",\n    \"rqInn\": \"7701234567\",\n    \"rqKpp\": \"770101001\",\n    \"rqOgrn\": \"1027700123456\",\n    \"rqCompanyName\": \"Ромашка\",\n    \"rqDirector\": \"Иванов Иван Иванович\",\n    \"rqVatPayer\": true\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Frequisites\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"entityTypeId\": 4,\n    \"entityId\": 15,\n    \"presetId\": 1,\n    \"name\": \"Основной\",\n    \"rqName\": \"ООО «Ромашка»\",\n    \"rqInn\": \"7701234567\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Frequisites', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    entityTypeId: 4,\n    entityId: 15,\n    presetId: 1,\n    name: 'Основной',\n    rqName: 'ООО «Ромашка»',\n    rqInn: '7701234567',\n    rqKpp: '770101001',\n    rqOgrn: '1027700123456',\n    rqCompanyName: 'Ромашка',\n    rqDirector: 'Иванов Иван Иванович',\n    rqVatPayer: true,\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Создан реквизит ID:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Frequisites', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    entityTypeId: 4,\n    entityId: 15,\n    presetId: 1,\n    name: 'Основной',\n    rqName: 'ООО «Ромашка»',\n    rqInn: '7701234567',\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | object | Созданный реквизит |\n| `data.id` | number | Идентификатор новой записи |\n| `data.entityTypeId` \u002F `data.entityId` \u002F `data.presetId` | number | Переданные значения |\n| `data.name` | string \\| null | Название реквизита |\n| `data.active` | boolean | Активен ли реквизит. По умолчанию `true` |\n| `data.sort` | number | Порядок сортировки. По умолчанию `500` |\n| `data.createdAt` \u002F `data.updatedAt` | datetime | Совпадают при создании |\n| `data.createdBy` | number | ID создателя |\n| `data.modifyBy` | number \\| null | `null` сразу после создания |\n\nОтвет содержит все поля шаблона реквизита в camelCase. Незаполненные поля — `null`. Полный список полей — [Поля реквизита](\u002Fdocs\u002Fentities\u002Frequisites\u002Ffields).\n\n## Пример ответа\n\nHTTP-статус: `201 Created`\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 42,\n    \"entityTypeId\": 4,\n    \"entityId\": 15,\n    \"presetId\": 1,\n    \"name\": \"Основной\",\n    \"active\": true,\n    \"sort\": 500,\n    \"createdAt\": \"2026-04-19T14:30:00+03:00\",\n    \"updatedAt\": \"2026-04-19T14:30:00+03:00\",\n    \"createdBy\": 1,\n    \"modifyBy\": null,\n    \"rqName\": \"ООО «Ромашка»\",\n    \"rqInn\": \"7701234567\",\n    \"rqKpp\": \"770101001\",\n    \"rqOgrn\": \"1027700123456\",\n    \"rqCompanyName\": \"Ромашка\",\n    \"rqDirector\": \"Иванов Иван Иванович\",\n    \"rqVatPayer\": true,\n    \"rqAccountant\": null,\n    \"rqCeoName\": null,\n    \"rqOkpo\": null,\n    \"rqOkved\": null\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не указан `presetId`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"PRESET_ID field value is not specified\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Не указано обязательное поле — Битрикс24 отвечает текстом вида `PRESET_ID is not defined or invalid` \u002F «Не заполнено обязательное поле „Название\"» |\n| 422 | `BITRIX_ERROR` | Битрикс24 отклонил значение одного из полей (например, несуществующий `presetId`) |\n| 403 | `ACCESS_DENIED` | Нет доступа к родительской компании\u002Fконтакту |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Поля, которых нет в шаблоне, игнорируются.** Если передать поле, которого нет в выбранном шаблоне, Битрикс24 молча его проигнорирует — ошибка не возникнет, но и значение не сохранится.\n\n## Смотрите также\n\n- [Список реквизитов](\u002Fdocs\u002Fentities\u002Frequisites\u002Flist) — получить существующие\n- [Поля реквизита](\u002Fdocs\u002Fentities\u002Frequisites\u002Ffields) — полный перечень\n- [Обновить реквизит](\u002Fdocs\u002Fentities\u002Frequisites\u002Fupdate) — изменить после создания\n- [Синтаксис фильтрации](\u002Fdocs\u002Ffiltering)\n- [Batch](\u002Fdocs\u002Fbatch) — массовое создание\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-06-30",{}]