---
title: "Подключить базу 1С юрлица"
method: POST
path: "/api/v1/finance/exchange/onec/connections"
tags: ["Finance exchange"]
---

# Подключить базу 1С юрлица

`POST /api/v1/finance/exchange/onec/connections`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/exchange/onec/connections`
- 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

Заводит подключение базы 1С:Бухгалтерии юрлица. Пароль пользователя 1С вводит человек на экране подключения: через MCP пароль не передаётся, без него Акеда к базе не обращается. С паролем доступ проверяется сразу.

## Headers

- `X-Tenant` string, required

## Request body

- FinanceOneCConnectionInput
  - `company_id` string, uuid, required
  - `base_url` string, required: Адрес публикации базы 1С: https://сервер/ИмяБазы
  - `username` string, required
  - `password` string, password: Пароль пользователя 1С; вводится только на экране подключения, через MCP не передаётся
  - `format_version` string
  - `objects` FinanceOneCObjects: Состав обмена — вид данных → включён.
    - `counterparties` boolean
    - `contracts` boolean
    - `services` boolean
    - `sales` boolean
    - `purchases` boolean
    - `bank` boolean
    - `cash` boolean
    - `payroll` boolean
    - `budget` boolean
    - `declarations` boolean
  - `object_settings` FinanceOneCObjectSettings: Настройки видов данных сверх галочки: ключ — вид из objects
  - `documents_since` string, date
  - `send_every_minutes` integer
  - `receive_daily_at` string
  - `errors_owner_user_id` integer
  - `receive_enabled` boolean: Включить приём из 1С по расписанию; не передан — оставить как есть, у нового подключения — выключен

## Response `201`

Созданное подключение без пароля

- FinanceOneCConnection
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `company_name` string, required
  - `base_url` string, required: Адрес публикации базы 1С без хвоста /ws
  - `username` string, required
  - `has_password` boolean, required
  - `format_version` string, required: Версия EnterpriseData; пусто — старшая, которую назовёт база
  - `node_code` string, uuid, required
  - `node_prefix` string, required
  - `base_node_code` string, required
  - `base_name` string, required
  - `base_config_version` string, required
  - `setup_step` 'access' | 'node' | 'wizard' | 'ready', required: access — доступ не проверен; node — узла Акеды в базе нет; wizard — бухгалтер не прошёл мастер в 1С; ready — обмен идёт
  - `sent_no` integer, required
  - `received_no` integer, required
  - `objects` FinanceOneCObjects, required: Состав обмена — вид данных → включён.
    - `counterparties` boolean
    - `contracts` boolean
    - `services` boolean
    - `sales` boolean
    - `purchases` boolean
    - `bank` boolean
    - `cash` boolean
    - `payroll` boolean
    - `budget` boolean
    - `declarations` boolean
  - `object_settings` FinanceOneCObjectSettings: Настройки видов данных сверх галочки: ключ — вид из objects
  - `documents_since` string, date
  - `send_every_minutes` integer, required
  - `receive_daily_at` string, required
  - `errors_owner_user_id` integer
  - `last_session_at` string, date-time
  - `last_received_at` string, date-time: Последний приём из 1С
  - `receive_enabled` boolean: Приём из 1С по расписанию включён: он пишет в учёт, поэтому по умолчанию выключен
  - `last_error` string
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

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

---

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