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

Обновления

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

Метод создает товар по указанному Ozon ID.

POST /v1/product/import-by-sku

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

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
    }
  ]
}

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

Попробовать через 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"
}

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

/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

/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": 1,
      "title": "Books",
      "children": [
        {
          "category_id": 2,
          "title": "Glossary",
          "children": []
        },
        {
          "category_id": 3,
          "title": "Science Fiction",
          "children": []
        }
      ]
    }
  ]
}

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": 1,
      "title": "Books",
      "children": [
        {
          "category_id": 2,
          "title": "Glossary",
          "children": []
        },
        {
          "category_id": 3,
          "title": "Science Fiction",
          "children": []
        }
      ]
    }
  ]
}

/v2​/category​

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

/attribute​

POST /v2​/category​/attribute​


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

category_id * integer

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

attribute_type string

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

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

    language string

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


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


    id integer

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

    name string

    Название.

    is_collection boolean

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

    is_required boolean

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

    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


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

    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
    {
      "category_id": 17036076,
      "attribute_id": 8229,
      "language": "EN",
      "last_value_id": 0,
      "limit": 1
    }

    /value​/by-option

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


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

    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
    {
      "options": [
        {
          "attribute_id": 8229,
          "option_id": 400
        }
      ],
      "language": "EN"
    }

    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.

      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.

      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

      /values/by-option

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


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

      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 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/by-option/in.json
      Response status  200 
      Can not resolve examples/v2/category/attribute/values/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/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

      Код ошибки

      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-by-sku

      POST /v1/product/import-by-sku

      Создает товар по указанному Ozon ID. Количество товарова не ограничено. Вам нужно заполнить поля offer_id, price, sku, vat. Swagger


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

      name string

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

      offer_id string

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

      old_price string

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

      premium_price string

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

      price string

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

      sku integer

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

      vat string

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

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


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


        task_id integer

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

        unmatched_sku_list integer

        sku, который не нашли в системе Ozon.

        POST /v1/product/import-by-sku HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "items": [
            {
              "name": "string",
              "offer_id": "string",
              "old_price": "string",
              "premium_price": "string",
              "price": "string",
              "sku": 0,
              "vat": "string"
            }
          ]
        }
        Response status  200 
        {
          "result": {
            "task_id": 0,
            "unmatched_sku_list": [
              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 
            {
            
            }

            /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

            Статусы отправлений

            Методы для изменения статусов отправлений вручную. Используйте, если работаете по схеме Доставка по выбору продавца, чтобы переводить отправления по статусам и присваивать им трек-номера.

            /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"
                  }
                ]
              }

              Отправления из-за рубежа

              /approve

              POST /v2/posting/crossborder/approve

              pampam


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

              posting_number * string

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


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


              result boolean

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

              POST /v2/posting/crossborder/approve HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "posting_number": "13009555-0001-1"
              }
              Response status  200 
              {
                "result": true
              }

              /cancel

              POST /v2/posting/crossborder/cancel


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

              cancel_reason_id * integer

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

              cancel_reason_message string

              Дополнительная информация по отмене. Если cancel_reason_id = 402, параметр обязательный.

              posting_number * string

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

              sku integer

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


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


              result boolean

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

              POST /v2/posting/crossborder/cancel HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "cancel_reason_id": 361,
                "cancel_reason_message": "",
                "posting_number": "39268230-0002-3",
                "sku": [
                  149123456
                ]
              }
              Response status  200 
              {
                "result": true
              }

              /cancel-reason/list

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

              Can not resolve handlers/crossborder_cancel-reason.md


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


              id integer

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

              title string

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

              type_id string

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

              • buyer — покупатель,
              • seller — продавец.

              POST /v2/posting/crossborder/cancel 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/posting/crossborder/cancel-reason/list/in.json
              Response status  200 
              Can not resolve examples/v2/posting/crossborder/cancel-reason/list/out.json

              /get

              POST /v2/posting/crossborder/get

              Can not resolve handlers/crossborder_get.md


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

              posting_number * string

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

              translit boolean

              True, если включена транслитерация адреса из кириллицы в латиницу.


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


              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

              Почтовый индекс получателя.

              cancel_reason_id integer

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

              created_at datetime

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

              customer_email string

              Email покупателя.

              customer_id 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

              Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

              shipping_provider_id integer

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

              status string

              Результат обработки товара классификатором

              • CLASSIFIED — товар классифицирован,
              • NOT_CLASSIFIED — возникла ошибка.

              tracking_number string

              Трек-номер отправления.

              POST /v2/posting/crossborder/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": "39268230-0002-3",
              }
              Response status  200 
              {
                "result": [
                  {
                    "address": {
                      "address_tail": "г. Москва, ул. Центральная, 1",
                      "addressee": "Петров Иван Владимирович",
                      "city": "Москва",
                      "comment": "",
                      "country": "Россия",
                      "district": "",
                      "phone": "+7 495 123-45-67",
                      "region": "Москва",
                      "zip_code": "101000"
                    },
                    "auto_cancel_date": "2019-11-18T11:30:11.571Z",
                    "cancel_reason_id": 76,
                    "created_at": "2019-11-18T11:30:11.571Z",
                    "customer_email": "petrov@email.com",
                    "customer_id": 60006,
                    "in_process_at": "2019-11-18T11:30:11.571Z",
                    "order_id": 77712345,
                    "order_nr": "1111444",
                    "posting_number": "39268230-0002-3",
                    "products": [
                      {
                        "name": "Фитнес-браслет",
                        "offer_id": "DEP-1234",
                        "price": "1900.00",
                        "quantity": 1,
                        "sku": 100056
                      }
                    ],
                    "shipping_provider_id": 0,
                    "status": "awaiting_approve",
                    "tracking_number": ""
                  }
                ]
              }

              /ship

              POST /v2/posting/crossborder/ship

              Can not resolve handlers/crossborder_ship.md


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

              items * object

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

              mandatory_mark string

              Значение обязательной маркировки для товара.

              quantity integer

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

              sku integer

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

              posting_number string

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

              shipping_provider_id integer

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

              tracking_number string

              Трек-номер отправления.


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


              package_number string

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

              POST /v2/posting/crossborder/ship HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "items": [
                  {
                    "quantity": 2,
                    "sku": 100056
                  }
                ],
                "posting_number": "39268230-0002-3",
                "shipping_provider_id": 15109877837000,
                "tracking_number": "AB123456CD"
              }
              Response status  200 
              {
                "result": {
                  "package_number": "232123"
                }
              }

              /shipping-provider/list

              POST /v2/posting/crossborder/shipping-provider/list

              Can not resolve handlers/cb_shipping_provider.md


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


              id integer

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

              name string

              Название службы доставки.

              POST /v2/posting/crossborder/shipping-provider/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": [
                  {
                    "id": 15109877837000,
                    "name": "shiptor"
                  },
                  {
                    "id": 15308950689000,
                    "name": "china-post"
                  }
                ]
              }

              /unfulfilled/list

              POST /v2/posting/crossborder/unfulfilled/list

              Can not resolve handlers/cb_unfulfilled.md


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

              dir * string

              Направление сортировки.

              • asc — по возрастанию,
              • desc — по убыванию.

              limit * integer

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

              offset * integer

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

              status * string

              Статус отправления.

              • awaiting_approve — ожидает подтверждения,
              • awaiting_packaging — ожидает упаковки,
              • awaiting_deliver — ожидает отгрузки,
              • delivering — доставляется,
              • driver_pickup — у водителя,
              • delivered — доставлено,
              • cancelled — отменено.

              translit * boolean

              True, если включена транслитерация адреса из кириллицы в латиницу.


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


              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

              Почтовый индекс получателя.

              cancel_reason_id integer

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

              created_at datetime

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

              customer_email string

              Email покупателя.

              customer_id 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

              Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

              shipping_provider_id integer

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

              status string

              Статус отправления.

              tracking_number string

              Трек-номер отправления.

              POST /v2/posting/crossborder/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": "asc",
                "limit": 10,
                "offset": 0,
                "status": [
                  "awaiting_packaging"
                ]
              }
              Response status  200 
              {
                "result": [
                  {
                    "address": {
                      "address_tail": "г. Москва, ул. Центральная, 1",
                      "addressee": "Петров Иван Владимирович",
                      "city": "Москва",
                      "comment": "",
                      "country": "Россия",
                      "district": "",
                      "phone": "+7 495 123-45-67",
                      "region": "Москва",
                      "zip_code": "101000"
                    },
                    "auto_cancel_date": "2019-11-18T11:30:11.571Z",
                    "cancel_reason_id": 76,
                    "created_at": "2019-11-18T11:30:11.571Z",
                    "customer_email": "petrov@email.com",
                    "customer_id": 60006,
                    "in_process_at": "2019-11-18T11:30:11.571Z",
                    "order_id": 77712345,
                    "order_nr": "1111444",
                    "posting_number": "39268230-0002-3",
                    "products": [
                      {
                        "name": "Фитнес-браслет",
                        "offer_id": "DEP-1234",
                        "price": "1900.00",
                        "quantity": 1,
                        "sku": 100056
                      }
                    ],
                    "shipping_provider_id": 0,
                    "status": "awaiting_approve",
                    "tracking_number": ""
                  }
                ]
              }

              Продажа со склада Ozon

              /get

              POST /v2/posting/fbo/get

              Can not resolve handlers/fbo-get.md


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

              posting_number * string

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

              with object

              Дополнительные поля, которые нужно добавить в ответ.

              analytics_data boolean

              Добавить в ответ данные аналитики.

              financial_data boolean

              Добавить в ответ финансовые данные.


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


              analytics_data object

              Аналитические данные.

              city string

              Город доставки.

              delivery_type string

              Способ доставки.

              is_premium boolean

              Наличие подписки Премиум.

              payment_type_group_name string

              Способ оплаты.

              region string

              Регион доставки.

              warehouse_id integer

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

              warehouse_name string

              Название склада отправки заказа.

              cancel_reason_id integer

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

              created_at datetime

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

              financial_data object

              Финансовые данные.

              products object

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

              actions array

              commission_amount integer

              Размер комиссии за товар.

              commission_percent integer

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

              old_price string

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

              payout integer

              Выплата продавцу.

              picking object

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

              price string

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

              product_id 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.

              status string

              Результат обработки товара классификатором

              • CLASSIFIED — товар классифицирован,
              • NOT_CLASSIFIED — возникла ошибка.

              POST /v2/posting/fbo/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": "13009555-0001-1",
                "with": {
                  "analytics_data": true,
                  "financial_data": true
                }
              }
              Response status  200 
              {
                "result": {
                  "order_id": 152398500,
                  "order_number": "33920144-0066",
                  "posting_number": "33920144-0066-1",
                  "status": "awaiting_deliver",
                  "cancel_reason_id": 0,
                  "created_at": "2020-06-24T01:23:45.51Z",
                  "in_process_at": "2020-06-24T01:23:45.387Z",
                  "products": [
                    {
                      "sku": 147524707,
                      "name": "DEFENDER Наушники вставки Basic 603 черный",
                      "quantity": 1,
                      "offer_id": "63603",
                      "price": "77.00",
                    }
                  ],
                  "analytics_data": {
                    "region": "Москва",
                    "city": "Москва",
                    "delivery_type": "Courier",
                    "is_premium": false,
                    "payment_type_group_name": "Карты оплаты",
                    "warehouse_id": 6048863967000,
                    "warehouse_name": "ТВЕРЬ_ХАБ"
                  },
                  "financial_data": {
                    "products": [
                      {
                        "commission_amount": 0,
                        "commission_percent": 0,
                        "payout": 0,
                        "product_id": 147524707,
                        "old_price": 0,
                        "price": 77,
                        "total_discount_value": 0,
                        "total_discount_percent": 0,
                        "actions": null,
                        "picking": null,
                      }
                    ]
                  }
                }
              }

              /list

              POST /v2/posting/fbo/list

              Can not resolve handlers/fbo-list.md


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

              dir * string

              Направление сортировки.

              • asc — по возрастанию,
              • desc — по убыванию.

              filter * object

              order_id string

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

              order_number string

              Номер заказа.

              since datetime

              Начало периода в формате YYYY-MM-DD.

              to datetime

              Конец периода в формате YYYY-MM-DD.

              status string

              Статус отправления.

              • awaiting_approve — ожидает подтверждения,
              • awaiting_packaging — ожидает упаковки,
              • awaiting_deliver — ожидает отгрузки,
              • delivering — доставляется,
              • driver_pickup — у водителя,
              • delivered — доставлено,
              • cancelled — отменено.

              limit * integer

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

              offset integer

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

              translit boolean

              True, если включена транслитерация адреса из кириллицы в латиницу.

              with object

              Дополнительные поля, которые нужно добавить в ответ.

              analytics_data boolean

              Добавить в ответ данные аналитики.

              financial_data boolean

              Добавить в ответ финансовые данные.


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


              analytics_data object

              Аналитические данные.

              city string

              Город доставки.

              delivery_type string

              Способ доставки.

              is_premium boolean

              Наличие подписки Премиум.

              payment_type_group_name string

              Способ оплаты.

              region string

              Регион доставки.

              warehouse_id integer

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

              warehouse_name string

              Название склада отправки заказа.

              cancel_reason_id integer

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

              created_at datetime

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

              financial_data object

              Финансовые данные.

              products object

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

              actions array

              commission_amount integer

              Размер комиссии за товар.

              commission_percent integer

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

              old_price string

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

              payout integer

              Выплата продавцу.

              picking object

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

              price string

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

              product_id 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.

              status string

              Результат обработки товара классификатором

              • CLASSIFIED — товар классифицирован,
              • NOT_CLASSIFIED — возникла ошибка.

              POST /v2/posting/fbo/list HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "dir": "asc",
                "filter":
                {
                  "since": "2018-10-24T16:24:09.474Z",
                  "to": "2019-10-24T16:24:09.474Z"
                },
                "limit": 10,
                "offset": 0,
                "translit": true,
                "with": {
                  "analytics_data": true,
                  "financial_data": true
                }
              }
              Response status  200 
              {
                "result":[
                  {
                    "order_id":152398500,
                    "order_number":"33920144-0066",
                    "posting_number":"33920144-0066-1",
                    "status":"awaiting_deliver",
                    "cancel_reason_id":0,
                    "created_at":"2020-06-24T01:23:45.51Z",
                    "in_process_at":"2020-06-24T01:23:45.387Z",
                    "products":
                      [
                        {
                          "sku":147524707,
                          "name":"DEFENDER Наушники вставки Basic 603 черный",
                          "quantity":1,
                          "offer_id":"63603",
                          "price":"77.00",
                        }
                      ],
                    "analytics_data":
                      {
                        "region":"Москва",
                        "city":"Москва",
                        "delivery_type":"Courier",
                        "is_premium":false,
                        "payment_type_group_name":"Карты оплаты",
                        "warehouse_id":6048863967000,
                        "warehouse_name":"ТВЕРЬ_ХАБ",
                      },
                    "financial_data":
                      {
                        "products":
                          [
                            {
                              "commission_amount":0,
                              "commission_percent":0,
                              "payout":0,
                              "product_id":147524707,
                              "old_price":0,
                              "price":77,
                              "total_discount_value":0,
                              "total_discount_percent":0,
                              "actions":null,
                              "picking":null
                            }
                          ]
                      }
                  }
                ]
              }

              Продажа со своего склада

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

              Swagger

              /act/check-status

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


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

              id * integer

              Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.


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


              added_to_act string

              Массив c номерами отправлений, которые добавлены в Акт приема-передачи. Эти отправления нужно передать сегодня.

              removed_from_act string

              Массив с номерами отправлений, которые не попали в Акт приема-передачи. Такие отправления нужно передавать со следующей отгрузкой.

              status string

              Статус запроса.

              • in_process — документы формируются, нужно подождать,
              • ready — документы сформированы и готовы для скачивания,
              • error — произошла ошибка при формировании документов, запросите документы повторно.

              POST /v2/posting/fbs/act/check-status HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "id": 15684442104000
              }
              Response status  200 
              {
                "result": {
                  "status": "ready",
                  "added_to_act": [
                    "00420000-0030-2",
                    "01560000-0096-4"
                  ],
                  "removed_from_act": [
                    "03840000-0096-3"
                  ]
                }
              }

              /act/create

              POST /v2/posting/fbs/act/create

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


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

              containers_count integer

              Количество грузовых мест. Подробнее в Помощи


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


              id integer

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

              POST /v2/posting/fbs/act/create HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "containers_count": 5
              }
              Response status  200 
              {
                "result": {
                  "id": 15684442104000
                }
              }

              /act​/get-container-labels

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

              Метод создает этикетки для грузового места.


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

              id * integer

              Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.

              POST /v2/posting/fbs/act/get-container-labels HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "id": 0
              }
              Response status  200 
              pdf-документ

              /act​/get-pdf

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


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

              id * integer

              Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.

              POST /v2/posting/fbs/act/get-pdf HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "id": 15684442104000
              }
              Response status  200 
              pdf-документ

              /arbitration

              POST /v2/posting/fbs/arbitration


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

              posting_number * string

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


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


              result boolean

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

              POST /v2/posting/fbs/arbitration HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "posting_number":
                [
                  "02898753-0009-1",
                  "02898753-0009-2"
                ]
              }
              Response status  200 
              {
                "result": "true"
              }

              /awaiting-delivery

              POST /v2/posting/fbs/awaiting-delivery


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

              posting_number * string

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


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


              result boolean

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

              POST /v2/posting/fbs/awaiting-delivery HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "posting_number":
                [
                  "02898753-0009-1",
                  "02898753-0009-2"
                ]
              }
              Response status  200 
              {
                "result": "true"
              }

              /cancel

              POST /v2/posting/fbs/cancel


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

              cancel_reason_id * integer

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

              cancel_reason_message string

              Дополнительная информация по отмене. Если cancel_reason_id = 402, параметр обязательный.

              posting_number * string

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


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


              result boolean

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

              POST /v2/posting/fbs/cancel HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "cancel_reason_id": 402,
                "cancel_reason_message": "Wrong seller id",
                "posting_number": 13076543-0001-1
              }
              Response status  200 
              {
                "result": "true"
              }

              /cancel-reason/list

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


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


              id integer

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

              title string

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

              type_id string

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

              • buyer — покупатель,
              • seller — продавец.

              POST /v2/posting/fbs/cancel-reason/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": [
                  {
                    "id": 123,
                    "title": "Error",
                    "type_id": "seller"
                  }
                ]
              }

              /get

              POST /v2/posting/fbs/get


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

              posting_number * string

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

              with object

              Дополнительные поля, которые нужно добавить в ответ.

              analytics_data boolean

              Добавить в ответ данные аналитики.

              barcodes boolean

              Добавить в ответ штрихкоды отправления.

              financial_data boolean

              Добавить в ответ финансовые данные.


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


              analytics_data object

              Аналитические данные.

              city string

              Город доставки.

              delivery_type string

              Способ доставки.

              is_premium boolean

              Наличие подписки Премиум.

              payment_type_group_name string

              Способ оплаты.

              region string

              Регион доставки.

              warehouse_id integer

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

              warehouse_name string

              Название склада отправки заказа.

              barcodes object

              Штрихкоды отправления.

              upper_barcode string

              Верхний штрихкод на маркировке отправления.

              lower_barcode string

              Нижний штрихкод на маркировке отправления.

              cancel_reason_id integer

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

              created_at datetime

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

              financial_data object

              Финансовые данные.

              products object

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

              actions array

              commission_amount integer

              Размер комиссии за товар.

              commission_percent integer

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

              old_price string

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

              payout integer

              Выплата продавцу.

              picking object

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

              price string

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

              product_id 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

              Статус отправления.

              POST /v2/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": "13076543-0001-1",
                "with": {
                  "analytics_data": true,
                  "barcodes": true,
                  "financial_data": true
                }
              }
              Response status  200 
              {
                "result": {
                  "analytics_data": {
                    "city": "string",
                    "delivery_type": "string",
                    "is_premium": true,
                    "payment_type_group_name": "string",
                    "region": "string"
                  },
                  "barcodes": {
                    "lower_barcode": "string",
                    "upper_barcode": "string"
                  },
                  "cancel_reason_id": 0,
                  "created_at": "2020-07-06T07:40:22.281Z",
                  "financial_data": {
                    "products": [
                      {
                        "actions": [
                          "string"
                        ],
                        "commission_amount": 0,
                        "commission_percent": 0,
                        "old_price": 0,
                        "payout": 0,
                        "picking": {
                          "amount": 0,
                          "moment": "2020-07-06T07:40:22.281Z",
                          "tag": "string"
                        },
                        "price": 0,
                        "product_id": 0,
                        "total_discount_percent": 0,
                        "total_discount_value": 0
                      }
                    ]
                  },
                  "in_process_at": "2020-07-06T07:40:22.281Z",
                  "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": "2020-07-06T07:40:22.281Z",
                  "status": "string"
                }
              }
              

              /get-by-barcode

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


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

              barcode * string

              Штрихкод отправления.


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


              barcodes object

              Штрихкоды отправления.

              upper_barcode string

              Верхний штрихкод на маркировке отправления.

              lower_barcode string

              Нижний штрихкод на маркировке отправления.

              cancel_reason_id integer

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

              created_at datetime

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

              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

              Статус отправления.

              POST /v2/posting/fbs/get-by-barcode HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "barcode": "string"
              }
              Response status  200 
              {
                "result": {
                  "barcodes": {
                    "lower_barcode": "string",
                    "upper_barcode": "string"
                  },
                  "cancel_reason_id": 0,
                  "created_at": "2020-06-16T15:11:06.995Z",
                  "in_process_at": "2020-06-16T15:11:06.995Z",
                  "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": "2020-06-16T15:11:06.995Z",
                  "status": "string"
                }
              }

              /list

              POST /v2/posting/fbs/list


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

              dir * string

              Направление сортировки.

              • asc — по возрастанию,
              • desc — по убыванию.

              filter * object

              order_id string

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

              order_number string

              Номер заказа.

              since datetime

              Начало периода в формате YYYY-MM-DD.

              to datetime

              Конец периода в формате YYYY-MM-DD.

              status string

              Статус отправления.

              • awaiting_approve — ожидает подтверждения,
              • awaiting_packaging — ожидает упаковки,
              • awaiting_deliver — ожидает отгрузки,
              • delivering — доставляется,
              • driver_pickup — у водителя,
              • delivered — доставлено,
              • cancelled — отменено.

              limit * integer

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

              offset integer

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

              sort_by string

              Сортировка в ответе
              updated_at— по дате обновления,
              in_process_at— по времени обработки,
              order_created_at— по дате создания.

              with object

              Дополнительные поля, которые нужно добавить в ответ.

              analytics_data boolean

              Добавить в ответ данные аналитики.

              barcodes boolean

              Добавить в ответ штрихкоды отправления.

              financial_data boolean

              Добавить в ответ финансовые данные.


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


              analytics_data object

              Аналитические данные.

              city string

              Город доставки.

              delivery_type string

              Способ доставки.

              is_premium boolean

              Наличие подписки Премиум.

              payment_type_group_name string

              Способ оплаты.

              region string

              Регион доставки.

              warehouse_id integer

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

              warehouse_name string

              Название склада отправки заказа.

              barcodes object

              Штрихкоды отправления.

              upper_barcode string

              Верхний штрихкод на маркировке отправления.

              lower_barcode string

              Нижний штрихкод на маркировке отправления.

              cancel_reason_id integer

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

              created_at datetime

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

              financial_data object

              Финансовые данные.

              products object

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

              actions array

              commission_amount integer

              Размер комиссии за товар.

              commission_percent integer

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

              old_price string

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

              payout integer

              Выплата продавцу.

              picking object

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

              price string

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

              product_id 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

              Статус отправления.

              POST /v2/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": {
                  "order_id": 0,
                  "order_number": "string",
                  "since": "2020-11-13T11:43:37.496Z",
                  "status": "string",
                  "to": "2020-11-13T11:43:37.496Z"
                },
                "limit": 0,
                "offset": 0,
                "sort_by": "string",
                "with": {
                  "analytics_data": true,
                  "barcodes": true,
                  "financial_data": true
                }
              }
              Response status  200 
              {
                "result": [
                  {
                    "analytics_data": {
                      "city": "string",
                      "delivery_type": "string",
                      "is_premium": true,
                      "payment_type_group_name": "string",
                      "region": "string"
                    },
                    "barcodes": {
                      "lower_barcode": "string",
                      "upper_barcode": "string"
                    },
                    "cancel_reason_id": 0,
                    "created_at": "2020-07-06T06:23:14.627Z",
                    "financial_data": {
                      "products": [
                        {
                          "actions": [
                            "string"
                          ],
                          "commission_amount": 0,
                          "commission_percent": 0,
                          "old_price": 0,
                          "payout": 0,
                          "picking": {
                            "amount": 0,
                            "moment": "2020-07-06T06:23:14.627Z",
                            "tag": "string"
                          },
                          "price": 0,
                          "product_id": 0,
                          "total_discount_percent": 0,
                          "total_discount_value": 0
                        }
                      ]
                    },
                    "in_process_at": "2020-07-06T06:23:14.627Z",
                    "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": "2020-07-06T06:23:14.627Z",
                    "status": "string"
                  }
                ]
              }
              

              /package-label

              POST /v2/posting/fbs/package-label


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

              posting_number * string

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

              POST /v2/posting/fbs/package-label HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "posting_number":
                [
                  "13076543-0001-1"
                ]
              }
              Response status  200 
              pdf-документ

              /product/mandatory-mark/is-required

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

              Проверяет необходимость маркировки для товара по его SKU.

              Подробнее про маркировку товаров в Помощи


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

              sku * integer

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


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


              is_required boolean

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

              sku integer

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

              POST /v2/posting/fbs/product/mandatory-mark/is-required HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "sku": [
                  0
                ]
              }
              Response status  200 
              {
                "result": [
                  {
                    "is_required": true,
                    "sku": 0
                  }
                ]
              }

              /product/mandatory-mark/validate

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

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

              Подробнее про маркировку товаров в Помощи


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

              mandatory_mark * string

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


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


              mandatory_mark string

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

              result boolean

              True, если маркировка валидна.

              POST /v2/posting/fbs/product/mandatory-mark/validate HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "mandatory_mark": [
                  "string"
                ]
              }
              Response status  200 
              {
                "result": [
                  {
                    "mandatory_mark": "string",
                    "result": true
                  }
                ]
              }

              /ship

              POST /v2/posting/fbs/ship


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

              packages * object

              items object

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

              mandatory_mark string

              Значение обязательной маркировки для товара.

              quantity integer

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

              sku integer

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

              posting_number string

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


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


              result boolean

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

              POST /v2/posting/fbs/ship HTTP/1.1
              Host: api-seller.ozon.ru 
              Client-Id: 836
              Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
              Content-Type: application/json
              {
                "packages": [
                  {
                    "items": [
                      {
                        "mandatory_mark": [
                          "string"
                        ],
                        "quantity": 0,
                        "sku": 0
                      }
                    ]
                  }
                ],
                "posting_number": "string"
              }
              Response status  200 
              {
                "result": [
                  "string"
                ]
              }

              /unfulfilled/list

              POST /v2/posting/fbs/unfulfilled/list


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

              dir string

              Направление сортировки.

              • asc — по возрастанию,
              • desc — по убыванию.

              limit integer

              Количество отп