В этой статье рассмотрим основные группы ссылок Ozon Seller API, разберём, какие данные возвращают наиболее полезные методы и для каких задач продавцу стоит их использовать.
Метод в контексте API это адрес, к которому обращается внешняя программа для получения или изменения данных.
POST /v3/product/listпример метода OZON API
В примере выше метод позволяет получить список товаров продавца.
В зависимости от параметров запроса можно ограничить выборку, например, по состоянию товара или отфильтровать по другим условиям.
Большинство методов Seller API используют HTTP метод POST, даже для получения информации.
Потому по одному только HTTP-методу нельзя определить, изменяет запрос данные или запрашивает их.
Документация OZON Seller API расположена по адресу https://docs.ozon.com/api/seller/
Базовый адрес для обращения в OZON Seller API: https://api-seller.ozon.ru
Для обращения к методам используются соответствующие заголовки авторизации (Идентификатор клиента:Client-Id и API-ключ:Api-Key).
Одна из наиболее востребованных групп OZON Seller API это методы работы с товарным каталогом.
Они позволяют получить список товаров, характеристики, описания, изображения и другую информацию, необходимую для управления ассортиментом.
Особенно полезны эти методы продавцам с большим количеством SKU, а также компаниям, которые синхронизируют каталог Ozon с товароучётной системой.
| Метод | Что возвращает | Для чего полезен |
|---|---|---|
POST /v3/product/list | Список товаров продавца, идентификаторы и артикулы, информацию о состоянии товаров и другие доступные поля | Выгрузка и синхронизация ассортимента |
POST /v3/product/info/list | Подробную информацию о товарах по переданным идентификаторам | Получение сведений о конкретных товарах |
POST /v1/product/info/description | Описание товара и связанные с ним данные карточки | Проверка содержимого карточек |
POST /v4/product/info/attributes | Информацию о характеристиках товаров | Контроль заполнения характеристик |
POST /v2/product/pictures/info | Информацию об изображениях товаров | Проверка загруженных изображений |
POST /v1/product/rating-by-sku | Контент-рейтинг товаров по SKU | Поиск карточек с недостаточно заполненным контентом |
POST /v1/product/info/subscription | Количество пользователей, подписавшихся на товар | Оценка интереса к отсутствующим в наличии товарам |
В зависимости от выбранного метода и состава ответа продавец может получать:
идентификаторы товаров Ozon (product_id)
артикулы продавца (offer_id)
SKU товаров
названия и описания
категории и характеристики
информацию об изображениях
состояние и доступность товарных карточек
показатели контент-рейтинга
Важно учитывать, что не каждый метод возвращает все перечисленные сведения одновременно.
Например, для получения списка товаров используется один метод, а для подробной информации о характеристиках или изображениях уже другие.
Можно регулярно выгружать каталог Ozon и сверять его с внутренней базой товаров, для поддержания актуальности ассортимента.
Цены это одна из наиболее часто обновляемых категорий данных на маркетплейсе. OZON Seller API позволяет получать актуальную информацию и передавать новые значения цен из внешней системы.
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
POST /v5/product/info/prices | Возвращает информацию о ценах товаров | Контроль текущих цен и скидок |
POST /v1/product/prices/details | Возвращает подробную информацию о ценах товаров | Анализ ценовых параметров |
POST /v1/product/import/prices | Обновляет цены товаров по переданным данным | Массовое изменение цен |
POST /v1/product/info/discounted | Возвращает информацию об уценённом товаре и основном товаре по его SKU | Контроль уценённых товаров |
POST /v1/pricing-strategy/list | Возвращает список ценовых стратегий | Контроль используемых стратегий |
POST /v1/pricing-strategy/info | Возвращает информацию о конкретной стратегии | Проверка параметров стратегии |
POST /v1/pricing-strategy/competitors/list | Возвращает список конкурентов в рамках ценовой стратегии | Анализ конкурентного окружения |
POST /v1/pricing-strategy/product/info | Возвращает информацию о цене товара у конкурента | Сравнение цен |
В зависимости от метода в ответах могут присутствовать:
текущая цена товара
цена до скидки
минимальная цена
цены с учётом различных скидок
информация о ценовой стратегии
данные о ценах конкурентов
идентификаторы товаров, к которым относятся цены
Продавец может синхронизировать изменения цен собственной системы учета и интернет магазина OZON.
Стоит учитывать, что получение цены и её изменение это разные операции.
Для чтения используются информационные методы, а для обновления отдельные методы импорта цен.
Контроль остатков необходим для предотвращения ситуаций, когда товар фактически закончился, но продолжает отображаться доступным для заказа.
OZON Seller API позволяет получать информацию о количестве товаров и распределении остатков по складам.
При этом методы могут существенно отличаться в зависимости от схемы работы: FBO, FBS или rFBS.
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
POST /v4/product/info/stocks | Возвращает информацию о количестве товаров | Общий контроль товарных остатков |
POST /v2/product/info/stocks-by-warehouse/fbs | Возвращает информацию об остатках на складах продавца | Контроль остатков FBS и rFBS |
POST /v1/product/info/stocks-by-warehouse/fbo | Возвращает информацию о стоках на складах FBO | Контроль размещения товаров на складах Ozon |
POST /v1/analytics/stocks | Возвращает аналитические данные по остаткам | Анализ складских запасов |
POST /v2/analytics/stock_on_warehouses | Возвращает отчёт по остаткам и товарам | Анализ распределения запасов |
POST /v1/analytics/turnover/stocks | Возвращает данные об оборачиваемости товаров | Планирование закупок и поставок |
POST /v2/products/stocks | Обновляет количество товаров на складах | Передача актуальных остатков в Ozon |
В зависимости от схемы работы и выбранного метода API может возвращать:
идентификатор товара и SKU
идентификатор склада
количество товаров на складе
доступное количество
зарезервированное количество
информацию о распределении запасов
показатели оборачиваемости
Можно настроить синхронизацию остатков с системой учета.
Актуально, если продажи идут одновременно на нескольких площадках.
При этом не следует считать, что все методы возвращают одинаковую структуру информации по остаткам.
Для FBO и FBS используются разные сценарии получения информации.
Работа с заказами это одно из основных направлений использования Seller API.
Методы позволяют получать список отправлений, подробную информацию о конкретном заказе и отслеживать состояние его обработки.
Здесь важно различать схемы FBO и FBS:
FBO
Товар хранится на складе Ozon, а обработкой и доставкой занимается маркетплейс.
FBS
Товар хранится у продавца, который самостоятельно собирает заказ и передаёт его в доставку Ozon.
rFBS
Продавец использует собственную логистику или стороннюю службу доставки в рамках соответствующей схемы.
| Метод | Что возвращает | Для чего полезен |
|---|---|---|
POST /v3/posting/fbo/list | Список отправлений FBO с информацией о заказах и их статусах | Выгрузка заказов FBO |
POST /v2/posting/fbo/get | Подробную информацию об отправлении FBO по его идентификатору | Получение состава и деталей конкретного заказа |
| Метод | Что возвращает | Для чего полезен |
|---|---|---|
POST /v4/posting/fbs/list | Список отправлений FBS с учётом переданных фильтров | Получение списка заказов |
POST /v4/posting/fbs/unfulfilled/list | Список необработанных отправлений | Контроль новых заказов |
POST /v3/posting/fbs/get | Подробную информацию об отправлении по его идентификатору | Получение состава и параметров заказа |
POST /v2/posting/fbs/get-by-barcode | Информацию об отправлении по штрихкоду | Поиск отправления при сборке |
В зависимости от метода можно получить:
номер отправления (posting_number)
идентификаторы товаров
артикулы продавца
SKU
количество товаров в отправлении
статус заказа
дату создания и другие временные параметры
информацию о доставке
данные о товарах в отправлении
дополнительные сведения, необходимые для сборки и обработки заказа
Заказы можно автоматически передавать в свою систему и формировать задания на сборку, периодически проверять статусы и контролировать отгрузку.
В актуальном перечне методов для получения списков FBO и FBS используются версии /v3/posting/fbo/list и /v4/posting/fbs/list.
Старые версии некоторых методов постингов были отключены 1 августа 2026 года.
Кроме получения заказов, OZON Seller API позволяет работать с логистическими операциями: формировать отгрузки FBS, получать информацию о поставках FBO, контролировать грузоместа и получать документы.
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
POST /v2/carriage/delivery/list | Возвращает список методов доставки и отгрузок | Выбор подходящей отгрузки |
POST /v1/carriage/get | Возвращает информацию о перевозке | Контроль перевозки |
POST /v1/assembly/fbs/posting/list | Возвращает список отправлений | Контроль отправлений при сборке |
POST /v1/assembly/fbs/product/list | Возвращает список товаров в отправлениях | Проверка состава сборки |
POST /v2/posting/fbs/act/list | Возвращает список актов по отгрузкам | Контроль документов |
POST /v2/posting/fbs/act/get-postings | Возвращает список отправлений в акте | Проверка состава акта |
POST /v2/posting/fbs/act/get-pdf | Формирует или возвращает PDF с документами | Получение документов для отгрузки |
POST /v2/posting/fbs/act/check-status | Возвращает статус отгрузки и документов | Проверка готовности документов |
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
POST /v3/supply-order/list | Возвращает список заявок на поставку | Контроль поставок |
POST /v3/supply-order/get | Возвращает информацию о конкретной заявке | Получение деталей поставки |
POST /v1/supply-order/details | Возвращает подробную информацию о заявке на поставку | Проверка состава и параметров заявки |
POST /v1/supply-order/bundle | Возвращает состав поставки или заявки | Контроль товарного состава |
POST /v1/supplier/available_warehouses | Возвращает информацию о загруженности складов Ozon | Выбор склада для поставки |
POST /v2/cluster/list | Возвращает информацию о макролокальных кластерах | Планирование распределения поставок |
Продавец может автоматизировать контроль поставок, получать информацию о статусах заявок, проверять состав отправлений и формировать необходимые документы.
Для анализа работы магазина OZON Seller API предоставляет методы получения аналитических данных и формирования отчётов.
Некоторые аналитические методы доступны только при определённых условиях, например в рамках Premium-доступа.
Поэтому перед интеграцией необходимо проверить права доступа к конкретному методу.
| Метод | Что возвращает | Для чего полезен |
|---|---|---|
POST /v1/analytics/data | Аналитические данные по товарам за заданный период и с учётом выбранных показателей | Анализ продаж и динамики показателей |
POST /v1/analytics/turnover/stocks | Информацию об оборачиваемости товаров | Планирование закупок |
POST /v1/analytics/stocks | Аналитические данные по остаткам | Контроль складских запасов |
POST /v2/analytics/stock_on_warehouses | Отчёт по остаткам и товарам | Анализ распределения товаров |
POST /v1/analytics/product-queries | Информацию о поисковых запросах, по которым находят товары продавца | Анализ поискового спроса |
POST /v1/analytics/product-queries/details | Детализацию поисковых запросов по товару | Анализ спроса на отдельные товары |
В зависимости от метода и выбранных параметров можно получать:
количество заказов
количество продаж
выручку и другие товарные показатели
динамику показателей за выбранный период
остатки и оборачиваемость
данные о поисковых запросах
показатели по отдельным товарам
Можно собирать данные за каждый день, неделю или месяц и формировать собственную аналитику.
Например: сравнивать продажи разных товаров, определять позиции с низкой оборачиваемостью и планировать объём следующей поставки.
Финансовые методы особенно полезны для бухгалтерии и управленческого учёта.
С их помощью можно получать сведения о транзакциях, начислениях, реализации товаров и взаиморасчётах с маркетплейсом.
| Метод | Что возвращает | Для чего полезен |
|---|---|---|
POST /v3/finance/transaction/list | Список финансовых транзакций за заданный период | Детализация финансовых операций |
POST /v3/finance/transaction/totals | Суммы финансовых транзакций | Получение итоговых сумм |
POST /v2/finance/realization | Отчёт о реализации товаров | Сверка данных о реализации |
POST /v1/finance/realization/posting | Позаказный отчёт о реализации товаров | Анализ реализации по отправлениям |
POST /v1/finance/cash-flow-statement/list | Финансовый отчёт о движении денежных средств | Контроль денежных потоков |
POST /v1/finance/compensation | Отчёт о компенсациях | Учёт компенсационных начислений |
POST /v1/finance/decompensation | Отчёт о декомпенсациях | Контроль корректировок компенсаций |
POST /v1/finance/mutual-settlement | Отчёт о взаиморасчётах | Сверка расчётов с Ozon |
POST /v1/finance/products/buyout | Отчёт о выкупленных товарах | Анализ выкупа |
В зависимости от метода в ответах могут присутствовать:
идентификаторы транзакций
даты операций
типы начислений и списаний
суммы операций
информация об отправлениях
SKU и данные о товарах
сведения о реализации
данные о компенсациях и взаиморасчётах
Финансовые данные можно регулярно выгружать в бухгалтерскую или управленческую систему, сверять начисления и расходы, анализировать экономику продаж и формировать отчётность.
Важно не путать финансовую транзакцию, отчёт о реализации и фактическую выплату. Это разные сущности, и для их анализа могут потребоваться разные методы.
Возвраты влияют на фактические продажи, складские остатки и финансовые показатели магазина.
Поэтому продавцу важно не только получать информацию о новых заказах, но и отслеживать возвратные операции.
| Метод | Что возвращает | Для чего полезен |
|---|---|---|
POST /v1/returns/list | Информацию о возвратах FBO и FBS | Общий контроль возвратов |
POST /v2/returns/rfbs/list | Список заявок на возврат rFBS | Контроль возвратов по схеме rFBS |
POST /v2/returns/rfbs/get | Подробную информацию о заявке на возврат | Анализ отдельного возврата |
POST /v3/returns/company/fbo | Информацию о возвратах FBO | Анализ возвратов по схеме FBO |
POST /v3/returns/company/fbs | Информацию о возвратах FBS | Анализ возвратов по схеме FBS |
Можно автоматически получать сведения о возвратах, сопоставлять их с исходными заказами и учитывать возвращённые товары при расчёте продаж и остатков.
OZON Seller API предоставляет методы для получения информации об акциях Ozon и товарах, которые могут участвовать в них.
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
GET /v1/actions | Возвращает список акций | Получение доступных акций |
POST /v2/actions/candidates | Возвращает список товаров, которые могут участвовать в акции | Подбор товаров для продвижения |
POST /v2/actions/products | Возвращает список товаров, участвующих в акции | Контроль участия товаров |
POST /v1/actions/products/update | Добавляет или обновляет товар в акции | Управление участием товаров |
POST /v1/actions/discounts-task/list | Возвращает список заявок на скидку | Контроль заявок на скидку |
POST /v1/actions/discounts-task/approve | Согласовывает заявку на скидку | Автоматизация обработки заявок |
POST /v1/actions/discounts-task/decline | Отклоняет заявку на скидку | Управление заявками |
Продавец может автоматически получать список доступных акций, проверять товары, участвующие в продвижении, и контролировать заявки на скидки.
В API есть отдельные методы для акций Ozon и отдельная группа бета-методов для управления собственными акциями продавца.
Это разные наборы операций.
Для работы с обратной связью покупателей предусмотрены отдельные методы для отзывов и вопросов. Они позволяют получать сообщения, проверять их статус и автоматизировать ответы.
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
POST /v2/review/list | Возвращает список отзывов | Получение новых отзывов |
POST /v2/review/info | Возвращает информацию об отзыве | Просмотр деталей конкретного отзыва |
POST /v2/review/count | Возвращает количество отзывов по статусам | Контроль необработанных отзывов |
POST /v2/review/change-status | Изменяет статус отзыва | Управление обработкой отзывов |
POST /v1/review/comment/list | Возвращает список комментариев к отзыву | Просмотр переписки по отзыву |
POST /v1/review/comment/create | Создаёт комментарий к отзыву | Ответ покупателю |
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
POST /v1/question/list | Возвращает список вопросов | Получение вопросов покупателей |
POST /v1/question/info | Возвращает информацию о конкретном вопросе | Просмотр деталей вопроса |
POST /v1/question/count | Возвращает количество вопросов по статусам | Контроль необработанных вопросов |
POST /v1/question/top-sku | Возвращает товары с наибольшим количеством вопросов | Поиск товаров, требующих дополнительной информации |
POST /v1/question/answer/list | Возвращает список ответов на вопрос | Просмотр ответов |
POST /v1/question/answer/create | Создаёт ответ на вопрос | Автоматизация ответов |
Можно собирать новые отзывы и вопросы в единую систему, распределять их между сотрудниками и контролировать скорость обработки обращений.
Отдельная группа методов позволяет получать список чатов и историю переписки с покупателями.
| Метод | Что возвращает или делает | Для чего полезен |
|---|---|---|
POST /v3/chat/list | Возвращает список чатов | Получение списка диалогов |
POST /v3/chat/history | Возвращает историю сообщений в чате | Просмотр переписки |
POST /v1/chat/send/file | Отправляет файл в чат | Передача файлов покупателю |
Данные о переписке можно интегрировать во внутреннюю систему поддержки, чтобы сотрудники могли работать с обращениями покупателей в едином интерфейсе.
Seller API позволяет получать информацию о текущих рейтингах продавца и отслеживать их изменения.
| Метод | Что возвращает | Для чего полезен |
|---|---|---|
POST /v1/rating/summary | Информацию о текущих рейтингах продавца | Контроль текущих показателей |
POST /v1/rating/history | Информацию о рейтингах за период | Анализ динамики |
POST /v1/rating/index/fbs/info | Индекс ошибок FBS и rFBS | Контроль качества обработки заказов |
POST /v1/rating/index/fbs/posting/list | Список отправлений, повлиявших на индекс ошибок FBS и rFBS | Поиск проблемных отправлений |
Можно отслеживать изменение рейтингов и находить отправления, которые повлияли на индекс ошибок.
Это помогает быстрее выявлять проблемы в обработке заказов.
Необязательно подключать все методы Ozon Seller API сразу.
Выбор зависит от того, какие процессы нужно автоматизировать.
| Задача | Рекомендуемые методы |
|---|---|
| Выгрузка каталога товаров | /v3/product/list, /v3/product/info/list |
| Получение характеристик товаров | /v4/product/info/attributes |
| Контроль цен | /v5/product/info/prices |
| Обновление цен | /v1/product/import/prices |
| Контроль остатков | /v4/product/info/stocks, /v2/product/info/stocks-by-warehouse/fbs |
| Обновление остатков | /v2/products/stocks |
| Получение заказов FBO | /v3/posting/fbo/list |
| Получение заказов FBS | /v4/posting/fbs/list, /v4/posting/fbs/unfulfilled/list |
| Получение финансовых операций | /v3/finance/transaction/list |
| Получение отчёта о реализации | /v2/finance/realization |
| Контроль возвратов | /v1/returns/list |
| Работа с отзывами | /v2/review/list, /v2/review/count |
| Получение вопросов | /v1/question/list |
| Контроль рейтинга | /v1/rating/summary, /v1/rating/history |
Для большинства продавцов логично начать с пяти направлений:
товары чтобы получить актуальный каталог
цены и остатки чтобы синхронизировать данные с учётной системой
заказы чтобы автоматизировать обработку отправлений
финансы чтобы контролировать начисления и реализацию
возвраты чтобы учитывать обратные операции
После этого можно подключать аналитику, отзывы, вопросы, чаты и другие методы.
Перед подключением методов стоит учитывать несколько особенностей.
Не все методы доступны каждому продавцу
В документации присутствуют базовые, Premium и бета-методы.
Для отдельных операций могут требоваться специальные права, условия доступа или подключённые возможности.
Версии методов могут отключаться
Нельзя ориентироваться только на старые примеры кода или статьи.
Например, в 2026 году Ozon объявил об отключении старых методов получения списков FBO и FBS-отправлений.
Получение и изменение данных это разные операции
Некоторые методы только возвращают информацию, другие изменяют данные магазина.
Например, /v5/product/info/prices используется для получения цен, а /v1/product/import/prices для их обновления.
Состав ответа зависит от параметров запроса
Не каждый метод возвращает полный набор данных.
Некоторые методы требуют передать идентификаторы, период, фильтры или статус.
Для больших выборок также необходимо учитывать пагинацию.
API требует контроля доступа и безопасности
Для методов используются права, назначенные ключу или приложению.
Срок действия API-ключей и правила авторизации могут меняться, поэтому необходимо следить за актуальными требованиями Ozon.
Время в API
При работе с датами и временем важно учитывать, что Seller API использует UTC. Это необходимо принимать во внимание при выгрузке заказов, финансовых операций и аналитики.
Если у вас остались вопросы по OZON Seller API вы можете обратиться за консультацией к программисту.
