Docflow payment requests

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

Changed on

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

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)

Path parameters

idstring uuid required

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

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Request body

versioninteger required

Версия заявки, которую видел человек

reasonstring

Что поправить; читает автор заявки

Response

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

idstring uuid required
numberstring 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_idstring uuid required
company_namestring required
contact_idstring uuid
contact_namestring required
item_idstring uuid
item_namestring required
amountstring required
currencystring required
due_datestring date required
purposestring required
justificationstring required

Обоснование автора для согласующего

priority'high' | 'normal' | 'low' required

Приоритет оплаты

payment_method'bank' | 'cash' required

Форма оплаты

department_idstring uuid
department_namestring
project_idstring uuid
project_namestring
vat_rate'' | 'none' | '0' | '5' | '7' | '10' | '20' | '22'

Ставка НДС: пусто — не указана, none — без НДС

vat_amountstring

Сумма НДС

reason_code'late' | 'no_documents' | 'no_funds' | 'duplicate' | 'other'

Типовая причина отклонения казначеем: подана вне срока, нет документов, нет денег на дату, дубль, другое

can_copyboolean

Можно ли завести новую заявку по образцу этой

payee_account_idstring uuid
can_reworkboolean

Можно ли вернуть заявку на доработку: она согласована, платёжка ещё не в банке, а человек — автор или согласующий

can_refresh_payeeboolean

Можно ли обновить получателя из контрагента: автор, заявка с контрагентом — черновик, на доработке или согласованная до банка

schedule_idstring uuid
schedule_periodstring

Период регулярной заявки, за который заведена заявка

schedule_namestring

Название регулярной заявки

can_recallboolean

Можно ли вернуть заявку в черновик: автор, заявка на согласовании и ещё не согласована

can_repeatboolean

Можно ли повторить отклонённую или отозванную заявку новым черновиком

destination'' | 'calendar' | 'treasury' required

Куда ушла согласованная заявка: снимок флага маршрута

reasonstring

Причина отказа, возврата на доработку или отклонения казначеем

finance_request_idstring uuid
approval_autoboolean required

Согласована автоматически: маршрута для заявки нет и согласование не обязательно, прохода согласования не было

rejected_by_financeboolean required

Согласованную заявку отклонил казначей в модуле finance; причина — в reason

created_byinteger
created_by_namestring required
created_atstring date-time required
updated_atstring date-time required
versioninteger required
can_editboolean required
can_submitboolean required
can_cancelboolean required

Changes

  • 765c65fadf8fRevision changes
    • warning

      added the new partially_paid enum value to the response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 408f7294f7a9Revision changes
    • info

      endpoint added