---
title: "Поручить работу по документу"
method: POST
path: "/api/v1/docflow/flow/documents/{id}/assignments"
tags: ["Docflow flow"]
---

# Поручить работу по документу

`POST /api/v1/docflow/flow/documents/{id}/assignments`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/docflow/flow/documents/{id}/assignments`
- 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`)

«Поручить» в карточке документа: заводит задачу модуля tasks исполнителю (плюс соисполнители) со связью на документ. Текст поручения — это и есть резолюция: его первая строка вместе с названием документа становится названием задачи, весь текст — описанием. Проект задач выбирать не нужно: задача ложится в системный раздел «Поручения», участники поручения становятся его участниками и видят только свои поручения. Срок не задан — три рабочих дня по производственному календарю, 18:00 по Москве; срок в прошлом — 422. Поручить может тот, кто видит документ (право записи не нужно: поручение документ не меняет); чужой документ — 404. Исполнитель или соисполнитель не состоит в кабинете — 422 docflow.assignment.invalid с полем executor_id; модуль задач не подключён — 409 docflow.assignment.unavailable. Исполнение задачи автор узнаёт уведомлением задачника «Задача выполнена». Повтор с тем же Idempotency-Key отдаёт то же поручение.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required
- `Idempotency-Key` string

## Request body

- DocflowFlowAssignmentInput: Что поручить по документу.
  - `text` string, required: Текст поручения (резолюция): что сделать по документу
  - `executor_id` integer, required: Исполнитель — действующий участник кабинета
  - `coexecutor_ids` integer[]: Соисполнители; исполнитель и повторы отбрасываются
  - `due_at` string, date-time: Срок; не задан — три рабочих дня, 18:00 по Москве

## Response `201`

Поручение заведено

- DocflowFlowAssignment: Поручение по документу — задача модуля tasks со связью на документ.
  - `task_id` string, uuid, required
  - `identifier` string, required: Номер задачи (POR-1)
  - `title` string, required: Название задачи: первая строка поручения и название документа
  - `text` string, required: Текст поручения
  - `creator` DocflowFlowAssignmentPerson, required: Участник поручения.
    - `id` integer, required: Пользователь кабинета
    - `name` string, required: Имя
  - `executor` DocflowFlowAssignmentPerson, required: Участник поручения.
    - `id` integer, required: Пользователь кабинета
    - `name` string, required: Имя
  - `coexecutors` DocflowFlowAssignmentPerson[], required: Соисполнители
    - `id` integer, required: Пользователь кабинета
    - `name` string, required: Имя
  - `due_at` string, date-time, nullable, required: Срок; пусто — без срока
  - `state` 'open' | 'done' | 'cancelled', required: Состояние по этапу задачи
  - `status_name` string, required: Этап задачи словами кабинета
  - `overdue` boolean, required: Открыто, а срок прошёл
  - `created_at` string, date-time, required: Когда поручено
  - `document_id` string, uuid, required
  - `document_label` string, required: Название документа на момент поручения

## Other responses

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

## Changes

- **2026-10-20** `765c65fadf8f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/docflow/flow/documents/:id/assignments/post.md)

---

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