---
title: "Получить очередь согласований"
method: GET
path: "/api/v1/docflow/approvals"
tags: ["Docflow approvals"]
---

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

`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`)

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

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

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

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

## Query parameters

- `mine` 'true' | 'false'
- `state` 'pending' | 'approved' | 'rejected' | 'returned' | 'cancelled'
- `module` 'docflow' | 'finance' | 'stock'
- `kind` 'flow_document' | 'payment_request' | 'edo_message' | 'stock_purchase_request'
- `search` string
- `overdue` 'true' | 'false'
- `limit` integer
- `offset` integer

## Headers

- `X-Tenant` string, required

## Response `200`

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

- DocflowApprovalInboxPage
  - `items` DocflowApprovalInboxItem[], required
    - `approval_id` string, uuid, required
    - `subject` DocflowApprovalSubject, required: Предмет согласования нейтральной тройкой «модуль — вид — идентификатор». Факты предоставляет модуль-владелец: карточка, заявка на оплату, пакет ЭДО или складская заявка на закупку. Складскую заявку отправляют проведением через API склада; общие команды отправки, повтора и отзыва согласования для неё закрыты.
      - `module` 'docflow' | 'finance' | 'stock', required: Модуль-владелец предмета
      - `kind` 'flow_document' | 'payment_request' | 'edo_message' | 'stock_purchase_request', required: Вид предмета: карточка документооборота, заявка на оплату, входящий документ ЭДО или складская заявка на закупку
      - `id` string, uuid, required
    - `subject_title` string, required
    - `subject_number` string
    - `route_name` string
    - `stage_title` string
    - `stage_position` integer, required
    - `stage_count` integer, required: Сколько этапов в маршруте всего
    - `stage_mode` 'all' | 'any', required
    - `amount` string
    - `currency` string
    - `company_name` string
    - `contact_name` string
    - `requested_name` string
    - `requested_at` string, date-time, required
    - `due_at` string, date-time
    - `overdue` boolean, required
    - `on_behalf_of` string: Чью визу вы ставите, если это не ваша собственная
    - `on_behalf_via` 'self' | 'substitute' | 'delegate' | 'administrator'
    - `returned_to_me` boolean, required: Истинно у собственной отправки, которую вернули на доработку
    - `informational` boolean: Строка этапа «ознакомиться»: решения не ждут, нужна отметка POST /approvals/{id}/acknowledge
  - `has_more` boolean, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

[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/3c60ded179f2?raw)