---
title: "Получить остатки Ozon по складам"
method: GET
path: "/api/v1/marketplace/ozon/stocks"
tags: ["Marketplace Ozon"]
---

# Получить остатки Ozon по складам

`GET /api/v1/marketplace/ozon/stocks`

## Request

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

Доступный остаток в разрезе склада и кластера, сгруппированный по
товару. Выборка ограничена 8000 строками склад-товар. Нулевые
остатки отбрасываются.

## Query parameters

- `store` string
- `group` string
- `search` string
- `q` string

## Headers

- `X-Tenant` string, required

## Response `200`

Остатки по складам

- MarketplaceOzonStocksPage
  - `count` integer, required
  - `warehouses` string[], required: Склады встреченные в выборке
  - `results` MarketplaceOzonStockProduct[], required
    - `store` string, uuid, required
    - `store_name` string, required
    - `offer_id` string, required
    - `name` string, required
    - `image` string, required
    - `total` integer, required
    - `warehouses` MarketplaceOzonStockWarehouse[], required
      - `warehouse` string, required
      - `cluster` string
      - `qty` integer, required
    - `to_client` integer: Товар в пути к покупателю, шт
    - `buyout_pct` number: Выкуп, % — когорта созревших заказов, как у воронки; нет — поля нет
    - `effective` number: Остаток с возвратом невыкупленного из того, что в пути: остаток + в пути × (1 − выкуп)
  - `truncated` boolean: Строк «товар × склад» больше предела 8000: хвост артикулов не пришёл, отсутствие товара не значит «остатка нет»

## Other responses

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

---

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