[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fbank-details\u002Fcreate":3,"docs-tabs-entities\u002Fbank-details\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать банковский реквизит\n\n`POST \u002Fv1\u002Fbank-details`\n\nСоздаёт новый банковский реквизит и привязывает его к реквизиту CRM. Восстановить удалённую запись нельзя — создавайте новую при необходимости.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `entityId` | number | да | ID реквизита-владельца. Поиск: `GET \u002Fv1\u002Frequisites` |\n| `name` | string | да | Название банковского реквизита |\n| `entityTypeId` | number | нет | Тип родительской сущности. Укажите `8`, чтобы привязать запись к реквизиту |\n| `rqBik` | string | нет | БИК банка |\n| `rqAccNum` | string | нет | Расчётный счёт |\n| `rqCorAccNum` | string | нет | Корреспондентский счёт |\n| `rqSwift` | string | нет | Код SWIFT |\n| `rqIban` | string | нет | Номер IBAN |\n| `rqBankName` | string | нет | Наименование банка |\n| `rqBankAddr` | string | нет | Адрес банка |\n| `rqAccName` | string | нет | Наименование владельца счёта |\n| `rqAccCurrency` | string | нет | Валюта счёта |\n| `active` | boolean | нет | Активен ли реквизит. По умолчанию `true` |\n| `sort` | number | нет | Порядок сортировки. По умолчанию `500` |\n| `code` \u002F `xmlId` \u002F `originatorId` | string | нет | Внешние идентификаторы для синхронизации |\n| `comments` | string | нет | Комментарий |\n\nПоля `id`, `createdAt`, `updatedAt`, `createdBy`, `modifyBy` заполняются системой и игнорируются при записи.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbank-details\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"entityTypeId\": 8,\n    \"entityId\": 1,\n    \"name\": \"Расчётный счёт\",\n    \"rqBik\": \"044525225\",\n    \"rqAccNum\": \"40702810500000000001\",\n    \"rqSwift\": \"SABRRUMM\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbank-details\" \\\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\": 8,\n    \"entityId\": 1,\n    \"name\": \"Расчётный счёт\",\n    \"rqBik\": \"044525225\",\n    \"rqAccNum\": \"40702810500000000001\",\n    \"rqSwift\": \"SABRRUMM\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbank-details', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    entityTypeId: 8,\n    entityId: 1,\n    name: 'Расчётный счёт',\n    rqBik: '044525225',\n    rqAccNum: '40702810500000000001',\n    rqSwift: 'SABRRUMM',\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\u002Fbank-details', {\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: 8,\n    entityId: 1,\n    name: 'Расчётный счёт',\n    rqBik: '044525225',\n    rqAccNum: '40702810500000000001',\n    rqSwift: 'SABRRUMM',\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Создан банковский реквизит ID:', data.id)\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | object | Созданный банковский реквизит |\n| `data.id` | number | Идентификатор новой записи |\n| `data.entityId` | number | ID реквизита-владельца |\n| `data.countryId` | number | ID страны; `0`, если страна не задана |\n| `data.name` | string \\| null | Название |\n| `data.active` | boolean | Активен ли реквизит |\n| `data.sort` | number | Порядок сортировки |\n| `data.rqBik` | string \\| null | БИК банка |\n| `data.rqAccNum` | string \\| null | Расчётный счёт |\n| `data.rqCorAccNum` | string \\| null | Корреспондентский счёт |\n| `data.rqSwift` | string \\| null | Код SWIFT |\n| `data.rqIban` | string \\| null | Номер IBAN |\n| `data.rqBankName` | string \\| null | Наименование банка |\n| `data.rqBankAddr` | string \\| null | Адрес банка |\n| `data.rqAccName` | string \\| null | Наименование владельца счёта |\n| `data.rqAccCurrency` | string \\| null | Валюта счёта |\n| `data.comments` | string \\| null | Комментарий |\n| `data.createdAt` | datetime | Дата создания (ISO 8601) |\n| `data.updatedAt` | datetime \\| null | Дата последнего изменения |\n| `data.createdBy` | number | ID создателя |\n| `data.modifyBy` | number \\| null | `null` сразу после создания |\n\nНезаполненные поля возвращаются как `null`. Полный список — [`GET \u002Fv1\u002Fbank-details\u002Ffields`](\u002Fdocs\u002Fentities\u002Fbank-details\u002Ffields).\n\n## Пример ответа\n\nHTTP-статус: `201 Created`\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 19,\n    \"entityId\": 1,\n    \"countryId\": 0,\n    \"createdAt\": \"2026-06-10T10:14:29.000Z\",\n    \"updatedAt\": null,\n    \"createdBy\": 1,\n    \"modifyBy\": null,\n    \"name\": \"Расчётный счёт\",\n    \"code\": null,\n    \"xmlId\": null,\n    \"originatorId\": null,\n    \"active\": true,\n    \"sort\": 500,\n    \"rqBankName\": null,\n    \"rqBankAddr\": null,\n    \"rqBik\": \"044525225\",\n    \"rqAccName\": null,\n    \"rqAccNum\": \"40702810500000000001\",\n    \"rqAccCurrency\": null,\n    \"rqCorAccNum\": null,\n    \"rqIban\": null,\n    \"rqSwift\": \"SABRRUMM\",\n    \"comments\": null\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — не передан `entityId`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"ENTITY_ID is not defined or invalid.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Не передан `entityTypeId` или `entityId`, либо Битрикс24 отклонил значение поля |\n| 403 | `SCOPE_DENIED` | Ключ не имеет скоупа `crm`. Сообщение: `This endpoint requires 'crm' scope` |\n| 401 | `TOKEN_MISSING` | Не передан `X-Api-Key` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**`entityTypeId` не возвращается на чтении.** Это поле-владелец: его передают при создании со значением `8`, но в ответе `GET \u002Fv1\u002Fbank-details\u002F:id` и в списке его нет.\n\n## Смотрите также\n\n- [Список банковских реквизитов](\u002Fdocs\u002Fentities\u002Fbank-details\u002Flist)\n- [Обновить банковский реквизит](\u002Fdocs\u002Fentities\u002Fbank-details\u002Fupdate)\n- [Удалить банковский реквизит](\u002Fdocs\u002Fentities\u002Fbank-details\u002Fdelete)\n- [Поля банковского реквизита](\u002Fdocs\u002Fentities\u002Fbank-details\u002Ffields)\n- [Реквизиты](\u002Fdocs\u002Fentities\u002Frequisites)\n- [Batch](\u002Fdocs\u002Fbatch)\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization)\n","2026-06-19",{}]