---
title: "Добавить расчётный счёт контрагенту"
method: POST
path: "/api/v1/core/contacts/{id}/bank-accounts"
tags: ["Core contacts"]
---

# Добавить расчётный счёт контрагенту

`POST /api/v1/core/contacts/{id}/bank-accounts`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/core/contacts/{id}/bank-accounts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Заводит расчётный счёт контрагента. БИК — девять цифр, номер счёта — двадцать, и номер обязан сходиться с БИК по контрольному ключу Банка России: иначе 400 с понятной причиной, потому что платёж по такой паре банк вернёт. Тот же БИК и номер второй строкой не заводятся: прежний счёт включается и возвращается тем же ответом, поэтому повтор безопасен и без ключа. is_default=true делает счёт основным и снимает признак с прежнего основного; если основного у контрагента ещё нет, основным становится заводимый счёт. Карточка, которую ведёт карточка сотрудника, отвечает 409: её реквизиты правят у сотрудника. Читает Idempotency-Key — повтор с тем же ключом отдаёт тот же ответ.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required
- `Idempotency-Key` string

## Request body

- CoreContactBankAccountCreate
  - `bic` string, required: БИК банка; нецифровые знаки отбрасываются, остаться должно девять цифр
  - `account` string, required: Номер расчётного счёта; нецифровые знаки отбрасываются, остаться должно двадцать цифр
  - `bank_name` string: Название банка
  - `is_default` boolean: Сделать счёт основным
  - `comment` string: Комментарий к счёту
  - `source` 'manual' | 'document' | 'card': Откуда счёт; не прислано — manual

## Response `201`

Заведённый или вновь включённый счёт

- CoreContactBankAccount: Расчётный счёт контрагента в справочнике модуля core. Документы и заявки на оплату хранят ссылку на него, а не копию реквизитов.
  - `id` string, uuid, required
  - `contact_id` string, uuid, required
  - `bic` string, required: БИК банка, девять цифр
  - `account` string, required: Номер расчётного счёта, двадцать цифр
  - `bank_name` string, required: Название банка
  - `is_default` boolean, required: Основной счёт: подставляется, когда документ своего счёта не назвал. У контрагента он один
  - `is_active` boolean, required: Выключенный счёт не предлагается новым документам, но читается в старых
  - `comment` string, required: Комментарий к счёту
  - `source` 'manual' | 'document' | 'card', required: Откуда счёт появился: manual — завёл человек, document — прочитан из счёта поставщика и прошёл проверку ключа, card — пришёл через плоские поля карточки контрагента.
  - `created_at` string, required: Когда счёт заведён: отметка времени базы текстом
  - `updated_at` string, required: Когда счёт последний раз менялся: отметка времени базы текстом

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Idempotency-Key уже использован для другого запроса: другое тело, другой адрес или другая операция. Код `idempotency.key_mismatch`; сохранённый ответ не раскрывается. Для новой команды берут новый ключ.
- `503`: Хранилище ключей идемпотентности недоступно, команда с заголовком Idempotency-Key не выполнялась. Код `idempotency.unavailable`; Retry-After говорит, когда повторить.

## Changes

- **2026-10-20** `408f7294f7a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/core/contacts/:id/bank-accounts/post.md)

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/7a6b75f272ee?raw)