---
title: "Получить справочники конструктора маршрутов"
method: GET
path: "/api/v1/docflow/approval-settings"
tags: ["Docflow approvals"]
---

# Получить справочники конструктора маршрутов

`GET /api/v1/docflow/approval-settings`

## Request

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

Подразделения, роли, люди и обязательность согласования по видам предметов — ОДНИМ ответом. Три отдельных запроса ради одной формы означают три повода ей мигнуть на медленной связи и три места, где список окажется из разных моментов времени.

Подразделения и роли приходят из справочников кабинета такими, как их видит согласование: идентификатор и читаемое имя, без состава прав. Отбор search сужает список людей подстрокой по имени; людей отдаётся не больше ста — конструктору нужен выбор, а не выгрузка кабинета.

## Query parameters

- `search` string

## Headers

- `X-Tenant` string, required

## Response `200`

Справочники конструктора

- DocflowApprovalDirectories: Справочники конструктора маршрутов ОДНИМ ответом: три отдельных запроса ради одной формы означают три повода ей мигнуть и три места, где список окажется из разных моментов времени.
  - `departments` DocflowApprovalDepartment[], required
    - `id` string, uuid, required
    - `code` string, required
    - `label` string, required
  - `roles` DocflowApprovalRoleRef[], required
    - `id` string, uuid, required
    - `name` string, required
  - `people` DocflowApprovalPerson[], required
    - `id` integer, required
    - `name` string, required
  - `subjects` DocflowApprovalPolicy[], required: Виды предметов, которые сегодня умеют согласовываться, вместе с их обязательностью
    - `subject_module` 'docflow' | 'finance' | 'stock', required
    - `subject_kind` 'flow_document' | 'payment_request' | 'edo_message' | 'stock_purchase_request', required
    - `required` boolean, required
    - `required_locked` boolean: Обязательность согласования защищена от отключения для этого вида предмета
    - `invoice_required` boolean: Счёт обязателен: заявку на оплату без счёта-основания не отправить. Не задано при сохранении — прежнее значение

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