---
title: "Завести заявку на оплату"
method: POST
path: "/api/v1/docflow/payment-requests"
tags: ["Docflow payment requests"]
---

# Завести заявку на оплату

`POST /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 / edo_message), карточка документооборота (docflow / flow_document) или основание словами (docflow / manual). Отказ проверки называет поле (422, code docflow.payment_request.field, поле field): юрлицо, получатель, БИК, сумма, валюта, срок, назначение. По одной бумаге (счёт, закупка, договор с суммой, долг) заявок может быть несколько, пока заявки на согласовании, на доработке и согласованные вместе не больше суммы бумаги; сумма, которая в остаток заведомо не поместится, — 422 docflow.payment_request.over_claim с полем amount и суммами total, claimed, remaining, currency. Заявка на ту же сумму по той же бумаге — не отказ: карточка заявки называет её в possible_duplicates. Счёт, принесённый файлом, передаётся полем invoice_card: карточка входящего счёта и заявка на ней заводятся одной транзакцией (нужно право docflow.flow:write), отказ заявки откатывает карточку; файл кладут в карточку следом сессией загрузки.

## Headers

- `X-Tenant` string, required

## Request body

- DocflowPaymentRequestInput
  - `company_id` string, uuid, required
  - `contact_id` string, uuid
  - `item_id` string, uuid
  - `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
  - `due_date` string, date, required
  - `purpose` string, required
  - `priority` 'high' | 'normal' | 'low': Приоритет оплаты, как в заявке на расходование денежных средств 1С:ERP
  - `payment_method` 'bank' | 'cash': Форма оплаты: безналичная или наличные (без банковских реквизитов, платит касса)
  - `justification` string: Обоснование — какую задачу решает платёж и почему сейчас; читает согласующий. Черновик сохраняется без него, отправка на согласование — нет
  - `department_id` string, uuid
  - `project_id` string, uuid
  - `vat_rate` '' | 'none' | '0' | '5' | '7' | '10' | '20' | '22': Ставка НДС: пусто — не указана, none — без НДС, иначе процент
  - `vat_amount` string: Сумма НДС в составе суммы заявки; у ставки none не хранится
  - `payee_account_id` string, uuid
  - `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: Тип платежа
  - `basis` DocflowPaymentRequestBasis
    - `module` 'docflow' | 'core': Модуль основания
    - `kind` 'edo_message' | 'flow_document' | 'manual' | 'order' | 'document': Вид основания: входящий документ ЭДО, карточка документооборота или основание словами
    - `id` string, uuid
    - `title` string
    - `contract_id` string, uuid
  - `invoice_card` DocflowPaymentRequestInvoiceCard: Счёт, принесённый файлом: карточка входящего счёта, которая заводится вместе с заявкой одной транзакцией и становится её основанием (basis docflow / flow_document). Юрлицо и контрагент — заявки, контрагент обязателен (иначе 422 с полем contact_id). Нужно право docflow.flow:write; отказ правила карточки — её отказом. Только при заведении заявки, правка поле не принимает
    - `kind` 'invoice' | 'other': Вид карточки: счёт или «Прочее» (платёжка 1С)
    - `content` DocflowFlowContent, required: Реквизиты бумаги — то, что переписано с документа.
      - `title` string, required
      - `number` string
      - `date` string, date, required
      - `contract` DocflowFlowContractTerms: Условия договора в старой форме. Остаётся читаемой и принимается, но новую коммерческую часть описывает commercial. У договора без лимита (mode=framework) суммы и валюты в условиях нет вовсе — искусственного нуля здесь не бывает. Коммерческая часть рядом с ним законна только с payment_rule, у которого названа сумма платежа: это бессрочный договор с регулярным платежом. Без неё это рамочный договор, суммы которого ведутся спецификациями, и commercial с ним не сохраняется.
        - `mode` 'framework' | 'fixed', required
        - `subject` string, required
        - `valid_from` string, date, required
        - `valid_until` string, date
        - `amount` string: Только у mode=fixed
        - `currency` string
        - `payment_terms` string
        - `renewal_terms` string
        - `order_funnel_id` string, uuid: Воронка продаж или закупок договора: продажи или закупки по договору идут в неё (пометка кабинета, не текст бумаги)
        - `responsibles` DocflowFlowResponsible[]: Ответственные по договору с долями: продажи и закупки периодов получают их по умолчанию; сумма долей — ровно 100
          - `employee_id` string, uuid, required
          - `share` string, required: Доля в процентах десятичным текстом
        - `renewal` DocflowFlowContractRenewal: Пролонгация договора данными (ERP-2672). Поля нет — «не указано»; renewal_terms остаётся примечанием словами. По ней фоновый проход напоминает автору и ответственным в день «решите до» (valid_until минус notice_days, иначе 30 дней) и в последний день срока.
          - `auto` boolean, required: true — продлевается сам, если никто не заявил о расторжении; false — пролонгации нет
          - `period_months` integer: На сколько месяцев продлевается; обязателен при auto=true (иначе 400 с полем content.contract.renewal.period_months). Автопролонгация без valid_until — 400 с полем content.contract.valid_until
          - `notice_days` integer: За сколько дней до конца срока уведомить о расторжении; 0 или нет — напоминание за 30 дней
        - `renewal_marks` DocflowFlowContractRenewalMarks: Отметки решения по сроку договора. Пишут только команды renew и decline_renewal; save формы их переносит.
          - `declined_for` string, date: «Не продлевать» к этому последнему дню срока; совпадает с valid_until — напоминаний нет
          - `declined_by` integer: Кто отметил «Не продлевать»
          - `declined_at` string, date-time
          - `renewed_from` string, date: Прежний последний день срока до последней команды renew
      - `commercial` DocflowFlowCommercial: Коммерческая часть бумаги — сумма, валюта, строки и графики. Пустая amount законна только вместе с payment_rule, у которого названа сумма платежа: у бессрочного договора итога нет и быть не может, а строк оригинала и этапов работ у такой сделки не бывает — их суммы обязаны сойтись с итогом.
        - `currency` string, required
        - `amount` string, required: Десятичным текстом; пусто — итога нет или его выводит правило графика
        - `payment_terms` string
        - `due_date` string, date
        - `lines` DocflowFlowCommercialLine[]
          - `id` string, uuid, required
          - `product_id` string, uuid
          - `product_name` string
          - `name` string, required
          - `unit` string
          - `quantity` string
          - `price` string
          - `amount` string, required
          - `vat_amount` string, nullable: null означает, что налог не переписывали, а не что строка без налога
          - `vat_rate` string: Ставка строки в записи документа: «22%», «22/122», «без НДС». Пусто — по учётной политике юрлица на дату документа
          - `article` string: Ручной артикул товара для покупателя (ДопСведТов@АртикулТов). Пусто — по настройке покупателя
          - `code` string: Ручной код товара для покупателя (ДопСведТов@КодТов). Пусто — по настройке покупателя
        - `milestones` DocflowFlowScheduleStage[]: Этапы работ
          - `id` string, uuid, required
          - `label` string
          - `date` string, date
          - `amount` string, required: Десятичным текстом, не числом с плавающей точкой
          - `due_trigger` string: Чем открывается срок платежа: датой или закрытием этапа
          - `after_stage_id` string, uuid
          - `delay_days` integer: Дней после события срока
        - `payments` DocflowFlowScheduleStage[]: График платежей; при payment_rule — его раскрытие
          - `id` string, uuid, required
          - `label` string
          - `date` string, date
          - `amount` string, required: Десятичным текстом, не числом с плавающей точкой
          - `due_trigger` string: Чем открывается срок платежа: датой или закрытием этапа
          - `after_stage_id` string, uuid
          - `delay_days` integer: Дней после события срока
        - `payment_rule` DocflowFlowPaymentRule: Регулярный график оплат одним правилом: сумма платежа, период, день, начало и ровно одно из трёх окончаний — число платежей, последняя дата или open («пока действует договор»). Сервер раскрывает правило в строки payments сам; план финансов и расчёты видят только строки, как при ручном графике. При названной сумме платежа сумма документа (commercial.amount) может быть пустой: с count или until она вычисляется как N × платёж, с open её нет вовсе. Бессрочное правило раскрывается на горизонт в 12 ближайших платежей — это план, а не весь договор.
          - `amount` string: Сумма одного платежа десятичным текстом; пусто — сумма документа делится поровну. Обязательна, когда суммы документа нет
          - `period` 'month' | 'week' | 'quarter', required
          - `day` integer, required: День месяца (month, quarter; короткий месяц прижимает к своему концу) или день недели ISO 1..7 (week). При заданном day_kind сервер записывает 31, и день задаёт day_kind
          - `day_kind` 'last' | 'last_workday': Какой день месяца платёжный, только для month и quarter: last — последний день месяца, last_workday — последний рабочий день месяца по производственному календарю РФ (праздники ст. 112 ТК РФ и переносы выходных). Пусто — число из day. Для week — отказ 422
          - `advance` boolean: Оплата вперёд — за следующий период: даты платежей не меняются, а период, за который платёж, на шаг правила позже (платёж 30.10 — за ноябрь). От этого периода считаются период, название и строки условий продажи или закупки периода и конец периода для бумаг; первый период (orders.from) и срок договора сравниваются с ним же. С shares не сочетается: отказ 422 docflow.flow.payment_advance_shares
          - `start` string, date, required: Первый платёж — ближайшая дата не раньше этой
          - `count` integer: Число платежей; задаётся вместо until
          - `until` string, date: Последняя допустимая дата включительно; задаётся вместо count
          - `open` boolean: Пока действует договор: окончания нет, итога нет, раскрываются ближайшие 12 платежей
          - `orders` DocflowFlowPaymentRuleOrders: «Заводить продажу или закупку на каждый период» — только у договора (kind=contract). Зарегистрированный договор сам заводит на каждую наступившую стадию правила подтверждённый продажу или закупку ядра (source_kind=contract, external_id «<id договора>/<период>»): сразу после регистрации и фоновым проходом раз в час. Один договор и один период — один продажа или закупка навсегда: отменённый не воскресает, период не позже последнего продажи или закупки договора не заводится. Будущие периоды не заводятся; исполнение и бумаги периода — вручную.
            - `from` string, date: Первый период: стадии раньше этой даты продаж или закупок не получают. Пусто — с начала правила, прошедшие периоды догоняются
            - `product_id` string, uuid
            - `product_name` string: Название услуги на момент выбора; пишет сервер, присланное не читается
            - `papers` DocflowFlowPeriodPapers: Счёт и закрывающая бумага каждого периода регулярного договора продажи, которые договор выпускает сам. Без поля бумаги выпускают вручную
              - …
            - `project_id` string, uuid
            - `department_id` string, uuid
            - `cfo_id` string, uuid
          - `shares` DocflowFlowPaymentShare[]: Оплата периода долями: проценты вместе ровно 100. Продажа или закупка периода получает график оплат из долей. Пусто — один платёж периода в дату правила
            - `percent` string, required: Доля суммы периода в процентах десятичным текстом, до двух знаков
            - `day` integer: День периода: число месяца стадии (month, quarter) или день недели ISO 1..7 (week)
            - `after_act_days` integer: Срок через столько дней после акта периода
      - `correction` DocflowFlowCorrection: Содержание УКД по возврату покупателя: строки исходного УПД «до» и остаток «после». Снимается при выпуске и дальше не пересчитывается.
        - `return_id` string, uuid, required
        - `return_number` string
        - `return_date` string, date
        - `basis_id` string, uuid, required
        - `basis_number` string, required
        - `basis_date` string, date, required
        - `lines` DocflowFlowCorrectionLine[], required
          - `id` string, uuid, required
          - `number` integer, required: Номер строки в исходном УПД
          - `product_id` string, uuid
          - `name` string, required
          - `unit` string
          - `unit_code` string: Код единицы по ОКЕИ
          - `vat_rate` string, required
          - `article` string: Ручной артикул строки, перенесённый из строки УПД; пусто — по настройке покупателя
          - `code` string: Ручной код строки, перенесённый из строки УПД
          - `before` DocflowFlowCorrectionState, required
            - `quantity` string, required
            - `price` string: Цена за единицу без налога
            - `amount_without_vat` string, required
            - `vat_amount` string: Пусто у необлагаемой строки
            - `amount_with_vat` string, required
          - `after` DocflowFlowCorrectionState, required
            - `quantity` string, required
            - `price` string: Цена за единицу без налога
            - `amount_without_vat` string, required
            - `vat_amount` string: Пусто у необлагаемой строки
            - `amount_with_vat` string, required
      - `transfer` DocflowFlowAgentTransfer: Передача товара агенту или комиссионеру и возврат от него (ERP-2178): УПД с функцией ДОП и особым обстоятельством СпОбстФДОП. Только у вида upd. Карточку из черновика площадки («Упд по акту приемки» Wildberries) заводит сервер, строки и коды в ней — слово площадки.
        - `case` '00005' | '00006', required: 00005 — передача агенту или комиссионеру, 00006 — возврат от него
        - `platform` string: Площадка, составившая черновик (wildberries); пусто у бумаги, набранной у нас
        - `source_id` string, uuid
        - `source_title` string: Как документ назван у площадки
        - `operation` string: Содержание операции словами черновика
        - `basis` DocflowFlowAgentTransferRef[]
          - `name` string, required
          - `number` string
          - `date` string, date
        - `lines` DocflowFlowAgentTransferLine[]
          - `line_id` string, uuid, required
          - `gtin` string
          - `marks` object[], required
            - `transport_package` string: Код транспортной упаковки (SSCC монопаллеты)
            - `count` string: Количество единиц при передаче по GTIN
            - `codes` string[]
            - `packages` string[]
      - `amendment_purpose` 'terms' | 'deal': Назначение допсоглашения (ERP-2063), только у вида amendment: terms — меняет условия договора (цену, срок, абонентскую плату), deal — оформляет отдельную покупку или продажу по договору и ведёт себя как спецификация: может быть основанием сделки, его условия услуг в договор не идут. Не прислано у ДС — terms; у другого вида — отказ
      - `specification_purpose` 'terms' | 'deal': Назначение спецификации (ERP-2083), только у вида specification: terms — условия или прайс на срок договора (строки условий идут в сделки периодов, своей сделки нет), deal — партия, основание своей сделки. Не прислано — по содержанию: есть строки условий — terms, иначе deal; у другого вида — отказ
      - `invoice` DocflowFlowInvoiceTerms: Условия карточки счёта: чем счёт связан с договором и заказом, по какой день он ещё обещает деньги платёжному календарю и на какой расчётный счёт контрагента просят платить.
        - `contract_stage_id` string, uuid
        - `order_payment_term_id` string, uuid
        - `basis_contract_id` string, uuid
        - `basis_deal_id` string, uuid
        - `expected_until` string, date: По какой день включительно счёт ещё ждут в платёжном календаре; пусто — от срока оплаты умолчанием кабинета
        - `expectation_off` boolean: Счёт снят с ожидания рукой: карточка жива, но строки в платёжном календаре нет
        - `distinct_from` UUID[]: Карточки счетов, которые человек проверил и назвал «это другой счёт»: проверка дублей их больше не подсвечивает. Пишется действием invoice_distinct
        - `payee_account_id` string, uuid
      - `recognized` DocflowFlowRecognized: Прочитанное машиной из файла карточки — НА ПРОВЕРКУ. Живёт отдельно от условий договора: в условия сумма и срок попадают только рукой человека. Пустое поле означает «не прочиталось», а не ноль. Приёмка входящего договора в PDF заполняет его текстом бумаги.
        - `source` string: Имя вложения словами оператора: по нему человек откроет ту же бумагу и сверит
        - `amount` string: Десятичная строка
        - `currency` string
        - `valid_from` string, date
        - `valid_until` string, date
        - `payee` DocflowFlowRecognizedPayee: Получатель и его счёт, как они написаны в счёте поставщика. Платят не по ним, а по счёту контрагента из карточки: прочитанное хранится, чтобы показать расхождение.
          - `name` string: Наименование получателя из бумаги
          - `inn` string: ИНН получателя из бумаги
          - `kpp` string: КПП получателя из бумаги
          - `account` string: Расчётный счёт из бумаги
          - `bic` string: БИК банка из бумаги
          - `bank_name` string: Банк получателя из бумаги
          - `corr_account` string: Корреспондентский счёт банка получателя из бумаги; у казначейского счёта — единый казначейский счёт
        - `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: Тип платежа
      - `custom` object: Значения своих полей кабинета (графы вида docflow.document.<вид>). В save не прислано — не меняются; правятся действием custom

## Response `201`

Черновик заявки

- 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, 19 info
  - added the new `partially_paid` enum value to the `progress` response property for the response status `201`
  - added the new optional request property `invoice_card`
  - added the new optional request property `payment_order`
  - added the new optional request property `project_id`
  - …16 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/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)