BCS-Коннектор
Быстрый старт

Быстрый старт

Подключение к BCS API за пять минут. Дальше — углубление по конкретному сценарию.

:::info Что такое BCS API BCS — банковский коннектор: REST API + MCP сверху, который выдаёт внешним сервисам контролируемый доступ к РС нескольких банков (Точка, Сбер) через один контракт. Авторизация — Bearer-токен, выпущенный администратором. Платежи и выписки обрабатываются BCS; банковские секреты на стороне клиента не нужны и не передаются. :::

Три сценария — выберите свой

Каждый сценарий ниже — отдельный раздел в этой документации. Если вы интегратор ERP / 1С / собственный backend — начинайте с первого. Если вы подключаете AI-ассистента — третий.

  • Платежи (отправка платежей из 1С / ERP). Раздел: Платежи. Для 1С есть отдельный гайд: Интеграция с 1С.
  • Выписки (заказ и скачивание выписок в форматах 1C v1.02 / v1.03 / CSV / JSON). Раздел: Выписки.
  • AI-ассистент (read-only доступ для Claude Code, Claude Desktop, Cursor через MCP). Раздел: MCP.

Шаг 1. Получите токен

Токены выпускает администратор BCS через /admin/api-tokens. Один токен = одна компания + конкретный набор расчётных счетов + ограниченные права (читать выписки / отправлять платежи). Подробности — Авторизация.

Значение токена показывается один раз при создании — сохраните его в secret-менеджер. В БД хранится только sha256-хеш + видимый префикс (bcs_live_xxxxxxxx) для корреляции с логами.

Шаг 2. Smoke — первый запрос

Все запросы шлются на ваш BCS-инстанс под /api/v1/integration/* (REST) или /api/v1/mcp (MCP). Универсальный smoke — справочник доступных токену РС:

curl --silent --show-error \
     -H "Authorization: Bearer bcs_live_<TOKEN>" \
     "https://bsc.example.com/api/v1/integration/bank-accounts"

Ожидаемый ответ: 200 OK + JSON с компанией и списком разрешённых токену РС. Поля account_number_masked — основная форма представления РС в ответах (4070…1234); полный 20-значный номер возвращается только в admin-зоне.

{
  "company": {
    "id": "<company-uuid>",
    "name": "ООО Ромашка",
    "inn": "7700000000"
  },
  "bank_accounts": [
    {
      "id": "<bank-account-uuid>",
      "alias": "Точка main",
      "account_number_masked": "4070…1234",
      "bik": "044525104",
      "bank": { "code": "tochka", "name": "Точка Банк" },
      "is_active": true,
      "permissions": { "read_statements": true, "send_payments": true }
    }
  ]
}

Если получили 401 — проверьте, что токен скопирован без пробелов и не отозван. Если 403 forbidden_ip — ваш IP не в allow-list токена (попросите админа расширить или ходите с разрешённого адреса).

Шаг 3. Следующий шаг — по сценарию

  • Платежи 1С: Интеграция с 1С (формат файла, выгрузка из 1С, импорт обратно).
  • Платежи через REST: Платежи (upload → submit → status → search).
  • Выписки: Выписки (request → polling → export в 4 форматах).
  • AI-ассистент: MCP (Streamable HTTP без бинарника + stdio bcs-mcp как fallback).

Базовые соглашения

  • Все запросы — HTTPS. Body — JSON (Content-Type: application/json), кроме загрузки 1С-файла (multipart).
  • Авторизация только через Authorization: Bearer …. Cookies и Basic-auth не поддерживаются.
  • Все ошибки — единый envelope {"error":{"code":"...","message":"..."}}. Полный справочник кодов: Коды ошибок.
  • Версионирование URL: /api/v1/. Breaking changes выйдут под новым префиксом (/api/v2/), а не как silent изменения существующего контракта.
  • Rate-limit, retry, размер запроса: Лимиты и соглашения.
BCS-КоннекторЦифровой офис