---
title: "Получить список партий"
method: GET
path: "/api/v1/stock/batches"
tags: ["Stock batches"]
---

# Получить список партий

`GET /api/v1/stock/batches`

## Request

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

Количество и сумма партии считаются из движений регистра stock. Партия заводится уже черновиком документа, но в списке её нет, пока документ не проведён и по ней нет ни одного действующего движения: партии черновиков и отменённых документов не показываются. Израсходованная партия проведённого документа остаётся в списке с остатком 0; счётчик считает уже отобранное.

## Query parameters

- `company_id` string, uuid
- `product_id` string, uuid
- `q` string
- `expiry` 'expired' | 'soon' | 'all'
- `product` string
- `batch` string
- `received_from` string, date
- `received_to` string, date
- `produced_from` string, date
- `produced_to` string, date
- `quantity_from` string
- `quantity_to` string
- `amount_from` string
- `amount_to` string
- `warehouse_id` string, uuid
- `warehouse_scope` 'own' | 'platform' | 'all'
- `sort` 'received_at' | 'expires_at' | 'product' | 'company' | 'quantity' | 'amount'
- `direction` 'asc' | 'desc'
- `limit` integer
- `offset` integer
- `in_stock` boolean
- `series` string
- `group` 'series'

## Headers

- `X-Tenant` string, required

## Response `200`

Страница партий

- StockBatchPage
  - `count` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `results` StockBatch[], required
    - `id` string, uuid, required
    - `business_id` string, uuid, required
    - `business_name` string, required
    - `company_id` string, uuid, required
    - `company_name` string, required
    - `product_id` string, uuid, required
    - `product_sku` string, required
    - `product_name` string, required
    - `photo_file_id` string, uuid
    - `source_document_id` string, uuid, required
    - `source_document_type_key` string, required
    - `source_line_id` string, uuid, required
    - `received_at` string, date-time, required
    - `supplier_batch_code` string, required
    - `gtin` string: GTIN маркировки партии (ERP-2134), 14 цифр; пусто — не задан
    - `produced_at` string, date-time, nullable, required
    - `expires_at` string, date-time, nullable, required
    - `is_active` boolean, required
    - `quantity` string, required: Считается из движений регистра stock
    - `amount` string, required: Считается из движений регистра stock
    - `source_document_number` string: Номер документа-источника партии
    - `source_document_date` string, date: Дата документа-источника
    - `warehouses` StockBatchWarehouseStock[]: Где лежит партия (ERP-1788): ненулевой остаток по складам и состояниям. Заполняется в списке; в карточке партии может быть пустым
      - `warehouse_id` string, uuid, required
      - `warehouse_name` string, required
      - `parent_id` string, uuid, required
      - `parent_name` string, required
      - `external` boolean, required: Склад внешней стороны: площадки или товара в пути к ней
      - `condition_id` string, uuid, required
      - `condition_name` string, required
      - `qty` string, required
    - `series_batch_count` integer: Строка серии (group=series, ERP-2199): сколько партий сложено; у строки партии поля нет
    - `series_dates_differ` boolean: Строка серии: выпуск или срок у партий серии разные — серию стоит поправить целиком

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