Docflow approvals

Принять решение согласующего

Решений три, и «отказать» с «вернуть на доработку» — РАЗНЫЕ действия: reject заканчивает маршрут, return отдаёт предмет автору и ждёт его правки, оставляя проход открытым. Обоим обязателен комментарий: без слов автор не узнает, что исправлять, и вернётся с той же бумагой. Approve комментария не требует.

Поле reviewer_id называет, ЧЬЯ виза закрывается, и это не обязательно тот, кто нажимает: замещающий закрывает визу отсутствующего, оставаясь собой в истории. Право ответить за чужую визу ищется в одном порядке — замещающий, прямой согласующий, администратор согласований. Автор прохода approve не ставит ни за кого — 409 docflow.approval.self_review (ERP-1188); вернуть или отклонить свою бумагу он может.

Режим этапа — «все» или «достаточно одного». Кворума с процентом нет намеренно: «две трети склада» никто не считает, а объяснить отказ таким правилом невозможно.

Операция стоит под ОТДЕЛЬНЫМ правом docflow.flow:approve: «согласовать» и «редактировать» в живой компании дают разным людям, и права на правку предмета для решения недостаточно, как и наоборот.

post/api/v1/docflow/approvals/{id}/decisions

Request

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

approval_idstring uuid
reviewer_idinteger

ЧЬЯ виза закрывается. Не обязательно тот, кто нажимает: замещающий закрывает визу отсутствующего, оставаясь собой в истории

decision'approve' | 'return' | 'reject' required
commentstring

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.