---
title: "Получить сводку по резервам"
method: GET
path: "/api/v1/stock/report/reservations"
tags: ["Stock reports"]
---

# Получить сводку по резервам

`GET /api/v1/stock/report/reservations`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/report/reservations`
- 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

По каждому проведённому резерву даёт исходное, отгруженное, снятое и оставшееся количество, состояние и строки по позициям. Строка называет непокрытое количество (unbacked_qty), его часть, вызванную просрочкой (expired_qty), и действующий состав её товара (active_spec): по ним непокрытое можно собрать обычной комплектацией без основания — резерв при этом не меняется, а непокрытое пересчитывается само. Обеспечение считается от годного остатка в состоянии строки резерва: товар, просроченный на as_of, резерв не обеспечивает.

## Query parameters

- `company_id` string, uuid
- `warehouse_id` string, uuid
- `as_of` string, date
- `unbacked` boolean
- `limit` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Сводка по резервам

- StockReportReservationPage
  - `count` integer, required
  - `results` StockReportReservationSummary[], required
    - `document_id` string, uuid, required
    - `original_qty` string, required: Decimal string
    - `shipped_qty` string, required: Decimal string
    - `released_qty` string, required: Decimal string
    - `remaining_qty` string, required: Decimal string
    - `unbacked_qty` string, required: Часть остатка резерва, не покрытая годным остатком склада: списание товар забрало или срок годности вышел, обещание ждёт поступления. Без товара остаются самые новые обещания
    - `expired_qty` string: Decimal string. Часть unbacked_qty резерва, вызванная просрочкой (ERP-2149); сумма по строкам. Поля нет — просрочка ни при чём
    - `state` 'active' | 'partially_shipped' | 'fulfilled' | 'released', required
    - `is_overdue` boolean, required
    - `lines` StockReportReservationLine[], required
      - `basis_line_id` string, uuid, required
      - `product_id` string, uuid, required
      - `original_qty` string, required: Decimal string
      - `shipped_qty` string, required: Decimal string
      - `released_qty` string, required: Decimal string
      - `remaining_qty` string, required: Decimal string
      - `unbacked_qty` string, required: Decimal string в базовой единице товара. Часть остатка строки, не покрытая годным остатком склада в состоянии строки: обещание ждёт поступления. Просроченный на as_of товар резерв не обеспечивает. Сумма по строкам равна unbacked_qty резерва; без товара остаются самые новые обещания
      - `expired_qty` string: Decimal string. Часть unbacked_qty строки, вызванная просрочкой: товар лежит, но срок годности вышел к as_of (ERP-2149). Не больше unbacked_qty. Поля нет — просрочка ни при чём
      - `active_spec` StockReportReservationLineSpec, required: Действующая версия состава изделия у товара строки резерва.
        - `version_id` string, uuid, required
        - `spec_id` string, uuid, required
        - `version` integer, required
        - `name` string, required
        - `kind` 'assembly' | 'production' | 'kit', required
        - `output_qty` string, required: Decimal string. Сколько изделия даёт один состав, в базовой единице товара

## Other responses

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

---

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