Создать банковский реквизит

POST /v1/bank-details

Создаёт новый банковский реквизит и привязывает его к реквизиту CRM. Восстановить удалённую запись нельзя — создавайте новую при необходимости.

Поля запроса (body)

Поле Тип Обяз. Описание
entityId number да ID реквизита-владельца. Поиск: GET /v1/requisites
name string да Название банковского реквизита
entityTypeId number нет Тип родительской сущности. Укажите 8, чтобы привязать запись к реквизиту
rqBik string нет БИК банка
rqAccNum string нет Расчётный счёт
rqCorAccNum string нет Корреспондентский счёт
rqSwift string нет Код SWIFT
rqIban string нет Номер IBAN
rqBankName string нет Наименование банка
rqBankAddr string нет Адрес банка
rqAccName string нет Наименование владельца счёта
rqAccCurrency string нет Валюта счёта
active boolean нет Активен ли реквизит. По умолчанию true
sort number нет Порядок сортировки. По умолчанию 500
code / xmlId / originatorId string нет Внешние идентификаторы для синхронизации
comments string нет Комментарий

Поля id, createdAt, updatedAt, createdBy, modifyBy заполняются системой и игнорируются при записи.

Примеры

curl — личный ключ

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/bank-details" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 8,
    "entityId": 1,
    "name": "Расчётный счёт",
    "rqBik": "044525225",
    "rqAccNum": "40702810500000000001",
    "rqSwift": "SABRRUMM"
  }'

curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/bank-details" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 8,
    "entityId": 1,
    "name": "Расчётный счёт",
    "rqBik": "044525225",
    "rqAccNum": "40702810500000000001",
    "rqSwift": "SABRRUMM"
  }'

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bank-details', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    entityTypeId: 8,
    entityId: 1,
    name: 'Расчётный счёт',
    rqBik: '044525225',
    rqAccNum: '40702810500000000001',
    rqSwift: 'SABRRUMM',
  }),
})

const { success, data } = await res.json()
console.log('Создан банковский реквизит ID:', data.id)

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bank-details', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    entityTypeId: 8,
    entityId: 1,
    name: 'Расчётный счёт',
    rqBik: '044525225',
    rqAccNum: '40702810500000000001',
    rqSwift: 'SABRRUMM',
  }),
})

const { success, data } = await res.json()
console.log('Создан банковский реквизит ID:', data.id)

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Созданный банковский реквизит
data.id number Идентификатор новой записи
data.entityId number ID реквизита-владельца
data.countryId number ID страны; 0, если страна не задана
data.name string | null Название
data.active boolean Активен ли реквизит
data.sort number Порядок сортировки
data.rqBik string | null БИК банка
data.rqAccNum string | null Расчётный счёт
data.rqCorAccNum string | null Корреспондентский счёт
data.rqSwift string | null Код SWIFT
data.rqIban string | null Номер IBAN
data.rqBankName string | null Наименование банка
data.rqBankAddr string | null Адрес банка
data.rqAccName string | null Наименование владельца счёта
data.rqAccCurrency string | null Валюта счёта
data.comments string | null Комментарий
data.createdAt datetime Дата создания (ISO 8601)
data.updatedAt datetime | null Дата последнего изменения
data.createdBy number ID создателя
data.modifyBy number | null null сразу после создания

Незаполненные поля возвращаются как null. Полный список — `GET /v1/bank-details/fields`.

Пример ответа

HTTP-статус: 201 Created

JSON 
{
  "success": true,
  "data": {
    "id": 19,
    "entityId": 1,
    "countryId": 0,
    "createdAt": "2026-06-10T10:14:29.000Z",
    "updatedAt": null,
    "createdBy": 1,
    "modifyBy": null,
    "name": "Расчётный счёт",
    "code": null,
    "xmlId": null,
    "originatorId": null,
    "active": true,
    "sort": 500,
    "rqBankName": null,
    "rqBankAddr": null,
    "rqBik": "044525225",
    "rqAccName": null,
    "rqAccNum": "40702810500000000001",
    "rqAccCurrency": null,
    "rqCorAccNum": null,
    "rqIban": null,
    "rqSwift": "SABRRUMM",
    "comments": null
  }
}

Пример ответа при ошибке

422 — не передан entityId:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "ENTITY_ID is not defined or invalid."
  }
}

Ошибки

HTTP Код Описание
422 BITRIX_ERROR Не передан entityTypeId или entityId, либо Битрикс24 отклонил значение поля
403 SCOPE_DENIED Ключ не имеет скоупа crm. Сообщение: This endpoint requires 'crm' scope
401 TOKEN_MISSING Не передан X-Api-Key

Полный список общих ошибок API — Ошибки.

Известные особенности

entityTypeId не возвращается на чтении. Это поле-владелец: его передают при создании со значением 8, но в ответе GET /v1/bank-details/:id и в списке его нет.

Смотрите также