---
title: "Получить заявки на оплату"
method: GET
path: "/api/v1/docflow/payment-requests"
tags: ["Docflow payment requests"]
---

# Получить заявки на оплату

`GET /api/v1/docflow/payment-requests`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/docflow/payment-requests`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Заявка на оплату — документ модуля docflow (документы): её заводят и согласуют здесь, а в модуль finance (счета, выписки и расчёты) приходит только согласованная. Автор с правом docflow.flow:request видит свои заявки; scope=all отдаёт все заявки кабинета тем, у кого есть docflow.flow:read или docflow.flow:approve. Строка несёт ход оплаты (progress) и, когда платёж прошёл, реквизиты платёжного поручения — доступа к финансам для этого не нужно.

## Query parameters

- `scope` 'mine' | 'all'
- `status` 'draft' | 'on_approval' | 'rework' | 'approved' | 'rejected' | 'cancelled': Состояние документа заявки: черновик, на согласовании, на доработке, согласована, отклонена, отозвана
- `contact_id` string, uuid

## Headers

- `X-Tenant` string, required

## Response `200`

Заявки на оплату

- DocflowPaymentRequestList
  - `results` DocflowPaymentRequest[], required
    - `id` string, uuid, required
    - `number` string, required
    - `status` 'draft' | 'on_approval' | 'rework' | 'approved' | 'rejected' | 'cancelled', required: Состояние документа заявки: черновик, на согласовании, на доработке, согласована, отклонена, отозвана
    - `progress` 'draft' | 'on_approval' | 'rework' | 'approved' | 'rejected' | 'cancelled' | 'scheduled' | 'sent' | 'exported' | 'partially_paid' | 'paid' | 'payment_cancelled', required: Ход заявки глазами автора: состояние документа, после согласования — состояние оплаты; exported — платёжка выгружена файлом для интернет-банка (то же слово, что у казначея)
    - `company_id` string, uuid, required
    - `company_name` string, required
    - `contact_id` string, uuid
    - `contact_name` string, required
    - `item_id` string, uuid
    - `item_name` string, required
    - `payee` DocflowPaymentRequestPayee, 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, date, required
    - `purpose` string, required
    - `justification` string, required: Обоснование автора для согласующего
    - `priority` 'high' | 'normal' | 'low', required: Приоритет оплаты
    - `payment_method` 'bank' | 'cash', required: Форма оплаты
    - `department_id` string, uuid
    - `department_name` string
    - `project_id` string, uuid
    - `project_name` string
    - `vat_rate` '' | 'none' | '0' | '5' | '7' | '10' | '20' | '22': Ставка НДС: пусто — не указана, none — без НДС
    - `vat_amount` string: Сумма НДС
    - `reason_code` 'late' | 'no_documents' | 'no_funds' | 'duplicate' | 'other': Типовая причина отклонения казначеем: подана вне срока, нет документов, нет денег на дату, дубль, другое
    - `can_copy` boolean: Можно ли завести новую заявку по образцу этой
    - `payee_account_id` string, uuid
    - `can_rework` boolean: Можно ли вернуть заявку на доработку: она согласована, платёжка ещё не в банке, а человек — автор или согласующий
    - `can_refresh_payee` boolean: Можно ли обновить получателя из контрагента: автор, заявка с контрагентом — черновик, на доработке или согласованная до банка
    - `payment_order` FinancePaymentOrderFields: Реквизиты платёжного поручения сверх получателя — налоговые и бюджетные поля.
      - `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: Тип платежа
    - `schedule_id` string, uuid
    - `schedule_period` string: Период регулярной заявки, за который заведена заявка
    - `schedule_name` string: Название регулярной заявки
    - `can_recall` boolean: Можно ли вернуть заявку в черновик: автор, заявка на согласовании и ещё не согласована
    - `can_repeat` boolean: Можно ли повторить отклонённую или отозванную заявку новым черновиком
    - `basis_balance` DocflowPaymentBasisBalance: Остаток бумаги-основания к заявке: заявлено · оплачено · осталось
      - `module` string, required
      - `kind` string, required
      - `id` string, uuid, required
      - `paper_kind` 'invoice' | 'order' | 'contract' | 'debt' | 'paper', required: Вид бумаги: счёт, закупка, договор, долг или иная бумага
      - `currency` string, required
      - `limited` boolean, required: У бумаги есть сумма-предел; нет — total и remaining пусты
      - `total` string: Сумма бумаги: итог счёта или закупки, сумма договора, остаток долга
      - `claimed` string, required: Держат заявки на согласовании, на доработке и согласованные
      - `paid` string, required: Из заявленного оплачено
      - `remaining` string: Сколько ещё можно заявить
      - `requests` DocflowPaymentRequestBrief[], required: Заявки по бумаге, видимые спросившему, кроме отозванных
        - `id` string, uuid, required
        - `number` string, required
        - `amount` string, required
        - `currency` string, required
        - `due_date` string, date, required
        - `status` 'draft' | 'on_approval' | 'rework' | 'approved' | 'rejected' | 'cancelled', required: Состояние документа заявки: черновик, на согласовании, на доработке, согласована, отклонена, отозвана
        - `progress` string, required
    - `possible_duplicates` DocflowPaymentRequestBrief[]: Живые заявки той же бумаги на ту же сумму — предупреждение о возможном дубле; только в карточке заявки
      - `id` string, uuid, required
      - `number` string, required
      - `amount` string, required
      - `currency` string, required
      - `due_date` string, date, required
      - `status` 'draft' | 'on_approval' | 'rework' | 'approved' | 'rejected' | 'cancelled', required: Состояние документа заявки: черновик, на согласовании, на доработке, согласована, отклонена, отозвана
      - `progress` string, required
    - `basis` DocflowPaymentRequestBasis, required
      - `module` 'docflow' | 'core': Модуль основания
      - `kind` 'edo_message' | 'flow_document' | 'manual' | 'order' | 'document': Вид основания: входящий документ ЭДО, карточка документооборота или основание словами
      - `id` string, uuid
      - `title` string
      - `contract_id` string, uuid
    - `destination` '' | 'calendar' | 'treasury', required: Куда ушла согласованная заявка: снимок флага маршрута
    - `reason` string: Причина отказа, возврата на доработку или отклонения казначеем
    - `payment` DocflowPaymentRequestPayment: Что стало с оплатой у модуля finance (строка очереди оплат)
      - `request_id` string, uuid, required
      - `status` string, required: Состояние строки очереди: planned, sent, awaiting_signature, partially_paid, executed, rejected, cancelled, returned
      - `planned_on` string, date: Дата оплаты; пусто, пока заявка ждёт даты у казначея
      - `awaiting_schedule` boolean, required
      - `sent_at` string, date-time
      - `executed_on` string, date
      - `payment_order` DocflowPaymentRequestOrder: Платёжное поручение, которым заявка оплачена, — реквизиты проведённого документа денежной операции
        - `document_id` string, uuid, required
        - `number` string, required
        - `date` string, date, required
        - `amount` string, required
        - `currency` string, required
      - `bank_rejection` string: Банк отклонил платёжку, строка вернулась в очередь казначея: текст банка, без текста — его слово. Заявка остаётся согласованной
      - `amount` string: Сумма заявки
      - `paid_amount` string: Сколько оплачено привязанными платежами
      - `remainder` string: Сколько осталось оплатить
      - `currency` string
      - `payments` DocflowPaymentRequestOrder[]: Все платежи, которыми заявка оплачена
        - `document_id` string, uuid, required
        - `number` string, required
        - `date` string, date, required
        - `amount` string, required
        - `currency` string, required
      - `closed_short_reason` string: Финансы закрыли заявку без остатка — почему
      - `exported_to_file` boolean: Платёжка выгружена файлом для банк-клиента, по API в банк не уходила; ход заявки — exported
    - `finance_request_id` string, uuid
    - `approval_auto` boolean, required: Согласована автоматически: маршрута для заявки нет и согласование не обязательно, прохода согласования не было
    - `rejected_by_finance` boolean, required: Согласованную заявку отклонил казначей в модуле finance; причина — в reason
    - `created_by` integer
    - `created_by_name` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `version` integer, required
    - `can_edit` boolean, required
    - `can_submit` boolean, required
    - `can_cancel` boolean, required

## Other responses

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

## Changes

- **2026-10-20** `765c65fadf8f`: 1 warning, 17 info
  - added the new `partially_paid` enum value to the `results/items/progress` response property for the response status `200`
  - added the new optional `query` request parameter `contact_id`
  - added the optional property `results/items/basis_balance` to the response with the `200` status
  - added the optional property `results/items/can_recall` to the response with the `200` status
  - …14 more
- **2026-10-20** `408f7294f7a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/docflow/payment-requests/get.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)