---
title: "Получить сводку сроков годности"
method: GET
path: "/api/v1/stock/batch-stock/summary"
tags: ["Stock batches"]
---

# Получить сводку сроков годности

`GET /api/v1/stock/batch-stock/summary`

## Request

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

Сводка остатков по состоянию срока (ERP-1788): просрочено, красная, жёлтая и зелёная градации ОСГ кабинета (grades; по умолчанию < 30 %, 30–70 %, от 70 %), без срока — строки, партии, количество и себестоимость. Отборы — как у списка остатков по партиям.

## Query parameters

- `product_id` string, uuid
- `warehouse_id` string, uuid
- `warehouse_ids` string
- `company_id` string, uuid
- `business_id` string, uuid
- `as_of` string, date
- `shelf_as_of` string, date
- `unavailable_only` boolean
- `without_company` boolean

## Headers

- `X-Tenant` string, required

## Response `200`

Сводка сроков

- StockBatchStockSummary
  - `as_of` string, date, required
  - `shelf_as_of` string, date, required: Дата ОСГ и градаций (ERP-2182)
  - `grades` StockShelfGrades, required: Градации ОСГ кабинета (ERP-2182, настройки склада): ОСГ ниже critical_pct — critical, ниже warning_pct — warning, иначе ok; партия без ОСГ — по дням до срока: не больше critical_days — critical, не больше warning_days — warning.
    - `critical_pct` string, required
    - `warning_pct` string, required
    - `critical_days` integer, required
    - `warning_days` integer, required
  - `expired` StockBatchStockBucket, required
    - `rows` integer, required
    - `batches` integer, required
    - `qty` string, required
    - `amount` string, required
  - `critical` StockBatchStockBucket, required
    - `rows` integer, required
    - `batches` integer, required
    - `qty` string, required
    - `amount` string, required
  - `warning` StockBatchStockBucket, required
    - `rows` integer, required
    - `batches` integer, required
    - `qty` string, required
    - `amount` string, required
  - `ok` StockBatchStockBucket, required
    - `rows` integer, required
    - `batches` integer, required
    - `qty` string, required
    - `amount` string, required
  - `none` StockBatchStockBucket, required
    - `rows` integer, required
    - `batches` integer, required
    - `qty` string, required
    - `amount` string, required

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