Docflow approvals

Получить очередь согласований

Одна строка на проход: предмет, маршрут, номер активного этапа из их общего числа, сумма, кто просит, когда попросил и срок. Ни файлов, ни состава предмета, ни учётных связей здесь нет ВОВСЕ — очередь открывают, чтобы решить, что открывать дальше, и полный предмет каждого пункта был бы трафиком за содержимое, которое человек, скорее всего, не раскроет.

Умолчание mine=true — ЛИЧНАЯ очередь: раздел заведён ради вопроса «что ждёт меня», а не ради обзора кабинета. Значение false показывает всё видимое человеку, включая его собственные отправленные. Чужую очередь спросить нечем: действующее лицо сервер берёт из сессии, и параметра с идентификатором человека у операции нет.

Предмет назван нейтральной тройкой «модуль — вид — идентификатор», и внешнего ключа на него нет вовсе, поэтому одна очередь держит и карточки документооборота, и заявки на оплату модуля finance (счета, выписки и расчёты); отбор module сужает её до одного модуля.

Строка помечена on_behalf_of, когда закрывается не ваша собственная виза: замещение или поручение. Сумма пуста законно — у рамочного договора её нет, и ноль вместо неё назвал бы сумму, которой не называли.

get/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)

Query parameters

mine'true' | 'false'

true — только ждущее решения текущего человека; false — всё видимое ему

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

Состояние прохода

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

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

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

Вид предмета согласования

searchstring

Поиск подстрокой по заголовку и номеру предмета

overdue'true' | 'false'

true — только просроченные этапы

limitinteger
offsetinteger

Headers

X-Tenantstring required

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

Response

Страница очереди согласований

has_moreboolean required

Changes

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