---
title: "Привязать платежи к заявке на оплату"
method: POST
path: "/api/v1/finance/payment-requests/{id}/fact"
tags: ["Finance payment calendar"]
---

# Привязать платежи к заявке на оплату

`POST /api/v1/finance/payment-requests/{id}/fact`

## Request

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

Казначей привязывает к заявке один или несколько проведённых исходящих платежей (ERP-2672): payments — платёж и сумма, которая ложится на заявку (пусто — меньшее из свободного остатка платежа и остатка заявки); document_id — короткая запись одного платежа. Другая сумма (частичная оплата, комиссия), другой счёт того же юрлица, дата раньше заявки, другой получатель — расхождения: без confirm_warnings ответ 409 finance.payment_request.link_confirm со списком warnings (amount, account, date, payee, in_bank), с ним — привязка проходит, и расхождения записываются в связь. Жёсткие отказы: поступление — 400 finance.payment_request.fact_direction; другая валюта — 400 fact_currency; платёж другого юрлица — 400 fact_company; платёж уже целиком на других заявках или закрывает план календаря — 409 fact_taken; уже привязан к этой заявке — 409 fact_linked; сумма больше свободного остатка — 400 link_amount. Платежей на сумму заявки и больше — заявка executed и автор в «Документах» узнаёт об оплате; меньше — partially_paid с остатком. Заявка закрыта — 409 finance.payment_request.closed; версия устарела — 409 finance.payment_request.conflict.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- FinancePaymentRequestAttachInput
  - `document_id` string, uuid
  - `amount` string: Сумма для document_id; пусто — по умолчанию
  - `payments` FinancePaymentRequestLinkItem[]: Платежи и суммы, которые ложатся на заявку
    - `document_id` string, uuid, required
    - `amount` string: Сколько из платежа ложится на заявку; пусто — меньшее из свободного остатка платежа и остатка заявки
  - `confirm_warnings` boolean: Расхождения с заявкой видены и подтверждены
  - `expected_version` integer, required: Версия заявки, которую видел казначей

## Response `200`

Заявка после привязки

