---
title: "Загрузить реестр платежей провайдера"
method: POST
path: "/api/v1/finance/acquiring/registries"
tags: ["Finance acquiring"]
---

# Загрузить реестр платежей провайдера

`POST /api/v1/finance/acquiring/registries`

## Request

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

CSV реестра платежей текстом (ЮKassa: стандартный или настраиваемый; колонки ищутся по заголовку). Находит оплаты по номерам платежей, заводит «Комиссию эквайринга» там, где удержание при оплате не было названо, отмечает неизвестные платежи и расхождения удержания и сверяет оплаты с выплатой на сумму реестра — сразу или когда выплата придёт. Тот же файл второй раз возвращает прежний реестр (200, replayed=true).

## Headers

- `X-Tenant` string, required

## Request body

- FinanceAcquiringRegistryInput
  - `company_id` string, uuid, required
  - `provider` string, required: Ключ провайдера (yookassa)
  - `file_name` string: Имя файла для истории загрузок
  - `content` string, required: Содержимое CSV реестра текстом в UTF-8, до 4 МБ

## Response `200`

Тот же файл уже загружен — прежний реестр

- FinanceAcquiringRegistryImport
  - `registry` FinanceAcquiringRegistry, required
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `provider` string, required: Ключ провайдера
    - `file_name` string, required: Имя загруженного файла
    - `currency` string, required: Валюта платежей, ISO 4217
    - `rows_count` integer, required: Число платежей в реестре
    - `amount` string, required: Сумма платежей
    - `net_amount` string, required: Сумма к зачислению — ею реестр находит выплату
    - `fee_amount` string, required: Удержано всего
    - `payout_document_id` string, uuid
    - `status` 'matched' | 'awaiting_payout' | 'discrepancy', required: awaiting_payout — выплаты на сумму реестра ещё нет; matched — сверен; discrepancy — сверен, но есть строки для человека
    - `uploaded_at` string, date-time, required: Когда загружен
    - `rows` FinanceAcquiringRegistryRow[]: Строки реестра
      - `line` integer, required: Номер строки в файле
      - `external_id` string, required: Идентификатор платежа у провайдера
      - `amount` string, required: Сумма платежа, десятичная строка
      - `net_amount` string, required: Сумма к зачислению, десятичная строка
      - `fee` string, required: Удержано провайдером, всего с налогом
      - `fee_vat` string: В том числе налог с комиссии
      - `paid_at` string, date-time: Время платежа из реестра
      - `receipt_document_id` string, uuid
      - `status` 'matched' | 'unknown_payment' | 'fee_mismatch', required: matched — оплата найдена и удержание сходится; unknown_payment — оплаты с таким номером в учёте нет; fee_mismatch — в учёте другое удержание
  - `replayed` boolean, required: true — этот файл уже был загружен

## Other responses

- `201`: Загруженный реестр и его сверка
- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `422`: Запрос разобран, но бизнес-значение недопустимо
- `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/3c60ded179f2?raw)