---
title: "Создать акты списания и оприходования по инвентаризации"
method: POST
path: "/api/v1/stock/documents/{id}/derive"
tags: ["Stock inventory"]
---

# Создать акты списания и оприходования по инвентаризации

`POST /api/v1/stock/documents/{id}/derive`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/documents/{id}/derive`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Работает только на завершённом пересчёте (`counted`). Расхождения
превращаются в черновики списания и оприходования одной транзакцией под
блокировкой складского регистра; излишку нужна цена. Пары пересортицы
(`regrade`, ERP-2198) уходят одним черновиком «Пересортица»: недостача
одного товара списывается, излишек другого приходуется той же
стоимостью; непарное остаётся списанием и оприходованием. Пары
предлагает stockGetInventoryRegradePlan. Повторный вызов на
уже разобранной инвентаризации ничего не создаёт — он возвращает ранее
созданные акты и приводит рабочий шаг к их состоянию.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- StockInventoryDeriveInput: Пары пересортицы (ERP-2198). Без тела или без пар — обычные списание и оприходование
  - `regrade` StockInventoryRegradePair[]: Подтверждённые пары «недостача ↔ излишек»: сумма пар по строке не больше её отклонения
    - `from_line_id` string, uuid, required
    - `to_line_id` string, uuid, required
    - `qty` string, required: Количество пары в базовой единице, decimal string

## Response `200`

Инвентаризация и созданные акты

- StockInventoryDeriveResult
  - `inventory` CoreDocument, required
    - `id` string, uuid, required
    - `type_id` string, uuid, required
    - `type_key` string, required
    - `type_name` string, required
    - `number` string, required
    - `date` string, date, required
    - `status` 'draft' | 'posted' | 'cancelled', required
    - `basis_type` string, uuid, required
    - `basis_id` string, uuid, required
    - `basis_number` string, required
    - `entity_refs` object, required
    - `payload` object, required
    - `comment` string, required
    - `is_marked_deleted` boolean, required
    - `created_by` integer, nullable, required
    - `created_by_name` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `posted_at` string, required
    - `cancelled_at` string, required
    - `custom` object: Значения своих полей кабинета (графы вида core.document.<ключ вида>). Отдаёт карточка документа; списки поле не несут
  - `documents` CoreDocument[], required: Черновики пересортицы, списания и оприходования; пустой список означает, что расхождений нет
    - `id` string, uuid, required
    - `type_id` string, uuid, required
    - `type_key` string, required
    - `type_name` string, required
    - `number` string, required
    - `date` string, date, required
    - `status` 'draft' | 'posted' | 'cancelled', required
    - `basis_type` string, uuid, required
    - `basis_id` string, uuid, required
    - `basis_number` string, required
    - `entity_refs` object, required
    - `payload` object, required
    - `comment` string, required
    - `is_marked_deleted` boolean, required
    - `created_by` integer, nullable, required
    - `created_by_name` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `posted_at` string, required
    - `cancelled_at` string, required
    - `custom` object: Значения своих полей кабинета (графы вида core.document.<ключ вида>). Отдаёт карточка документа; списки поле не несут
  - `surplus_prices` object[]: Цены излишков, подставленные при формировании актов (человек их не вписал); source none — 0, оценить до закрытия месяца
    - `product_id` string, uuid, required
    - `price` string, required
    - `source` 'warehouse' | 'company' | 'last_receipt' | 'card' | 'none', required

## Other responses

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

---

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