NAV navbar
logo

Начало работы

В документе описаны методы Ozon Seller API — программного интерфейса для работы с маркетплейсом Ozon.

Основные категории методов Seller API:

  • товары,
  • отправления,
  • чат с покупателями,
  • отчеты.

Авторизация

Доступ к API могут получить только пользователи зарегистрированные в Ozon Seller.

Для каждого запроса нужно указывать идентификатор клиента и его API-ключ:

  1. В личном кабинете перейдите в настройки, на вкладку API-ключи.
  2. Введите название для ключа и нажмите "Создать ключ" — ниже появится список ваших API-ключей.
  3. Вы можете создать несколько API-ключей, например, если у вас несколько магазинов на Маркетплейсе Ozon.

Тестовая среда

Тестовая среда дублирует методы Seller API, но полностью изолирована от настоящих данных. Здесь можно пробовать вызывать методы API, получать ответы, наблюдать изменение тестовых данных.

Запросы к тестовой среде не изменяют данные в Ozon Seller, созданные товары и заказы нигде не показываются.

Адрес для отправки тестовых запросов: cb-api.ozonru.me

ПараметрОписание
Client-Id836
Api-Key0296d4f2-70a1-4c09-b507-904fd05567b9

Рабочая среда

Запросы к API на рабочей среде меняют настоящие данные, поэтому будьте внимательны — созданные товары и заказы затрагивают реальных пользователей.

Адрес рабочей среды: api-seller.ozon.ru

Созданные товары можно посмотреть по ссылке вида

https://www.ozon.ru/context/detail/id/SKU

где вместо SKU нужно указать значение для созданного товара.

Формат запроса:

GET / HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 
Api-Key: 
Content-Type: application/json

Характеристики и категории

На Ozon товары отличаются категориями и характеристикам — так пользователи могут найти нужный им продукт. Поэтому при создании товара, укажите подробную информацию: выберите категорию и заполните характеристики. Для каждой категории товаров есть стандартный набор характеристик — можете использовать их или дополнить собственными. У категорий ниже второго уровня характеристики, как правило, одинаковые.

Список категорий и характеристик товаров на Ozon может меняться — обо всех крупных обновлениях мы делаем рассылку. Проверьте, что в личном кабинете указаны актуальные контактные данные.

Список методов

GET /v1​/categories​/tree

Полное дерево категорий товаров на Ozon.

GET /v1/categories/tree/{categoryId}

Дерево подкатегорий. Аналигочен GET /v1​/categories​/tree, но для конкретной категории.

GET /v1​/categories​/{categoryId}​/attributes

Характеристики отдельной категории. Идентификатор категории указывается в адресе запроса.

POST /v1/category/attribute

Работает до 1.06.2020: список характеристик для категории, идентификатор которой указан в теле запроса.

POST /v1/category/tree

Дерево категорий. В теле запроса можно передать идентификатор категории, для которой надо построить дерево вложенных категорий.

POST /v2​/category​/attribute

Обновленная версия списка характеристик для категории, идентификатор которой указан в теле запроса.

POST /v2​/category​/attribute​/value​/by-option

Если идентификатор справочника или харектеристики изменился, можно узнать его новое значение по старому идендификатору.

POST /v2​/category​/attribute​/values

Справочник для указанной в теле запроса категории или характеристики.

Товары и цены

Добавить товары на Ozon можно в личном кабинете, через XLS-шаблон или с помощью методов Seller API.

Перед публикацией на Маркетплейсе товары проходят модерацию.

Для пробной интеграции рекомендуем загружать товары по одному, а не пакетами — так они быстрее пройдут проверку.

Если при добавлении товаров возникли ошибки, исправьте их и загрузите товары ещё раз.

Часть данных о товаре нельзя изменить:

  • код поставщика — offer_id;
  • категорию товара — category_id;
  • если наши сотрудники измерили товар на складе — габариты товара.

Если товар уже объединен в карточку, его нельзя редактировать.

Список методов

POST /v2/product/import

Метод для первичной загрузки товаров. В одном запросе можно передать до 1000 товаров.

POST /v2/product/info

Возвращает информацию о товаре по его идентификатору. Если указать только offer_id, то в результатах поиска будут только товары вашего магазина, даже если у другого продавца есть такие же артикулы.

POST /v2/products/info/attributes

Возвращает описание характеристик товара по его идентификатору. Товар можно искать по offer_id или product_id.

POST /v1/product/update Меняет данные на карточке товара, кроме цены и количества товаров на складах.

POST /v1/product/archieve Переносит товары в архив.

POST /v1/product/unarchieve Возвращает товары из архива.

POST ​/v1​/product​/info​/prices

Подробная информация о цене товара: цена поставщика, цена с учетом Ozon Premium, ценовой индекс и подобное.

POST /v1/product/info/stocks

Возвращает информацию о количестве товаров на складах: сколько единиц есть в наличии, сколько ожидается в поставке и сколько разерезервировано покупателями.

Заказы и отправления

Заказы на Ozon делятся на отправления: даже если в заказе одно отправление, все действия будут касаться именно отправления, а не заказа.

Можно самостоятельно разбить заказ на несколько отправлений, например, если товары нельзя хранить вместе или если они находятся на разных складах. Подробно о том, как работает поставка и сбор заказов есть в Помощи: FBS, FBO.

Чтобы работать с отправлениями через API, добавьте товары, дождитесь модерации и обновите остатки. Все новые заказы создают отправления в статусе «awaiting_packaging».

FBS

FBO

Crossborder

Обновления

15 апреля:

Метод позволяет получить характеристики для указанной категории товаров.

POST /v1/category/attribute

Метод позволяет получить идентификаторы справочников и характеристик.

POST /v2/category/attribute/value/by-option

Возвращает описание характеристик товара по его идентификатору. Товар можно искать по offer_id или product_id.

POST /v2/products/info/attributes

Возвращает список отправлений за указанный период времени.

POST /v2/posting/crossborder/list

Возвращает итоговую сумму по транзакциям за период, по статусу или отправлению.

POST /v2/finance/transaction/totals

Возвращает список отчетов, которые были сформированы раньше.

POST /v1/report/list

Возвращает информацию о запрошенном отчете по его уникальному ID.

POST /v1/report/info

Возвращает отчет по товарам, который также доступен в личном кабинете продавца.

POST /v1/report/products/create

Возвращает отчет по товарам, который также доступен в личном кабинете продавца.

POST /v1/report/transactions/create

13 апреля:

Метод позволяет изменить информацию о количестве товара в наличии.

POST /v1/product/import/stocks

Метод позволяет получить информацию о товаре по идентификатору.

POST /v1/product/info

Метод позволяет получить список товаров.

POST /v1/product/list

Метод позволяет установить продажу товара только по предоплате.

POST /v1/product/prepayment/set

Метод позволяет получить информацию о списке товаров.

POST /v2/product/info/list

Метод выводит список сертифицируемых категорий.

POST /v1/product/certification/list

Метод возвращает описание товара.

POST /v1/product/info/description

Метод позволяет получить информацию о товаре.

GET /v1/products/info/{product_id}

Метод позволяет обновить цены товаров.

POST /v1/products/prices

Метод позволяет получить информацию о товарах.

POST /v2/product/info/stocks

Метод позволяет получить статус создания карточки товара.

POST /v1/product/import/info

Метод позволяет изменить цену одного или нескольких товаров.

POST /v1/product/import/prices

Метод позволяет обновить количество товаров.

POST /v1/products/stocks

Метод позволяет обновить информацию о товаре.

POST /v1/products/update

13 января: Чат с покупателем

Метод для возвращения информации о чате с указанными идентификаторами:

POST /v1/chat/list

Метод для отправления файла в существующий чат по его идентификатору:

POST /v1/chat/send/file

Метод для отправления сообщения в существующий чат по его идентификатору:

POST /v1/chat/send/message

Метод для cоздания нового чата с покупателем:

POST /v1/chat/start

25 декабря: Чат с покупателем

Добавили метод для запроса истории чата.

POST /v1/chat/history

15 декабря: Данные аналитики

Добавили метод для генерации отчетов.

POST /v1/analytics/data

Укажите период и метрики, которые нужно посчитать — в ответе будет аналитика, сгруппированная по параметру dimensions.

9 декабря: Доставка по выбору продавца

Методы работают в тестовом режиме на органиченное количество продавцов.

Добавили группу методов для ручного обновления статусов:

POST /v2/fbs/posting/delivered

POST /v2/fbs/posting/delivering

POST /v2/fbs/posting/last-mile

Метод для добавления трек-номера к отправлениям:

POST /v2/fbs/posting/tracking-number/set

Методы для получения списков отправлений:

POST /v3/posting/fbs/get

POST /v3/posting/fbs/list

POST /v3/posting/fbs/unfulfilled/list

Метод обновления остатков товаров на складах:

POST /v2/products/stocks

20 августа: Работа с накладными

Добавили метод для получения списка накладных по номеру заявки: GET /v1/supplier/orders​/{orderId}/waybill_acceptance_results

и метод, который возвращает результаты приемки по номеру накладной GET ​/v1​/supplier​/waybill_acceptance_results/{waybillId}.

17 августа: Сертификаты качества

Добавили методы для массовой загрузки сертификатов качества и товаров к ним:

GET /v1​/product​/certificate​/accordance-types — справочник соответствия типов.

POST ​/v1​/product​/certificate​/bind — добавление товаров к сертификатам.

POST /v1/product/certificate/create — загрузка сертификатов.

GET /v1/product/certificate/types — справочник типов документов.

Подробнее про сертификаты качества в Помощи

11 августа: Пропуск для водителя

Добавили методы создания и редактирования пропуска для водителя на склад отгрузки. Укажите данные водителя и транспортного средства, чтобы создать пропуск. По приезду на склад водитель должен предъявить только паспорт, бумажная копия пропуска не обязательна.

Создать или изменить пропуск можно не позже, чем за 30 минут до приезда на склад.

Заказать пропуск POST /pass/create

Посмотреть последний созданный пропуск POST /pass/get/last

Обновить данные в пропуске POST /pass/update

Пример работы методов можно посмотреть в Swagger

24 июля: Удаление товаров

Если товары в архиве и у них нет SKU, то их можно удалить методом POST /v2/products/delete.

16 июля: Информация о комиссиях

Добавили информацию о комиссии на товар в методы /v1/product/info/prices и /v2/product/info.

В ответе теперь есть объект comissions с размером и процентом комиссии для товара, стоимостью доставки и возврата.

13 июля: Аналитические и финансовые данные

В ответ методов /v2/posting/fbs/list, /v2/posting/fbs/get, /v2/posting/fbo/list и /v2/posting/fbo/get добавили финансовые и аналитические данные.

Используйте параметр with.analytics_data и with.financial_data.

08 июля: Архивация товаров

Добавили методы для работы с архивом товаров:

22 июня: Грузовые места

Если для вашего способа отгрузки настроена доверительная приемка, вам потребуется отгружать отправления не поштучно, а грузовыми местами — большими упаковками, в которых находятся отправления. Тогда наш курьер или сотрудник пункта приема получит от вас грузовое место с отправлениями. Он не будет распаковывать его и проверять состав отправлений при отгрузке. Это мы сделаем позже, когда будем готовить доставку отправлений покупателям. Подробнее в Помощи

16 июня: Обязательная маркировка

С 1 июля 2020 года вступает в силу закон: вся обувь, которая продается на территории России, должна иметь маркировку. Продажа обуви без маркировки запрещается с 1 июля.

Добавили методы, которые помогут добавить и проверить маркировку товаров:

POST: /v2/posting/fbs/product/mandatory-mark/is-required

POST: /v2/posting/fbs/product/mandatory-mark/validate

Добавили поле mandatory_mark в тело запроса для метода POST: /v2/posting/fbs/ship и в ответ методов POST: /v2/posting/fbs/get, POST: /v2/posting/fbs/list

Подробно про обязательную маркировку в Помощи

Методы Seller API

Здесь подробное описание параметров и примеры данных для методов Ozon Seller API. Обратите внимание, что для некоторых методов есть v2/ — обновленная версия. Рекомендуем перейти на неё, чтобы всё работало как задумано.

Про все важные изменения мы сообщаем по электронной почте, которую вы указали в личном кабинете.

Если у вас остались вопросы или появились идеи — напишите нам.

Getting started

The document describes the methods of the Ozon Seller API used to work with Ozon Marketplace.

Main categories of the Seller API methods:

  • products
  • shipments
  • chat with customer
  • reports

Authorization

Only users of the Ozon Seller Center can access the API.

For each request, you must specify the client ID and its API key:

  1. In your account, go to settings, and select the API keys tab.
  2. Enter a name for the key and click "Create a key" — a list of your API keys will appear below.
  3. You can create multiple API keys, for example, if you have multiple stores on Ozon Marketplace.

Test environment

The test environment duplicates the methods of the Seller API, but is completely isolated from the real data. Here you can try to call API methods, get responses, and observe changes in test data.

Requests to the test environment do not change the data in Ozon Seller Account, the created products and orders are not shown anywhere.

Test environment URL: cb-api.ozonru.me

ParameterDescription
Client-Id836
Api-Key0296d4f2-70a1-4c09-b507-904fd05567b9

Production environment

API requests in the production environment changes real data, so be careful — created products and orders affect real users.

Production environment URL: api-seller.ozon.ru

The created products can be viewed at the link of the following form

https://www.ozon.ru/context/detail/id/SKU

where instead of the SKU, you need to specify the value for the created product.

Request format:

GET / HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 
Api-Key: 
Content-Type: application/json

Characteristics and categories

On Ozon, products have categories and characteristics, so users can find the product they need. Therefore, when creating a product, specify the detailed information: select a category and fill in the characteristics. For each product category, there is a standard set of characteristics — you can use them or add your own. Categories below the second level usually have the same characteristics.

The list of categories and characteristics of products on Ozon may change. We make a newsletter about all major updates. Make sure that there is the up-to-date contact information in your account.

List of methods

Product categories

GET /v1/categories/tree

GET /v1/categories/tree/[categoryId]

GET /v1/categories/tree/[categoryId]/attributes

v1 Characteristics and categories

POST /v1/category/tree

v2 Characteristics and categories

POST /v2​/category​/attribute​

POST /v2​/category​/attribute​/values

POST /v2​/category​/attribute​/values/values/by-option

Products and prices

You can add products to Ozon in your account, via an XLS template or using the Seller API methods.

Products are moderated before being published on the marketplace.

For trial integration, we recommend uploading products one at a time, rather than in batches. This way they will pass verification faster.

If errors occur when adding products, correct them and upload products again.

Some of the product information cannot be changed:

  • supplier code — offer_id
  • product category — category_id
  • if our employees have measured the products in the warehouse — the dimensions of the product

If the products are already merged into one PDP (product description page), they cannot be edited.

List of methods

Warehouse

POST /v1/warehouse/list

Returns a list of your warehouses.

POST /v1/delivery-method/list

Returns a list of delivery methods for your warehouse.

Products and prices

POST /v1/product/archive

GET /v1/product/certificate/accordance-types

POST /v1/product/certificate/bind

POST /v1/product/certificate/create

GET /v1/product/certificate/types

POST /v1/product/import/info

POST /v1/product/import/prices

POST /v1/product/info/prices

POST /v1/product/unarchive

POST /v1/product/update

v1 Products and prices

POST /v1/products/prices

POST /v1/products/stocks

v2 Products and prices

POST /v2/product/import

POST /v2/product/info

POST /v2/product/info/stocks

POST /v2/products/delete

POST /v2/products/stocks

Orders and shipments

Orders on Ozon are split into shipments: even if the order contains one shipment, all actions will relate to the shipment, not the order.

You can split an order into multiple shipments yourself, for example, if the products cannot be stored together or if they are located in different warehouses. Learn more about how the delivery and packaging of orders works in Help Center.

To work with shipments via the API, add products, wait for moderation, and update the stock. All new orders create shipments with the status "awaiting_packaging".

List of methods

FBS

POST /v2/posting/fbs/act/check-status

POST /v2/posting/fbs/act/create

POST /v2/posting/fbs/act/get-container-labels

POST /v2/posting/fbs/act/get-pdf

POST /v2/posting/fbs/arbitration

POST /v2/posting/fbs/awaiting-delivery

POST /v2/posting/fbs/cancel

POST /v2/posting/fbs/cancel-reason/list

POST /v2/posting/fbs/get

POST /v2/posting/fbs/get-by-barcode

POST /v2/posting/fbs/package-label

POST /v2/posting/fbs/product/mandatory-mark/is-required

POST /v2/posting/fbs/product/mandatory-mark/validate

POST /v2/posting/fbs/ship

Shipment details

POST /v3/posting/fbs/get

POST /v3/posting/fbs/list

POST /v3/posting/fbs/unfulfilled/list

Shipment status and tracking numbers

POST /v2/fbs/posting/delivered

Change status to "Delivered".

POST /v2/fbs/posting/delivering

Change status to "In Transit".

POST /v2/fbs/posting/last-mile

Change status to "Courier is on the way".

POST /v2/fbs/posting/tracking-number/set

Assign tracking numbers to shipments.

Seller API methods

Here is a detailed description of the parameters, and sample requests and responses for the methods of the Ozon Seller API. Note that there is a v2/ (updated version) for some methods. We recommend switching to it so that everything works as intended.

We inform you about all important changes by e-mail, which you specified in your account.

If you have any questions or ideas, contact us.

Пропуск на склад для водителя

/create

POST /pass/create

Создать пропуск для водителя. Укажите контактные данные водителя, дату и время отгрузки. Памятка для водителей. Swagger


Параметры запроса

car_model * string

Модель автомобиля.

car_number * string

Номер автомобиля.

driver_name * string

Имя водителя.

driver_patronymic string

Отчество водителя.

driver_surname * string

Фамилия водителя

end_unloading_time string

Время окончания отгрузки.

is_regular_pass boolean

True, если пропуск регулярный.

start_unloading_time * string

Время начала отгрузки.

telephone string

Контактный номер телефона водителя.

trailer_number string

Номер прицепа.

unload_date * string

Дата отгрузки.


Параметры ответа


pass_id integer

Идентификатор созданного пропуска.

POST /pass/create HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "car_model": "string",
  "car_number": "string",
  "driver_name": "string",
  "driver_patronymic": "string",
  "driver_surname": "string",
  "end_unloading_time": "string",
  "is_regular_pass": true,
  "start_unloading_time": "string",
  "telephone": "string",
  "trailer_number": "string",
  "unload_date": "string"
}
Response status  200 
{
  "pass_id": 0
}

/get/last

POST /pass/get/last

Получить данные последнего созданного пропуска. Swagger


Параметры ответа


car_model string

Модель автомобиля.

car_number string

Номер автомобиля.

driver_name string

Имя водителя.

driver_patronymic string

Отчество водителя.

driver_surname string

Фамилия водителя

end_unloading_time string

Время окончания отгрузки.

is_regular_pass boolean

True, если пропуск регулярный.

start_unloading_time string

Время начала отгрузки.

telephone string

Контактный номер телефона водителя.

trailer_number string

Номер прицепа.

unload_date string

Дата отгрузки.

POST /pass/get/last HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status  200 
{
  "car_model": "string",
  "car_number": "string",
  "company_id": 0,
  "driver_name": "string",
  "driver_patronymic": "string",
  "driver_surname": "string",
  "end_unloading_time": "string",
  "is_blocked": true,
  "is_regular": true,
  "start_unloading_time": "string",
  "telephone": "string",
  "trailer_number": "string",
  "unload_date": "string"
}

/update

POST /pass/update

Изменить данные пропуска. Swagger


Параметры запроса

car_model * string

Модель автомобиля.

car_number * string

Номер автомобиля.

driver_name * string

Имя водителя.

driver_patronymic string

Отчество водителя.

driver_surname * string

Фамилия водителя

end_unloading_time string

Время окончания отгрузки.

pass_id * integer

Идентификатор пропуска.

is_regular_pass boolean

True, если пропуск регулярный.

start_unloading_time * string

Время начала отгрузки.

telephone string

Контактный номер телефона водителя.

trailer_number string

Номер прицепа.

unload_date * string

Дата отгрузки.


Параметры ответа


result boolean

True, если запрос выполнен без ошибок.

POST /pass/update HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "car_model": "string",
  "car_number": "string",
  "driver_name": "string",
  "driver_patronymic": "string",
  "driver_surname": "string",
  "end_unloading_time": "string",
  "is_regular_pass": true,
  "start_unloading_time": "string",
  "telephone": "string",
  "trailer_number": "string",
  "unload_date": "string"
}
Response status  200 
{
  "result": true
}

Список складов

Попробовать через Swagger

/warehouse/list

POST /v1/warehouse/list

Выводит список складов. В запросе не нужно указывать параметры. Ваша компания будет определена по Client-ID.


Параметры ответа


warehouse_id integer

Идентификатор склада.

name string

Название склада.

is_rfbs boolean

True, если склад создан для схемы работы «Доставка по выбору продавца».

POST /v1/warehouse/list HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status  200 
{
  "result": [
    {
      "warehouse_id": int64,
      "name": "string",
      "is_rfbs": true
    }
  ]
}

List of warehouses

Try it out in Swagger

/warehouse/list

POST /v1/warehouse/list

Returns a list of your warehouses. No parameters. Your company is identified by the Client-ID.


Параметры ответа


name string

Warehouse name.

is_rfbs boolean

True, if the warehouse is created for the "Delivery at the seller's choice" scheme of work.

POST /v1/warehouse/list HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status  200 
{
  "result": [
    {
      "warehouse_id": int64,
      "name": "string",
      "is_rfbs": true
    }
  ]
}

/v1

Партнер может продвигать товары с помощью участия в акциях, которые Ozon регулярно проводит для покупателей. Добавить товары в акцию можно в личном кабинете, через XLS-шаблон или с помощью методов Seller API. Подробнее о типах акций в Помощи для партнеров.

Список акций

GET /v1/actions

Возвращает список акций, доступных для партнера.


Параметры ответа


action_id integer

Идентификатор акции.

title integer

Название акции.

date_start string

Название акции.

date_end string

Дата окончания акции.

potential_products_count integer

Количество товаров, доступных для акции.

is_participating boolean

Участие партнера в акции.

participating_products_count integer

Количество товаров, участвующих в акции.

banned_products_count integer

Количество заблокированных товаров.

with_targeting boolean

Акция с целевой аудиторией.

GET /v1/actions HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Response status  200 
{
  "result": [
    {
      "action_id": 2328,
      "title": "акция пагинация",
      "date_start": "2020-01-21T13:30:06Z",
      "date_end": "2020-01-30T21:00:00Z",
      "potential_products_count": 3,
      "is_participating": false,
      "participating_products_count": 0,
      "action_type": "DISCOUNT",
      "banned_products_count": 1,
      "with_targeting": false
    }
  ]
}

Список товаров, доступных для акции

POST /v1/actions/candidates

Возвращает список товаров, доступных для акции, по ее идентификатору.


Параметры запроса

limit integer

Количество ответов на странице. По умолчанию 100.

offset integer

Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.


Параметры ответа


products object

Список товаров, доступных для акции.

product_id integer

Идентификатор товара.

price2 out.float

Текущая цена товара без скидки.

action_price out.float

Цена товара по акции.

max_action_price out.float

Максимально возможная цена товара по акции.

total integer

Количество товаров, доступных для акции.

POST /v1/actions/candidates HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "action_id": 2422,
  "limit": 1,
  "offset": 0
}
Response status  200 
{
  "result": {
    "products": [
      {
        "product_id": 15323889,
        "price": 1100,
        "action_price": 1100,
        "max_action_price": 1100
      }
    ],
    "total": 1
  }
}

Список товаров, участвующих в акции

POST /v1/actions/products

Возвращает список товаров, доступных для акции, по ее идентификатору.


Параметры запроса

limit integer

Количество ответов на странице. По умолчанию 100.

offset integer

Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.


Параметры ответа


products object

Список товаров, доступных для акции.

product_id integer

Идентификатор товара.

price2 out.float

Текущая цена товара без скидки.

action_price out.float

Цена товара по акции.

max_action_price out.float

Максимально возможная цена товара по акции.

total integer

Количество товаров, доступных для акции.

POST /v1/actions/products HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "action_id": 2422,
  "limit": 1,
  "offset": 0
}
Response status  200 
{
  "result": {
    "products": [
      {
        "product_id": 15323889,
        "price": 1100,
        "action_price": 1100,
        "max_action_price": 1100
      }
    ],
    "total": 1
  }
}

Добавить товар в акцию

POST /v1/actions/products/activate

Позволяет добавить указанные товары в доступную для партнера акцию.


Параметры запроса


Параметры ответа


product_ids array

Список идентификаторов товаров, добавленных в акцию.

POST /v1/actions/products/activate HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "action_id": 2422,
  "products": [
    {
      "product_id": 15323889,
      "action_price": 931.00
    }
  ]
}
Response status  200 
{
  "result": {
    "product_ids": [
      15323889
    ]
  }
}

Удалить товар из акции

POST /v1/actions/products/deactivate

Позволяет удалить указанные товары из акции.


Параметры запроса


Параметры ответа