- FinancePaymentRequest: Строка очереди оплат модуля finance — заявка на оплату глазами казначея.
  - `payment_order` FinancePaymentOrderFields, required: Реквизиты платёжного поручения сверх получателя — налоговые и бюджетные поля.
    - `payer_inn` string: ИНН плательщика
    - `payer_kpp` string: КПП плательщика
    - `uin` string: УИН
    - `priority` string: Очерёдность платежа
    - `operation_kind` string: Вид операции
    - `payment_kind` string: Вид платежа
    - `payer_status` string: Статус составителя
    - `kbk` string: КБК
    - `oktmo` string: ОКТМО
    - `basis` string: Основание платежа
    - `period` string: Налоговый период
    - `doc_number` string: Номер документа-основания
    - `doc_date` string: Дата документа-основания
    - `payment_type` string: Тип платежа
  - `id` string, uuid, required
  - `number` string, required: Номер заявки
  - `business_id` string, uuid, required
  - `company_id` string, uuid, required
  - `account_id` string, uuid
  - `contact_id` string, uuid
  - `item_id` string, uuid
  - `company_name` string
  - `account_name` string
  - `contact_name` string
  - `item_name` string
  - `payee` FinancePaymentRequestPayee, required
    - `name` string, required: Наименование получателя
    - `inn` string: ИНН получателя
    - `kpp` string: КПП получателя
    - `account` string: Расчётный счёт получателя
    - `bic` string: БИК банка получателя
    - `bank_name` string: Банк получателя
    - `corr_account` string: Корреспондентский счёт банка
  - `amount` string, required: Сумма
  - `currency` string, required: Валюта
  - `due_date` string, required: Срок оплаты по счёту или договору
  - `planned_on` string, required: Когда платим: решение финансов
  - `purpose` string, required: Назначение платежа
  - `priority` string, required: Приоритет оплаты: high, normal или low
  - `status` 'pending_approval' | 'planned' | 'sent' | 'awaiting_signature' | 'partially_paid' | 'executed' | 'rejected' | 'cancelled' | 'returned', required: Состояние строки очереди; после возврата на доработку — returned; partially_paid — оплачена частично
  - `source` FinancePaymentRequestSource, required: Основание заявки нейтральной тройкой — модуль, вид и идентификатор у владельца.
    - `module` string: Модуль-владелец основания
    - `kind` string: Вид бумаги у владельца
    - `id` string, uuid
    - `contract_id` string, uuid
    - `title` string: Название основания для человека
  - `bank` FinancePaymentRequestBank, required: Что сказал банк о платёжке заявки.
    - `connector_id` string, uuid
    - `provider` string: Ключ банка
    - `provider_name` string: Название банка
    - `external_id` string: Идентификатор платёжки у банка
    - `status` string: Состояние платёжки у банка, нормализованное
    - `bank_status` string: Состояние словами банка
    - `sign_url` string: Страница подписания в интернет-банке
    - `error` string: Последний отказ банка
    - `attempted_at` string, date-time: Когда отправка последний раз уходила в банк
    - `order_number` string: Номер платёжного поручения
    - `order_date` string: Дата платёжного поручения
  - `fact_document_id` string, uuid
  - `executed_on` string: Дата фактической оплаты
  - `paid_amount` string: Сколько оплачено привязанными платежами
  - `remainder` string: Сколько осталось оплатить
  - `payments` FinancePaymentRequestPayment[]: Привязанные платежи; только в карточке заявки
    - `id` string, uuid, required
    - `request_id` string, uuid, required
    - `request_number` string: Номер заявки
    - `document_id` string, uuid, required
    - `amount` string, required: Сколько из платежа легло на заявку
    - `fact_amount` string: Сумма всего платежа
    - `currency` string
    - `paid_on` string, date, required: Дата платежа
    - `number` string: Номер документа платежа
    - `account_name` string: Счёт, с которого ушёл платёж
    - `counterparty` string: Получатель словами платежа
    - `mode` 'auto' | 'manual' | 'migrated', required: Кто привязал: сверка, казначей или перенос прежней ссылки
    - `warnings` string[]: Подтверждённые при привязке расхождения
    - `created_by` integer
    - `created_by_name` string
    - `created_at` string, date-time, required
  - `order_round` integer: Раунд платёжки: 0 — первая, «Оплатить остаток» заводит следующую со своим номером
  - `closed_short_reason` string: Почему заявку закрыли без остатка
  - `created_by` integer
  - `created_by_name` string
  - `created_at` string, date-time, required
  - `updated_by` integer
  - `updated_by_name` string
  - `updated_at` string, date-time, required
  - `sent_by` integer
  - `sent_by_name` string
  - `sent_at` string: Когда заявка отправлена в банк
  - `responsible_id` integer: Кому передана открытая заявка; нет — автор
  - `responsible_name` string
  - `version` integer, required: Версия строки для expected_version
  - `queued` boolean, required: Заявка стоит в очереди оплат
  - `awaiting_schedule` boolean, required: Согласованная заявка ждёт даты платежа у казначея
  - `can_send` boolean, required: Можно ли отправить в банк
  - `send_block_reason` string: Почему отправить нельзя
  - `approval` FinancePaymentRequestApproval: Чем и кем согласована заявка модуля docflow.
    - `module` string, required: Модуль, где согласована заявка
    - `document_id` string, uuid
    - `version` integer: Версия документа на момент согласования
    - `approved_at` string, date-time, required: Когда согласована
    - `approved_by` integer: Кто согласовал
    - `approved_by_name` string: Имя согласовавшего
    - `auto` boolean, required: Согласована автоматически, без прохода по маршруту
  - `vat_rate` '' | 'none' | '0' | '5' | '7' | '10' | '20' | '22': Ставка НДС заявки «Документов»: пусто — не указана, none — без НДС, иначе процент
  - `vat_amount` string: НДС в составе суммы заявки; у «без НДС» нет
  - `department_id` string, uuid
  - `department_name` string
  - `project_id` string, uuid
  - `project_name` string
  - `contract_title` string: Договор основания словами (source.contract_id), снимком на момент приёма заявки

## Other responses

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

## Changes

- **2026-10-20** `765c65fadf8f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/finance/payment-requests/:id/fact/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/7a6b75f272ee?raw)