---
title: "Частично изменить банковский счёт"
method: PATCH
path: "/api/v1/finance/accounts/{id}"
tags: ["Finance accounts"]
---

# Частично изменить банковский счёт

`PATCH /api/v1/finance/accounts/{id}`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/accounts/{id}`
- 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

Отсутствующее поле не меняется; явный null у company или gl_account отвязывает ссылку. Название, номер и БИК нельзя очистить.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- FinanceAccountPatch
  - `company` string, uuid, nullable
  - `company_name` string
  - `name` string
  - `bank_name` string
  - `bic` string
  - `number` string
  - `currency` string
  - `gl_account` string, uuid, nullable
  - `is_active` boolean
  - `in_use_since` string, nullable: «Используется с», ГГГГ-ММ-ДД; null или пустая строка снимают ограничение.
  - `bank_timezone` string: Часовой пояс банковских суток (IANA). Источник пояса становится manual.

## Response `200`

Обновлённый счёт

- FinanceAccount
  - `id` string, uuid, required
  - `business` string, uuid, nullable: Бизнес, которому принадлежат деньги — у счёта из юрлица, у кассы из её карточки. null только у старого счёта без юрлица в кабинете с несколькими бизнесами.
  - `kind` 'bank' | 'cash', required: Где лежат деньги. `bank` — расчётный счёт, `cash` — касса из справочника «Кассы». Список общий намеренно: вопрос «сколько у меня денег» задаётся один раз. У кассы банковские поля (`bic`, `number`, `bank_name`, `connector`) пусты по построению, а не «ещё не заполнены», и карточка счёта по её идентификатору не открывается.
  - `company` string, uuid, nullable, required
  - `bank` string, uuid, nullable, required
  - `company_name` string, required
  - `company_directory_name` string, required
  - `company_inn` string, required
  - `company_is_active` boolean, required
  - `name` string, required
  - `bank_name` string, required
  - `bic` string, required
  - `number` string, required
  - `currency` string, required
  - `gl_account` string, uuid, nullable, required
  - `is_active` boolean, required
  - `opening_balance` string, required: Decimal string
  - `balance` string, required: Decimal string
  - `txn_count` integer, required
  - `connector` string, uuid, nullable, required
  - `connector_name` string, required
  - `connector_status` string, required
  - `sync_enabled` boolean, required
  - `synced_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `bank_balance` string, nullable: Остаток по данным банка на момент `bank_balance_at`, decimal string. null — банк остатка не называл (счёт не подключён или остаток ещё не приходил): это не ноль, и сверять с ним нечего.
  - `bank_balance_at` string, date-time, nullable: Когда банк назвал остаток `bank_balance`.
  - `bank_closed_at` string, date-time, nullable: Когда счёт закрыт банком. null — счёт действующий.
  - `in_use_since` string, date: «Используется с»: с какой даты счёт принадлежит бизнесу. Операции раньше неё коннектор не запрашивает, загрузка файла пропускает, ручной ввод отклоняет. Поля нет — ограничения нет.
  - `bank_timezone` string, nullable: Часовой пояс банковских суток счёта (IANA), например Asia/Novosibirsk. По нему банк режет сутки выписки, и по нему считаются окно синхронизации, «Загрузить период» и остаток на дату. Умолчание — по БИК подразделения банка. null у кассы.
  - `bank_timezone_source` 'bic' | 'default' | 'manual' | 'null', nullable: Откуда пояс: `bic` — определён по БИК, `default` — определить не удалось, стоит умолчание (проверьте пояс), `manual` — задан человеком; подключение банка ручной пояс не трогает.
  - `account_type` 'settlement' | 'deposit': Вид счёта. `settlement` — расчётный (счёт книги 51), `deposit` — вклад. Деньги вклада учитываются статьёй «Депозиты и вклады»: отправка и возврат идут ею, а остаток депозитного счёта в итог денег не входит.
  - `account_type_source` 'number' | 'bank' | 'manual': Откуда вид: `number` — выведен из номера счёта (421…–422… и 423…, 426… — вклад), `bank` — назван банком, `manual` — выбран человеком. Ручной выбор номер и банк не перебивают.

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `500`: Внутренняя ошибка без раскрытия server-only деталей

---

[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/3c60ded179f2?raw)