---
title: "Подключить выписку банка по почте"
method: POST
path: "/api/v1/finance/statement-mailboxes"
tags: ["Finance connectors"]
---

# Подключить выписку банка по почте

`POST /api/v1/finance/statement-mailboxes`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/statement-mailboxes`
- 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`)

Заводит подключение юрлица и выдаёт адрес приёма <токен>@<поддомен приёма>.
Письмо на этот адрес загружается, только если пришло с доменов банка и
прошло подпись DKIM, а номер счёта в файле — счёт этого юрлица. Счёт
подключения необязателен: без него выписка идёт в счёт юрлица из файла.

## Headers

- `X-Tenant` string, required

## Request body

- FinanceStatementMailboxCreate
  - `company_id` string, uuid, required
  - `account_id` string, uuid, nullable
  - `bank_name` string, required
  - `sender_domains` string[], required: Домены банка, например sovcombank.ru; элемент может перечислять несколько через запятую

## Response `201`

Созданное подключение с адресом приёма

- FinanceStatementMailbox
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `account_id` string, uuid, nullable, required: Счёт, если выписки адреса идут только в него
  - `bank_name` string, required
  - `sender_domains` string[], required: Домены отправителя; поддомены подходят
  - `address` string, required: Адрес приёма; пусто, пока на сервере не задан поддомен приёма
  - `status` 'active' | 'paused' | 'disconnected', required
  - `created_by` integer, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `last_mail_at` string, date-time, nullable, required
  - `last_mail_status` string, required: Итог последнего письма; пусто, пока писем не было
  - `company_name` string
  - `account_number` string

## Other responses

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

## Changes

- **2026-10-21** `7a6b75f272ee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/finance/statement-mailboxes/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/9dcf3c80b29a?raw)