Справочник/Ozon Seller API

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

Проверено · Markdown-версия
Коротко

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

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

Запрос 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 по кластерам.

Эти цифры по вашему магазину

MP Index считает комиссии, логистику и прибыль каждого товара по начислениям вашего Ozon Seller API.

Открыть демо →