product_ids array

Список идентификаторов товаров, удаленных из акции.

POST /v1/actions/products/deactivate HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "action_id": 2422,
  "product_ids": [
    15323889
  ]
}
Response status  200 
{
  "result": {
    "product_ids": [
      15323889
    ]
  }
}

Список методов склада

Попробовать через Swagger

/list

POST /v1/delivery-method/list

Возвращает список методов склада.


Параметры запроса

filter object

Фильтр для поиска методов доставки.

warehouse_id integer

Идентификатор склада.

provider_id integer

Идентификатор службы доставки.

status string

Статус метода доставки:
- «NEW» (Создан),
- «EDITED» (Редактируется),
- «ACTIVE» (Активный),
- «DISABLED» (Неактивный).

limit integer

Количество элементов в ответе. Максимум — 50, минимум — 1.

offset integer

Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.


Параметры ответа


has_next boolean

True, если нужно сделать повторный запрос с новым параметром offset. Это нужно для получения остальных методов.
False, если были возвращены все методы доставки по запросу.

result object

Результат запроса.

company_id integer

Идентификатор продавца.

created_at datetime

Дата и время создания метода доставки.

cutoff string

Время до которого продавцу нужно собрать заказ.

id integer

Идентификатор метода доставки.

name string

Название метода доставки.

provider_id integer

Идентификатор службы доставки.

status string

Статус метода доставки:
- «NEW» (Создан),
- «EDITED» (Редактируется),
- «ACTIVE» (Активный),
- «DISABLED» (Неактивный).

template_id integer

Идентификатор услуги по доставке заказа.

updated_at datetime

Дата и время последнего обновления метода метода доставки.

warehouse_id integer

Идентификатор склада.

POST /v1/delivery-method/list HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "filter": {
    "provider_id": 0,
    "status": "string",
    "warehouse_id": 0
  },
  "limit": 0,
  "offset": 0
}
Response status  200 
{
  "has_next": true,
  "result": [
    {
      "company_id": 0,
      "created_at": "2021-02-25T08:39:26.514Z",
      "cutoff": "string",
      "id": 0,
      "name": "string",
      "provider_id": 0,
      "status": "string",
      "template_id": 0,
      "updated_at": "2021-02-25T08:39:26.514Z",
      "warehouse_id": 0
    }
  ]
}

List of delivery methods for a warehouse

Try it out in Swagger

/list

POST /v1/delivery-method/list

Returns a list of delivery methods for your warehouse.


Параметры запроса

filter object

Search filter for delivery methods.

provider_id integer

Delivery service ID.

status string

Delivery method status:
- «NEW»
- «EDITED»
- «ACTIVE»
- «DISABLED»

limit integer

Number of items in a response. Maximum — 50, minimum — 1.

offset integer

Number of omitted items in a response. For example, if the value of offset is 10, the response starts from the 11th item.


Параметры ответа


has_next boolean

True, if you need to make a request with a new offset parameter value. You need this to get the rest of delivery methods.
False, if all delivery methods are returned.

POST /v1/delivery-method/list HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "filter": {
    "provider_id": 0,
    "status": "string",
    "warehouse_id": 0
  },
  "limit": 0,
  "offset": 0
}
Response status  200 
{
  "has_next": true,
  "result": [
    {
      "company_id": 0,
      "created_at": "2021-02-25T08:39:26.514Z",
      "cutoff": "string",
      "id": 0,
      "name": "string",
      "provider_id": 0,
      "status": "string",
      "template_id": 0,
      "updated_at": "2021-02-25T08:39:26.514Z",
      "warehouse_id": 0
    }
  ]
}

Данные аналитики

/data

POST /v1/analytics/data

Swagger


Параметры запроса

date_from datetime

Дата, с которой будут данные в отчете.

date_to datetime

Дата, до которой будут данные в отчете.

dimension string

Группировка данных в отчете.
sku— идентификатор товара,brand— бренд,
modelID— модель,
category1— категория первого уровня,
category2— категория второго уровня,
category3— категория третьего уровня,
day— день.

filters object

key string

Параметр сортировки — metrics или dimensions.

op string

Операция сравнения EQ — равно, GTE — больше или равно, GT — больше, LT — меньше, LTE — меньше или равно.

value number

Значение для сравнения.

limit integer

Количество отправлений в ответе. Максимум — 50, минимум — 1.

metrics string

Массив метрик, по которым будет сформирован отчет.
session_view_search— Сессии с показом в поиске или в категории
session_view— Сессии, всего
session_view_pdp— Сессии с показом на карточке товара
adv_view_pdp— Показы на карточке товара, спонсорские товары
position_category— Позиция в поиске и категории
adv_view_all— Показы всего, спонсорские товары
adv_view_search_category— Показы в поиске и в категории, спонсорские товары
hits_view— Показы, всего
hits_view_pdp— Показы на карточке товара
hits_view_search— Показы в поиске и в категории
hits_tocart— В корзину, всего
hits_tocart_pdp— В корзину из карточки товара
hits_tocart_search— В корзину из поиска или категории
conv_tocart— Конверсия в корзину, общая
conv_tocart_pdp— Конверсия в корзину из карточки товара
conv_tocart_search— Конверсия в корзину из поиска или категории
ordered_units— Заказано товаров
cancellations— Отменено товаров
delivered_units— Доставлено товаров
returns— Возвращено товаров
adv_sum_all— Расходы на рекламу, всего
postings_premium— Отправления с премиум-подпиской
revenue— Заказано на сумму
postings— Отправления

offset integer

Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.

sort object

Настройки сортировки отчета.

key string

Метрика, по которой будет отсортирован результат запроса.

order string

ASC— по убыванию,
DESC— по возрастанию.


Параметры ответа


data object

dimensions string

Группировка данных в отчете.
sku— идентификатор товара,brand— бренд,
modelID— модель,
category1— категория первого уровня,
category2— категория второго уровня,
category3— категория третьего уровня,
day— день.

metrics number

Список значений метрики.

totals integer

Итоговые и средние значения метрик.

timestamp string

Время создания отчета.

POST /v1/analytics/data HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "date_from": "string",
  "date_to": "string",
  "dimension": [
    "string"
  ],
  "filters": [
    {
      "key": "string",
      "op": "EQ",
      "value": "string"
    }
  ],
  "limit": 0,
  "metrics": [
    "string"
  ],
  "offset": 0,
  "sort": [
    {
      "key": "string",
      "order": "ASC"
    }
  ]
}
Response status  200 
{
  "result": {
    "data": [
      {
        "dimensions": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "metrics": [
          0
        ]
      }
    ],
    "totals": [
      0
    ]
  },
  "timestamp": "string"
}

/stock_on_warehouses

POST /v1/analytics/stock_on_warehouses

Отчет по остаткам и товарам в перемещении по складам Ozon. Swagger


Параметры запроса

limit integer

Количество ответов на странице. По умолчанию 100.

offset integer

Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.


Параметры ответа


timestamp string

Время создания отчета.

total_items object

Данные по остаткам на всех складах.

barcode string

Штрихкод.

category string

Категория.

discounted string

Уцененный товар (Да/Нет).

height integer

Высота упаковки.

length integer

Длина товара.

offer_id string

Идентификатор товара в системе продавца — артикул.

sku integer

Идентификатор товара на Ozon.

stock object

Информация об остатках товаров.

between_warehouses integer

Количество товаров, которое перемещается в текущее время между фулфилмент центрами.

for_sale integer

Количество товаров доступных для продажи.

loss integer

Количество товаров не найденных при подборе.

not_for_sale integer

Количество товаров не подлежащих реализации.

shipped integer

Количество товаров в доставке.

title string

Название товара.

volume integer

Объем товара.

weight integer

Вес товара в упаковке.

width integer

Ширина упаковки.

wh_items object

Данные остатков по определенным складам.

id integer

Новый идентификатор.

items object

Информация о товарах на складе.

barcode string

Штрихкод.

category string

Категория.

discounted string

Уцененный товар (Да/Нет).

height integer

Высота упаковки.

length integer

Длина товара.

offer_id string

Идентификатор товара в системе продавца — артикул.

sku integer

Идентификатор товара на Ozon.

stock object

Информация об остатках товаров.

title string

Название категории.

volume integer

Объем товара.

weight integer

Вес товара в упаковке.

width integer

Ширина упаковки.

name string

Название склада.

POST /v1/analytics/stock_on_warehouses HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "limit": 0,
  "offset": 0
}
Response status  200 
{
  "timestamp": "string",
  "total_items": [
    {
      "barcode": "string",
      "category": "string",
      "discounted": "string",
      "height": 0,
      "length": 0,
      "offer_id": "string",
      "sku": "string",
      "stock": {
        "between_warehouses": 0,
        "for_sale": 0,
        "loss": 0,
        "not_for_sale": 0,
        "shipped": 0
      },
      "title": "string",
      "volume": 0,
      "weight": 0,
      "width": 0
    }
  ],
  "wh_items": [
    {
      "id": "string",
      "items": [
        {
          "barcode": "string",
          "category": "string",
          "discounted": "string",
          "height": 0,
          "length": 0,
          "offer_id": "string",
          "sku": "string",
          "stock": {
            "for_sale": 0,
            "loss": 0,
            "not_for_sale": 0
          },
          "title": "string",
          "volume": 0,
          "weight": 0,
          "width": 0
        }
      ],
      "name": "string"
    }
  ]
}

Работа с брендом

/company-certification/list

POST /v1/brand/company-certification/list

Возвращает список брендов, для продажи которых небходимо загрузить подтверждающие документы. Подробнее о документах на бренды в Помощи.


Параметры запроса

page integer

Номер страницы, возвращаемой в запросе.

page_size integer

Количество элементов на странице.


Параметры ответа


brand_certification object

Cписок сертифицируемых брендов.

brand_id integer

Идентификатор бренда.

brand_name string

Название бренда.

has_certificate boolean

True, если есть документы на бренд.

total integer

Количество брендов в списке.

POST /v1/brand/company-certification/list HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "page": 1,
  "page_size": 2
}
Response status  200 
{
  "result": {
    "brand_certification": [
      {
        "brand_id": 19709360,
        "brand_name": "Select",
        "has_certificate": false
      },
      {
        "brand_id": 78055689,
        "brand_name": "Start Line",
        "has_certificate": false
      }
    ],
    "total": 2
  }
}

Категории товаров

Попробовать через Swagger

/tree

GET /v1/categories/tree

Возвращает категории для товаров в виде дерева. Создание товаров доступно только в категориях последнего уровня, соответственно вам необходимо сопоставить именно эти категории с категориями своей площадки. Категории не создаются по запросу пользователя.


Параметры ответа


category_id integer

Идентификатор категории.

children array

Дерево подкатегорий.

title string

Название категории.

GET /v1/categories/tree/ HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Response status  200 
{
  "result": [
    {
      "category_id": 0,
      "children": [
        null
      ],
      "title": "string"
    }
  ]
}

/tree/[categoryId]

GET /v1/categories/tree/[categoryId]

Возвращает дерево вложенных категории по иденификатору родительской.


Параметры ответа


category_id integer

Идентификатор категории.

children array

Дерево подкатегорий.

title string

Название категории.

GET /v1/category/tree/[categoryId] HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Can not resolve examples/v1/categories/tree/categoryId/in.json
Response status  200 
Can not resolve examples/v1/category/tree/categoryId/out.json

/tree/[categoryId]/attributes

GET /v1/categories/tree/[categoryId]/attributes


Параметры ответа


child array

Массив дочерних характеристик. Структура дочерней и родительской характеристики должна совпадать.

id integer

Номер задания на формирование документов.

is_collection boolean

Флаг, что характеристика — набор значений.

is_required boolean

Флаг обязательной характеристики.

name string

Название.

option array

Массив предустановленных значений характеристики.

GET /v1/categories/tree/[categoryId]/attributes HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Can not resolve examples/v1/categories/tree/categoryId/attributes/in.json
Response status  200 
Can not resolve examples/v1/categories/tree/categoryId/attributes/out.json

Product categories

Try it out in Swagger

/tree

GET /v1/categories/tree

Returns categories for products in a tree view. Creating products is only available in the last level categories, so you need to match these categories with your categories. Categories are not created at the user's request.


Параметры ответа


children array

Subcategory tree.

title string

Category name.

GET /v1/categories/tree/ HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Response status  200 
{
  "result": [
    {
      "category_id": 0,
      "children": [
        null
      ],
      "title": "string"
    }
  ]
}

/tree/[categoryId]

GET /v1/categories/tree/[categoryId]

Returns a tree of nested categories by the ID of the parent category.


Параметры ответа


children array

Subcategory tree.

title string

Category name.

GET /v1/category/tree/[categoryId] HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Can not resolve examples/v1/categories/tree/categoryId/in.json
Response status  200 
Can not resolve examples/v1/category/tree/categoryId/out.json

/tree/[categoryId]/attributes

GET /v1/categories/tree/[categoryId]/attributes


Параметры ответа


child array

Array of child characteristics. The structure of the child and parent characteristics must match.

id integer

The number of the task for generating documents.

is_collection boolean

True if the characteristic is a number of values.

is_required boolean

True if the characteristic is required.

option array

Array of preset characteristic values.

GET /v1/categories/tree/[categoryId]/attributes HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Can not resolve examples/v1/categories/tree/categoryId/attributes/in.json
Response status  200 
Can not resolve examples/v1/categories/tree/categoryId/attributes/out.json

/v1/category

/attribute

POST /v1/category/attribute

Получение характеристик для указанной категории товаров.

Характеристики бывают нескольких типов, в зависимости от типа меняется способ заполнения значения.

Встречаются характеристики, где нет важного значения, например для шапки нельзя указать пол: унисекс, необходимо указать два значения пол: мужской, женский.

Существуют системные характеристики, которые не отображаются пользователю, но нужны для объединения товаров в одну группу. Например, характеристика "Название модели" в категориях "Одежда", "Обувь".


Параметры запроса

attribute_type string

