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

PATCH /v1/bank-details/:id

Обновляет поля существующего банковского реквизита. Передавайте только те поля, которые нужно изменить. Полный список — `GET /v1/bank-details/fields`.

Параметры

Параметр Тип Обяз. Описание
id (path) number да ID банковского реквизита

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

Поле Тип Обяз. Описание
name string нет Название банковского реквизита
rqBik string нет БИК банка
rqAccNum string нет Расчётный счёт
rqCorAccNum string нет Корреспондентский счёт
rqSwift string нет Код SWIFT
rqIban string нет Номер IBAN
rqBankName string нет Наименование банка
rqBankAddr string нет Адрес банка
rqAccName string нет Наименование владельца счёта
rqAccCurrency string нет Валюта счёта
active boolean нет Активен ли реквизит
sort number нет Порядок сортировки
comments string нет Комментарий

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

Примеры

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

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/bank-details/19" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rqAccName": "ООО Ромашка",
    "rqCorAccNum": "30101810400000000225"
  }'

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

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/bank-details/19" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "rqAccName": "ООО Ромашка",
    "rqCorAccNum": "30101810400000000225"
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bank-details/19', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    rqAccName: 'ООО Ромашка',
    rqCorAccNum: '30101810400000000225',
  }),
})

const { success, data } = await res.json()

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bank-details/19', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    rqAccName: 'ООО Ромашка',
    rqCorAccNum: '30101810400000000225',
  }),
})

const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Обновлённый банковский реквизит с актуальными значениями полей
data.id number Идентификатор записи
data.entityId number ID реквизита-владельца
data.updatedAt datetime Новая дата изменения (ISO 8601)
data.modifyBy number ID пользователя, выполнившего обновление

Объект содержит все поля в camelCase, включая неизменённые. Незаполненные поля — null. Полный список — Поля банковского реквизита.

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

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

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

404 — банковский реквизит не найден:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "The RequisiteBankDetail with ID '999999' is not found"
  }
}

Ошибки

HTTP Код Описание
404 ENTITY_NOT_FOUND Банковский реквизит с таким ID не найден
403 SCOPE_DENIED Ключ не имеет скоупа crm. Сообщение: This endpoint requires 'crm' scope
401 TOKEN_MISSING Не передан X-Api-Key

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

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

Пустое значение очищает поле. Чтобы очистить поле, передайте пустую строку "". В ответе очищенные строки приходят как null.

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