---
title: "Вернуть согласованную заявку на оплату на доработку"
method: POST
path: "/api/v1/docflow/payment-requests/{id}/rework"
tags: ["Docflow payment requests"]
---

# Вернуть согласованную заявку на оплату на доработку

`POST /api/v1/docflow/payment-requests/{id}/rework`

## Request

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

Согласованная заявка, платёжка по которой ещё не ушла в банк, возвращается на доработку: строка очереди оплат модуля finance снимается, заявка переходит в состояние rework, её правят и отправляют на согласование заново — маршрут подбирается снова. Вернуть может автор заявки и тот, кто согласует заявки (иначе 403); причина необязательна, её читает автор. Признак can_rework в карточке заявки говорит, доступно ли действие. Заявка не в состоянии approved — 409 docflow.payment_request.state; версия устарела — 409 docflow.payment_request.conflict; платёжка уже в банке — 409 docflow.payment_request.in_bank: её сначала удаляют в интернет-банке, а финансы возвращают заявку в план.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- DocflowPaymentRequestReworkInput
  - `version` integer, required: Версия заявки, которую видел человек
  - `reason` string: Что поправить; читает автор заявки

## Response `200`

Заявка на доработке

- DocflowPaymentRequest
  - `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`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Запрос разобран, но бизнес-значение недопустимо
- `503`: Внешний банк, справочник или контур подключений временно недоступен

## Changes

- **2026-10-20** `765c65fadf8f`: 1 warning, 16 info
  - added the new `partially_paid` enum value to the `progress` response property for the response status `200`
  - added the optional property `basis_balance` to the response with the `200` status
  - added the optional property `can_recall` to the response with the `200` status
  - added the optional property `can_repeat` to the response with the `200` status
  - …13 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/:id/rework/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)