Фильтр по характеристикам

  • required — обязательная,
  • optional — дополнительная.

    category_id * integer

    Идентификатор категории.

    language string

    Язык в ответе: EN — английский, RU — русский. По умолчанию используется русский язык.


    Параметры ответа


    child object

    Массив дочерних характеристик. Структура дочерней и родительской характеристики должна совпадать.

    description string

    Описание характеристики.

    id integer

    Идентификатор характеристики.

    is_collection boolean

    Флаг, что характеристика — набор значений.

    is_required boolean

    Флаг обязательной характеристики.

    name string

    Название.

    option object

    Массив предустановленных значений характеристики.

    id integer

    Идентификатор предустановленного значения характеристики.

    value string

    Текст для предустановленного значения характеристики.

    type string

    Тип характеристики

    description string

    Описание характеристики.

    id integer

    Идентификатор характеристики.

    is_collection boolean

    Флаг обязательной характеристики.

    is_required boolean

    Флаг обязательной характеристики.

    name string

    Название.

    option object

    Массив предустановленных значений характеристики.

    id integer

    Идентификатор предустановленного значения характеристики.

    value string

    Текст для предустановленного значения характеристики.

    type string

    Тип характеристики

    POST /v1/category/attribute HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "attribute_type": "ALL",
      "category_id": 0,
      "language": "DEFAULT"
    }
    Response status  200 
    {
      "result": [
        {
          "child": [
            {
              "description": "string",
              "id": 0,
              "is_collection": true,
              "is_required": true,
              "name": "string",
              "option": [
                {
                  "id": 0,
                  "value": "string"
                }
              ],
              "type": "string"
            }
          ],
          "description": "string",
          "id": 0,
          "is_collection": true,
          "is_required": true,
          "name": "string",
          "option": [
            {
              "id": 0,
              "value": "string"
            }
          ],
          "type": "string"
        }
      ]
    }

    /tree

    POST /v1/category/tree

    Возвращает категории для товаров в виде дерева. Создание товаров доступно только в категориях последнего уровня, соответственно вам необходимо сопоставить именно эти категории с категориями своей площадки. Категории не создаются по запросу пользователя.

    Чтобы получить полное дерево, можно использовать запрос GET /v1/categories/tree. Для GET-запроса не нужны входные параметры.


    Параметры запроса

    category_id * integer

    Идентификатор категории.

    language string

    Язык в ответе: EN — английский, RU — русский. По умолчанию используется русский язык.


    Параметры ответа


    result array

    Список категорий.

    category_id integer

    Идентификатор категории.

    children array

    Дерево подкатегорий.

    title string

    Название категории.

    POST /v1/category/tree HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "category_id": 17036076,
      "language": "EN"
    }
    
    Response status  200 
    {
      "result": [
        {
          "category_id": 0,
          "children": [
            null
          ],
          "title": "string"
        }
      ]
    }

    v1 Characteristics and categories

    /tree

    POST /v1/category/tree

    Returns categories for products in a tree view. Creating products is only available in the last level categories, so you need to match these categories with your categories. Categories are not created at the user's request.

    To get the full tree, you can use the GET /v1/categories/tree request. The GET request does not need any input parameters.


    Параметры запроса

    language string

    The language in the response: EN — English, RU — Russian. The default language is Russian.


    Параметры ответа


    result array

    List of categories.

    children array

    Subcategory tree.

    title string

    Category name.

    POST /v1/category/tree HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "category_id": 17036076,
      "language": "EN"
    }
    
    Response status  200 
    {
      "result": [
        {
          "category_id": 0,
          "children": [
            null
          ],
          "title": "string"
        }
      ]
    }

    /v2​/category​

    Группа методов для работы с категориями товаров

    /attribute​

    POST /v2​/category​/attribute​


    Параметры запроса

    category_id * integer

    Идентификатор категории.

    attribute_type string

    Фильтр по характеристикам

    • required — обязательная,
    • optional — дополнительная.

      language string

      Язык в ответе: EN — английский, RU — русский. По умолчанию используется русский язык.


      Параметры ответа


      id integer

      Номер задания на формирование документов.

      name string

      Название.

      type string

      Тип характеристики

      is_collection boolean

      Флаг, что характеристика — набор значений.

      is_required boolean

      Флаг обязательной характеристики.

      group_id integer

      Идентификатор группы характеристик.

      group_name string

      Название группы характеристик.

      dictionary_id integer

      Идентификатор справочника.

      POST /v2/category/attribute HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "attribute_type": "ALL",
        "category_id": 0,
        "language": "DEFAULT"
      }
      Response status  200 
      {
        "result": [
          {
            "description": "string",
            "dictionary_id": 0,
            "group_id": 0,
            "group_name": "string",
            "id": 0,
            "is_collection": true,
            "is_required": true,
            "name": "string",
            "type": "string"
          }
        ]
      }

      /attribute/value/by-option

      POST /v2​/category​/attribute/value/by-option

      Идентификаторы справочников и характеристик могут обновляться — чтобы узнать новое значение, укажите в запросе старый идентификатор.


      Параметры запроса

      language string

      Язык в ответе: EN — английский, RU — русский. По умолчанию используется русский язык.

      options object

      Массив идентификаторов.

      attribute_id integer

      Старый идентификатор характеристики.

      option_id integer

      Старый идентификатор справочника.


      Параметры ответа


      attribute_id integer

      Старый идентификатор характеристики.

      id integer

      Новый идентификатор.

      option_id integer

      Старый идентификатор справочника.

      value string

      Значение характеристики товара.

      POST /v2/category/attribute/value/by-option HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      Can not resolve examples/v2/category/attribute/value/option/in.json
      Response status  200 
      Can not resolve examples/v2/category/attribute/value/option/out.json

      /attribute​/values

      POST /v2​/category​/attribute​/values


      Параметры запроса

      category_id * integer

      Идентификатор категории.

      limit * integer

      Количество отправлений в ответе. Максимум — 50, минимум — 1.

      language string

      Язык в ответе: EN — английский, RU — русский. По умолчанию используется русский язык.

      POST /v2/category/attribute HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      Can not resolve examples/v2/category/attribute/value

      v2 Characteristics and categories

      A group of methods for working with product categories

      /attribute​

      POST /v2​/category​/attribute​


      Параметры запроса

      attribute_type string

      Characteristics types:

      • required
      • optional

        language string

        The language in the response: EN — English, RU — Russian. The default language is Russian.


        Параметры ответа


        id integer

        The number of the task for generating documents.

        is_collection boolean

        True if the characteristic is a number of values.

        is_required boolean

        True if the characteristic is required.

        group_id integer

        Идентификатор группы характеристик.

        group_name string

        Название группы характеристик.

        dictionary_id integer

        Идентификатор справочника.

        POST /v2/category/attribute HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "attribute_type": "ALL",
          "category_id": 0,
          "language": "DEFAULT"
        }
        Response status  200 
        {
          "result": [
            {
              "description": "string",
              "dictionary_id": 0,
              "group_id": 0,
              "group_name": "string",
              "id": 0,
              "is_collection": true,
              "is_required": true,
              "name": "string",
              "type": "string"
            }
          ]
        }

        /attribute​/values

        POST /v2​/category​/attribute​/values


        Параметры запроса

        limit * integer

        Number of shipments in a response. Maximum — 50, minimum — 1.

        language string

        The language in the response: EN — English, RU — Russian. The default language is Russian.


        Параметры ответа


        id integer

        The number of the task for generating documents.

        value string

        Значение характеристики товара.

        POST /v2/category/attribute HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        Can not resolve examples/v2/category/attribute/values/in.json
        Response status  200 
        Can not resolve examples/v2/category/attribute/values/out.json

        /attribute​/values

        POST /v2​/category​/attribute​/values


        Параметры запроса

        options object

        Массив идентификаторов.

        attribute_id integer

        Старый идентификатор характеристики.

        option_id integer

        Старый идентификатор справочника.

        language string

        The language in the response: EN — English, RU — Russian. The default language is Russian.


        Параметры ответа


        id integer

        The number of the task for generating documents.

        option_id integer

        ID of the preset value of the characteristic.

        attribute_id integer

        Идентификатор характеристики.

        value string

        Text for the preset value of the characteristic.

        POST /v2/category/attribute/value/by-option HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        Can not resolve examples/v2/category/attribute/value/by-option/in.json
        Response status  200 
        Can not resolve examples/v2/category/attribute/value/by-option/out.json

        Чат с покупателями

        Попробовать через Swagger

        /list

        POST /v1/chat/list

        Возвращает информацию о чатах с указанными идентификаторами.


        Параметры запроса

        chat_id_list string

        Массив с идентификаторами чатов, для которых нужно вывести информацию.

        page integer

        Количество страниц в ответе.

        page_size integer

        Количество заказов на странице. Значение по умолчанию: 100. Максимальное значение: 1000.


        Параметры ответа


        id string

        Идентификатор чата.

        last_message_id string

        Идентификатор последнего сообщения в чате.

        users object

        Cписок участников чата.

        id string

        Идентификатор участника чата.

        type string

        Тип участника чата:
        - customer — покупатель,
        - seller — продавец,
        - crm — системные сообщения,
        - courier — курьер.

        POST /v1/chat/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "chat_id_list": [
            "string"
          ],
          "page": 0,
          "page_size": 0
        }
        Response status  200 
        {
          "result": [
            {
              "id": "string",
              "last_message_id": "string",
              "users": [
                {
                  "id": "string",
                  "type": "string"
                }
              ]
            }
          ]
        }

        /history

        POST /v1/chat/history

        Возвращает историю сообщений в чате.

        По умолчанию сообщения показываются от старого к новому. Чтобы получить историю сообщений от самого нового сообщения до самого старого, используйте метод /v1/chat/updates. У методов /v1/chat/history и /v1/chat/updates одинаковая структура запроса и ответа.


        Параметры запроса

        chat_id string

        Идентификатор чата.

        from_message_id string

        Идентификатор сообщения, с которого начать вывод истории чата.

        limit integer

        Количество сообщений в ответе.


        Параметры ответа


        context object

        Заказ или отдельный товар, о котором пользователь написал в чат.

        order object

        Информация о заказе.

        order_number string

        Номер заказа, к которому относится отправление.

        postings object

        Информация об отправлении.

        delivery_schema string

        Схема доставки заказа:
        - fbs — доставка со склада продавца,
        - crossborder — доставка из-за рубежа.

        posting_number string

        Номер отправления.

        sku_list array

        Список идентификаторов товаров в отправлении.

        created_at datetime

        Дата и время создания сообщения.

        file object

        Информация о файле в чате. Отображается только для сообщений с параметром type = file.

        mime string

        Тип файла. Список и примеры допустимых значений на github.

        name string

        Название файла.

        size integer

        Размер файла в байтах.

        url string

        URL файла.

        text string

        Сообщение, только для type: text.

        type string

        Тип сообщения:
        - text — текст,
        - file — файл.

        user array

        Информация об авторе сообщения.

        POST /v1/chat/history/ HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "chat_id": "3cdf5407-9f90-4752-8105-8f1d4cd427f5",
          "from_message_id": "986714",
          "limit": 10
        }
        Response status  200 
        {
          "result": [
            {
              "context": {
                "item": {
                  "sku": 0
                },
                "order": {
                  "order_number": "123456-0001",
                  "postings": [
                    {
                      "delivery_schema": "fbs",
                      "posting_number": "13076543-0001-1",
                      "sku_list": [
                        149512345
                      ]
                    }
                  ]
                }
              },
              "created_at": "2019-11-25T10:43:06.518Z",
              "file": {
                "mime": "image/jpeg",
                "name": "32679625.jpg",
                "size": 815313,
                "url": "http://api-seller.ozon.ru/v1/chat/file/3cdf5407-9f90-4752-8105-8f1d4cd427f563f87e6da3651007ab96185f38772032b3918e31.jpg",
              },
              "id": "1931356687558511593",
              "text": "hello",
              "type": "file",
              "user": {
                "id": "30735682",
                "type": "customer"
              }
            }
          ]
        }

        /send/file

        POST /v1/chat/send/file

        Отправляет файл в существующий чат по его идентификатору.


        Параметры запроса

        base64_content string

        Файл в виде строки base64.

        chat_id string

        Идентификатор чата.

        name string

        Название файла с расширением.


        Параметры ответа


        result string

        Результат обработки запроса.

        POST /v1/chat/send/file HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "base64_content": "string",
          "chat_id": "string",
          "name": "string"
        }
        Response status  200 
        {
          "result": "string"
        }

        /send/message

        POST /v1/chat/send/message

        Отправляет сообщение в существующий чат по его идентификатору.


        Параметры запроса

        chat_id string

        Идентификатор чата.

        text string

        Текст сообщения в формате plain text.


        Параметры ответа


        result string

        Результат обработки запроса.

        POST /v1/chat/send/message HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "chat_id": "string",
          "text": "string"
        }
        Response status  200 
        {
          "result": "string"
        }

        /start

        POST /v1/chat/start

        Создает новый чат с покупателем по отправлению. Например, чтобы уточнить адрес или модель товара.


        Параметры запроса

        posting_number string

        Идентификатор отправления.


        Параметры ответа


        chat_id string

        Идентификатор чата.

        POST /v1/chat/start HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number": "string"
        }
        Response status  200 
        {
          "result": {
            "chat_id": "string"
          }
        }

        Работа с товарами

        /archive

        POST /v1/product/archive

        Перенести товар в архив. Swagger


        Параметры запроса

        product_id * integer

        Идентификатор товара.


        Параметры ответа


        result boolean

        Результат обработки запроса. True, если запрос выполнился без ошибок.

        POST /v1/product/archive HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "product_id": [
            14929,
            244206,
            458202,
            710646
          ]
        }
        Response status  200 
        {
          "result": true
        }

        /certificate/accordance-types

        GET /v1/product/certificate/accordance-types

        Cправочник типов соответствия требованиям. Swagger


        Параметры ответа


        result object

        Список типов и названий сертификатов.

        name string

        Название документа.

        value string

        Значение справочника.

        POST /v1/product/certificate/accordance-types HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {}
        Response status  200 
        Can not resolve examples/v1/product/certificate/accordance-type/out.json

        /certificate/bind

        POST /v1/product/certificate/bind

        Привязать сертификат к товару. Swagger


        Параметры запроса

        certificate_id integer

        Идентификатор сертификата, который был присвоен при его загрузке.

        item_id integer

        Массив идентификаторов товаров, к которым относится этот сертификат.


        Параметры ответа


        result boolean

        True, если запрос выполнен без ошибок.

        POST /v1/product/certificate/bind HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "certificate_id": 0,
          "item_id": [
            0
          ]
        }

        /certificate/create

        POST /v1/product/certificate/create

        Метод добавления сертификатов для товаров. Swagger


        Параметры запроса

        files * array

        Массив сертификатов для товара. Допустимые расширения jpg, jpeg, png, pdf.

        name * string

        Название сертификата. Максимум 100 символов.

        number * string

        Номер сертификата. Максимум 100 символов.

        type_code * string

        Тип сертификата. Список типов можно получить методом GET /v1/product/certificate/types.

        accordance_type_code * string

        Тип соответствия требованиям. Список типов можно получить методом GET /v1/product/certificate/accordance-types.

        issue_date * datetime

        Дата начала действия сертификата.

        expire_date datetime

        Дата окончания действия сертификата. Может быть пустым для бессрочных сертификатов.


        Параметры ответа


        id integer

        Идентификатор загруженного сертификата.

        POST /v1/product/certificate/create HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {}
        Response status  200 
        {
          "id": 123
        }

        /certificate/types

        GET /v1/product/certificate/types

        Справочник типов документов. Swagger


        Параметры ответа


        result object

        Список типов и названий сертификатов.

        name string

        Название документа.

        value string

        Значение справочника.

        POST /v1/product/certificate/types HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {}
        Response status  200 
        {
          "result": [
            {
              "name": "string",
              "value": "string"
            }
          ]
        }

        /import

        POST /v1/product/import

        Позволяет создавать и обновлять товары. За один запрос можно создать до 1000 позиций. Обновление товаров через этот метод ставит товары в очередь на повторную модерацию, поэтому данный метод лучше использовать только для обновления отдельных полей у товаров.

        Обратите внимание, что также можно создавать групповую карточку товара с несколькими цветами и размерами в категориях: "Одежда", "Обувь" Для того чтобы создать карточку товара с несколькими цветами/размерами, необходимо заполнить характеристику "Название модели" (8292). Товары одной модели, разных размеров и цветов должны иметь одинаковое значение в характеристике 8292. Например, есть товар двух цветов (черный, белый) и 3 размеров (40, 42, 43). У всех этих товаров должно быть одинаковое значение характеристики 8292. Все продукты с одинаковыми характеристиками 8292 будут отображаться в одной товарной карточке.


        Параметры запроса

        attributes object

        Массив характеристик товара. Чтобы узнать какие характеристики есть у категории товара, используйте метод [Список характеристик категории](https://docs.ozon.ru/api/seller#/v2%E2%80%8B/category%E2%80%8B/attribute%E2%80%8B).

        collection array

        Массив значений характеристики. Например, характеристика Цвет может принимать два значения

        complex object

        Массив характеристик, которые поддерживают вложенные свойства. Например, у характеристики Процессор есть вложенные характеристики Производитель, L2 Cache, и другие. У каждой из вложенных характеристик может быть несколько вариантов значений.

        id integer

        Идентификатор характеристики.

        value string

        Значение характеристики.

        complex_collection object

        Массив характеристик с одинаковым названием, но разными значениями. Например, у CD диска с аудиокнигой может быть несколько характеристик Аудио дорожка, каждая из который будет иметь разные значения вложенных характеристик Длина дорожки, Битрейт и тому подобное.

        collection object

        Массив значений характеристики.

        id integer

        Идентификатор характеристики.

        value string

        Значение характеристики.

        barcode string

        Штрихкод товара.

        depth integer

        Глубина упаковки.

        description string

        Описание товара. Для переноса строки в описании используйте HTML-тег [br](https://www.w3schools.com/tags/tag_br.asp).

        dimension_unit string

        Единица измерения габаритов

        • mm — миллиметры,
        • cm — сантиметры,
        • in — дюймы.

        height integer

        Высота упаковки.

        name string

        Название товара. До 500 символов.

        offer_id string

        Идентификатор товара в системе продавца — артикул.

        old_price string

        Цена до скидок (будет зачеркнута на карточке товара). Указывается в рублях. Разделитель дробной части — точка, до двух знаков после точки.

        premium_price string

        Цена для клиентов с подпиской Ozon Premium.

        price string

        Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.

        vat string

        Ставка НДС для товара

        • 0 — не облагается НДС,
        • 0.1 — 10%,
        • 0.2 — 20%.

          vendor string

          Производитель товара. До 100 символов.

          vendor_code string

          Код производителя. До 100 символов.

          weight integer

          Вес товара в упаковке. Предельное значение — 1000 килограммов или конвертированная величина в других единицах измерения.

          weight_unit string

          Единицы измерения веса: g — граммы, kg — килограммы, lb — фунты.

          width integer

          Ширина упаковки.


          Параметры ответа


          task_id integer

          Код задачи на импорт товаров. Статус выполнения задачи можно получить, используя метод [Статус создания товара](https://docs.ozon.ru/api/seller#/v1/product/import/info).

          POST /v1/product/import HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "items": [
              {
                "attributes": [
                  {
                    "collection": [
                      "string"
                    ],
                    "complex": [
                      {
                        "id": 0,
                        "value": "string"
                      }
                    ],
                    "complex_collection": [
                      {
                        "collection": [
                          {
                            "id": 0,
                            "value": "string"
                          }
                        ]
                      }
                    ],
                    "id": 0,
                    "value": "string"
                  }
                ],
                "barcode": "string",
                "category_id": 0,
                "depth": 0,
                "description": "string",
                "dimension_unit": "string",
                "height": 0,
                "images": [
                  {
                    "default": true,
                    "file_name": "string"
                  }
                ],
                "name": "string",
                "offer_id": "string",
                "old_price": "string",
                "premium_price": "string",
                "price": "string",
                "vat": "string",
                "vendor": "string",
                "vendor_code": "string",
                "weight": 0,
                "weight_unit": "string",
                "width": 0
              }
            ]
          }
          Response status  200 
          {
            "result": {
              "task_id": 0
            }
          }

          /import/info

          POST /v1/product/import/info

          Позволяет получить статус создания карточки товара.


          Параметры запроса

          task_id integer

          Код задачи на импорт товаров.


          Параметры ответа


          items object

          Информация о товарах.

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          product_id integer

          Идентификатор товара.

          status string

          Статус создания товара. Информация о товаре обрабатывается очередями. Возможные значения параметра processing, moderating, processed, failed_moderation, failed_validation, failed. Актуальный статус обновления информации о товаре можно проверить методом

          total string

          Идентификатор товара в системе продавца.

          POST /v1/product/import/info HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "task_id": 0
          }
          Response status  200 
          {
            "result": {
              "items": [
                {
                  "offer_id": "string",
                  "product_id": 0,
                  "status": "string"
                }
              ],
              "total": 0
            }
          }

          Обновить цену

          POST /v1/product/import/prices

          Позволяет изменить цену одного или нескольких товаров. За один запрос можно изменить цены для 1000 товаров. Чтобы сбросить old_price или premium_price — поставьте 0 у этих параметров.


          Параметры запроса

          prices object

          Информация о ценах товаров.

          offer_id string

          Идентификатор товара в системе продавца.

          old_price string

          Цена до скидок (будет зачеркнута на карточке товара). Указывается в рублях. Разделитель дробной части — точка, до двух знаков после точки.

          premium_price string

          Цена для клиентов с подпиской Ozon Premium.

          price string

          Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.

          product_id integer

          Идентификатор товара.


          Параметры ответа


          errors object

          Массив ошибок, которые возникли при обработке запроса.

          code string

          Код ошибки.

          message string

          Причина ошибки.

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          product_id integer

          Идентификатор товара.

          updated boolean

          True, если информации о товаре успешно обновлена.

          POST /v1/product/import/prices HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "prices": [
              {
                "offer_id": "string",
                "old_price": "string",
                "premium_price": "string",
                "price": "string",
                "product_id": 0
              }
            ]
          }
          Response status  200 
          {
            "result": [
              {
                "errors": [
                  {
                    "code": "string",
                    "message": "string"
                  }
                ],
                "offer_id": "string",
                "product_id": 0,
                "updated": true
              }
            ]
          }

          Обновить остатки

          POST /v1/product/import/stocks

          Позволяет изменить информацию о количестве товара в наличии. За один запрос можно изменить наличие для 100 товаров. Задать наличие товару возможно только после того, как статус товара сменился на "processed"


          Параметры запроса

          stocks object

          Информация о товарах на складах.

          offer_id string

          Идентификатор товара в системе продавца.

          product_id integer

          Идентификатор товара.

          stock integer

          Количество товара в наличии.


          Параметры ответа


          errors object

          Информация об ошибках.

          message string

          Текст ошибки.

          code string

          Код ошибки: - OVER_MAX_OVH_KGT: Вес или габариты товара больше максимальных. Обновить количество не получится. [Информация в помощи.](https://seller-edu.ozon.ru/docs/fbs/upravlenie-ostatkami.html#возникла-ошибка)
          - OVER_MAX_OVH_NON_KGT: Вы не можете продавать крупногабаритные товары с этого склада. [Информация в помощи&](https://seller-edu.ozon.ru/docs/fbs/upravlenie-ostatkami.html#возникла-ошибка)
          - NON_KGT_ON_KGT_WAREHOUSE: Все ваши товары продаются как крупногабаритные, а вы хотите продавать обычный. Он попадет под условия продажи крупногабаритных. [Информация в помощи.](https://seller-edu.ozon.ru/docs/fbs/upravlenie-ostatkami.html#возникла-ошибка)
          - STOCK_TOO_BIG: Указано слишком большое количество, попробуйте уменьшить его.
          - INVALID_STATE: Товар не прошел все этапы создания, проверьте его статус.
          - CANNOT_CREATE_FBS_SKU: Произошла внутренняя ошибка при обновлении наличия, попробуйте еще раз.
          - NOT_FOUND: Не удалось найти указанный товар.

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          product_id integer

          Идентификатор товара.

          updated boolean

          True, если информации о товаре успешно обновлена.

          POST /v1/product/import/stocks HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "stocks": [
              {
                "offer_id": "string",
                "product_id": 0,
                "stock": 0
              }
            ]
          }
          Response status  200 
          {
            "result": [
              {
                "errors": [
                  {
                    "code": "string",
                    "message": "string"
                  }
                ],
                "offer_id": "string",
                "product_id": 0,
                "updated": true
              }
            ]
          }

          Информация о товаре

          POST /v1/product/info

          Позволяет получить информацию о товаре по идентификатору. С 01 марта можно пользоваться новой версией этого метода:POST​ /v2​/product​/info. Пожалуйста, перейдите на новую версию до 01 июня — потом мы отключим поддержку первой версии.


          Параметры запроса

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          product_id integer

          Идентификатор товара.

          sku integer

          Идентификатор товара в системе Ozon — SKU.


          Параметры ответа


          barcode string

          Штрихкод.

          buybox_price string

          Цена главного предложения на Ozon. Устаревший параметр, больше не используется.

          category_id integer

          Идентификатор категории.

          created_at string

          Дата и время создания товара.

          id integer

          Идентификатор характеристики товара.

          images array

          Массив url для изображений товара.

          marketing_price string

          Цена на товар с учетом всех акций. Это значение будет указано на витрине Ozon.

          min_ozon_price string

          Минимальная цена на аналогичный товар на Ozon.

          name string

          Название товара. До 500 символов.

          offer_id string

          Идентификатор товара в системе продавца.

          old_price string

          Цена до учета скидок, на карточке товара отображается зачеркнутой.

          premium_price string

          Цена для клиентов с подпиской Ozon Premium.

          price string

          Цена товара с учетом скидок — это значение показывается на карточке товара.

          recommended_price string

          Цена на товар, рекомендованная системой на основании схожих предложений.

          sku integer

          Идентификатор товара на Ozon.

          sources array

          Информация о SKU Ozon.

          state string

          Статус добваления товара с систему:
          - processing — информация о товаре добавляется в систему, ожидайте;
          - moderating — товар проходит модерацию, ожидайте;
          - processed — информация обновлена;
          - failed_moderation — товар не прошел модерацию;
          - failed_validation — товар не прошел валидацию;
          - failed — возникла ошибка.

          stock integer

          Количество товара в наличии.

          stocks object

          Информация о количестве товара.

          coming integer

          Товары, которые ожидают поставки.

          present integer

          Товары в наличии.

          reserved integer

          Товары в резерве.

          validation_errors object

          Информация об ошибках валидации.

          code integer

          Код ошибки.

          error integer

          Описание ошибки.

          field integer

          Поле, в котором возникла ошибка.

          vat string

          Ставка НДС для товара:
          - 0 — не облагается НДС;
          - 0.1 — 10%;
          - 0.2 — 20%.

          visibility_details object

          Параметры видимости товара.

          active_product boolean

          Товар активирован.

          has_stock boolean

          У товара есть цена.

          visible boolean

          Товар доступен на складе.

          POST /v1/product/info HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "offer_id": "string",
            "product_id": 0,
            "sku": 0
          }
          Response status  200 
          {
            "result": {
              "barcode": "string",
              "buybox_price": "string",
              "category_id": 0,
              "created_at": "2021-03-24T12:31:04.417Z",
              "id": 0,
              "images": [
                "string"
              ],
              "marketing_price": "string",
              "min_ozon_price": "string",
              "name": "string",
              "offer_id": "string",
              "old_price": "string",
              "premium_price": "string",
              "price": "string",
              "recommended_price": "string",
              "sku": 0,
              "sources": [
                {
                  "is_enabled": true,
                  "sku": 0,
                  "source": "string"
                }
              ],
              "state": "string",
              "stock": 0,
              "stocks": {
                "coming": 0,
                "present": 0,
                "reserved": 0
              },
              "validation_errors": [
                {
                  "code": "string",
                  "error": "string",
                  "field": "string"
                }
              ],
              "vat": "string",
              "visibility_details": {
                "active_product": true,
                "has_stock": true
              },
              "visible": true
            }
          }

          /info/prices

          POST /v1/product/info/prices

          Получить информацию о цене товара. Swagger


          Параметры запроса

          page integer

          Номер страницы, возвращаемой в запросе.

          page_size integer

          Количество элементов на странице.


          Параметры ответа


          items object

          Массив товаров.

          commissions object

          Информация о комиссиях.

          deliveryAmount integer

          Стоимость доставки.

          minValue integer

          Минимальная комиссия.

          percent integer

          Процент комиссии.

          returnAmount integer

          Стоимость возврата.

          saleSchema string

          Схема продажи.

          value integer

          Сумма комиссии.

          marketing_actions object

          Информация о маркетинговых акциях.

          actions object

          Маркетинговые акции продавца. Параметры date_from, date_to, discountValue и title указываются для каждой акции продавца.

          date_from datetime

          Дата и время начала акции продавца.

          date_to datetime

          Дата и время окончания акции продавца.

          discountValue string

          Скидка по акции продавца.

          title string

          Название акции продавца.

          current_period_from datetime

          Дата и время начала текущего периода по всем действующим акциям.

          current_period_to datetime

          Дата и время окончания текущего периода по всем действующим акциям.

          ozon_actions_exist boolean

          True, если к товару может быть применена акция за счет Ozon.

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          price object

          Информация о цене.

          buybox_price string

          Цена главного предложения на Ozon.

          marketing_price string

          Цена на товар с учетом всех акций. Это значение будет указано на витрине Ozon.

          marketing_seller_price string

          Цена на товар с учетом акций только продавца.

          min_ozon_price string

          Минимальная цена на аналогичный товар на Ozon.

          old_price string

          Цена до учета скидок, на карточке товара отображается зачеркнутой.

          premium_price string

          Цена для клиентов с подпиской Ozon Premium.

          price string

          Цена товара с учетом скидок — это значение показывается на карточке товара.

          recommended_price string

          Цена на товар, рекомендованная системой на основании схожих предложений.

          retail_price string

          Цена поставщика.

          vat string

          Ставка НДС для товара.

          price_index string

          Ценовой индекс. Подробнее в Помощи

          product_id integer

          Идентификатор товара.

          volume_weight integer

          Объемный вес товара.

          total integer

          Количество товаров в списке.

          POST /v1/product/info/prices HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "page": 1,
            "page_size": 100
          }
          Response status  200 
          {
            "result": {
              "items": [
                {
                  "commissions": [
                    {
                      "deliveryAmount": 0,
                      "minValue": 0,
                      "percent": 0,
                      "returnAmount": 0,
                      "saleSchema": "string",
                      "value": 0
                    }
                  ],
                  "marketing_actions": {
                    "actions": [
                      {
                        "date_from": "2021-02-03T09:08:26.082Z",
                        "date_to": "2021-02-03T09:08:26.082Z",
                        "discountValue": "string",
                        "title": "string"
                      }
                    ],
                    "current_period_from": "2021-02-03T09:08:26.082Z",
                    "current_period_to": "2021-02-03T09:08:26.082Z",
                    "ozon_actions_exist": true
                  },
                  "offer_id": "string",
                  "price": {
                    "buybox_price": "string",
                    "marketing_price": "string",
                    "marketing_seller_price": "string",
                    "min_ozon_price": "string",
                    "old_price": "string",
                    "premium_price": "string",
                    "price": "string",
                    "recommended_price": "string",
                    "retail_price": "string",
                    "vat": "string"
                  },
                  "price_index": "string",
                  "product_id": 0,
                  "volume_weight": 0
                }
              ],
              "total": 0
            }
          }

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

          POST /v1/product/list

          Позволяет получить список товаров.


          Параметры запроса

          filter object

          Массив фильтра по дополнительным параметрам

          offer_id string

          Фильтр по параметру offer_id. Возможно передавать список значений.

          product_id string

          Фильтр по параметру product_id. Возможно передавать список значений.

          visibility string

          Фильтр по видимости товара, возможные значения:
          ALL: все товары.
          VISIBLE: товары, которые видны покупателям.
          INVISIBLE: товары, которые по какой-то из причин не видны покупателям.
          EMPTY_STOCK: товары, у которых не указано наличие.
          READY_TO_SUPPLY: товары, которым можно установить наличие.
          STATE_FAILED: товары, создание которых завершилось ошибко.

          page integer

          Номер страницы, возвращаемой в запросе.

          page_size integer

          Количество элементов на странице.


          Параметры ответа


          items object

          Массив товаров.

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          product_id integer

          Идентификатор товара.

          total integer

          Всего товаров.

          POST /v1/product/list HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "filter": {
              "offer_id": [
                "string"
              ],
              "product_id": [
                0
              ],
              "visibility": "ALL"
            },
            "page": 0,
            "page_size": 0
          }
          
          Response status  200 
          {
            "result": {
              "items": [
                {
                  "offer_id": "string",
                  "product_id": 0
                }
              ],
              "total": 0
            }
          }

          Продажа по предоплате

          POST /v1/product/prepayment/set

          Чтобы включить продажу товара только по предоплате, установите для него значение is_prepayment: true. В запросе обязательно укажите один из идентификаторов товара: product_id или offer_id.


          Параметры запроса

          is_prepayment boolean

          Флаг обязательной предоплаты для товара:
          - true — чтобы купить товар, нужно внести предоплату,
          - false — предоплата не обязательна.

          offers_ids array

          Массив идентификаторов товаров в системе продавца.

          products_ids array

          Массив идентификаторов товаров в системе Ozon.


          Параметры ответа


          item_updated object

          Информация об обновленных товарах.

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          product_id integer

          Идентификатор товара.

          success boolean

          Результат запроса:
          true — изменения сохранены;
          false — изменения не применились.

          POST /v1/product/prepayment/set HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "is_prepayment": true,
            "offers_ids": [
              "string"
            ],
            "products_ids": [
              0
            ]
          }
          Response status  200 
          {
            "result": {
              "item_updated": [
                {
                  "offer_id": "string",
                  "product_id": 0,
                  "success": true
                }
              ]
            }
          }

          /unarchive

          POST /v1/product/unarchive

          Вернуть товар из архива. Swagger


          Параметры запроса

          product_id * integer

          Идентификатор товара.


          Параметры ответа


          result boolean

          Результат обработки запроса. True, если запрос выполнился без ошибок.

          POST /v1/product/unarchive HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "product_id": [
              14929,
              244206,
              458202,
              710646
            ]
          }
          Response status  200 
          {
            "result": true
          }

          /update

          POST /v1/product/update

          Изменить данные на карточке товара, кроме цены и количества товаров на складах.


          Параметры запроса

          product_id * integer

          Идентификатор товара.

          barcode string

          Штрихкод товара.

          description string

          Описание товара. Для переноса строки в описании используйте HTML-тег br.

          name string

          Название товара. До 500 символов.

          vendor string

          Производитель товара. До 100 символов.

          vendor_code string

          Код производителя. До 100 символов.

          height integer

          Высота упаковки.

          depth integer

          Глубина упаковки.

          width integer

          Ширина упаковки.

          dimension_unit string

          Единица измерения габаритов

          • mm — миллиметры,
          • cm — сантиметры,
          • in — дюймы.

          weight integer

          Вес товара в упаковке. Предельное значение — 1000 килограммов или конвертированная величина в других единицах измерения.

          weight_unit string

          Единицы измерения веса: g — граммы, kg — килограммы, lb — фунты.

          images object

          Массив с изображениями, не больше 10.

          file_name string

          Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.

          default_img in.bool

          Признак, позволяющий установить изображение основным.

          attributes object

          Массив с характеристиками товара. Характеристики отличаются для разных категорий — их можно посмотреть в Помощи или через API.

          id integer

          Идентификатор характеристики.

          value string

          Значение характеристики.

          collection array

          Массив значений характеристики. Например, характеристика «Цвет» может принимать два значения: черный и белый.

          complex array

          Массив характеристик, у которых есть вложенные аттрибуты. Например, у характеристики «Процессор» есть вложенные характеристики «Производитель», «L2 Cache», и другие. У каждой из вложенных характеристик может быть несколько вариантов значений.

          complex_collection object

          Массив характеристик с одинаковым названием, но разными значениями.

          collection array

          Массив значений характеристики.


          Параметры ответа


          result boolean

          True, если запрос выполнен без ошибок.

          POST /v1/product/update HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "product_id": 124100,
            "barcode": "8801643566784",
            "description": "Red Samsung Galaxy S10 with 512GB",
            "name": "Samsung Galaxy S10",
            "vendor": "Samsung",
            "vendor_code": "SM-G960UZPAXAA",
            "height": 77,
            "depth": 11,
            "width": 120,
            "dimension_unit": "mm",
            "weight": 120,
            "weight_unit": "g",
            "images": [
              {
                "file_name": "http://pic.com/1.jpg",
                "default": true
              },
              {
                "file_name": "http://pic.com/2.jpg",
                "default": false
              },
              {
                "file_name": "http://pic.com/3.jpg",
                "default": false
              }
            ],
            "attributes": [
              {
                "id": 1,
                "value": "Samsung Galaxy S10"
              },
              {
                "id": 2,
                "collection": [
                  "128GB",
                  "512GB"
                ]
              },
              {
                "id": 3,
                "complex": [
                  {
                    "id": 10,
                    "value": "Unboxing video"
                  },
                  {
                    "id": 11,
                    "value": "http://videos.com/1.mp4"
                  }
                ]
              },
              {
                "id": 4,
                "complex_collection": [
                  {
                    "collection": [
                      {
                        "id": 10,
                        "value": "Additional video"
                      },
                      {
                        "id": 11,
                        "value": "http://videos.com/2.mp4"
                      }
                    ]
                  },
                  {
                    "collection": [
                      {
                        "id": 10,
                        "value": "Another one video"
                      },
                      {
                        "id": 11,
                        "value": "http://videos.com/3.mp4"
                      }
                    ]
                  }
                ]
              }
            ]
          }
          Response status  200 
          {
            "result": {
              "updated": true
            }
          }

          Work with products

          /archive

          POST /v1/product/archive

          Archive a product. Swagger


          Параметры запроса


          Параметры ответа


          result boolean

          The result of processing the request. True if the request was executed without errors.

          POST /v1/product/archive HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "product_id": [
              14929,
              244206,
              458202,
              710646
            ]
          }
          Response status  200 
          {
            "result": true
          }

          /certificate/accordance-types

          GET /v1/product/certificate/accordance-types

          Directory of accordance types. Swagger


          Параметры ответа


          result object

          List of certificate types and names.

          name string

          Certificate name.

          value string

          Certificate type.

          POST /v1/product/certificate/accordance-types HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {}
          Response status  200 
          Can not resolve examples/v1/product/certificate/accordance-type/out.json

          /certificate/bind

          POST /v1/product/certificate/bind

          Bind the certificate to the product. Swagger


          Параметры запроса

          certificate_id integer

          Certificate ID that was assigned when it was uploaded.

          item_id integer

          An array of product IDs that this certificate applies to.


          Параметры ответа


          result boolean

          True if the request was executed without errors.

          POST /v1/product/certificate/bind HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "certificate_id": 0,
            "item_id": [
              0
            ]
          }

          /certificate/create

          POST /v1/product/certificate/create

          Method for adding certificates for products. Swagger


          Параметры запроса

          files * array

          Array of certificates for the product. Valid extensions are jpg, jpeg, png, pdf.

          name * string

          Certificate name. No more than 100 characters.

          number * string

          Certificate number. No more than 100 characters.

          type_code * string

          Certificate type. To get the list of types, use the method GET /v1/product/certificate/types.

          accordance_type_code * string

          Accordance type. To get the list of types, use the method GET /v1/product/certificate/accordance-types.

          issue_date * datetime

          Issue date of the certificate.

          expire_date datetime

          The expiration date of the certificate. Can be empty for permanent certificates.


          Параметры ответа


          id integer

          Uploaded certificate ID.

          POST /v1/product/certificate/create HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {}
          Response status  200 
          {
            "id": 123
          }

          /certificate/types

          GET /v1/product/certificate/types

          Directory of document types. Swagger


          Параметры ответа


          result object

          List of certificate types and names.

          name string

          Certificate name.

          value string

          Certificate type.

          POST /v1/product/certificate/types HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {}
          Response status  200 
          {
            "result": [
              {
                "name": "string",
                "value": "string"
              }
            ]
          }

          /certification/list

          POST /v1/product/certification/list

          Выводит список сертифицируемых категорий. Swagger


          Параметры запроса

          page integer

          Номер страницы, возвращаемой в запросе.

          page_size integer

          Количество элементов на странице.


          Параметры ответа


          certification object

          Информация о сертифицируемых категориях.

          category_name string

          Название сертифицируемой категории.

          is_required boolean

          Флаг обязательной характеристики.

          total integer

          Всего категорий.

          POST /v1/product/certification/list HTTP/1.1
          Host: api-seller.ozon.ru 
          Client-Id: 836
          Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
          Content-Type: application/json
          {
            "page": 0,
            "page_size": 0
          }
          Response status  200 
          {
            "result": {
              "certification": [
                {
                  "category_name": "string",
                  "is_required": true
                }
              ],
              "total": 0
            }
          }

          /import

          POST /v1/product/import

          Allows you to change the price of one or more products. You can change the prices for 1000 products in one request. To reset old_price or premium_price, set these parameters to 0.


          Параметры запроса

          attributes object

          Массив характеристик товара. Чтобы узнать какие характеристики есть у категории товара, используйте метод [Список характеристик категории](https://docs.ozon.ru/api/seller#/v2%E2%80%8B/category%E2%80%8B/attribute%E2%80%8B).

          collection array

          Массив значений характеристики. Например, характеристика Цвет может принимать два значения

          complex object

          Массив характеристик, которые поддерживают вложенные свойства. Например, у характеристики Процессор есть вложенные характеристики Производитель, L2 Cache, и другие. У каждой из вложенных характеристик может быть несколько вариантов значений.

          id integer

          Идентификатор характеристики.

          value string

          Значение характеристики.

          complex_collection object

          Массив характеристик с одинаковым названием, но разными значениями. Например, у CD диска с аудиокнигой может быть несколько характеристик Аудио дорожка, каждая из который будет иметь разные значения вложенных характеристик Длина дорожки, Битрейт и тому подобное.

          collection object

          Массив значений характеристики.

          id integer

          Идентификатор характеристики.

          value string

          Значение характеристики.

          barcode string

          Штрихкод товара.

          depth integer

          Глубина упаковки.

          description string

          Описание товара. Для переноса строки в описании используйте HTML-тег [br](https://www.w3schools.com/tags/tag_br.asp).

          dimension_unit string

          Единица измерения габаритов

          • mm — миллиметры,
          • cm — сантиметры,
          • in — дюймы.

          height integer

          Высота упаковки.

          name string

          Название товара. До 500 символов.

          offer_id string

          Идентификатор товара в системе продавца — артикул.

          old_price string

          Цена до скидок (будет зачеркнута на карточке товара). Указывается в рублях. Разделитель дробной части — точка, до двух знаков после точки.

          premium_price string

          Цена для клиентов с подпиской Ozon Premium.

          price string

          Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.

          vat string

          Ставка НДС для товара

          • 0 — не облагается НДС,
          • 0.1 — 10%,
          • 0.2 — 20%.

            vendor string

            Производитель товара. До 100 символов.

            vendor_code string

            Код производителя. До 100 символов.

            weight integer

            Вес товара в упаковке. Предельное значение — 1000 килограммов или конвертированная величина в других единицах измерения.

            weight_unit string

            Единицы измерения веса: g — граммы, kg — килограммы, lb — фунты.

            width integer

            Ширина упаковки.


            Параметры ответа


            task_id integer

            Код задачи на импорт товаров. Статус выполнения задачи можно получить, используя метод [Статус создания товара](https://docs.ozon.ru/api/seller#/v1/product/import/info).

            POST /v1/product/import HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "items": [
                {
                  "attributes": [
                    {
                      "collection": [
                        "string"
                      ],
                      "complex": [
                        {
                          "id": 0,
                          "value": "string"
                        }
                      ],
                      "complex_collection": [
                        {
                          "collection": [
                            {
                              "id": 0,
                              "value": "string"
                            }
                          ]
                        }
                      ],
                      "id": 0,
                      "value": "string"
                    }
                  ],
                  "barcode": "string",
                  "category_id": 0,
                  "depth": 0,
                  "description": "string",
                  "dimension_unit": "string",
                  "height": 0,
                  "images": [
                    {
                      "default": true,
                      "file_name": "string"
                    }
                  ],
                  "name": "string",
                  "offer_id": "string",
                  "old_price": "string",
                  "premium_price": "string",
                  "price": "string",
                  "vat": "string",
                  "vendor": "string",
                  "vendor_code": "string",
                  "weight": 0,
                  "weight_unit": "string",
                  "width": 0
                }
              ]
            }
            Response status  200 
            {
              "result": {
                "task_id": 0
              }
            }

            /import/info

            POST /v1/product/import/info

            Get the status of creating a PDP (product description page).


            Параметры запроса

            task_id integer

            The task number for importing products.


            Параметры ответа


            items object

            Product details.

            offer_id string

            Seller Product ID.

            status string

            Product creation status. Product information is processed in queues. Possible parameter values: processing, moderating, processed, failed_moderation, failed_validation, failed.

            total string

            Seller Product ID.

            POST /v1/product/import/info HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "task_id": 0
            }
            Response status  200 
            {
              "result": {
                "items": [
                  {
                    "offer_id": "string",
                    "product_id": 0,
                    "status": "string"
                  }
                ],
                "total": 0
              }
            }

            Update price

            POST /v1/product/import/prices

            Allows you to change the price of one or more products. You can change the prices for 1000 products in one request. To reset old_price or premium_price, set these parameters to 0.


            Параметры запроса

            prices object

            Product prices details.

            offer_id string

            Seller Product ID.

            old_price string

            Price before discounts (will be strikethrough on the PDP) in rubles. The decimal separator is a dot, up to two characters after the dot.

            premium_price string

            Price for Ozon Premium subscribers.

            price string

            The price of the product including discounts. It is displayed on the PDP. If there are no discounts on the product, specify the old_price value.


            Параметры ответа


            errors object

            Array of errors that occurred when processing the request.

            code string

            Error code.

            message string

            Error reason.

            offer_id string

            Seller Product ID.

            updated boolean

            True if the product information has been successfully updated.

            POST /v1/product/import/prices HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "prices": [
                {
                  "offer_id": "string",
                  "old_price": "string",
                  "premium_price": "string",
                  "price": "string",
                  "product_id": 0
                }
              ]
            }
            Response status  200 
            {
              "result": [
                {
                  "errors": [
                    {
                      "code": "string",
                      "message": "string"
                    }
                  ],
                  "offer_id": "string",
                  "product_id": 0,
                  "updated": true
                }
              ]
            }

            /info/description

            POST /v1/product/info/description

            Возвращает описание товара. Swagger


            Параметры запроса

            offer_id string

            Идентификатор товара в системе продавца — артикул.

            product_id integer

            Идентификатор товара.


            Параметры ответа


            description string

            Описание.

            id integer

            Идентификатор.

            name string

            Название.

            offer_id string

            Идентификатор товара в системе продавца — артикул.

            POST /v1/product/info/description HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "offer_id": "string",
              "product_id": 0
            }
            Response status  200 
            {
              "result": {
                "description": "string",
                "id": 0,
                "name": "string",
                "offer_id": "string"
              }
            }

            /info/prices

            POST /v1/product/info/prices

            Get information about the product price. Swagger


            Параметры запроса

            page integer

            The number of the page returned in the request.

            page_size integer

            The number of items on the page.


            Параметры ответа


            items object

            Array of products.

            commissions-en object

            Commissions details.

            deliveryAmount integer

            Delivery cost.

            minValue integer

            Minimum commission.

            percent integer

            Commission percentage.

            returnAmount integer

            Return cost.

            saleSchema string

            Sale scheme.

            value integer

            Commission amount.

            offer_id-en string

            Seller Product ID.

            price_obj-en object

            Price details.

            buybox_price string

            The price of the main offer on Ozon.

            marketing_price string

            The price of the product, including all promotions. This value will be shown on the Ozon showcase.

            marketing_seller_price string

            The price of the product, including the promotions of the seller only.

            min_ozon_price string

            The minimum price for the same product on Ozon.

            old_price string

            The price before discounts, displayed strikethrough on the PDP.

            premium_price string

            The price for Ozon Premium subscribers.

            price string

            The product price including discounts. This value is displayed on the PDP.

            recommended_price string

            The price of the product recommended by the system based on similar offers.

            retail_price string

            Supplier's price.

            vat string

            The VAT rate for the product.

            price_index-en string

            Price index. Learn more in Help Center

            volume_weight-en integer

            The volumetric weight of the product.

            total integer

            The number of products in the list.

            POST /v1/product/info/prices HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "page": 1,
              "page_size": 100
            }
            Response status  200 
            {
              "result": {
                "items": [
                  {
                    "commissions": [
                      {
                        "deliveryAmount": 0,
                        "minValue": 0,
                        "percent": 0,
                        "returnAmount": 0,
                        "saleSchema": "string",
                        "value": 0
                      }
                    ],
                    "marketing_actions": {
                      "actions": [
                        {
                          "date_from": "2021-02-03T09:08:26.082Z",
                          "date_to": "2021-02-03T09:08:26.082Z",
                          "discountValue": "string",
                          "title": "string"
                        }
                      ],
                      "current_period_from": "2021-02-03T09:08:26.082Z",
                      "current_period_to": "2021-02-03T09:08:26.082Z",
                      "ozon_actions_exist": true
                    },
                    "offer_id": "string",
                    "price": {
                      "buybox_price": "string",
                      "marketing_price": "string",
                      "marketing_seller_price": "string",
                      "min_ozon_price": "string",
                      "old_price": "string",
                      "premium_price": "string",
                      "price": "string",
                      "recommended_price": "string",
                      "retail_price": "string",
                      "vat": "string"
                    },
                    "price_index": "string",
                    "product_id": 0,
                    "volume_weight": 0
                  }
                ],
                "total": 0
              }
            }

            /unarchive

            POST /v1/product/unarchive

            Unarchive a product. Swagger


            Параметры запроса


            Параметры ответа


            result boolean

            The result of processing the request. True if the request was executed without errors.

            POST /v1/product/unarchive HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "product_id": [
                14929,
                244206,
                458202,
                710646
              ]
            }
            Response status  200 
            {
              "result": true
            }

            /update

            POST /v1/product/update

            Change the data on the PDP, except for the price and number of items in the warehouses.


            Параметры запроса

            barcode string

            Product barcode.

            description string

            Product description. To wrap a line in a description, use the HTML tag br.

            name string

            Product name. Up to 500 characters.

            vendor string

            The manufacturer of the product. Up to 100 characters.

            vendor_code string

            Manufacturer's code. Up to 100 characters.

            height integer

            The height of the package.

            depth integer

            The depth of tha package.

            width integer

            The width of the package.

            dimension_unit string

            Unit of measurement of dimensions

            • mm — millimeters
            • cm — centimeters
            • in — inches

            weight integer

            The weight of the product in the package. The limit value is 1000 kilograms or the converted value in other units of measurement.

            weight_unit string

            Weight units: g — grams, kg — kilograms, lb — pounds.

            images object

            Array with images, no more than 10.

            file_name string

            Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.

            default_img in.bool

            Признак, позволяющий установить изображение основным.

            attributes object

            An array with product characteristics. The characteristics differ for different categories — you can see them in Help Center or via API.

            id integer

            Characteristic ID.

            value string

            The value of the characteristic.

            collection array

            Array of characteristic values. For example, the "Color" characteristic can take two values: black and white.

            complex array

            An array of characteristics that have nested attributes. For example, the "Processor" characteristic has nested characteristics "Manufacturer", "L2 Cache", and others. Each of the nested characteristics can have several variants of values.

            complex_collection object

            An array of characteristics with the same name but different values.

            collection array

            Array of characteristic values.


            Параметры ответа


            result boolean

            True if the request was executed without errors.

            POST /v1/product/update HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "product_id": 124100,
              "barcode": "8801643566784",
              "description": "Red Samsung Galaxy S10 with 512GB",
              "name": "Samsung Galaxy S10",
              "vendor": "Samsung",
              "vendor_code": "SM-G960UZPAXAA",
              "height": 77,
              "depth": 11,
              "width": 120,
              "dimension_unit": "mm",
              "weight": 120,
              "weight_unit": "g",
              "images": [
                {
                  "file_name": "http://pic.com/1.jpg",
                  "default": true
                },
                {
                  "file_name": "http://pic.com/2.jpg",
                  "default": false
                },
                {
                  "file_name": "http://pic.com/3.jpg",
                  "default": false
                }
              ],
              "attributes": [
                {
                  "id": 1,
                  "value": "Samsung Galaxy S10"
                },
                {
                  "id": 2,
                  "collection": [
                    "128GB",
                    "512GB"
                  ]
                },
                {
                  "id": 3,
                  "complex": [
                    {
                      "id": 10,
                      "value": "Unboxing video"
                    },
                    {
                      "id": 11,
                      "value": "http://videos.com/1.mp4"
                    }
                  ]
                },
                {
                  "id": 4,
                  "complex_collection": [
                    {
                      "collection": [
                        {
                          "id": 10,
                          "value": "Additional video"
                        },
                        {
                          "id": 11,
                          "value": "http://videos.com/2.mp4"
                        }
                      ]
                    },
                    {
                      "collection": [
                        {
                          "id": 10,
                          "value": "Another one video"
                        },
                        {
                          "id": 11,
                          "value": "http://videos.com/3.mp4"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
            Response status  200 
            {
              "result": {
                "updated": true
              }
            }

            /v1/products

            /prices

            POST /v1/products/prices

            Метод для обновления цен товаров.


            Параметры запроса

            stocks object

            Информация о ценах товаров.

            offer_id string

            Идентификатор товара в системе продавца.

            old_price string

            Цена до скидок (будет зачеркнута на карточке товара). Указывается в рублях. Разделитель дробной части — точка, до двух знаков после точки.

            premium_price string

            Цена для клиентов с подпиской Ozon Premium.

            price string

            Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.

            product_id integer

            Идентификатор товара.


            Параметры ответа


            errors object

            Массив ошибок, которые возникли при обработке запроса.

            code string

            Код ошибки.

            message string

            Причина ошибки.

            offer_id string

            Идентификатор товара в системе продавца — артикул.

            product_id integer

            Идентификатор товара.

            updated boolean

            True, если информации о товаре успешно обновлена.

            POST /v1/products/prices HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "prices": [
                {
                  "offer_id": "string",
                  "old_price": "string",
                  "premium_price": "string",
                  "price": "string",
                  "product_id": 0
                }
              ]
            }
            Response status  200 
            {
              "result": [
                {
                  "errors": [
                    {
                      "code": "string",
                      "message": "string"
                    }
                  ],
                  "offer_id": "string",
                  "product_id": 0,
                  "updated": true
                }
              ]
            }

            /stocks

            POST /v1/products/stocks

            Метод для обновления количества товаров. Не рекомендуется обновлять больше 500 товаров в одном запросе.


            Параметры запроса

            stocks object

            Информация об остатках товаров.

            offer_id string

            Идентификатор товара в системе продавца — артикул.

            product_id integer

            Идентификатор товара.

            stock integer

            Количество товара.


            Параметры ответа


            errors object

            Массив ошибок, которые возникли при обработке запроса.

            code string

            Код ошибки.

            message string

            Причина ошибки.

            offer_id string

            Идентификатор товара в системе продавца — артикул.

            product_id integer

            Идентификатор товара.

            updated boolean

            True, если информации о товаре успешно обновлена.

            POST /v1/products/stocks HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "stocks": [
                {
                  "offer_id": "string",
                  "product_id": 0,
                  "stock": 0
                }
              ]
            }
            Response status  200 
            {
              "result": [
                {
                  "errors": [
                    {
                      "code": "string",
                      "message": "string"
                    }
                  ],
                  "offer_id": "string",
                  "product_id": 0,
                  "updated": true
                }
              ]
            }

            /update

            POST /v1/products/update

            Метод для обновления информации о товаре. Количество не ограничено.


            Параметры запроса

            attributes object

            Массив c характеристиками товара.

            collection array

            Массив значений характеристик.

            complex object

            Массив характеристик, у которых есть вложенные аттрибуты.

            id integer

            Идентификатор характеристики.

            value string

            Значение характеристики.

            complex_collection object

            Массив характеристик с одинаковым названием, но разными значениями.

            collection object

            Массив значений характеристики.

            id integer

            Идентификатор характеристики.

            value string

            Значение характеристики.

            barcode string

            Штрихкод товара.

            depth integer

            Глубина упаковки.

            description string

            Описание товара.

            dimension_unit string

            Единица измерения габаритов

            • mm — миллиметры,
            • cm — сантиметры,
            • in — дюймы.

            height integer

            Высота упаковки.

            images object

            Идентификатор категории. При создании товара в выбранной категории не должно быть других вложенных категорий.

            default boolean

            Признак, позволяющий установить изображение основным.

            file_name string

            Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.

            name string

            Название товара. До 500 символов.

            product_id integer

            Идентификатор товара.

            vendor string

            Производитель товара. До 100 символов.

            vendor_code string

            Код производителя. До 100 символов.

            weight integer

            Вес товара в упаковке. Предельное значение — 1000 килограммов или конвертированная величина в других единицах измерения.

            weight_unit string

            Единицы измерения веса: g — граммы, kg — килограммы, lb — фунты.

            width integer

            Ширина упаковки.


            Параметры ответа


            updated boolean

            True, если информации о товаре успешно обновлена.

            POST /v1/products/update HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "attributes": [
                {
                  "collection": [
                    "string"
                  ],
                  "complex": [
                    {
                      "id": 0,
                      "value": "string"
                    }
                  ],
                  "complex_collection": [
                    {
                      "collection": [
                        {
                          "id": 0,
                          "value": "string"
                        }
                      ]
                    }
                  ],
                  "id": 0,
                  "value": "string"
                }
              ],
              "barcode": "string",
              "depth": 0,
              "description": "string",
              "dimension_unit": "string",
              "height": 0,
              "images": [
                {
                  "default": true,
                  "file_name": "string"
                }
              ],
              "name": "string",
              "product_id": 0,
              "vendor": "string",
              "vendor_code": "string",
              "weight": 0,
              "weight_unit": "string",
              "width": 0
            }
            Response status  200 
            {
              "result": [
                {
                  "errors": [
                    {
                      "code": "string",
                      "message": "string"
                    }
                  ],
                  "offer_id": "string",
                  "product_id": 0,
                  "updated": true
                }
              ]
            }

            v1 Products and prices

            /prices

            POST /v1/products/prices

            Update product prices.


            Параметры запроса

            stocks object

            Product prices details.

            offer_id string

            Seller Product ID.

            old_price string

            Price before discounts (will be strikethrough on the PDP) in rubles. The decimal separator is a dot, up to two characters after the dot.

            premium_price string

            Price for Ozon Premium subscribers.

            price string

            The price of the product including discounts. It is displayed on the PDP. If there are no discounts on the product, specify the old_price value.


            Параметры ответа


            errors object

            Array of errors that occurred when processing the request.

            code string

            Error code.

            message string

            Error reason.

            offer_id string

            Seller Product ID.

            updated boolean

            True if the product information has been successfully updated.

            POST /v1/products/prices HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "prices": [
                {
                  "offer_id": "string",
                  "old_price": "string",
                  "premium_price": "string",
                  "price": "string",
                  "product_id": 0
                }
              ]
            }
            Response status  200 
            {
              "result": [
                {
                  "errors": [
                    {
                      "code": "string",
                      "message": "string"
                    }
                  ],
                  "offer_id": "string",
                  "product_id": 0,
                  "updated": true
                }
              ]
            }

            /stocks

            POST /v1/products/stocks

            Method for updating the number of products. It is not recommended to update more than 500 products in a single request.


            Параметры запроса

            stocks object

            Stock details.

            offer_id string

            Seller Product ID

            stock integer

            The number of products.


            Параметры ответа


            errors object

            Array of errors that occurred when processing the request.

            code string

            Error code.

            message string

            Error reason.

            offer_id string

            Seller Product ID.

            updated boolean

            True if the product information has been successfully updated.

            POST /v1/products/stocks HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            {
              "stocks": [
                {
                  "offer_id": "string",
                  "product_id": 0,
                  "stock": 0
                }
              ]
            }
            Response status  200 
            {
              "result": [
                {
                  "errors": [
                    {
                      "code": "string",
                      "message": "string"
                    }
                  ],
                  "offer_id": "string",
                  "product_id": 0,
                  "updated": true
                }
              ]
            }

            Информация о товаре.

            GET /v1/products/info/{product_id}

            Позволяет получить информацию о товаре.


            URI Parameters


            Параметры запроса

            offer_id string

            Идентификатор товара в системе продавца — артикул.

            product_id integer

            Идентификатор товара.

            sku integer

            Идентификатор товара в системе Ozon — SKU.


            Параметры ответа


            barcode string

            Штрихкод.

            buybox_price string

            Цена главного предложения на Ozon. Устаревший параметр, больше не используется.

            category_id integer

            Идентификатор категории.

            created_at string

            Дата и время создания товара.

            id integer

            Идентификатор характеристики товара.

            images array

            Массив url для изображений товара.

            marketing_price string

            Цена на товар с учетом всех акций. Это значение будет указано на витрине Ozon.

            min_ozon_price string

            Минимальная цена на аналогичный товар на Ozon.

            name string

            Название товара. До 500 символов.

            offer_id string

            Идентификатор товара в системе продавца.

            old_price string

            Цена до учета скидок, на карточке товара отображается зачеркнутой.

            premium_price string

            Цена для клиентов с подпиской Ozon Premium.

            price string

            Цена товара с учетом скидок — это значение показывается на карточке товара.

            recommended_price string

            Цена на товар, рекомендованная системой на основании схожих предложений.

            sku integer

            Идентификатор товара на Ozon.

            sources array

            Информация о SKU Ozon.

            state string

            Статус добваления товара с систему:
            - processing — информация о товаре добавляется в систему, ожидайте;
            - moderating — товар проходит модерацию, ожидайте;
            - processed — информация обновлена;
            - failed_moderation — товар не прошел модерацию;
            - failed_validation — товар не прошел валидацию;
            - failed — возникла ошибка.

            stock integer

            Количество товара в наличии.

            stocks object

            Информация о количестве товара.

            coming integer

            Товары, которые ожидают поставки.

            present integer

            Товары в наличии.

            reserved integer

            Товары в резерве.

            validation_errors object

            Информация об ошибках валидации.

            code integer

            Код ошибки.

            error integer

            Описание ошибки.

            field integer

            Поле, в котором возникла ошибка.

            vat string

            Ставка НДС для товара:
            - 0 — не облагается НДС;
            - 0.1 — 10%;
            - 0.2 — 20%.

            visibility_details object

            Параметры видимости товара.

            active_product boolean

            Товар активирован.

            has_stock boolean

            У товара есть цена.

            visible boolean

            Товар доступен на складе.

            GET /v1/products/info/{product_id} HTTP/1.1
            Host: api-seller.ozon.ru 
            Client-Id: 836
            Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
            Content-Type: application/json
            Response status  200 
            {
              "result": {
                "barcode": "string",
                "buybox_price": "string",
                "category_id": 0,
                "created_at": "2021-03-25T17:37:39.802Z",
                "id": 0,
                "images": [
                  "string"
                ],
                "marketing_price": "string",
                "min_ozon_price": "string",
                "name": "string",
                "offer_id": "string",
                "old_price": "string",
                "premium_price": "string",
                "price": "string",
                "recommended_price": "string",
                "sku": 0,
                "sources": [
                  {
                    "is_enabled": true,
                    "sku": 0,
                    "source": "string"
                  }
                ],
                "state": "string",
                "stock": 0,
                "stocks": {
                  "coming": 0,
                  "present": 0,
                  "reserved": 0
                },
                "validation_errors": [
                  {
                    "code": "string",
                    "error": "string",
                    "field": "string"
                  }
                ],
                "vat": "string",
                "visibility_details": {
                  "active_product": true,
                  "has_stock": true
                },
                "visible": true
              }
            }

            /v2/product

            /import

            POST /v2/product/import

            Загрузите свои товары на Ozon. В одном запросе можно передать до 100 товаров. Каждый товар — это отдельный элемент в массиве items. Укажите всю информацию о товаре: его характеристики, штрихкод, изображения, габариты и цену.

            Характеристики зависят от категории товара — вы можете посмотреть список обязательных характеристик для некоторых категорий в Помощи или методом POST /v2/category/attribute.

            После модерации товар появится в вашем личном кабинете, но не будет виден пользователям, пока вы не выставите его на продажу.

            Каждый товар в запросе — отдельный элемент массива items.


            Параметры запроса

            attributes * object

            Массив с характеристиками товара. Характеристики отличаются для разных категорий — их можно посмотреть в Помощи или через API.

            complex_id integer

            Идентификатор характеристики, которая поддерживает вложенные свойства. Например, у характеристики «Процессор» есть вложенные характеристики «Производитель», «L2 Cache», и другие. У каждой из вложенных характеристик может быть несколько вариантов значений.

            id* integer

            Идентификатор характеристики.

            values object

            Массив вложенных значений характеристики.

            dictionary_value_id integer

            Идентификатор справочника.

            value string

            Значение из справочника.

            barcode string

            Штрихкод товара.

            category_id integer

            Идентификатор категории.

            complex_attributes object

            Массив характеристик, у которых есть вложенные атрибуты.

            attributes array

            Массив с характеристиками товара. Характеристики отличаются для разных категорий — их можно посмотреть в Помощи или через API.

            depth integer

            Глубина упаковки.

            dimension_unit string

            Единица измерения габаритов

            • mm — миллиметры,
            • cm — сантиметры,
            • in — дюймы.

            height integer

            Высота упаковки.

            image_group_id string

            Идентификатор для последующей пакетной загрузки изображений.

            images string

            Массив с изображениями, не больше 10.

            name string

            Название товара. До 500 символов.

            offer_id string

            Идентификатор товара в системе продавца — артикул.

            old_price string

            Цена до скидок (будет зачеркнута на карточке товара). Указывается в рублях. Разделитель дробной части — точка, до двух знаков после точки.

            pdf_list array

            Список pdf-файлов.

            premium_price string

            Цена для клиентов с подпиской Ozon Premium.

            price string

            Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.

            vat string

            Ставка НДС для товара

            • 0 — не облагается НДС,
            • 0.1 — 10%,
            • 0.2 — 20%.

              weight integer

              Вес товара в упаковке. Предельное значение — 1000 килограммов или конвертированная величина в других единицах измерения.

              weight_unit string

              Единицы измерения веса: g — граммы, kg — килограммы, lb — фунты.

              width integer

              Ширина упаковки.


              Параметры ответа


              task_id integer

              Номер задания на загрузку товаров.

              POST /v2/product/import HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "items": [
                  {
                    "attributes": [
                      {
                        "complex_id": 0,
                        "id": 0,
                        "values": [
                          {
                            "dictionary_value_id": 0,
                            "value": "string"
                          }
                        ]
                      }
                    ],
                    "barcode": "string",
                    "category_id": 0,
                    "complex_attributes": [
                      {
                        "attributes": [
                          {
                            "complex_id": 0,
                            "id": 0,
                            "values": [
                              {
                                "dictionary_value_id": 0,
                                "value": "string"
                              }
                            ]
                          }
                        ]
                      }
                    ],
                    "depth": 0,
                    "dimension_unit": "string",
                    "height": 0,
                    "image_group_id": "string",
                    "images": [
                      "string"
                    ],
                    "images360": [
                      "string"
                    ],
                    "name": "string",
                    "offer_id": "string",
                    "old_price": "string",
                    "pdf_list": [
                      {
                        "index": 0,
                        "name": "string",
                        "src_url": "string"
                      }
                    ],
                    "premium_price": "string",
                    "price": "string",
                    "vat": "string",
                    "weight": 0,
                    "weight_unit": "string",
                    "width": 0
                  }
                ]
              }
              Response status  200 
              {
                "result": {
                  "task_id": 0
                }
              }

              /info

              POST /v2/product/info

              Информация о товарах. Swagger


              Параметры запроса

              offer_id string

              Идентификатор товара в системе продавца — артикул.

              product_id integer

              Идентификатор товара.

              sku integer

              Идентификатор товара в системе Ozon — SKU.


              Параметры ответа


              barcode string

              Штрихкод.

              buybox_price string

              Цена главного предложения на Ozon.

              category_id integer

              Идентификатор категории.

              commissions object

              Информация о комиссиях.

              deliveryAmount integer

              Стоимость доставки.

              minValue integer

              Минимальная комиссия.

              percent integer

              Процент комиссии.

              returnAmount integer

              Стоимость возврата.

              saleSchema string

              Схема продажи.

              value integer

              Сумма комиссии.

              created_at datetime

              Дата и время создания отправления.

              errors object

              Ошибки модерации.

              attribute_id integer

              Идентификатор характеристики.

              code string

              Код ошибки.

              field string

              Поле, в котором найдена ошибка.

              level string

              Уровень характеристики.

              id integer

              Номер задания на формирование документов.

              images array

              Массив ссылок на изображения. Каждая ссылка — string.

              marketing_price string

              Цена на товар с учетом всех акций. Это значение будет указано на витрине Ozon.

              min_ozon_price string

              Минимальная цена на аналогичный товар на Ozon.

              name string

              Название.

              offer_id string

              Идентификатор товара в системе продавца — артикул.

              old_price string

              Цена до учета скидок, на карточке товара отображается зачеркнутой.

              premium_price string

              Цена для клиентов с подпиской Ozon Premium.

              price string

              Цена товара с учетом скидок — это значение показывается на карточке товара.

              price_index string

              Ценовой индекс. Подробнее в Помощи

              recommended_price string

              Цена на товар, рекомендованная системой на основании схожих предложений.

              sources object

              Информация об источниках схожих предложений. Подробнее в Помощи

              is_enabled boolean

              Флаг, что источник учитывается при расчете рыночного значения.

              sku integer

              Идентификатор товара на Ozon.

              source string

              Ссылка на источник.

              state string

              Статус товара.

              stocks object

              Информация об остатках товара.

              coming integer

              Ожидается поставка.

              present integer

              Сейчас на складе.

              reserved integer

              Зарезервировано.

              vat string

              Ставка НДС для товара.

              visibility_details object

              Настройки видимости товара.

              has_price boolean

              True, если установлена цена.

              has_stock boolean

              True, если есть отстаток на складах.

              active_product boolean

              True, если активный товар.

              reasons object

              Указывается причина, почему товар скрыт.

              description string

              Описание причины.

              id integer

              Идентификатор причины.

              visible boolean

              True, если товар выставлен на продажу.

              volume_weight integer

              Объемный вес товара.

              POST /v2/product/info HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "offer_id": "107112",
                "product_id": 15214026,
                "sku": 0
              }
              Response status  200 
              {
                "result": {
                  "barcode": "string",
                  "buybox_price": "string",
                  "category_id": 0,
                  "commissions": [
                    {
                      "deliveryAmount": 0,
                      "minValue": 0,
                      "percent": 0,
                      "returnAmount": 0,
                      "salaeSchema": "string",
                      "value": 0
                    }
                  ],
                  "created_at": "2021-02-05T07:08:17.131Z",
                  "errors": [
                    {
                      "attribute_id": 0,
                      "code": "string",
                      "field": "string",
                      "level": "string"
                    }
                  ],
                  "id": 0,
                  "images": [
                    "string"
                  ],
                  "marketing_price": "string",
                  "min_ozon_price": "string",
                  "name": "string",
                  "offer_id": "string",
                  "old_price": "string",
                  "premium_price": "string",
                  "price": "string",
                  "price_index": "string",
                  "recommended_price": "string",
                  "sources": [
                    {
                      "is_enabled": true,
                      "sku": 0,
                      "source": "string"
                    }
                  ],
                  "state": "string",
                  "stocks": {
                    "coming": 0,
                    "present": 0,
                    "reserved": 0
                  },
                  "vat": "string",
                  "visibility_details": {
                    "active_product": true,
                    "has_price": true,
                    "has_stock": true
                  },
                  "visible": true,
                  "volume_weight": 0
                }
              }
              
              
              
              
              
              

              /info/list

              POST /v2/product/info/list

              Информация о списке товаров. Чтобы получить массив товаров по их идентификаторам, можно использовать метод POST v2/product/info/list. В теле запроса должен быть массив однотипных идентификаторов, в ответе будет массив items. Внутри items для каждого отправления поля совпадают с POST v2/product/info/. Swagger


              Параметры запроса

              offer_id string

              Идентификатор товара в системе продавца — артикул.

              product_id integer

              Идентификатор товара.

              sku integer

              Идентификатор товара в системе Ozon — SKU.


              Параметры ответа


              barcode string

              Штрихкод.

              buybox_price string

              Цена главного предложения на Ozon.

              category_id integer

              Идентификатор категории.

              created_at datetime

              Дата и время создания отправления.

              errors object

              Ошибки модерации.

              attribute_id integer

              Идентификатор характеристики.

              code string

              Код ошибки.

              field string

              Поле, в котором найдена ошибка.

              level string

              Уровень характеристики.

              id integer

              Номер задания на формирование документов.

              images array

              Массив ссылок на изображения. Каждая ссылка — string.

              marketing_price string

              Цена на товар с учетом всех акций. Это значение будет указано на витрине Ozon.

              min_ozon_price string

              Минимальная цена на аналогичный товар на Ozon.

              name string

              Название.

              offer_id string

              Идентификатор товара в системе продавца — артикул.

              old_price string

              Цена до учета скидок, на карточке товара отображается зачеркнутой.

              premium_price string

              Цена для клиентов с подпиской Ozon Premium.

              price string

              Цена товара с учетом скидок — это значение показывается на карточке товара.

              price_index string

              Ценовой индекс. Подробнее в Помощи

              recommended_price string

              Цена на товар, рекомендованная системой на основании схожих предложений.

              sources object

              Информация об источниках схожих предложений. Подробнее в Помощи

              is_enabled boolean

              Флаг, что источник учитывается при расчете рыночного значения.

              sku integer

              Идентификатор товара на Ozon.

              source string

              Ссылка на источник.

              state string

              Статус товара.

              stocks object

              Информация об остатках товара.

              coming integer

              Ожидается поставка.

              present integer

              Сейчас на складе.

              reserved integer

              Зарезервировано.

              vat string

              Ставка НДС для товара.

              visibility_details object

              Настройки видимости товара.

              has_price boolean

              True, если установлена цена.

              has_stock boolean

              True, если есть отстаток на складах.

              active_product boolean

              True, если активный товар.

              reasons object

              Указывается причина, почему товар скрыт.

              description string

              Описание причины.

              id integer

              Идентификатор причины.

              visible boolean

              True, если товар выставлен на продажу.

              POST /v2/product/info/list HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "offer_id": [
                  "string"
                ],
                "product_id": [
                  0
                ],
                "sku": [
                  0
                ]
              }
              Response status  200 
              {
                "result": {
                  "items": [
                    {
                      "barcode": "string",
                      "buybox_price": "string",
                      "category_id": 0,
                      "created_at": "2021-03-25T12:02:19.901Z",
                      "errors": [
                        {
                          "attribute_id": 0,
                          "code": "string",
                          "field": "string",
                          "level": "string"
                        }
                      ],
                      "id": 0,
                      "images": [
                        "string"
                      ],
                      "marketing_price": "string",
                      "min_ozon_price": "string",
                      "name": "string",
                      "offer_id": "string",
                      "old_price": "string",
                      "premium_price": "string",
                      "price": "string",
                      "price_index": "string",
                      "recommended_price": "string",
                      "sources": [
                        {
                          "is_enabled": true,
                          "sku": 0,
                          "source": "string"
                        }
                      ],
                      "state": "string",
                      "stocks": {
                        "coming": 0,
                        "present": 0,
                        "reserved": 0
                      },
                      "vat": "string",
                      "visibility_details": {
                        "active_product": true,
                        "has_price": true,
                        "has_stock": true,
                        "reasons": {
                          "additionalProp1": {
                            "reasons": [
                              {
                                "description": "string",
                                "id": 0
                              }
                            ]
                          },
                          "additionalProp2": {
                            "reasons": [
                              {
                                "description": "string",
                                "id": 0
                              }
                            ]
                          },
                          "additionalProp3": {
                            "reasons": [
                              {
                                "description": "string",
                                "id": 0
                              }
                            ]
                          }
                        }
                      },
                      "visible": true
                    }
                  ]
                }
              }

              /info/stocks

              POST /v2/product/info/stocks

              Информация о товарах. Количество задается в запросе. Swagger


              Параметры запроса

              page integer

              Номер страницы, возвращаемой в запросе.

              page_size integer

              Количество элементов на странице.


              Параметры ответа


              items object

              Информация о товарах.

              offer_id string

              Идентификатор товара в системе продавца — артикул.

              product_id integer

              Идентификатор товара.

              stocks object

              Информация об остатках.

              present integer

              Сейчас на складе.

              reserved integer

              Зарезервировано.

              type string

              Тип склада.

              total integer

              Количество товаров.

              POST /v2/product/info/stocks HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "page": 0,
                "page_size": 0
              }
              Response status  200 
              {
                "result": {
                  "items": [
                    {
                      "offer_id": "string",
                      "product_id": 0,
                      "stocks": [
                        {
                          "present": 0,
                          "reserved": 0,
                          "type": "string"
                        }
                      ]
                    }
                  ],
                  "total": 0
                }
              }

              v2 Products and prices

              /import

              POST /v2/product/import

              Upload your products to Ozon. You can send up to 100 products in a single request. Each product is a separate item in the items array. Specify all the information about the product: its characteristics, barcode, images, dimensions and price.

              The characteristics depend on the product category — you can see the list of required characteristics for some categories using the method POST /v2/category/attribute.

              After moderation, the product will appear in your personal account, but will not be visible to customers until you put it up for sale.


              Параметры запроса

              attributes * object

              An array with product characteristics.

              complex_id integer

              ID of the characteristic that supports nested properties. For example, the "Processor" characteristic has nested characteristics "Manufacturer", "L2 Cache", and others. Each of the nested characteristics can have several variants of values.

              id* integer

              Characteristic ID.

              values object

              Array of nested characteristic values.

              dictionary_value_id integer

              Directory ID.

              value string

              The value from the directory.

              barcode string

              Product barcode.

              complex_attributes object

              An array of characteristics that have nested characteristics.

              attributes array

              An array with product characteristics.

              depth integer

              The depth of tha package.

              dimension_unit string

              Unit of measurement of dimensions

              • mm — millimeters
              • cm — centimeters
              • in — inches

              height integer

              The height of the package.

              image_group_id string

              ID for subsequent batch loading of images.

              images string

              Array with images, no more than 10.

              name string

              Product name. Up to 500 characters.

              offer_id string

              Seller Product ID.

              old_price string

              Price before discounts (will be strikethrough on the PDP) in rubles. The decimal separator is a dot, up to two characters after the dot.

              pdf_list array

              List of PDF-files.

              premium_price string

              The price for Ozon Premium subscribers.

              price string

              The price of the product including discounts. It is displayed on the PDP. If there are no discounts on the product, specify the old_price value.

              vat string

              VAT rate for the product

              • 0 — not subject to VAT
              • 0.1 — 10%
              • 0.2 — 20%

                weight integer

                The weight of the product in the package. The limit value is 1000 kilograms or the converted value in other units of measurement.

                weight_unit string

                Weight units: g — grams, kg — kilograms, lb — pounds.

                width integer

                The width of the package.


                Параметры ответа


                POST /v2/product/import HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "items": [
                    {
                      "attributes": [
                        {
                          "complex_id": 0,
                          "id": 0,
                          "values": [
                            {
                              "dictionary_value_id": 0,
                              "value": "string"
                            }
                          ]
                        }
                      ],
                      "barcode": "string",
                      "category_id": 0,
                      "complex_attributes": [
                        {
                          "attributes": [
                            {
                              "complex_id": 0,
                              "id": 0,
                              "values": [
                                {
                                  "dictionary_value_id": 0,
                                  "value": "string"
                                }
                              ]
                            }
                          ]
                        }
                      ],
                      "depth": 0,
                      "dimension_unit": "string",
                      "height": 0,
                      "image_group_id": "string",
                      "images": [
                        "string"
                      ],
                      "images360": [
                        "string"
                      ],
                      "name": "string",
                      "offer_id": "string",
                      "old_price": "string",
                      "pdf_list": [
                        {
                          "index": 0,
                          "name": "string",
                          "src_url": "string"
                        }
                      ],
                      "premium_price": "string",
                      "price": "string",
                      "vat": "string",
                      "weight": 0,
                      "weight_unit": "string",
                      "width": 0
                    }
                  ]
                }
                Response status  200 
                {
                  "result": {
                    "task_id": 0
                  }
                }

                /info

                POST /v2/product/info

                Product details. Swagger


                Параметры запроса

                offer_id string

                Seller Product ID.

                sku integer

                Ozon Product ID — SKU.


                Параметры ответа


                buybox_price string

                The price of the main offer on Ozon.

                commissions object

                Commissions details.

                minValue integer

                Minimum commission.

                percent integer

                Commission percentage.

                saleSchema string

                Sale scheme.

                value integer

                Commission amount.

                created_at datetime

                Date and time when the shipment was created.

                errors object

                Moderation errors.

                attribute_id integer

                Characteristic ID.

                code string

                Error code.

                field string

                The field where the error was found.

                level string

                The level of the characteristic.

                id integer

                The number of the task for generating documents.

                images array

                Array of links to images. Each link is a string.

                marketing_price string

                The price of the product, including all promotions. This value will be shown on the Ozon showcase.

                min_ozon_price string

                The minimum price for the same product on Ozon.

                offer_id string

                Seller Product ID.

                old_price string

                The price before discounts, displayed strikethrough on the PDP.

                premium_price string

                The price for Ozon Premium subscribers.

                price string

                The product price including discounts. This value is displayed on the PDP.

                price_index string

                Price index. Learn more in Help Center

                recommended_price string

                The price of the product recommended by the system based on similar offers.

                sources object

                Information about the sources of similar offers. Learn more in Help Center

                is_enabled boolean

                True if the source is taken into account when calculating the market value.

                sku integer

                Ozon ID.

                source string

                Link to the source.

                state string

                Product status.

                stocks object

                Stock details.

                coming integer

                Expecting supply.

                present integer

                In a warehouse.

                vat string

                The VAT rate for the product.

                visible boolean

                True if the product is on sale.

                volume_weight integer

                The volumetric weight of the product.

                POST /v2/product/info HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "offer_id": "107112",
                  "product_id": 15214026,
                  "sku": 0
                }
                Response status  200 
                {
                  "result": {
                    "barcode": "string",
                    "buybox_price": "string",
                    "category_id": 0,
                    "commissions": [
                      {
                        "deliveryAmount": 0,
                        "minValue": 0,
                        "percent": 0,
                        "returnAmount": 0,
                        "salaeSchema": "string",
                        "value": 0
                      }
                    ],
                    "created_at": "2021-02-05T07:08:17.131Z",
                    "errors": [
                      {
                        "attribute_id": 0,
                        "code": "string",
                        "field": "string",
                        "level": "string"
                      }
                    ],
                    "id": 0,
                    "images": [
                      "string"
                    ],
                    "marketing_price": "string",
                    "min_ozon_price": "string",
                    "name": "string",
                    "offer_id": "string",
                    "old_price": "string",
                    "premium_price": "string",
                    "price": "string",
                    "price_index": "string",
                    "recommended_price": "string",
                    "sources": [
                      {
                        "is_enabled": true,
                        "sku": 0,
                        "source": "string"
                      }
                    ],
                    "state": "string",
                    "stocks": {
                      "coming": 0,
                      "present": 0,
                      "reserved": 0
                    },
                    "vat": "string",
                    "visibility_details": {
                      "active_product": true,
                      "has_price": true,
                      "has_stock": true
                    },
                    "visible": true,
                    "volume_weight": 0
                  }
                }
                
                
                
                
                
                

                /info/stocks

                POST /v2/product/info/stocks

                Information about products. The quantity is specified in the request. Swagger


                Параметры запроса

                page integer

                The number of the page returned in the request.

                page_size integer

                The number of items on the page.


                Параметры ответа


                items object

                Products details.

                offer_id string

                Seller Product ID.

                stocks object

                Stock details.

                present integer

                In a warehouse.

                reserved integer

                Reserved.

                type string

                Warehouse type.

                total integer

                The number of products.

                POST /v2/product/info/stocks HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "page": 0,
                  "page_size": 0
                }
                Response status  200 
                {
                  "result": {
                    "items": [
                      {
                        "offer_id": "string",
                        "product_id": 0,
                        "stocks": [
                          {
                            "present": 0,
                            "reserved": 0,
                            "type": "string"
                          }
                        ]
                      }
                    ],
                    "total": 0
                  }
                }

                /v2/products

                /delete

                POST /v2/products/delete

                Метод для удаления товаров без SKU из архива. В одном запросе можно передать до 1000 идентификаторов.


                Параметры запроса

                products integer

                Идентификатор товара.

                offer_id string

                Идентификатор товара в системе продавца — артикул.


                Параметры ответа


                deleted boolean

                True, если запрос выполнен без ошибок и товары удалены.

                POST /v2/products/delete HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                
                }
                Response status  200 
                {
                
                }

                /stocks

                POST /v2/products/stocks

                Метод для обновления количества товаров на складах. Swagger


                Параметры запроса

                stocks object

                Информация о товарах на складах.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                product_id integer

                Идентификатор товара.

                stock integer

                Количество.

                warehouse_id integer

                Идентификатор склада.


                Параметры ответа


                errors object

                Массив ошибок, которые возникли при обработке запроса.

                code string

                Код ошибки.

                message string

                Текст ошибки: SKU STOCK NOT CHANGED. Количество товара на стоке не изменилось, так как вы передаете тот же остаток.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                product_id integer

                Идентификатор товара.

                updated boolean

                True, если запрос выполнен успешно и остатки обновлены.

                warehouse_id integer

                Идентификатор склада.

                POST /v2/products/stocks HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                Can not resolve examples/v2/products/stocks/in.json
                Response status  200 
                Can not resolve examples/v2/products/stocks/out.json

                /v2/products

                /delete

                POST /v2/products/delete

                Method for deleting products without an SKU from the archive. Up to 1000 IDs can be sent in a single request.


                Параметры запроса

                products integer

                Product ID.

                offer_id string

                Seller Product ID.


                Параметры ответа


                deleted boolean

                True if the request was executed without errors and the products were deleted.

                POST /v2/products/delete HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                
                }
                Response status  200 
                {
                
                }

                /info/attributes

                POST /v2/products/info/attributes

                Возвращает описание характеристик товара по его идентификатору. Товар можно искать по offer_id или product_id.


                Параметры запроса

                filter object

                Фильтр товаров.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                product_id integer

                Идентификатор товара.

                page integer

                Номер страницы, возвращаемой в запросе.

                page_size integer

                Количество элементов на странице.


                Параметры ответа


                attributes object

                Массив характеристик товара.

                attributeId integer

                Идентификатор характеристики.

                complexId integer

                Идентификатор характеристики, которая поддерживает вложенные свойства. Например, у характеристики Процессор есть вложенные характеристики Производитель, L2 Cache, и другие. У каждой из вложенных характеристик может быть несколько вариантов значений.

                values object

                Массив значений характеристик.

                dictionaryValueId integer

                Идентификатор характеристики в словаре.

                value string

                Значение характеристики товара.

                barcode string

                Штрихкод.

                category_id integer

                Идентификатор категории.

                complex_attributes object

                Массив вложенных характеристик.

                attributeId integer

                Идентификатор характеристики.

                complexId integer

                Идентификатор характеристики, которая поддерживает вложенные свойства. Например, у характеристики Процессор есть вложенные характеристики Производитель, L2 Cache, и другие. У каждой из вложенных характеристик может быть несколько вариантов значений.

                values object

                Массив значений характеристик.

                dictionaryValueId integer

                Идентификатор характеристики в словаре.

                value string

                Значение характеристики товара.

                depth integer

                Глубина.

                dimension_unit string

                Единица измерения габаритов

                • mm — миллиметры,
                • cm — сантиметры,
                • in — дюймы.

                height integer

                Высота упаковки.

                id integer

                Идентификатор характеристики товара.

                image_group_id string

                Идентификатор для последующей пакетной загрузки изображений.

                images array

                Массив url для изображений товара.

                images360 array

                Массив изображений 360.

                name string

                Название товара. До 500 символов.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                pdf_list array

                Массив pdf-файлов.

                weight integer

                Вес товара в упаковке.

                weight_unit string

                Единица измерения веса.

                width integer

                Ширина упаковки.

                POST /v2/products/info/attributes HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "filter": {
                    "offer_id": [
                      "string"
                    ],
                    "product_id": [
                      0
                    ]
                  },
                  "page": 0,
                  "page_size": 0
                }
                Response status  200 
                {
                  "result": [
                    {
                      "attributes": [
                        {
                          "attributeId": 0,
                          "complexId": 0,
                          "values": [
                            {
                              "dictionaryValueId": 0,
                              "value": "string"
                            }
                          ]
                        }
                      ],
                      "barcode": "string",
                      "category_id": 0,
                      "complex_attributes": [
                        {
                          "attributes": [
                            {
                              "attributeId": 0,
                              "complexId": 0,
                              "values": [
                                {
                                  "dictionaryValueId": 0,
                                  "value": "string"
                                }
                              ]
                            }
                          ]
                        }
                      ],
                      "depth": 0,
                      "dimension_unit": "string",
                      "height": 0,
                      "id": 0,
                      "image_group_id": "string",
                      "images": [
                        {
                          "default": true,
                          "file_name": "string",
                          "index": 0
                        }
                      ],
                      "images360": [
                        {
                          "file_name": "string",
                          "index": 0
                        }
                      ],
                      "name": "string",
                      "offer_id": "string",
                      "pdf_list": [
                        {
                          "file_name": "string",
                          "index": 0,
                          "name": "string"
                        }
                      ],
                      "weight": 0,
                      "weight_unit": "string",
                      "width": 0
                    }
                  ]
                }

                /stocks

                POST /v2/products/stocks

                Method for updating the number of products in warehouses. Swagger


                Параметры запроса

                stocks object

                Information about products in warehouses.

                offer_id string

                Seller Product ID.

                stock integer

                Quantity.


                Параметры ответа


                errors object

                Array of errors that occurred when processing the request.

                code string

                Error code.

                message string

                Error text: SKU STOCK NOT CHANGED. The number of the product in the warehouse has not changed, since you are sending the same stock.

                offer_id string

                Seller Product ID.

                updated boolean

                True if the request is successful and the stock is updated.

                POST /v2/products/stocks HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                Can not resolve examples/v2/products/stocks/in.json
                Response status  200 
                Can not resolve examples/v2/products/stocks/out.json

                Отчеты

                Список отчетов

                POST /v1/report/list

                Возвращает список отчетов, которые были сформированы раньше. Swagger


                Параметры запроса

                page integer

                Количество страниц в ответе.

                page_size integer

                Количество элементов на странице.


                Параметры ответа


                reports object

                Массив со всеми сгенерированными отчетами

                code string

                Уникальный ID отчета.

                created_at string

                Дата создания отчета.

                error string

                Код ошибки при генерации отчета.

                file string

                Ссылка на файл формата CSV.

                params object

                Массив с фильтрами, указанными при создании отчета продавцом.

                report_type string

                Тип отчета:
                SELLER_PRODUCTS — отчет по товарам,
                SELLER_TRANSACTIONS — отчет по транзакциям.

                status string

                Статус генерации отчета, возможные значения "success", "failed".

                total integer

                Суммарное количество отчетов.

                POST /v1/report/list HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "page": 0,
                  "page_size": 0,
                  "report_type": "ALL"
                }
                Response status  200 
                {
                  "result": {
                    "reports": [
                      {
                        "code": "string",
                        "created_at": "2021-04-14T17:49:07.569Z",
                        "error": "string",
                        "file": "string",
                        "params": {
                          "additionalProp1": "string",
                          "additionalProp2": "string",
                          "additionalProp3": "string"
                        },
                        "report_type": "string",
                        "status": "string"
                      }
                    ],
                    "total": 0
                  }
                }

                Информация об отчете

                POST /v1/report/info

                Возвращает информацию о запрошенном отчете по его уникальному ID. Swagger


                Параметры запроса

                code string

                Уникальный ID отчета


                Параметры ответа


                code string

                Уникальный ID отчета.

                created_at string

                Дата создания отчета.

                error string

                Код ошибки при генерации отчета.

                file string

                Ссылка на файл формата CSV.

                params object

                Массив с фильтрами, указанными при создании отчета продавцом.

                report_type string

                Тип отчета:
                SELLER_PRODUCTS — отчет по товарам,
                SELLER_TRANSACTIONS — отчет по транзакциям.

                status string

                Статус генерации отчета, возможные значения "success", "failed".

                POST /v1/report/info HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "code": "string"
                }
                Response status  200 
                {
                  "result": {
                    "code": "string",
                    "created_at": "2021-04-14T18:50:30.522Z",
                    "error": "string",
                    "file": "string",
                    "params": {
                      "additionalProp1": "string",
                      "additionalProp2": "string",
                      "additionalProp3": "string"
                    },
                    "report_type": "string",
                    "status": "string"
                  }
                }

                Отчет по товарам

                POST /v1/report/products/create

                Возвращает отчет по товарам, который также доступен в личном кабинете продавца. Swagger


                Параметры запроса

                language string

                Язык в ответе: EN — английский, RU — русский. По умолчанию используется русский язык.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                search string

                Поиск по содержанию записи, проверяет наличие.

                sku integer

                Идентификатор товара в системе Ozon — SKU.

                visibility string

                Фильтр по видимости товара, возможные значения:
                - ALL: все товары.
                - VISIBLE: товары, которые видны покупателям.
                - INVISIBLE: товары, которые по какой-то из причин не видны покупателям.
                - EMPTY_STOCK: товары, у которых не указано наличие.
                - READY_TO_SUPPLY: товары, которым можно установить наличие.
                - STATE_FAILED: товары, создание которых завершилось ошибкой.


                Параметры ответа


                code string

                Уникальный ID отчета.

                POST /v1/report/products/create HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "language": "DEFAULT",
                  "offer_id": [
                    "string"
                  ],
                  "search": "string",
                  "sku": [
                    0
                  ],
                  "visibility": "ALL"
                }
                Response status  200 
                {
                  "result": {
                    "code": "string"
                  }
                }

                Отчет по транзакциям

                POST /v1/report/transactions/create

                Возвращает отчет по товарам, который также доступен в личном кабинете продавца. Swagger


                Параметры запроса

                date_from string

                Дата с которой рассчитывается отчет по транзакциям. Формат YYYY-MM-DD

                date_to string

                Дата по которую рассчитывается отчет по транзакциям. Формат YYYY-MM-DD

                language string

                Язык в ответе: EN — английский, RU — русский. По умолчанию используется русский язык.

                search string

                Поиск по содержанию записи, проверяет наличие.

                transaction_type string

                Фильтр по типу транзакции, возможные варианты


                Параметры ответа


                code string

                Уникальный ID отчета.

                POST /v1/report/transactions/create HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "date_from": "string",
                  "date_to": "string",
                  "language": "DEFAULT",
                  "search": "string",
                  "transaction_type": "ALL"
                }
                
                Response status  200 
                {
                  "result": {
                    "code": "string"
                  }
                }
                

                Статусы отправлений

                Методы для изменения статусов отправлений вручную. Используйте, если работаете по схеме Доставка по выбору продавца, чтобы переводить отправления по статусам и присваивать им трек-номера.

                /delivered

                POST /v2/fbs/posting/delivered

                Перевести отправление в статус "Доставлено", если используется сторонняя служба доставки.
                Swagger


                Параметры запроса

                posting_number * string

                Идентификатор отправления.


                Параметры ответа


                error integer

                Ошибка при обработке запроса.

                posting_number string

                Номер отправления.

                result boolean

                True, если запрос выполнен без ошибок.

                POST /v2/posting/fbs/delivered HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": [
                    "string"
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                /delivering

                POST /v2/fbs/posting/delivering

                Перевести отправление в статус "Доставляется", если используется сторонняя служба доставки.
                Swagger


                Параметры запроса

                posting_number * string

                Идентификатор отправления.


                Параметры ответа


                error integer

                Ошибка при обработке запроса.

                posting_number string

                Номер отправления.

                result boolean

                True, если запрос выполнен без ошибок.

                POST /v2/posting/fbs/delivering HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": [
                    "string"
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                /last-mile

                POST /v2/fbs/posting/last-mile

                Swagger


                Параметры запроса

                posting_number * string

                Идентификатор отправления.


                Параметры ответа


                error integer

                Ошибка при обработке запроса.

                posting_number string

                Номер отправления.

                result boolean

                True, если запрос выполнен без ошибок.

                POST /v2/fbs/posting/last-mile HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": [
                    "string"
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                /tracking-number/set

                POST /v2/fbs/posting/tracking-number/set

                Добавить трек-номера к отправлениям.
                Swagger


                Параметры запроса

                tracking_numbers * object

                Массив с парами идентификатор отправления — трек-номер.

                posting_number string

                Идентификатор отправления.

                tracking_number string

                Трек-номер отправления.


                Параметры ответа


                error integer

                Ошибка при обработке запроса.

                posting_number string

                Номер отправления.

                result array

                Список категорий.

                POST /v2/fbs/posting/tracking-number/set HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "tracking_numbers": [
                    {
                      "posting_number": "string",
                      "tracking_number": "string"
                    }
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                Shipment status

                Methods for changing the status of shipments manually, and assigning tracking numbers.

                /delivered

                POST /v2/fbs/posting/delivered

                Change to "Delivered", if you use a third-party delivery service.
                Swagger


                Параметры запроса


                Параметры ответа


                error integer

                Request processing error.

                posting_number string

                Shipment number.

                result boolean

                True if the request was executed without errors.

                POST /v2/posting/fbs/delivered HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": [
                    "string"
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                /delivering

                POST /v2/fbs/posting/delivering

                Change to "In Transit", if you use a third-party delivery service.
                Swagger


                Параметры запроса


                Параметры ответа


                error integer

                Request processing error.

                posting_number string

                Shipment number.

                result boolean

                True if the request was executed without errors.

                POST /v2/posting/fbs/delivering HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": [
                    "string"
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                /last-mile

                POST /v2/fbs/posting/last-mile

                Change to "Courier is on the way", if you use a third-party delivery service.
                Swagger


                Параметры запроса


                Параметры ответа


                error integer

                Request processing error.

                posting_number string

                Shipment number.

                result boolean

                True if the request was executed without errors.

                POST /v2/fbs/posting/last-mile HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": [
                    "string"
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                /tracking-number/set

                POST /v2/fbs/posting/tracking-number/set

                Assign tracking numbers to shipments.
                Swagger


                Параметры запроса

                tracking_numbers * object

                Array with shipment ID — track number pairs.

                tracking_number string

                Tracking number.


                Параметры ответа


                error integer

                Request processing error.

                posting_number string

                Shipment number.

                result boolean

                True if the request was executed without errors.

                POST /v2/fbs/posting/tracking-number/set HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "tracking_numbers": [
                    {
                      "posting_number": "string",
                      "tracking_number": "string"
                    }
                  ]
                }
                Response status  200 
                {
                  "result": [
                    {
                      "error": "string",
                      "posting_number": "string",
                      "result": true
                    }
                  ]
                }

                Доставка по выбору продавца

                /get

                POST /v3/posting/fbs/get

                Получить данные отравлений. Swagger


                Параметры запроса

                posting_number string

                Идентификатор отправления.

                with object

                Дополнительные поля, которые нужно добавить в ответ.

                analytics_data boolean

                Добавить в ответ данные аналитики.

                barcodes boolean

                Добавить в ответ штрихкоды отправления.

                financial_data boolean

                Добавить в ответ финансовые данные.


                Параметры ответа


                addressee object

                Контактные данные получателя.

                name string

                Имя покупателя.

                phone string

                Контактный телефон.

                analytics_data object

                Аналитические данные.

                city string

                Город доставки.

                delivery_date_begin datetime

                Дата и время начала доставки.

                delivery_date_end datetime

                Дата и время конца доставки.

                delivery_type string

                Способ доставки.

                is_premium boolean

                Наличие подписки Премиум.

                payment_type_group_name string

                Способ оплаты.

                region string

                Регион доставки.

                tpl_provider string

                Служба доставки.

                tpl_provider_id integer

                Идентификатор службы доставки.

                warehouse_id integer

                Идентификатор склада.

                warehouse string

                Название склада отправки заказа.

                barcodes object

                Штрихкоды отправления.

                upper_barcode string

                Верхний штрихкод на маркировке отправления.

                lower_barcode string

                Нижний штрихкод на маркировке отправления.

                cancellation object

                Информация об отмене.

                affect_cancellation_rating boolean

                True, если отмена влияет на рейтинг продавца.

                cancel_reason string

                Причина отмены.

                cancel_reason_id integer

                Идентификатор причины отмены отправления.

                cancellation_initiator string

                Инициатор отмены отправления.

                cancellation_type string

                Тип отмены.

                cancelled_after_ship boolean

                True, если отмена произошла после передачи отправления в службу доставки.

                customer object

                Данные о покупателе.

                address object

                Информация об адресе доставки.

                address_tail string

                Адрес в текстовом формате.

                city string

                Город доставки.

                comment string

                Комментарий к заказу.

                country string

                Страна доставки.

                district string

                Район доставки.

                latitude integer

                Широта.

                longitude integer

                Долгота.

                pvz_code integer

                Код ПВЗ.

                region string

                Регион доставки.

                zip_code string

                Почтовый индекс получателя.

                customer_email string

                Email покупателя.

                customer_id integer

                Идентификатор покупателя.

                name string

                Имя покупателя.

                phone string

                Контактный телефон.

                delivering_date datetime

                Дата доставки.

                delivery_method object

                Метод доставки.

                id integer

                Идентификатор способа доставки

                name string

                Название способа доставки.

                tpl_provider string

                Служба доставки.

                tpl_provider_id integer

                Идентификатор службы доставки.

                warehouse string

                Название склада.

                warehouse_id integer

                Идентификатор склада.

                delivery_price string

                Стоимость доставки.

                financial_data object

                Данные о стоимости товара, размере скидки, выплате и комиссии.

                products object

                Массив товаров в отправлении.

                actions array

                client_price string

                Цена, по которой купили товар.

                commission_amount integer

                Размер комиссии за товар.

                commission_percent integer

                Процент комиссии.

                old_price string

                Цена до учета скидок, на карточке товара отображается зачеркнутой.

                payout integer

                Выплата продавцу.

                picking object

                Информация про доставку.

                price string

                Цена товара с учетом скидок — это значение показывается на карточке товара.

                product_id integer

                Идентификатор товара.

                quantity integer

                Количество товара.

                total_discount_percent integer

                Процент скидки.

                total_discount_value integer

                Сумма скидки.

                in_process_at datetime

                Дата и время начала обработки отправления.

                order_id integer

                Идентификатор заказа, к которому относится отправление.

                order_number string

                Номер заказа, к которому относится отправление.

                posting_number string

                Номер отправления.

                products object

                dimensions object

                Размеры товара.

                height integer

                Высота упаковки.

                length integer

                Длина товара.

                weight integer

                Вес товара в упаковке.

                width integer

                Ширина упаковки.

                mandatory_mark string

                Обязательная маркировка товара.

                name string

                Название.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                price string

                Цена товара с учетом скидок — это значение показывается на карточке товара.

                quantity integer

                Количество товара.

                sku integer

                Идентификатор товара на Ozon.

                shipment_date datetime

                Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

                status string

                Статус отправления.

                tpl_integration_type string

                Тип интеграции со службой доставки.
                ozon— доставка службой Ozon.
                tpl_tracking— доставка интегрированной службой.
                non_integrated— доставка сторонней службой.

                tracking_number string

                Трек-номер отправления.

                POST /v3/posting/fbs/get HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": "string",
                  "with": {
                    "analytics_data": true,
                    "barcodes": true,
                    "financial_data": true
                  }
                }
                Response status  200 
                {
                  "result": {
                    "additional_data": [
                      {
                        "key": "string",
                        "value": "string"
                      }
                    ],
                    "addressee": {
                      "name": "string",
                      "phone": "string"
                    },
                    "analytics_data": {
                      "city": "string",
                      "delivery_date_begin": "2021-04-09T08:18:29.541Z",
                      "delivery_date_end": "2021-04-09T08:18:29.541Z",
                      "delivery_type": "string",
                      "is_premium": true,
                      "payment_type_group_name": "string",
                      "region": "string",
                      "tpl_provider": "string",
                      "tpl_provider_id": 0,
                      "warehouse": "string",
                      "warehouse_id": 0
                    },
                    "barcodes": {
                      "lower_barcode": "string",
                      "upper_barcode": "string"
                    },
                    "cancellation": {
                      "affect_cancellation_rating": true,
                      "cancel_reason": "string",
                      "cancel_reason_id": 0,
                      "cancellation_initiator": "string",
                      "cancellation_type": "string",
                      "cancelled_after_ship": true
                    },
                    "customer": {
                      "address": {
                        "address_tail": "string",
                        "city": "string",
                        "comment": "string",
                        "country": "string",
                        "district": "string",
                        "latitude": 0,
                        "longitude": 0,
                        "pvz_code": 0,
                        "region": "string",
                        "zip_code": "string"
                      },
                      "customer_email": "string",
                      "customer_id": 0,
                      "name": "string",
                      "phone": "string"
                    },
                    "delivering_date": "2021-04-09T08:18:29.541Z",
                    "delivery_method": {
                      "id": 0,
                      "name": "string",
                      "tpl_provider": "string",
                      "tpl_provider_id": 0,
                      "warehouse": "string",
                      "warehouse_id": 0
                    },
                    "delivery_price": "string",
                    "financial_data": {
                      "products": [
                        {
                          "actions": [
                            "string"
                          ],
                          "client_price": "string",
                          "commission_amount": 0,
                          "commission_percent": 0,
                          "old_price": 0,
                          "payout": 0,
                          "picking": {
                            "amount": 0,
                            "moment": "2021-04-09T08:18:29.541Z",
                            "tag": "string"
                          },
                          "price": 0,
                          "product_id": 0,
                          "quantity": 0,
                          "total_discount_percent": 0,
                          "total_discount_value": 0
                        }
                      ]
                    },
                    "in_process_at": "2021-04-09T08:18:29.541Z",
                    "order_id": 0,
                    "order_number": "string",
                    "posting_number": "string",
                    "products": [
                      {
                        "dimensions": {
                          "height": "string",
                          "length": "string",
                          "weight": "string",
                          "width": "string"
                        },
                        "mandatory_mark": [
                          "string"
                        ],
                        "name": "string",
                        "offer_id": "string",
                        "price": "string",
                        "quantity": 0,
                        "sku": 0
                      }
                    ],
                    "provider_status": "string",
                    "shipment_date": "2021-04-09T08:18:29.541Z",
                    "status": "string",
                    "tpl_integration_type": "string",
                    "tracking_number": "string"
                  }
                }

                /list

                POST /v3/posting/fbs/list

                Swagger


                Параметры запроса

                dir string

                Направление сортировки.

                • asc — по возрастанию,
                • desc — по убыванию.

                filter object

                delivery_method_id integer

                Идентификатор способа доставки.

                order_id string

                Идентификатор заказа.

                provider_id integer

                Идентификатор службы доставки.

                since datetime

                Начало периода в формате YYYY-MM-DD.

                to datetime

                Конец периода в формате YYYY-MM-DD.

                status string

                Статус отправления.

                • awaiting_approve — ожидает подтверждения,
                • awaiting_packaging — ожидает упаковки,
                • awaiting_deliver — ожидает отгрузки,
                • delivering — доставляется,
                • driver_pickup — у водителя,
                • delivered — доставлено,
                • cancelled — отменено.

                warehouse_id integer

                Идентификатор склада.

                limit integer

                Количество отправлений в ответе. Максимум — 50, минимум — 1.

                offset integer

                Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.

                with object

                Дополнительные поля, которые нужно добавить в ответ.

                analytics_data boolean

                Добавить в ответ данные аналитики.

                barcodes boolean

                Добавить в ответ штрихкоды отправления.

                financial_data boolean

                Добавить в ответ финансовые данные.


                Параметры ответа


                has_next boolean

                True, если нужно сделать повторный запрос с новым параметром offset. Это нужно для получения остальных методов.
                False, если были возвращены все методы доставки по запросу.

                postings string

                Массив отправлений и подробная информация по каждому. В этот параметр вложены остальные, перечисленные ниже.

                addressee object

                Контактные данные получателя.

                name string

                Имя покупателя.

                phone string

                Контактный телефон.

                analytics_data object

                Аналитические данные.

                city string

                Город доставки.

                delivery_date_begin datetime

                Дата и время начала доставки.

                delivery_date_end datetime

                Дата и время конца доставки.

                delivery_type string

                Способ доставки.

                is_premium boolean

                Наличие подписки Премиум.

                payment_type_group_name string

                Способ оплаты.

                region string

                Регион доставки.

                tpl_provider string

                Служба доставки.

                tpl_provider_id integer

                Идентификатор службы доставки.

                warehouse_id integer

                Идентификатор склада.

                warehouse string

                Название склада отправки заказа.

                barcodes object

                Штрихкоды отправления.

                upper_barcode string

                Верхний штрихкод на маркировке отправления.

                lower_barcode string

                Нижний штрихкод на маркировке отправления.

                cancellation object

                Информация об отмене.

                affect_cancellation_rating boolean

                True, если отмена влияет на рейтинг продавца.

                cancel_reason string

                Причина отмены.

                cancel_reason_id integer

                Идентификатор причины отмены отправления.

                cancellation_initiator string

                Инициатор отмены отправления.

                cancellation_type string

                Тип отмены.

                cancelled_after_ship boolean

                True, если отмена произошла после передачи отправления в службу доставки.

                customer object

                Данные о покупателе.

                address object

                Информация об адресе доставки.

                address_tail string

                Адрес в текстовом формате.

                city string

                Город доставки.

                comment string

                Комментарий к заказу.

                country string

                Страна доставки.

                district string

                Район доставки.

                latitude integer

                Широта.

                longitude integer

                Долгота.

                pvz_code integer

                Код ПВЗ.

                region string

                Регион доставки.

                zip_code string

                Почтовый индекс получателя.

                customer_email string

                Email покупателя.

                customer_id integer

                Идентификатор покупателя.

                name string

                Имя покупателя.

                phone string

                Контактный телефон.

                delivering_date datetime

                Дата доставки.

                delivery_method object

                Метод доставки.

                id integer

                Идентификатор способа доставки

                name string

                Название способа доставки.

                tpl_provider string

                Служба доставки.

                tpl_provider_id integer

                Идентификатор службы доставки.

                warehouse string

                Название склада.

                warehouse_id integer

                Идентификатор склада.

                financial_data object

                Данные о стоимости товара, размере скидки, выплате и комиссии.

                products object

                Массив товаров в отправлении.

                actions array

                client_price string

                Цена, по которой купили товар.

                commission_amount integer

                Размер комиссии за товар.

                commission_percent integer

                Процент комиссии.

                old_price string

                Цена до учета скидок, на карточке товара отображается зачеркнутой.

                payout integer

                Выплата продавцу.

                picking object

                Информация про доставку.

                price string

                Цена товара с учетом скидок — это значение показывается на карточке товара.

                product_id integer

                Идентификатор товара.

                quantity integer

                Количество товара.

                total_discount_percent integer

                Процент скидки.

                total_discount_value integer

                Сумма скидки.

                in_process_at datetime

                Дата и время начала обработки отправления.

                order_id integer

                Идентификатор заказа, к которому относится отправление.

                order_number string

                Номер заказа, к которому относится отправление.

                posting_number string

                Номер отправления.

                products object

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

                mandatory_mark string

                Обязательная маркировка товара.

                name string

                Название товара.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                price string

                Цена товара.

                quantity integer

                Количество товара в отправлении.

                sku integer

                Идентификатор товара в системе Ozon.

                shipment_date datetime

                Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

                status string

                Статус отправления.

                tpl_integration_type string

                Тип интеграции со службой доставки.
                ozon— доставка службой Ozon.
                tpl_tracking— доставка интегрированной службой.
                non_integrated— доставка сторонней службой.

                tracking_number string

                Трек-номер отправления.

                POST /v3/posting/fbs/list HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "dir": "string",
                  "filter": {
                    "delivery_method_id": [
                      0
                    ],
                    "order_id": 0,
                    "provider_id": [
                      0
                    ],
                    "since": "2020-12-09T18:53:03.052Z",
                    "status": "string",
                    "to": "2020-12-09T18:53:03.052Z",
                    "warehouse_id": [
                      0
                    ]
                  },
                  "limit": 0,
                  "offset": 0,
                  "with": {
                    "analytics_data": true,
                    "barcodes": true,
                    "financial_data": true
                  }
                }
                Response status  200 
                {
                  "result": {
                    "has_next": true,
                    "postings": [
                      {
                        "addressee": {
                          "name": "string",
                          "phone": "string"
                        },
                        "analytics_data": {
                          "city": "string",
                          "delivery_date_begin": "2021-04-09T08:09:19.463Z",
                          "delivery_date_end": "2021-04-09T08:09:19.463Z",
                          "delivery_type": "string",
                          "is_premium": true,
                          "payment_type_group_name": "string",
                          "region": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "barcodes": {
                          "lower_barcode": "string",
                          "upper_barcode": "string"
                        },
                        "cancellation": {
                          "affect_cancellation_rating": true,
                          "cancel_reason": "string",
                          "cancel_reason_id": 0,
                          "cancellation_initiator": "string",
                          "cancellation_type": "string",
                          "cancelled_after_ship": true
                        },
                        "customer": {
                          "address": {
                            "address_tail": "string",
                            "city": "string",
                            "comment": "string",
                            "country": "string",
                            "district": "string",
                            "latitude": 0,
                            "longitude": 0,
                            "pvz_code": 0,
                            "region": "string",
                            "zip_code": "string"
                          },
                          "customer_email": "string",
                          "customer_id": 0,
                          "name": "string",
                          "phone": "string"
                        },
                        "delivering_date": "2021-04-09T08:09:19.463Z",
                        "delivery_method": {
                          "id": 0,
                          "name": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "financial_data": {
                          "products": [
                            {
                              "actions": [
                                "string"
                              ],
                              "client_price": "string",
                              "commission_amount": 0,
                              "commission_percent": 0,
                              "old_price": 0,
                              "payout": 0,
                              "picking": {
                                "amount": 0,
                                "moment": "2021-04-09T08:09:19.463Z",
                                "tag": "string"
                              },
                              "price": 0,
                              "product_id": 0,
                              "quantity": 0,
                              "total_discount_percent": 0,
                              "total_discount_value": 0
                            }
                          ]
                        },
                        "in_process_at": "2021-04-09T08:09:19.463Z",
                        "order_id": 0,
                        "order_number": "string",
                        "posting_number": "string",
                        "products": [
                          {
                            "mandatory_mark": [
                              "string"
                            ],
                            "name": "string",
                            "offer_id": "string",
                            "price": "string",
                            "quantity": 0,
                            "sku": 0
                          }
                        ],
                        "shipment_date": "2021-04-09T08:09:19.463Z",
                        "status": "string",
                        "tpl_integration_type": "string",
                        "tracking_number": "string"
                      }
                    ]
                  }
                }

                /unfulfilled/list

                POST /v3/posting/fbs/unfulfilled/list

                Swagger


                Параметры запроса

                dir string

                Направление сортировки.

                • asc — по возрастанию,
                • desc — по убыванию.

                filter object

                delivering_date_from datetime

                Минимальная дата доставки.

                delivering_date_to datetime

                Максимальная дата доставки.

                delivery_method_id integer

                Идентификатор способа доставки.

                provider_id integer

                Идентификатор службы доставки.

                status string

                Статус отправления.

                • awaiting_approve — ожидает подтверждения,
                • awaiting_packaging — ожидает упаковки,
                • awaiting_deliver — ожидает отгрузки,
                • delivering — доставляется,
                • driver_pickup — у водителя,
                • delivered — доставлено,
                • cancelled — отменено.

                warehouse_id integer

                Идентификатор склада.

                limit integer

                Количество отправлений в ответе. Максимум — 50, минимум — 1.

                offset integer

                Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.

                with object

                Дополнительные поля, которые нужно добавить в ответ.

                analytics_data boolean

                Добавить в ответ данные аналитики.

                barcodes boolean

                Добавить в ответ штрихкоды отправления.

                financial_data boolean

                Добавить в ответ финансовые данные.


                Параметры ответа


                count integer

                Счетчик элементов в ответе.

                postings string

                Массив отправлений и подробная информация по каждому. В этот параметр вложены остальные, перечисленные ниже.

                addressee object

                Контактные данные получателя.

                name string

                Имя покупателя.

                phone string

                Контактный телефон.

                analytics_data object

                Аналитические данные.

                city string

                Город доставки.

                delivery_date_begin datetime

                Дата и время начала доставки.

                delivery_date_end datetime

                Дата и время конца доставки.

                delivery_type string

                Способ доставки.

                is_premium boolean

                Наличие подписки Премиум.

                payment_type_group_name string

                Способ оплаты.

                region string

                Регион доставки.

                tpl_provider string

                Служба доставки.

                tpl_provider_id integer

                Идентификатор службы доставки.

                warehouse_id integer

                Идентификатор склада.

                warehouse string

                Название склада отправки заказа.

                barcodes object

                Штрихкоды отправления.

                upper_barcode string

                Верхний штрихкод на маркировке отправления.

                lower_barcode string

                Нижний штрихкод на маркировке отправления.

                cancellation object

                Информация об отмене.

                affect_cancellation_rating boolean

                True, если отмена влияет на рейтинг продавца.

                cancel_reason string

                Причина отмены.

                cancel_reason_id integer

                Идентификатор причины отмены отправления.

                cancellation_initiator string

                Инициатор отмены отправления.

                cancellation_type string

                Тип отмены.

                cancelled_after_ship boolean

                True, если отмена произошла после передачи отправления в службу доставки.

                customer object

                Данные о покупателе.

                address object

                Информация об адресе доставки.

                address_tail string

                Адрес в текстовом формате.

                city string

                Город доставки.

                comment string

                Комментарий к заказу.

                country string

                Страна доставки.

                district string

                Район доставки.

                latitude integer

                Широта.

                longitude integer

                Долгота.

                pvz_code integer

                Код ПВЗ.

                region string

                Регион доставки.

                zip_code string

                Почтовый индекс получателя.

                customer_email string

                Email покупателя.

                customer_id integer

                Идентификатор покупателя.

                name string

                Имя покупателя.

                phone string

                Контактный телефон.

                delivering_date datetime

                Дата доставки.

                delivery_method object

                Метод доставки.

                id integer

                Идентификатор способа доставки

                name string

                Название способа доставки.

                tpl_provider string

                Служба доставки.

                tpl_provider_id integer

                Идентификатор службы доставки.

                warehouse string

                Название склада.

                warehouse_id integer

                Идентификатор склада.

                financial_data object

                Данные о стоимости товара, размере скидки, выплате и комиссии.

                products object

                Массив товаров в отправлении.

                actions array

                client_price string

                Цена, по которой купили товар.

                commission_amount integer

                Размер комиссии за товар.

                commission_percent integer

                Процент комиссии.

                old_price string

                Цена до учета скидок, на карточке товара отображается зачеркнутой.

                payout integer

                Выплата продавцу.

                picking object

                Информация про доставку.

                price string

                Цена товара с учетом скидок — это значение показывается на карточке товара.

                product_id integer

                Идентификатор товара.

                quantity integer

                Количество товара.

                total_discount_percent integer

                Процент скидки.

                total_discount_value integer

                Сумма скидки.

                in_process_at datetime

                Дата и время начала обработки отправления.

                order_id integer

                Идентификатор заказа, к которому относится отправление.

                order_number string

                Номер заказа, к которому относится отправление.

                posting_number string

                Номер отправления.

                products object

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

                mandatory_mark string

                Обязательная маркировка товара.

                name string

                Название товара.

                offer_id string

                Идентификатор товара в системе продавца — артикул.

                price string

                Цена товара.

                quantity integer

                Количество товара в отправлении.

                sku integer

                Идентификатор товара в системе Ozon.

                shipment_date datetime

                Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

                status string

                Статус отправления.

                tpl_integration_type string

                Тип интеграции со службой доставки.
                ozon— доставка службой Ozon.
                tpl_tracking— доставка интегрированной службой.
                non_integrated— доставка сторонней службой.

                tracking_number string

                Трек-номер отправления.

                POST /v3/posting/fbs/unfulfilled/list HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "dir": "string",
                  "filter": {
                    "cutoff_from": "2020-12-09T19:05:41.040Z",
                    "cutoff_to": "2020-12-09T19:05:41.040Z",
                    "delivering_date_from": "2020-12-09T19:05:41.040Z",
                    "delivering_date_to": "2020-12-09T19:05:41.040Z",
                    "delivery_method_id": [
                      0
                    ],
                    "provider_id": [
                      0
                    ],
                    "status": "string",
                    "warehouse_id": [
                      0
                    ]
                  },
                  "limit": 0,
                  "offset": 0,
                  "with": {
                    "analytics_data": true,
                    "barcodes": true,
                    "financial_data": true
                  }
                }
                Response status  200 
                {
                  "result": {
                    "count": 0,
                    "postings": [
                      {
                        "addressee": {
                          "name": "string",
                          "phone": "string"
                        },
                        "analytics_data": {
                          "city": "string",
                          "delivery_date_begin": "2021-04-09T07:39:22.867Z",
                          "delivery_date_end": "2021-04-09T07:39:22.867Z",
                          "delivery_type": "string",
                          "is_premium": true,
                          "payment_type_group_name": "string",
                          "region": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "barcodes": {
                          "lower_barcode": "string",
                          "upper_barcode": "string"
                        },
                        "cancellation": {
                          "affect_cancellation_rating": true,
                          "cancel_reason": "string",
                          "cancel_reason_id": 0,
                          "cancellation_initiator": "string",
                          "cancellation_type": "string",
                          "cancelled_after_ship": true
                        },
                        "customer": {
                          "address": {
                            "address_tail": "string",
                            "city": "string",
                            "comment": "string",
                            "country": "string",
                            "district": "string",
                            "latitude": 0,
                            "longitude": 0,
                            "pvz_code": 0,
                            "region": "string",
                            "zip_code": "string"
                          },
                          "customer_email": "string",
                          "customer_id": 0,
                          "name": "string",
                          "phone": "string"
                        },
                        "delivering_date": "2021-04-09T07:39:22.868Z",
                        "delivery_method": {
                          "id": 0,
                          "name": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "financial_data": {
                          "products": [
                            {
                              "actions": [
                                "string"
                              ],
                              "client_price": "string",
                              "commission_amount": 0,
                              "commission_percent": 0,
                              "old_price": 0,
                              "payout": 0,
                              "picking": {
                                "amount": 0,
                                "moment": "2021-04-09T07:39:22.868Z",
                                "tag": "string"
                              },
                              "price": 0,
                              "product_id": 0,
                              "quantity": 0,
                              "total_discount_percent": 0,
                              "total_discount_value": 0
                            }
                          ]
                        },
                        "in_process_at": "2021-04-09T07:39:22.868Z",
                        "order_id": 0,
                        "order_number": "string",
                        "posting_number": "string",
                        "products": [
                          {
                            "mandatory_mark": [
                              "string"
                            ],
                            "name": "string",
                            "offer_id": "string",
                            "price": "string",
                            "quantity": 0,
                            "sku": 0
                          }
                        ],
                        "shipment_date": "2021-04-09T07:39:22.868Z",
                        "status": "string",
                        "tpl_integration_type": "string",
                        "tracking_number": "string"
                      }
                    ]
                  }
                }

                Shipment details

                /get

                POST /v3/posting/fbs/get

                Get shipment details. Swagger


                Параметры запроса

                with object

                Additional data that can be requested.

                analytics_data boolean

                True to add analytics data.

                barcodes boolean

                True to add shipment barcodes.

                financial_data boolean

                True to add financial data.


                Параметры ответа


                addressee object

                The customer's details.

                name string

                The customer's name.

                phone string

                The customer's phone number.

                analytics_data object

                Analytics data.

                city string

                Delivery city.

                delivery_date_begin datetime

                Delivery start date and time.

                delivery_date_end datetime

                Delivery end date and time.

                delivery_type string

                Delivery type.

                is_premium boolean

                True if the customer has Premium subscription.

                region string

                Delivery region.

                tpl_provider string

                Delivery service.

                tpl_provider_id integer

                Delivery service ID.

                warehouse string

                The warehouse name from where order dispatched.

                barcodes object

                Shipment barcodes.

                upper_barcode string

                The upper barcode on the shipment label.

                lower_barcode string

                The lower barcode on the shipment label.

                cancellation object

                Cancellation data.

                affect_cancellation_rating boolean

                True, if cancellation affects seller's rating.

                cancel_reason string

                Cancellation reason.

                cancel_reason_id integer

                Cancellation reason ID.

                cancellation_initiator string

                Cancellation requestor.

                cancellation_type string

                Cancellation type.

                cancelled_after_ship boolean

                True, if cancellation occured after the shipment had been transferred to the delivery service.

                customer object

                The customer's details.

                address object

                Delivery address.

                address_tail string

                Address in text format.

                addressee string

                Name and surname of the recipient.

                city string

                Delivery city.

                comment string

                Additional information from the customer.

                country string

                Delivery country.

                district string

                Delivery district.

                phone string

                The customer's phone number.

                region string

                Delivery region.

                zip_code string

                ZIP or postal code.

                customer_email string

                The customer's e-mail.

                name string

                The customer's name.

                phone string

                The customer's phone number.

                delivery_method object

                Delivery method.

                id integer

                Delivery method ID.

                name string

                Delivery method name.

                tpl_provider string

                Delivery service.

                tpl_provider_id integer

                Delivery service ID.

                warehouse string

                Warehouse name.

                delivery_price string

                Delivery price.

                financial_data object

                Data on the cost of the product, the amount of the discount, payment and commission.

                products object

                Array of products in the shipment.

                actions array

                client_price string

                The price at which the product was purchased.

                commission_amount integer

                Commission amount for the product

                commission_percent integer

                Commission percentage.

                old_price string

                The price before discounts, displayed strikethrough on the PDP.

                payout integer

                Payment to the seller.

                picking object

                Delivery details.

                price string

                The product price including discounts. This value is displayed on the PDP.

                product_id integer

                Product ID.

                quantity integer

                Number of items.

                total_discount_percent integer

                Discount percentage.

                total_discount_value integer

                Discount amount.

                in_process_at datetime

                Date and time when the shipment processing started.

                order_number string

                Order number.

                posting_number string

                Shipment number.

                products object

                dimensions object

                Product dimensions.

                height integer

                The height of the package.

                length integer

                The length of the package.

                weight integer

                The weight of the product in the package.

                width integer

                The width of the package.

                mandatory_mark string

                Mandatory marking.

                offer_id string

                Seller Product ID.

                price string

                The product price including discounts. This value is displayed on the PDP.

                quantity integer

                Number of items.

                sku integer

                Ozon ID.

                provider_status string

                Shipment status from a delivery service.

                shipment_date datetime

                The date and time by which the shipment must be packeged. If the shipment is not collected by this date — it will be automatically cancelled.

                status string

                Shipment status.

                tpl_integration_type string

                The type of integration with a delivery service.
                ozon— Ozon Logistics.
                tpl_tracking— integrated delivery service.
                non_integrated— non-integrated delivery service.

                tracking_number string

                Shipment tracking number.

                POST /v3/posting/fbs/get HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "posting_number": "string",
                  "with": {
                    "analytics_data": true,
                    "barcodes": true,
                    "financial_data": true
                  }
                }
                Response status  200 
                {
                  "result": {
                    "additional_data": [
                      {
                        "key": "string",
                        "value": "string"
                      }
                    ],
                    "addressee": {
                      "name": "string",
                      "phone": "string"
                    },
                    "analytics_data": {
                      "city": "string",
                      "delivery_date_begin": "2021-04-09T08:18:29.541Z",
                      "delivery_date_end": "2021-04-09T08:18:29.541Z",
                      "delivery_type": "string",
                      "is_premium": true,
                      "payment_type_group_name": "string",
                      "region": "string",
                      "tpl_provider": "string",
                      "tpl_provider_id": 0,
                      "warehouse": "string",
                      "warehouse_id": 0
                    },
                    "barcodes": {
                      "lower_barcode": "string",
                      "upper_barcode": "string"
                    },
                    "cancellation": {
                      "affect_cancellation_rating": true,
                      "cancel_reason": "string",
                      "cancel_reason_id": 0,
                      "cancellation_initiator": "string",
                      "cancellation_type": "string",
                      "cancelled_after_ship": true
                    },
                    "customer": {
                      "address": {
                        "address_tail": "string",
                        "city": "string",
                        "comment": "string",
                        "country": "string",
                        "district": "string",
                        "latitude": 0,
                        "longitude": 0,
                        "pvz_code": 0,
                        "region": "string",
                        "zip_code": "string"
                      },
                      "customer_email": "string",
                      "customer_id": 0,
                      "name": "string",
                      "phone": "string"
                    },
                    "delivering_date": "2021-04-09T08:18:29.541Z",
                    "delivery_method": {
                      "id": 0,
                      "name": "string",
                      "tpl_provider": "string",
                      "tpl_provider_id": 0,
                      "warehouse": "string",
                      "warehouse_id": 0
                    },
                    "delivery_price": "string",
                    "financial_data": {
                      "products": [
                        {
                          "actions": [
                            "string"
                          ],
                          "client_price": "string",
                          "commission_amount": 0,
                          "commission_percent": 0,
                          "old_price": 0,
                          "payout": 0,
                          "picking": {
                            "amount": 0,
                            "moment": "2021-04-09T08:18:29.541Z",
                            "tag": "string"
                          },
                          "price": 0,
                          "product_id": 0,
                          "quantity": 0,
                          "total_discount_percent": 0,
                          "total_discount_value": 0
                        }
                      ]
                    },
                    "in_process_at": "2021-04-09T08:18:29.541Z",
                    "order_id": 0,
                    "order_number": "string",
                    "posting_number": "string",
                    "products": [
                      {
                        "dimensions": {
                          "height": "string",
                          "length": "string",
                          "weight": "string",
                          "width": "string"
                        },
                        "mandatory_mark": [
                          "string"
                        ],
                        "name": "string",
                        "offer_id": "string",
                        "price": "string",
                        "quantity": 0,
                        "sku": 0
                      }
                    ],
                    "provider_status": "string",
                    "shipment_date": "2021-04-09T08:18:29.541Z",
                    "status": "string",
                    "tpl_integration_type": "string",
                    "tracking_number": "string"
                  }
                }

                /list

                POST /v3/posting/fbs/list

                Swagger


                Параметры запроса

                dir string

                Sorting direction.

                • asc — ascending
                • desc — descending

                filter object

                delivery_method_id integer

                Delivery method ID.

                provider_id integer

                Delivery service ID.

                since datetime

                The start of the period in the YYYY-MM-DD format.

                to datetime

                The end of the period in the YYYY-MM-DD format.

                status string

                Shipment status.

                • awaiting_approve
                • awaiting_packaging
                • awaiting_deliver — awaiting shipping
                • delivering — in transit
                • driver_pickup — a driver is delivering a package
                • delivered
                • cancelled

                limit integer

                Number of shipments in a response. Maximum — 50, minimum — 1.

                offset integer

                Number of omitted items in a response. For example, if the value of offset is 10, the response starts from the 11th item.

                with object

                Additional data that can be requested.

                analytics_data boolean

                True to add analytics data.

                barcodes boolean

                True to add shipment barcodes.

                financial_data boolean

                True to add financial data.


                Параметры ответа


                has_next boolean

                True, if you need to make a request with a new offset parameter value. You need this to get the rest of delivery methods.
                False, if all delivery methods are returned.

                postings string

                An array of shipments with the detailed information on each.

                addressee object

                The customer's details.

                name string

                The customer's name.

                phone string

                The customer's phone number.

                analytics_data object

                Analytics data.

                city string

                Delivery city.

                delivery_date_begin datetime

                Delivery start date and time.

                delivery_date_end datetime

                Delivery end date and time.

                delivery_type string

                Delivery type.

                is_premium boolean

                True if the customer has Premium subscription.

                region string

                Delivery region.

                tpl_provider string

                Delivery service.

                tpl_provider_id integer

                Delivery service ID.

                warehouse string

                The warehouse name from where order dispatched.

                barcodes object

                Shipment barcodes.

                upper_barcode string

                The upper barcode on the shipment label.

                lower_barcode string

                The lower barcode on the shipment label.

                cancellation object

                Cancellation data.

                affect_cancellation_rating boolean

                True, if cancellation affects seller's rating.

                cancel_reason string

                Cancellation reason.

                cancel_reason_id integer

                Cancellation reason ID.

                cancellation_initiator string

                Cancellation requestor.

                cancellation_type string

                Cancellation type.

                cancelled_after_ship boolean

                True, if cancellation occured after the shipment had been transferred to the delivery service.

                customer object

                The customer's details.

                address object

                Delivery address.

                address_tail string

                Address in text format.

                addressee string

                Name and surname of the recipient.

                city string

                Delivery city.

                comment string

                Additional information from the customer.

                country string

                Delivery country.

                district string

                Delivery district.

                phone string

                The customer's phone number.

                region string

                Delivery region.

                zip_code string

                ZIP or postal code.

                customer_email string

                The customer's e-mail.

                name string

                The customer's name.

                phone string

                The customer's phone number.

                delivery_method object

                Delivery method.

                id integer

                Delivery method ID.

                name string

                Delivery method name.

                tpl_provider string

                Delivery service.

                tpl_provider_id integer

                Delivery service ID.

                warehouse string

                Warehouse name.

                financial_data object

                Data on the cost of the product, the amount of the discount, payment and commission.

                products object

                Array of products in the shipment.

                actions array

                client_price string

                The price at which the product was purchased.

                commission_amount integer

                Commission amount for the product

                commission_percent integer

                Commission percentage.

                old_price string

                The price before discounts, displayed strikethrough on the PDP.

                payout integer

                Payment to the seller.

                picking object

                Delivery details.

                price string

                The product price including discounts. This value is displayed on the PDP.

                product_id integer

                Product ID.

                quantity integer

                Number of items.

                total_discount_percent integer

                Discount percentage.

                total_discount_value integer

                Discount amount.

                in_process_at datetime

                Date and time when the shipment processing started.

                order_number string

                Order number.

                posting_number string

                Shipment number.

                products object

                Liat of products in the shipment.

                mandatory_mark string

                Mandatory marking.

                name string

                Product name.

                offer_id string

                Seller Product ID.

                price string

                Product price.

                quantity integer

                Number of items in the shipment.

                sku integer

                Ozon ID.

                shipment_date datetime

                The date and time by which the shipment must be packeged. If the shipment is not collected by this date — it will be automatically cancelled.

                status string

                Shipment status.

                tpl_integration_type string

                The type of integration with a delivery service.
                ozon— Ozon Logistics.
                tpl_tracking— integrated delivery service.
                non_integrated— non-integrated delivery service.

                tracking_number string

                Shipment tracking number.

                POST /v3/posting/fbs/list HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "dir": "string",
                  "filter": {
                    "delivery_method_id": [
                      0
                    ],
                    "order_id": 0,
                    "provider_id": [
                      0
                    ],
                    "since": "2020-12-09T18:53:03.052Z",
                    "status": "string",
                    "to": "2020-12-09T18:53:03.052Z",
                    "warehouse_id": [
                      0
                    ]
                  },
                  "limit": 0,
                  "offset": 0,
                  "with": {
                    "analytics_data": true,
                    "barcodes": true,
                    "financial_data": true
                  }
                }
                Response status  200 
                {
                  "result": {
                    "has_next": true,
                    "postings": [
                      {
                        "addressee": {
                          "name": "string",
                          "phone": "string"
                        },
                        "analytics_data": {
                          "city": "string",
                          "delivery_date_begin": "2021-04-09T08:09:19.463Z",
                          "delivery_date_end": "2021-04-09T08:09:19.463Z",
                          "delivery_type": "string",
                          "is_premium": true,
                          "payment_type_group_name": "string",
                          "region": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "barcodes": {
                          "lower_barcode": "string",
                          "upper_barcode": "string"
                        },
                        "cancellation": {
                          "affect_cancellation_rating": true,
                          "cancel_reason": "string",
                          "cancel_reason_id": 0,
                          "cancellation_initiator": "string",
                          "cancellation_type": "string",
                          "cancelled_after_ship": true
                        },
                        "customer": {
                          "address": {
                            "address_tail": "string",
                            "city": "string",
                            "comment": "string",
                            "country": "string",
                            "district": "string",
                            "latitude": 0,
                            "longitude": 0,
                            "pvz_code": 0,
                            "region": "string",
                            "zip_code": "string"
                          },
                          "customer_email": "string",
                          "customer_id": 0,
                          "name": "string",
                          "phone": "string"
                        },
                        "delivering_date": "2021-04-09T08:09:19.463Z",
                        "delivery_method": {
                          "id": 0,
                          "name": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "financial_data": {
                          "products": [
                            {
                              "actions": [
                                "string"
                              ],
                              "client_price": "string",
                              "commission_amount": 0,
                              "commission_percent": 0,
                              "old_price": 0,
                              "payout": 0,
                              "picking": {
                                "amount": 0,
                                "moment": "2021-04-09T08:09:19.463Z",
                                "tag": "string"
                              },
                              "price": 0,
                              "product_id": 0,
                              "quantity": 0,
                              "total_discount_percent": 0,
                              "total_discount_value": 0
                            }
                          ]
                        },
                        "in_process_at": "2021-04-09T08:09:19.463Z",
                        "order_id": 0,
                        "order_number": "string",
                        "posting_number": "string",
                        "products": [
                          {
                            "mandatory_mark": [
                              "string"
                            ],
                            "name": "string",
                            "offer_id": "string",
                            "price": "string",
                            "quantity": 0,
                            "sku": 0
                          }
                        ],
                        "shipment_date": "2021-04-09T08:09:19.463Z",
                        "status": "string",
                        "tpl_integration_type": "string",
                        "tracking_number": "string"
                      }
                    ]
                  }
                }

                /unfulfilled/list

                POST /v3/posting/fbs/unfulfilled/list

                Swagger


                Параметры запроса

                dir string

                Sorting direction.

                • asc — ascending
                • desc — descending

                limit integer

                Number of shipments in a response. Maximum — 50, minimum — 1.

                offset integer

                Number of omitted items in a response. For example, if the value of offset is 10, the response starts from the 11th item.

                with object

                Additional data that can be requested.

                analytics_data boolean

                True to add analytics data.

                barcodes boolean

                True to add shipment barcodes.

                financial_data boolean

                True to add financial data.


                Параметры ответа


                postings string

                An array of shipments with the detailed information on each.

                addressee object

                The customer's details.

                name string

                The customer's name.

                phone string

                The customer's phone number.

                analytics_data object

                Analytics data.

                city string

                Delivery city.

                delivery_date_begin datetime

                Delivery start date and time.

                delivery_date_end datetime

                Delivery end date and time.

                delivery_type string

                Delivery type.

                is_premium boolean

                True if the customer has Premium subscription.

                region string

                Delivery region.

                tpl_provider string

                Delivery service.

                tpl_provider_id integer

                Delivery service ID.

                warehouse string

                The warehouse name from where order dispatched.

                barcodes object

                Shipment barcodes.

                upper_barcode string

                The upper barcode on the shipment label.

                lower_barcode string

                The lower barcode on the shipment label.

                cancellation object

                Cancellation data.

                affect_cancellation_rating boolean

                True, if cancellation affects seller's rating.

                cancel_reason string

                Cancellation reason.

                cancel_reason_id integer

                Cancellation reason ID.

                cancellation_initiator string

                Cancellation requestor.

                cancellation_type string

                Cancellation type.

                cancelled_after_ship boolean

                True, if cancellation occured after the shipment had been transferred to the delivery service.

                customer object

                The customer's details.

                address object

                Delivery address.

                address_tail string

                Address in text format.

                addressee string

                Name and surname of the recipient.

                city string

                Delivery city.

                comment string

                Additional information from the customer.

                country string

                Delivery country.

                district string

                Delivery district.

                phone string

                The customer's phone number.

                region string

                Delivery region.

                zip_code string

                ZIP or postal code.

                customer_email string

                The customer's e-mail.

                name string

                The customer's name.

                phone string

                The customer's phone number.

                delivery_method object

                Delivery method.

                id integer

                Delivery method ID.

                name string

                Delivery method name.

                tpl_provider string

                Delivery service.

                tpl_provider_id integer

                Delivery service ID.

                warehouse string

                Warehouse name.

                financial_data object

                Data on the cost of the product, the amount of the discount, payment and commission.

                products object

                Array of products in the shipment.

                actions array

                client_price string

                The price at which the product was purchased.

                commission_amount integer

                Commission amount for the product

                commission_percent integer

                Commission percentage.

                old_price string

                The price before discounts, displayed strikethrough on the PDP.

                payout integer

                Payment to the seller.

                picking object

                Delivery details.

                price string

                The product price including discounts. This value is displayed on the PDP.

                product_id integer

                Product ID.

                quantity integer

                Number of items.

                total_discount_percent integer

                Discount percentage.

                total_discount_value integer

                Discount amount.

                in_process_at datetime

                Date and time when the shipment processing started.

                order_number string

                Order number.

                posting_number string

                Shipment number.

                products object

                Liat of products in the shipment.

                mandatory_mark string

                Mandatory marking.

                name string

                Product name.

                offer_id string

                Seller Product ID.

                price string

                Product price.

                quantity integer

                Number of items in the shipment.

                sku integer

                Ozon ID.

                shipment_date datetime

                The date and time by which the shipment must be packeged. If the shipment is not collected by this date — it will be automatically cancelled.

                status string

                Shipment status.

                tpl_integration_type string

                The type of integration with a delivery service.
                ozon— Ozon Logistics.
                tpl_tracking— integrated delivery service.
                non_integrated— non-integrated delivery service.

                tracking_number string

                Shipment tracking number.

                POST /v3/posting/fbs/unfulfilled/list HTTP/1.1
                Host: api-seller.ozon.ru 
                Client-Id: 836
                Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                Content-Type: application/json
                {
                  "dir": "string",
                  "filter": {
                    "cutoff_from": "2020-12-09T19:05:41.040Z",
                    "cutoff_to": "2020-12-09T19:05:41.040Z",
                    "delivering_date_from": "2020-12-09T19:05:41.040Z",
                    "delivering_date_to": "2020-12-09T19:05:41.040Z",
                    "delivery_method_id": [
                      0
                    ],
                    "provider_id": [
                      0
                    ],
                    "status": "string",
                    "warehouse_id": [
                      0
                    ]
                  },
                  "limit": 0,
                  "offset": 0,
                  "with": {
                    "analytics_data": true,
                    "barcodes": true,
                    "financial_data": true
                  }
                }
                Response status  200 
                {
                  "result": {
                    "count": 0,
                    "postings": [
                      {
                        "addressee": {
                          "name": "string",
                          "phone": "string"
                        },
                        "analytics_data": {
                          "city": "string",
                          "delivery_date_begin": "2021-04-09T07:39:22.867Z",
                          "delivery_date_end": "2021-04-09T07:39:22.867Z",
                          "delivery_type": "string",
                          "is_premium": true,
                          "payment_type_group_name": "string",
                          "region": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "barcodes": {
                          "lower_barcode": "string",
                          "upper_barcode": "string"
                        },
                        "cancellation": {
                          "affect_cancellation_rating": true,
                          "cancel_reason": "string",
                          "cancel_reason_id": 0,
                          "cancellation_initiator": "string",
                          "cancellation_type": "string",
                          "cancelled_after_ship": true
                        },
                        "customer": {
                          "address": {
                            "address_tail": "string",
                            "city": "string",
                            "comment": "string",
                            "country": "string",
                            "district": "string",
                            "latitude": 0,
                            "longitude": 0,
                            "pvz_code": 0,
                            "region": "string",
                            "zip_code": "string"
                          },
                          "customer_email": "string",
                          "customer_id": 0,
                          "name": "string",
                          "phone": "string"
                        },
                        "delivering_date": "2021-04-09T07:39:22.868Z",
                        "delivery_method": {
                          "id": 0,
                          "name": "string",
                          "tpl_provider": "string",
                          "tpl_provider_id": 0,
                          "warehouse": "string",
                          "warehouse_id": 0
                        },
                        "financial_data": {
                          "products": [
                            {
                              "actions": [
                                "string"
                              ],
                              "client_price": "string",
                              "commission_amount": 0,
                              "commission_percent": 0,
                              "old_price": 0,
                              "payout": 0,
                              "picking": {
                                "amount": 0,
                                "moment": "2021-04-09T07:39:22.868Z",
                                "tag": "string"
                              },
                              "price": 0,
                              "product_id": 0,
                              "quantity": 0,
                              "total_discount_percent": 0,
                              "total_discount_value": 0
                            }
                          ]
                        },
                        "in_process_at": "2021-04-09T07:39:22.868Z",
                        "order_id": 0,
                        "order_number": "string",
                        "posting_number": "string",
                        "products": [
                          {
                            "mandatory_mark": [
                              "string"
                            ],
                            "name": "string",
                            "offer_id": "string",
                            "price": "string",
                            "quantity": 0,
                            "sku": 0
                          }
                        ],
                        "shipment_date": "2021-04-09T07:39:22.868Z",
                        "status": "string",
                        "tpl_integration_type": "string",
                        "tracking_number": "string"
                      }
                    ]
                  }
                }

                Информация о транзакциях

                Информация о транзакциях за указанный период, по конкретным отправлениями или определенного типа.

                /transaction​/list

                POST /v2/finance/transaction​/list

                Возвращает подробную информацию по транзакциям для отправления. Если в запросе не указывать posting_number, то в ответе будут все отправления за указанный период или отправления определенного типа.


                Параметры запроса

                filter * object

                Фильтр для поиска транзакций.

                date object

                Период времени.

                from datetime

                Начало периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                to datetime

                Конец периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                posting_number string

                Номер отправления.

                transaction_type string

                Тип транзакции

                • all — все,
                • orders — заказы,
                • returns — возвраты,
                • services — сервисные сборы.

                  page * integer

                  Номер страницы, возвращаемой в запросе.

                  page_size * integer

                  Количество элементов на странице.


                  Параметры ответа


                  commission_amount integer

                  Сумма комиссии.

                  details string

                  Информация о товаре в транзакции.

                  discount_amount integer

                  Сумма скидки.

                  item_delivery_amount integer

                  Количество доставленных товаров.

                  item_return_amount integer

                  Сумма скидки.

                  order_amount integer

                  Сумма заказа.

                  order_date datetime

                  Дата заказа в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                  order_number string

                  Номер заказа.

                  order_state string

                  Статус отправления

                  total_amount string

                  Итоговый размер начислений.

                  transaction_date datetime

                  Дата транзакции в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                  transaction_number integer

                  Идентификатор транзакции.

                  transaction_type string

                  Тип транзакции.

                  transaction_type_slug string

                  Тип транзакции в системном виде

                  POST /v2/finance/transaction/list HTTP/1.1
                  Host: api-seller.ozon.ru 
                  Client-Id: 836
                  Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                  Content-Type: application/json
                  {
                    "filter": {
                      "date": {
                        "from": "2021-03-02T10:17:12.739Z",
                        "to": "2021-03-02T10:17:12.739Z"
                      },
                      "posting_number": "string",
                      "transaction_type": "string"
                    },
                    "page": 0,
                    "page_size": 0
                  }
                  Response status  200 
                  {
                    "result": [
                      {
                        "commission_amount": 0,
                        "details": "string",
                        "discount_amount": 0,
                        "item_delivery_amount": 0,
                        "item_return_amount": 0,
                        "order_amount": 0,
                        "order_date": "2021-03-02T10:23:58.217Z",
                        "order_number": "string",
                        "order_state": "string",
                        "total_amount": 0,
                        "transaction_date": "2021-03-02T10:23:58.217Z",
                        "transaction_number": 0,
                        "transaction_type": "string",
                        "transaction_type_slug": "string"
                      }
                    ]
                  }

                  /transaction/totals

                  POST /v2/finance/transaction/totals

                  Возвращает итоговые суммы по транзакциям за указанный период.


                  Параметры запроса

                  filter * object

                  Фильтр для поиска транзакций.

                  date object

                  Период времени.

                  from datetime

                  Начало периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                  to datetime

                  Конец периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                  posting_number string

                  Номер отправления.

                  transaction_type string

                  Тип транзакции

                  • all — все,
                  • orders — заказы,
                  • returns — возвраты,
                  • services — сервисные сборы.

                    page * integer

                    Номер страницы, возвращаемой в запросе.

                    page_size * integer

                    Количество элементов на странице.


                    Параметры ответа


                    commission_amount integer

                    Размер комиссии за товар.

                    discount_amount integer

                    Сумма скидки.

                    item_delivery_amount integer

                    Количество доставленных товаров.

                    item_return_amount integer

                    Количество возвратов.

                    order_amount integer

                    Сумма заказа.

                    total_amount integer

                    Итоговый размер начислений.

                    POST /v2/finance/transaction/totals HTTP/1.1
                    Host: api-seller.ozon.ru 
                    Client-Id: 836
                    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                    Content-Type: application/json
                    {
                      "filter": {
                        "date": {
                          "from": "2021-04-14T15:38:20.247Z",
                          "to": "2021-04-14T15:38:20.247Z"
                        },
                        "posting_number": "string",
                        "transaction_type": "string"
                      },
                      "page": 0,
                      "page_size": 0
                    }
                    Response status  200 
                    {
                      "commission_amount": 0,
                      "discount_amount": 0,
                      "item_delivery_amount": 0,
                      "item_return_amount": 0,
                      "order_amount": 0,
                      "total_amount": 0
                    }

                    /v3/finance/transaction

                    Список транзакций

                    POST /v3/finance/transaction/list

                    Возвращает подробную информацию по всем начислениям. Можно указать номер отправления (posting_number), чтобы получить все начисления за указанный период, связанные с отправлением. Можно выбрать начисления определенного типа.


                    Параметры запроса

                    filter * object

                    Фильтр для поиска транзакций.

                    date object

                    Период времени.

                    from datetime

                    Начало промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                    to datetime

                    Конец промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                    operation_type string

                    Типы операций:
                    - ClientReturnAgentOperation — Получение возврата, отмены, невыкупа от покупателя,
                    - MarketplaceMarketingActionCostOperation — Услуги продвижения товаров,
                    - MarketplaceSaleReviewsOperation — Приобретение отзывов на платформе,
                    - MarketplaceSellerCompensationOperation — Прочие компенсации,
                    - OperationAgentDeliveredToCustomer — Доставка покупателю,
                    - OperationAgentDeliveredToCustomerCanceled — Доставка покупателю — исправленное начисление,
                    - OperationAgentStornoDeliveredToCustomer — Доставка покупателю — отмена начисления,
                    - OperationClaim — Начисление по претензии,
                    - OperationCorrectionSeller — Инвентаризация взаиморасчетов,
                    - OperationDefectiveWriteOff — Компенсация за поврежденный на складе товар,
                    - OperationItemReturn — Доставка и обработка возврата, отмены, невыкупа,
                    - OperationLackWriteOff — Компенсация за утерянный на складе товар,
                    - OperationMarketplaceCrossDockServiceWriteOff — Доставка товаров на склад Ozon (кросс-докинг),
                    - OperationMarketplaceServiceStorage — Услуга размещения товаров на складе,
                    - OperationSetOff — Взаимозачет с другими договорами контрагента,
                    - MarketplaceSellerReexposureDeliveryReturnOperation — Перечисление за доставку от покупателя,
                    - OperationReturnGoodsFBSofRMS — Доставка и обработка возврата, отмены, невыкупа,
                    - ReturnAgentOperationRFBS — Возврат перечисления за доставку покупателю,
                    - MarketplaceSellerShippingCompensationReturnOperation — Компенсация перечисления за доставку.

                    posting_number string

                    Номер отправления.

                    transaction_type string

                    Тип операции. Некоторые операции могут быть разделены во времени. Например, при приеме возврата от покупателя списывается стоимость товара и возвращается комиссия, а когда товар возвращается на склад, начисляется услуга по обработке возврата.
                    Типы начисления:
                    - all — все,
                    - orders — заказы,
                    - returns — возвраты и отмены,
                    - services — сервисные сборы,
                    - compensation,
                    - transferDelivery — стоимость на доставку,
                    - other — прочее.

                    page * integer

                    Номер страницы, возвращаемой в запросе.

                    page_size * integer

                    Количество элементов на странице.


                    Параметры ответа


                    operations object

                    Информация об операциях.

                    accruals_for_sale integer

                    Стоимость товаров с учётом скидок продавца.

                    amount integer

                    Итоговая сумма операции.

                    delivery_charge integer

                    Стоимость доставки для начислений по тарифам действовавшим до 1 февраля 2021 года, а также начислений для КГТ товаров.

                    items object

                    Информация о товаре.

                    name string

                    Название товара.

                    sku integer

                    Идентификатор товара в системе Ozon.

                    operation_date string

                    Дата операции.

                    operation_id integer

                    Идентификатор операции.

                    operation_type string

                    Тип операции.

                    operation_type_name string

                    Название типа операции.

                    posting object

                    Информация об отправлении.

                    delivery_schema string

                    Схема доставки. Например, FBO, FBS, RFBS или Crossborder.

                    order_date string

                    Дата принятия отправления в обработку.

                    posting_number string

                    Номер отправления.

                    warehouse_id integer

                    Идентификатор склада.

                    return_delivery_charge integer

                    Плата за возвраты и отмены для начислений по тарифам действовавшим до 1 февраля 2021 года, а также начислений для КГТ товаров.

                    sale_commission integer

                    Комиссия за продажу/возврат комиссии за продажу.

                    services object

                    Информация об услугах. Типы услуг:
                    - MarketplaceNotDeliveredCostItem — Возврат невостребованного товара от покупателя на склад,
                    - MarketplaceReturnAfterDeliveryCostItem — Возврат от покупателя на склад после доставки,
                    - MarketplaceDeliveryCostItem — Доставка товара до покупателя,
                    - MarketplaceSaleReviewsItem — Приобретение отзывов на платформе,
                    - ItemAdvertisementForSupplierLogistic — Доставка товаров на склад Ozon (кросс-докинг),
                    - MarketplaceServiceStorageItem — Размещения товаров,
                    - MarketplaceMarketingActionCostItem — Продвижение товаров,
                    - MarketplaceServiceItemInstallment — Продвижению и продажа в рассрочку,
                    - MarketplaceServiceItemMarkingItems — Обязательная маркировка товаров,
                    - MarketplaceServiceItemFlexiblePaymentSchedule — Гибкий график выплат,
                    - MarketplaceServiceItemReturnFromStock — Комплектация товаров для вывоза продавцом,
                    - ItemAdvertisementForSupplierLogisticSeller — Транспортно-экспедиционные услуги,
                    - MarketplaceServiceItemDelivToCustomer — Последняя миля,
                    - MarketplaceServiceItemDirectFlowTrans — Магистраль,
                    - MarketplaceServiceItemDropoffFF — Обработка отправления,
                    - MarketplaceServiceItemDropoffPVZ — Обработка отправления,
                    - MarketplaceServiceItemDropoffSC — Обработка отправления,
                    - MarketplaceServiceItemFulfillment — Сборка заказа,
                    - MarketplaceServiceItemPickup — Выезд транспортного средства по адресу продавца для забора отправлений (Pick-up),
                    - MarketplaceServiceItemReturnAfterDelivToCustomer — Обработка возврата,
                    - MarketplaceServiceItemReturnFlowTrans — Обратная магистраль,
                    - MarketplaceServiceItemReturnNotDelivToCustomer — Обработка отмен,
                    - MarketplaceServiceItemReturnPartGoodsCustomer — Обработка невыкупа."

                    name string

                    Название услуги.

                    price string

                    Стоимость услуги.

                    type string

                    Типы начисления:
                    - all — все,
                    - orders — заказы,
                    - returns — возвраты и отмены,
                    - services — сервисные сборы,
                    - compensation,
                    - transferDelivery — стоимость на доставку,
                    - other — прочее.

                    page_count integer

                    Количество страниц.

                    row_count integer

                    Количество товаров.

                    POST /v3/finance/transaction/list HTTP/1.1
                    Host: api-seller.ozon.ru 
                    Client-Id: 836
                    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                    Content-Type: application/json
                    {
                      "filter": {
                        "date": {
                          "from": "2021-03-11T14:19:08.570Z",
                          "to": "2021-03-11T14:19:08.570Z"
                        },
                        "operation_type": [
                          "string"
                        ],
                        "posting_number": "string",
                        "transaction_type": "string"
                      },
                      "page": 0,
                      "page_size": 0
                    }
                    Response status  200 
                    {
                      "result": {
                        "operations": [
                          {
                            "accruals_for_sale": 0,
                            "amount": 0,
                            "delivery_charge": 0,
                            "items": [
                              {
                                "name": "string",
                                "sku": 0
                              }
                            ],
                            "operation_date": "string",
                            "operation_id": 0,
                            "operation_type": "string",
                            "operation_type_name": "string",
                            "posting": {
                              "delivery_schema": "string",
                              "order_date": "string",
                              "posting_number": "string",
                              "warehouse_id": 0
                            },
                            "return_delivery_charge": 0,
                            "sale_commission": 0,
                            "services": [
                              {
                                "name": "string",
                                "price": 0
                              }
                            ],
                            "type": "string"
                          }
                        ],
                        "page_count": 0,
                        "row_count": 0
                      }
                    }

                    Суммы транзакций

                    POST /v3/finance/transaction/totals

                    Возвращает итоговые суммы по транзакциям за указанный период.


                    Параметры запроса

                    company_id integer

                    Идентификатор компании.

                    period object

                    Период.

                    from datetime

                    Начало промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                    to datetime

                    Конец промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.

                    type string

                    Типы начисления:
                    - all — все,
                    - orders — заказы,
                    - returns — возвраты и отмены,
                    - services — сервисные сборы,
                    - compensation,
                    - transferDelivery — стоимость на доставку,
                    - other — прочее.


                    Параметры ответа


                    accruals_for_sale integer

                    Общая стоимость товаров и возвратов в заданный период.

                    sale_commission integer

                    Сумма комиссии, которая была удержана при продаже товара и возвращена при его возврате.

                    processing_and_delivery integer

                    Стоимость услуг обработки отправлений, сборки заказов, магистрали и последней мили, а также доставки до введения новых комиссий и тарифов с 1 февраля 2021 года.
                    Магистраль — доставка товаров между кластерами.
                    Последняя миля — доставка товаров покупателю в пункт выдачи заказов, постамат или курьером.

                    refunds_and_cancellations integer

                    Стоимость обратной магистрали, обработки возвратов, отмен и невыкупа товара, а также возвратов до введения новых комиссий и тарифов с 1 февраля 2021 года.
                    Магистраль — доставка товаров между кластерами.
                    Последняя миля — доставка товаров покупателю в пункт выдачи заказов, постамат или курьером.

                    services_amount integer

                    Стоимость дополнительных услуг, не связанных напрямую с доставками и возвратами товаров. Например, продвижения или размещения товаров.

                    compensation_amount string

                    Компенсации.

                    money_transfer integer

                    Начисления за доставку и возвраты при работе по схеме «Доставка по выбору продавца».

                    others_amount integer

                    Прочие начисления.

                    POST /v3/finance/transaction/totals HTTP/1.1
                    Host: api-seller.ozon.ru 
                    Client-Id: 836
                    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
                    Content-Type: application/json
                    {
                      "company_id": 1,
                      "period": {
                        "from": "2021-04-01",
                        "to": "2021-04-15"
                      },
                      "type": "all"
                    }
                    
                    Response status  200 
                    {
                      "result": {
                        "operations": [
                          {
                            "accruals_for_sale": 0,
                            "amount": 0,
                            "delivery_charge": 0,
                            "items": [
                              {
                                "name": "string",
                                "sku": 0
                              }
                            ],
                            "operation_date": "string",
                            "operation_id": 0,
                            "operation_type": "string",
                            "operation_type_name": "string",
                            "posting": {
                              "delivery_schema": "string",
                              "order_date": "st