# Банковские реквизиты

Банковские счета, привязанные к реквизиту: расчётный счёт, БИК, корреспондентский счёт, SWIFT, IBAN. Без банковского реквизита нельзя выставить счёт на оплату.

Битрикс24 API: `crm.requisite.bankdetail.*`
Скоуп: `crm`

## Операции

- [Создать банковский реквизит](./bank-details/create.md) — `POST /v1/bank-details`
- [Список банковских реквизитов](./bank-details/list.md) — `GET /v1/bank-details`
- [Получить банковский реквизит](./bank-details/get.md) — `GET /v1/bank-details/:id`
- [Обновить банковский реквизит](./bank-details/update.md) — `PATCH /v1/bank-details/:id`
- [Удалить банковский реквизит](./bank-details/delete.md) — `DELETE /v1/bank-details/:id`
- [Поиск банковских реквизитов](./bank-details/search.md) — `POST /v1/bank-details/search`
- [Поля банковского реквизита](./bank-details/fields.md) — `GET /v1/bank-details/fields`

## Ключевые поля

| Поле | Описание |
|------|---------|
| `entityId` | ID реквизита, которому принадлежит банковский реквизит (из `GET /v1/requisites`) |
| `name` | Название банковского реквизита |
| `rqBik` | БИК банка |
| `rqAccNum` | Расчётный счёт |
| `rqCorAccNum` | Корреспондентский счёт |
| `rqSwift` / `rqIban` | Международные реквизиты счёта |

Полный список полей — [`GET /v1/bank-details/fields`](./bank-details/fields.md).

## Что нужно знать перед работой

1. **Банковский реквизит привязан к реквизиту.** При создании обязательны `entityId` — идентификатор реквизита из `GET /v1/requisites` — и `name`.
2. **`entityTypeId` необязателен, но не возвращается на чтении.** Это поле-владелец. Укажите `8` — реквизит — при создании, чтобы привязать запись к реквизиту. В ответе `GET` его нет.
3. **Поля возвращаются в camelCase.** Российские реквизиты счёта — `rqBik`, `rqAccNum`, `rqCorAccNum`, `rqAccCurrency`, международные — `rqSwift`, `rqIban`. У записей без указанной страны `countryId` приходит как `0`.

## Связанные сущности

| Сущность | Эндпоинт | Назначение |
|----------|----------|-----------|
| Реквизиты | `GET /v1/requisites` | Владелец банковского реквизита. `entityId` банковского реквизита — это `id` реквизита. |
| Шаблоны реквизитов | `GET /v1/requisite-presets` | Шаблон набора полей реквизита-владельца. |
| Связи реквизитов | `POST /v1/requisite-links` | Привязка реквизита и банковского реквизита к счёту или предложению. |

## Типичный сценарий

1. Найти реквизит компании: [`GET /v1/requisites?filter[entityTypeId]=4&filter[entityId]=15`](./requisites/list.md).
2. Создать банковский реквизит на него: [`POST /v1/bank-details`](./bank-details/create.md) с `entityTypeId: 8` и `entityId` реквизита.
3. Использовать `id` банковского реквизита при выставлении счёта или в [связи реквизитов](./requisite-links.md).

## Лимиты

| Лимит | Значение |
|-------|----------|
| Максимум записей на запрос | 5000 (`limit ≤ 5000`) |
| Авто-пагинация | включается при `limit > 50` |
| `offset` на больших выборках | рекомендуется `limit ≤ 500` при `offset ≥ 2500` |
| Batch-запросы | до 50 операций в [`POST /v1/batch`](/docs/batch) |
| Rate limit | общий для API Вайбкод — см. [Лимиты и оптимизация](/docs/optimization) |

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

- [Реквизиты компании для генерации документа](/docs/recipes/document-requisites)
- [Entity API](/docs/entity-api)
- [Синтаксис фильтрации](/docs/filtering)
- [Batch](/docs/batch)
- [Справочник API](/docs/api-reference)