Docflow approvals

Отправить предмет на согласование

Маршрут не перечисляют в запросе — его ПОДБИРАЮТ. Тело называет только предмет тройкой «модуль — вид — идентификатор», а факты о нём (сумму, контрагента, статью расхода, автора) согласование спрашивает у модуля-владельца его портом: читать чужую таблицу ради этих полей нельзя, да и незачем.

Подошло несколько шаблонов — берётся САМЫЙ КОНКРЕТНЫЙ: маршрут, названный на юрлицо и вид документа, выигрывает у маршрута на весь модуль. Нижняя граница суммы маршрута включается, верхняя нет, поэтому смежные диапазоны стыкуются без щели и без нахлёста.

Маршрута под предмет не нашлось, а вид объявлен требующим согласования — отказ docflow.approval.route_not_found. Это НЕДОНАСТРОЙКА кабинета, и назвать её надо именно так: «согласуйте сами» здесь неверный совет. Если у подобранного маршрута все этапы согласования отсечены лимитом по сумме, проход согласуется в момент отправки (state approved) со строкой журнала auto_approved: маршрут сам сказал, что бумагу такой суммы визировать не нужно (ERP-1566).

post/api/v1/docflow/approvals

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/docflow/approvals
  • 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)

Headers

X-Tenantstring required

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

Request body

module'docflow' | 'finance' | 'stock' required

Модуль-владелец предмета

kind'flow_document' | 'payment_request' | 'edo_message' | 'stock_purchase_request' required

Вид предмета: карточка документооборота, заявка на оплату, входящий документ ЭДО или складская заявка на закупку

idstring uuid required

Response

Заведённый проход согласования

idstring uuid required
subject_titlestring
subject_numberstring
company_idstring uuid
contact_idstring uuid
item_idstring uuid
route_idstring uuid
route_namestring
rework_mode'restart' | 'returner_only' required
amountstring

Пусто законно: у рамочного договора суммы нет

currencystring
content_versioninteger required

Редакция предмета, по которой решают

content_fingerprintstring

SHA-256 значимого состава складской заявки, по которому получено согласие; закупка проверяет совпадение с текущим составом

state'pending' | 'approved' | 'rejected' | 'returned' | 'cancelled' required
active_stageinteger required

Номер текущего этапа

requested_byinteger required
requested_namestring
requested_atstring date-time required
finished_atstring date-time
reminded_atstring date-time
escalated_atstring date-time
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.