# Кластеры Ozon в API: список кластеров, кластер заказа и остатки по складам

> Список кластеров Ozon со складами отдает метод POST /v1/cluster/list: на 24.09.2026 для типа CLUSTER_TYPE_OZON это 22 кластера и 1105 складов. Кластер, куда доставлен заказ, указан в поле financial_data.cluster_to отправления и совпадает с названием кластера из этого списка. Остатки FBO по складам отдает /v2/analytics/stock_on_warehouses, склад там указан только названием, по нему остаток привязывается к кластеру.

Проверено: 11.10.2026. Источник: https://mp-index.ru/spravka/klastery-ozon-api

## Список кластеров

Запрос `POST /v1/cluster/list` с телом `{"cluster_type": "CLUSTER_TYPE_OZON"}`. Ответ (проверен 24.09.2026): `clusters[]` с полями `id`, `name`, `type`, `macrolocal_cluster_id` и `logistic_clusters[].warehouses[]` (`warehouse_id`, `type`, `name`). Справочник общий для всех продавцов и меняется редко, его достаточно обновлять раз в сутки.

## Кластер заказа

В отправлении FBO и FBS поле `financial_data.cluster_to` - кластер покупателя. Название в `cluster_to` совпадает с `name` кластера из `/v1/cluster/list`. Заказы в страны СНГ могут приходить с кластером, которого нет в списке типа CLUSTER_TYPE_OZON.

## Остатки по кластерам

- `POST /v2/analytics/stock_on_warehouses` - остатки FBO по складам Ozon постранично (limit и offset), без списка товаров. В строке есть `sku`, `item_code` (offer_id), `warehouse_name`, `free_to_sell_amount`, `reserved_amount`, `promised_amount`. ID склада нет.
- Название склада совпадает с `name` склада из `/v1/cluster/list`: так остаток привязывается к кластеру.
- Остатки на своем складе продавца (FBS) отдает `/v2/product/info/stocks-by-warehouse/fbs`, к кластерам Ozon они не относятся.

## Зачем это нужно

Доля заказов кластера показывает, сколько товара везти на склады этого кластера, а сравнение логистики по кластерам - куда доставка обходится дороже. Как сравнивать логистику так, чтобы размер товаров не искажал результат, и данные реального магазина - на странице [логистика Ozon по кластерам](https://mp-index.ru/spravka/logistika-ozon-po-klasteram).

## Источники

- [Документация Ozon Seller API](https://docs.ozon.ru/api/seller/)

## Смотрите также

- [Логистика Ozon по кластерам: насколько регион дороже на тех же товарах](https://mp-index.ru/spravka/logistika-ozon-po-klasteram)
- [product_id, SKU и offer_id в Ozon API: как сопоставить заказы, начисления и карточки](https://mp-index.ru/spravka/identifikatory-tovara-ozon-api)
- [Ограничения Ozon Seller API, о которых не пишут в документации](https://mp-index.ru/spravka/limity-ozon-seller-api)

---
Справочник продавца Ozon, MP Index: https://mp-index.ru/spravka/