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

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
}

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

/warehouse/list

POST /v1/warehouse/list

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

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

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

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

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.

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

Warehouse ID.

potential_products_count integer

Warehouse name.

is_rfbs boolean

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

POST /v1/warehouse/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{}

Response status  200

{
  "result": [
    {
      "warehouse_id": int64,
      "name": "string",
      "is_rfbs": true
    }
  ]
}

/v1

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

Список акций

GET /v1/actions

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

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

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

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

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

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

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

is_participating boolean

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

participating_products_count integer

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

action_type string

banned_products_count integer

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

with_targeting boolean

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

GET /v1/actions HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Response status  200

{
  "result": [
    {
      "action_id": 2328,
      "title": "акция пагинация",
      "date_start": "2020-01-21T13:30:06Z",
      "date_end": "2020-01-30T21:00:00Z",
      "potential_products_count": 3,
      "is_participating": false,
      "participating_products_count": 0,
      "action_type": "DISCOUNT",
      "banned_products_count": 1,
      "with_targeting": false
    }
  ]
}

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

POST /v1/actions/candidates

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

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

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

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

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

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

max_action_price out.float

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

price2 out.float

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

action_price out.float

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

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

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

POST /v1/actions/candidates HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "action_id": 2422,
  "limit": 1,
  "offset": 0
}

Response status  200

{
  "result": {
    "products": [
      {
        "product_id": 15323889,
        "price": 1100,
        "action_price": 1100,
        "max_action_price": 1100
      }
    ],
    "total": 1
  }
}

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

POST /v1/actions/products

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

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

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

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

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

max_action_price out.float

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

price2 out.float

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

action_price out.float

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

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

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

POST /v1/actions/products HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "action_id": 2422,
  "limit": 1,
  "offset": 0
}

Response status  200

{
  "result": {
    "products": [
      {
        "product_id": 15323889,
        "price": 1100,
        "action_price": 1100,
        "max_action_price": 1100
      }
    ],
    "total": 1
  }
}

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

POST /v1/actions/products/activate

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

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

products in.products_2

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

product_ids array

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

POST /v1/actions/products/activate HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "action_id": 2422,
  "products": [
    {
      "product_id": 15323889,
      "action_price": 931.00
    }
  ]
}

Response status  200

{
  "result": {
    "product_ids": [
      15323889
    ]
  }
}

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

POST /v1/actions/products/deactivate

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

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

product_ids in.product_ids_2

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

product_ids array

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

POST /v1/actions/products/deactivate HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "action_id": 2422,
  "product_ids": [
    15323889
  ]
}

Response status  200

{
  "result": {
    "product_ids": [
      15323889
    ]
  }
}

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

/list

POST /v1/delivery-method/list

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

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

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

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

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

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

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

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

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

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

company_id integer

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

created_at datetime

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

cutoff string

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

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

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

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

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

template_id integer

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

updated_at datetime

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

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

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.

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

Search filter for delivery methods.

Warehouse ID.

Delivery service ID.

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

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

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

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

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.

result out.result4-en

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

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

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

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

Количество отправлений в ответе. Максимум — 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— Отправления

sort object

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

key string

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

order string

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

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

data object

dimensions string

metrics number

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

totals integer

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

timestamp string

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

POST /v1/analytics/data HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "date_from": "string",
  "date_to": "string",
  "dimension": [
    "string"
  ],
  "filters": [
    {
      "key": "string",
      "op": "EQ",
      "value": "string"
    }
  ],
  "limit": 0,
  "metrics": [
    "string"
  ],
  "offset": 0,
  "sort": [
    {
      "key": "string",
      "order": "ASC"
    }
  ]
}

Response status  200

{
  "result": {
    "data": [
      {
        "dimensions": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "metrics": [
          0
        ]
      }
    ],
    "totals": [
      0
    ]
  },
  "timestamp": "string"
}

/stock_on_warehouses

POST /v1/analytics/stock_on_warehouses

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

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

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

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

timestamp string

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

total_items object

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

Штрихкод.

category string

Категория.

discounted string

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

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

length integer

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

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

between_warehouses integer

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

stock object

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

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

for_sale integer

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

loss integer

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

not_for_sale integer

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

shipped integer

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

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

volume integer

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

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

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

wh_items object

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

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

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

Штрихкод.

category string

Категория.

discounted string

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

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

length integer

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

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

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

stock object

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

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

volume integer

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

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

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

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

POST /v1/analytics/stock_on_warehouses HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "limit": 0,
  "offset": 0
}

Response status  200

{
  "timestamp": "string",
  "total_items": [
    {
      "barcode": "string",
      "category": "string",
      "discounted": "string",
      "height": 0,
      "length": 0,
      "offer_id": "string",
      "sku": "string",
      "stock": {
        "between_warehouses": 0,
        "for_sale": 0,
        "loss": 0,
        "not_for_sale": 0,
        "shipped": 0
      },
      "title": "string",
      "volume": 0,
      "weight": 0,
      "width": 0
    }
  ],
  "wh_items": [
    {
      "id": "string",
      "items": [
        {
          "barcode": "string",
          "category": "string",
          "discounted": "string",
          "height": 0,
          "length": 0,
          "offer_id": "string",
          "sku": "string",
          "stock": {
            "for_sale": 0,
            "loss": 0,
            "not_for_sale": 0
          },
          "title": "string",
          "volume": 0,
          "weight": 0,
          "width": 0
        }
      ],
      "name": "string"
    }
  ]
}

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

/company-certification/list

POST /v1/brand/company-certification/list

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

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

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

brand_certification object

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

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

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

brand_id integer

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

brand_name string

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

has_certificate boolean

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

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

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

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

/tree

GET /v1/categories/tree

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

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

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

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

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

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]

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

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

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

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

description out.description

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

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

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

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

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

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

Название.

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.

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

Category ID.

Subcategory tree.

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.

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

Category ID.

Subcategory tree.

description out.description

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.

The number of the task for generating documents.

True if the characteristic is a number of values.

True if the characteristic is required.

Name.

option array

Array of preset characteristic values.

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

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Can not resolve examples/v1/categories/tree/categoryId/attributes/in.json

Response status  200

Can not resolve examples/v1/categories/tree/categoryId/attributes/out.json

/v1/category

/attribute

POST /v1/category/attribute

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

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

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

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

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

attribute_type string

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

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

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

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

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

child object

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

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

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

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

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

Название.

option object

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

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

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

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

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

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

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

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

Название.

option object

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

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

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

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

POST /v1/category/attribute HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "attribute_type": "ALL",
  "category_id": 0,
  "language": "DEFAULT"
}

Response status  200

{
  "result": [
    {
      "child": [
        {
          "description": "string",
          "id": 0,
          "is_collection": true,
          "is_required": true,
          "name": "string",
          "option": [
            {
              "id": 0,
              "value": "string"
            }
          ],
          "type": "string"
        }
      ],
      "description": "string",
      "id": 0,
      "is_collection": true,
      "is_required": true,
      "name": "string",
      "option": [
        {
          "id": 0,
          "value": "string"
        }
      ],
      "type": "string"
    }
  ]
}

/tree

POST /v1/category/tree

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

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

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

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

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

result array

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

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

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

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

POST /v1/category/tree HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "category_id": 17036076,
  "language": "EN"
}

Response status  200

{
  "result": [
    {
      "category_id": 0,
      "children": [
        null
      ],
      "title": "string"
    }
  ]
}

v1 Characteristics and categories

/tree

POST /v1/category/tree

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

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

Category ID.

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

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

List of categories.

Category ID.

Subcategory tree.

Category name.

POST /v1/category/tree HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "category_id": 17036076,
  "language": "EN"
}

Response status  200

{
  "result": [
    {
      "category_id": 0,
      "children": [
        null
      ],
      "title": "string"
    }
  ]
}

/v2/category

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

/attribute

POST /v2/category/attribute

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

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

attribute_type string

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

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

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

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

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

description out.description2

Название.

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

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

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

group_id integer

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

group_name string

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

dictionary_id integer

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

POST /v2/category/attribute HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "attribute_type": "ALL",
  "category_id": 0,
  "language": "DEFAULT"
}

Response status  200

{
  "result": [
    {
      "description": "string",
      "dictionary_id": 0,
      "group_id": 0,
      "group_name": "string",
      "id": 0,
      "is_collection": true,
      "is_required": true,
      "name": "string",
      "type": "string"
    }
  ]
}

/attribute/value/by-option

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

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

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

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

options object

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

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

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

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

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

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

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

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

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

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Can not resolve examples/v2/category/attribute/value/option/in.json

Response status  200

Can not resolve examples/v2/category/attribute/value/option/out.json

/attribute/values

POST /v2/category/attribute/values

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

attribute_id * in.attribute_id

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

last_value_id in.last_value_id

limit * integer

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

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

POST /v2/category/attribute HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Can not resolve examples/v2/category/attribute/value

v2 Characteristics and categories

A group of methods for working with product categories

/attribute

POST /v2/category/attribute

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

Category ID.

attribute_type string

Characteristics types:

required
optional

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

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

The number of the task for generating documents.

description out.description

Name.

True if the characteristic is a number of values.

True if the characteristic is required.

group_id integer

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

group_name string

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

dictionary_id integer

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

POST /v2/category/attribute HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "attribute_type": "ALL",
  "category_id": 0,
  "language": "DEFAULT"
}

Response status  200

{
  "result": [
    {
      "description": "string",
      "dictionary_id": 0,
      "group_id": 0,
      "group_name": "string",
      "id": 0,
      "is_collection": true,
      "is_required": true,
      "name": "string",
      "type": "string"
    }
  ]
}

/attribute/values

POST /v2/category/attribute/values

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

attribute_id * in.attribute_id

Category ID.

last_value_id in.last_value_id

limit * integer

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

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

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

The number of the task for generating documents.

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

picture out.picture

info out.info

POST /v2/category/attribute HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Can not resolve examples/v2/category/attribute/values/in.json

Response status  200

Can not resolve examples/v2/category/attribute/values/out.json

/attribute/values

POST /v2/category/attribute/values

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

options object

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

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

attribute_id in.attribute_id

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

option_id in.option_id

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

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

The number of the task for generating documents.

ID of the preset value of the characteristic.

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

Text for the preset value of the characteristic.

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

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Can not resolve examples/v2/category/attribute/value/by-option/in.json

Response status  200

Can not resolve examples/v2/category/attribute/value/by-option/out.json

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

/list

POST /v1/chat/list

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

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

chat_id_list string

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

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

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

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

id string

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

last_message_id string

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

users object

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

id 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 одинаковая структура запроса и ответа.

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

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

from_message_id string

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

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

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

context object

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

order object

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

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

postings object

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

delivery_schema string

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

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

sku_list array

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

created_at datetime

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

file object

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

mime string

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

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

size integer

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

url string

URL файла.

text string

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

Тип сообщения:
- 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Результат обработки запроса. 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

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

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

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

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

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

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

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

accordance_type_code * string

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.

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

issue_date * datetime

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

expire_date datetime

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

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

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

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

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

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

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

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

POST /v1/product/certificate/types HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{}

Response status  200

{
  "result": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

/import

POST /v1/product/import

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

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

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

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

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

complex object

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

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

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

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

collection object

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

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

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

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

category_id category_id2

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

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

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

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

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

images images3

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

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

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

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

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

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

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

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

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

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

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

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

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

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

POST /v1/product/import HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "items": [
    {
      "attributes": [
        {
          "collection": [
            "string"
          ],
          "complex": [
            {
              "id": 0,
              "value": "string"
            }
          ],
          "complex_collection": [
            {
              "collection": [
                {
                  "id": 0,
                  "value": "string"
                }
              ]
            }
          ],
          "id": 0,
          "value": "string"
        }
      ],
      "barcode": "string",
      "category_id": 0,
      "depth": 0,
      "description": "string",
      "dimension_unit": "string",
      "height": 0,
      "images": [
        {
          "default": true,
          "file_name": "string"
        }
      ],
      "name": "string",
      "offer_id": "string",
      "old_price": "string",
      "premium_price": "string",
      "price": "string",
      "vat": "string",
      "vendor": "string",
      "vendor_code": "string",
      "weight": 0,
      "weight_unit": "string",
      "width": 0
    }
  ]
}

Response status  200

{
  "result": {
    "task_id": 0
  }
}

/import/info

POST /v1/product/import/info

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

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

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

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

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

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

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

Статус создания товара. Информация о товаре обрабатывается очередями. Возможные значения параметра 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

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

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

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

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

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

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

Код ошибки.

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

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

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

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"

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

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

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

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

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

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

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

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

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

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

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

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 июня — потом мы отключим поддержку первой версии.

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

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

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

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

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

Штрихкод.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

sources array

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

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

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

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

coming integer

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

present integer

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

reserved integer

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

validation_errors object

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

code integer

Код ошибки.

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

field integer

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

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

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

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

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

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

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

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

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

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

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

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

commissions object

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

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

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

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

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

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

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

marketing_actions object

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

actions object

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

date_from datetime

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

date_to datetime

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

discountValue string

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

current_period_from datetime

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

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

current_period_to datetime

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

ozon_actions_exist boolean

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

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

price object

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

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

marketing_seller_price string

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

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

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

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

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

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

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

retail_price string

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

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

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

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

volume_weight 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

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

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

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

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

product_id string

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

visibility string

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Результат обработки запроса. 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

images object

Массив с изображениями, не больше 10.

file_name string

Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.

default_img in.bool

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

Массив с характеристиками товара. Характеристики отличаются для разных категорий — их можно посмотреть в Помощи или через API.

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

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

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

complex array

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

Массив характеристик с одинаковым названием, но разными значениями.

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

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

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

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

Product ID.

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

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

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

List of certificate types and names.

Certificate name.

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.

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

accordance_type_code * string

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

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

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

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

List of certificate types and names.

Certificate name.

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

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

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

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

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

certification object

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

category_name string

Название сертифицируемой категории.

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

Всего категорий.

POST /v1/product/certification/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": {
    "certification": [
      {
        "category_name": "string",
        "is_required": true
      }
    ],
    "total": 0
  }
}

/import

POST /v1/product/import

Allows you to change the price of one or more products. You can change the prices for 1000 products in one request. To reset old_price or premium_price, set these parameters to 0.

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

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

complex object

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

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

collection object

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

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

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

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

category_id category_id2

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

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

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

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

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

images images3

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

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

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

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

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

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

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

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

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

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

POST /v1/product/import HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "items": [
    {
      "attributes": [
        {
          "collection": [
            "string"
          ],
          "complex": [
            {
              "id": 0,
              "value": "string"
            }
          ],
          "complex_collection": [
            {
              "collection": [
                {
                  "id": 0,
                  "value": "string"
                }
              ]
            }
          ],
          "id": 0,
          "value": "string"
        }
      ],
      "barcode": "string",
      "category_id": 0,
      "depth": 0,
      "description": "string",
      "dimension_unit": "string",
      "height": 0,
      "images": [
        {
          "default": true,
          "file_name": "string"
        }
      ],
      "name": "string",
      "offer_id": "string",
      "old_price": "string",
      "premium_price": "string",
      "price": "string",
      "vat": "string",
      "vendor": "string",
      "vendor_code": "string",
      "weight": 0,
      "weight_unit": "string",
      "width": 0
    }
  ]
}

Response status  200

{
  "result": {
    "task_id": 0
  }
}

/import/info

POST /v1/product/import/info

Get the status of creating a PDP (product description page).

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

The task number for importing products.

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

Product details.

Seller Product ID.

Product ID.

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.

Seller Product ID.

Price before discounts (will be strikethrough on the PDP) in rubles. The decimal separator is a dot, up to two characters after the dot.

Price for Ozon Premium subscribers.

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.

Product ID.

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

Array of errors that occurred when processing the request.

Error code.

Error reason.

Seller Product ID.

Product ID.

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

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

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

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

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

Описание.

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

Название.

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

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

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

The number of the page returned in the request.

The number of items on the page.

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

Array of products.

commissions-en object

Commissions details.

Delivery cost.

marketing_actions out.marketing_actions-en

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.

The price of the main offer on Ozon.

marketing_seller_price string

The price of the product, including all promotions. This value will be shown on the Ozon showcase.

The price of the product, including the promotions of the seller only.

The minimum price for the same product on Ozon.

The price before discounts, displayed strikethrough on the PDP.

The price for Ozon Premium subscribers.

The product price including discounts. This value is displayed on the PDP.

The price of the product recommended by the system based on similar offers.

retail_price string

Supplier's price.

The VAT rate for the product.

price_index-en string

Price index. Learn more in Help Center

product_id-en integer

Product ID.

volume_weight-en integer

The volumetric weight of the product.

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

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

Product ID.

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

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.

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

Product ID.

Product barcode.

Product description. To wrap a line in a description, use the HTML tag br.

Product name. Up to 500 characters.

The manufacturer of the product. Up to 100 characters.

Manufacturer's code. Up to 100 characters.

The height of the package.

The depth of tha package.

The width of the package.

Unit of measurement of dimensions

mm — millimeters
cm — centimeters
in — inches

The weight of the product in the package. The limit value is 1000 kilograms or the converted value in other units of measurement.

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

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

An array with product characteristics. The characteristics differ for different categories — you can see them in Help Center or via API.

Characteristic ID.

The value of the characteristic.

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.

An array of characteristics with the same name but different values.

Array of characteristic values.

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

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

Метод для обновления цен товаров.

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

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

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

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

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

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

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

Код ошибки.

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

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

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

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 товаров в одном запросе.

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

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

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

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

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

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

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

Код ошибки.

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

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

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

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

Метод для обновления информации о товаре. Количество не ограничено.

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

Массив c характеристиками товара.

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

complex object

Массив характеристик, у которых есть вложенные аттрибуты.

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

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

Массив характеристик с одинаковым названием, но разными значениями.

collection object

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

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

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

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

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

Описание товара.

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

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

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

images object

Идентификатор категории. При создании товара в выбранной категории не должно быть других вложенных категорий.

default boolean

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

file_name string

Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.

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

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

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

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

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

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

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

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.

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

Product prices details.

Seller Product ID.

Price before discounts (will be strikethrough on the PDP) in rubles. The decimal separator is a dot, up to two characters after the dot.

Price for Ozon Premium subscribers.

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.

Product ID.

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

Array of errors that occurred when processing the request.

Error code.

Error reason.

Seller Product ID.

Product ID.

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.

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

Stock details.

Seller Product ID

Product ID.

The number of products.

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

Array of errors that occurred when processing the request.

Error code.

Error reason.

Seller Product ID.

Product ID.

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

product_id string

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

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

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

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

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

Штрихкод.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

sources array

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

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

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

coming integer

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

present integer

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

reserved integer

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

validation_errors object

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

code integer

Код ошибки.

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

field integer

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

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

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

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

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

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

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

complex_id integer

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

id* integer

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

dictionary_value_id integer

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

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

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

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

complex_attributes object

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

Массив характеристик, у которых есть вложенные атрибуты.

attributes array

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

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

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

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

image_group_id string

Идентификатор для последующей пакетной загрузки изображений.

images string

Массив с изображениями, не больше 10.

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

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

pdf_list array

Список pdf-файлов.

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

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

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

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

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

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

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

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

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

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

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

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

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

Штрихкод.

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

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

commissions object

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

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

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

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

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

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

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

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

Ошибки модерации.

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

Код ошибки.

field string

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

level string

Уровень характеристики.

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

Массив ссылок на изображения. Каждая ссылка — string.

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

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

Название.

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

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

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

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

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

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

sources object

Информация об источниках схожих предложений. Подробнее в Помощи

is_enabled boolean

Флаг, что источник учитывается при расчете рыночного значения.

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

source string

Ссылка на источник.

Статус товара.

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

Ожидается поставка.

Сейчас на складе.

Зарезервировано.

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

Настройки видимости товара.

has_price boolean

True, если установлена цена.

True, если есть отстаток на складах.

True, если активный товар.

reasons object

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

Описание причины.

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

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

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

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

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

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

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

Штрихкод.

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

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

created_at datetime

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

Ошибки модерации.

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

Код ошибки.

field string

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

level string

Уровень характеристики.

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

Массив ссылок на изображения. Каждая ссылка — string.

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

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

Название.

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

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

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

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

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

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

sources object

Информация об источниках схожих предложений. Подробнее в Помощи

is_enabled boolean

Флаг, что источник учитывается при расчете рыночного значения.

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

source string

Ссылка на источник.

Статус товара.

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

Ожидается поставка.

Сейчас на складе.

Зарезервировано.

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

Настройки видимости товара.

has_price boolean

True, если установлена цена.

True, если есть отстаток на складах.

True, если активный товар.

reasons object

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

Описание причины.

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

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

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

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

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

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

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

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

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

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

Сейчас на складе.

Зарезервировано.

Тип склада.

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

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.

dictionary_value_id integer

Array of nested characteristic values.

Directory ID.

The value from the directory.

Product barcode.

complex_attributes object

Category ID.

An array of characteristics that have nested characteristics.

attributes array

An array with product characteristics.

The depth of tha package.

Unit of measurement of dimensions

mm — millimeters
cm — centimeters
in — inches

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.

Product name. Up to 500 characters.

Seller Product ID.

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.

The price for Ozon Premium subscribers.

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 rate for the product

0 — not subject to VAT
0.1 — 10%
0.2 — 20%

The weight of the product in the package. The limit value is 1000 kilograms or the converted value in other units of measurement.

Weight units: g — grams, kg — kilograms, lb — pounds.

The width of the package.

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

task_id out.task_id-en

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

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

Seller Product ID.

Product ID.

Ozon Product ID — SKU.

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

Barcode.

The price of the main offer on Ozon.

Category ID.

commissions object

Commissions details.

Delivery cost.

Minimum commission.

percent integer

Commission percentage.

Return cost.

Sale scheme.

Commission amount.

Date and time when the shipment was created.

Moderation errors.

Characteristic ID.

Error code.

The field where the error was found.

level string

The level of the characteristic.

The number of the task for generating documents.

Array of links to images. Each link is a string.

The price of the product, including all promotions. This value will be shown on the Ozon showcase.

The minimum price for the same product on Ozon.

Name.

Seller Product ID.

The price before discounts, displayed strikethrough on the PDP.

The price for Ozon Premium subscribers.

The product price including discounts. This value is displayed on the PDP.

Price index. Learn more in Help Center

visibility_details out.visibility_details-en

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.

Ozon ID.

Link to the source.

Product status.

Stock details.

Expecting supply.

In a warehouse.

Reserved.

The VAT rate for the product.

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

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

The number of the page returned in the request.

The number of items on the page.

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

Products details.

Seller Product ID.

Product ID.

Stock details.

In a warehouse.

Reserved.

Warehouse type.

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

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

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

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

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

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

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

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

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

Количество.

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

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

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

Код ошибки.

Текст ошибки: SKU STOCK NOT CHANGED. Количество товара на стоке не изменилось, так как вы передаете тот же остаток.

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

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

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

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

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.

Seller Product ID.

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

deleted boolean

True if the request was executed without errors and the products were deleted.

POST /v2/products/delete HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{

}

Response status  200

{

}

/info/attributes

POST /v2/products/info/attributes

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

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

Фильтр товаров.

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

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

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

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

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

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

attributeId integer

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

complexId integer

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

dictionaryValueId integer

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

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

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

Штрихкод.

complex_attributes object

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

Массив вложенных характеристик.

attributeId integer

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

complexId integer

dictionaryValueId integer

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

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

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

Глубина.

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

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

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

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

image_group_id string

Идентификатор для последующей пакетной загрузки изображений.

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

images360 array

Массив изображений 360.

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

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

pdf_list array

Массив pdf-файлов.

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

Единица измерения веса.

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

POST /v2/products/info/attributes HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "filter": {
    "offer_id": [
      "string"
    ],
    "product_id": [
      0
    ]
  },
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": [
    {
      "attributes": [
        {
          "attributeId": 0,
          "complexId": 0,
          "values": [
            {
              "dictionaryValueId": 0,
              "value": "string"
            }
          ]
        }
      ],
      "barcode": "string",
      "category_id": 0,
      "complex_attributes": [
        {
          "attributes": [
            {
              "attributeId": 0,
              "complexId": 0,
              "values": [
                {
                  "dictionaryValueId": 0,
                  "value": "string"
                }
              ]
            }
          ]
        }
      ],
      "depth": 0,
      "dimension_unit": "string",
      "height": 0,
      "id": 0,
      "image_group_id": "string",
      "images": [
        {
          "default": true,
          "file_name": "string",
          "index": 0
        }
      ],
      "images360": [
        {
          "file_name": "string",
          "index": 0
        }
      ],
      "name": "string",
      "offer_id": "string",
      "pdf_list": [
        {
          "file_name": "string",
          "index": 0,
          "name": "string"
        }
      ],
      "weight": 0,
      "weight_unit": "string",
      "width": 0
    }
  ]
}

/stocks

POST /v2/products/stocks

Method for updating the number of products in warehouses. Swagger

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

Information about products in warehouses.

Seller Product ID.

Product ID.

Quantity.

Warehouse ID.

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

Array of errors that occurred when processing the request.

Error code.

Error text: SKU STOCK NOT CHANGED. The number of the product in the warehouse has not changed, since you are sending the same stock.

Seller Product ID.

Product ID.

True if the request is successful and the stock is updated.

Warehouse ID.

POST /v2/products/stocks HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Can not resolve examples/v2/products/stocks/in.json

Response status  200

Can not resolve examples/v2/products/stocks/out.json

Отчеты

Список отчетов

POST /v1/report/list

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

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

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

report_type in.report_type

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

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

reports object

Массив со всеми сгенерированными отчетами

Уникальный ID отчета.

Дата создания отчета.

error string

Код ошибки при генерации отчета.

file string

Ссылка на файл формата CSV.

params object

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

report_type string

Тип отчета:
SELLER_PRODUCTS — отчет по товарам,
SELLER_TRANSACTIONS — отчет по транзакциям.

Статус генерации отчета, возможные значения "success", "failed".

Суммарное количество отчетов.

POST /v1/report/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "page": 0,
  "page_size": 0,
  "report_type": "ALL"
}

Response status  200

{
  "result": {
    "reports": [
      {
        "code": "string",
        "created_at": "2021-04-14T17:49:07.569Z",
        "error": "string",
        "file": "string",
        "params": {
          "additionalProp1": "string",
          "additionalProp2": "string",
          "additionalProp3": "string"
        },
        "report_type": "string",
        "status": "string"
      }
    ],
    "total": 0
  }
}

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

POST /v1/report/info

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

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

Уникальный ID отчета

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

Уникальный ID отчета.

Дата создания отчета.

error string

Код ошибки при генерации отчета.

file string

Ссылка на файл формата CSV.

params object

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

report_type string

Тип отчета:
SELLER_PRODUCTS — отчет по товарам,
SELLER_TRANSACTIONS — отчет по транзакциям.

Статус генерации отчета, возможные значения "success", "failed".

POST /v1/report/info HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "code": "string"
}

Response status  200

{
  "result": {
    "code": "string",
    "created_at": "2021-04-14T18:50:30.522Z",
    "error": "string",
    "file": "string",
    "params": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "report_type": "string",
    "status": "string"
  }
}

Отчет по товарам

POST /v1/report/products/create

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

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

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

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

search string

Поиск по содержанию записи, проверяет наличие.

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

visibility string

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

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

Уникальный ID отчета.

POST /v1/report/products/create HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "language": "DEFAULT",
  "offer_id": [
    "string"
  ],
  "search": "string",
  "sku": [
    0
  ],
  "visibility": "ALL"
}

Response status  200

{
  "result": {
    "code": "string"
  }
}

Отчет по транзакциям

POST /v1/report/transactions/create

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

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

date_from string

Дата с которой рассчитывается отчет по транзакциям. Формат YYYY-MM-DD

date_to string

Дата по которую рассчитывается отчет по транзакциям. Формат YYYY-MM-DD

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

search string

Поиск по содержанию записи, проверяет наличие.

Фильтр по типу транзакции, возможные варианты

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

Уникальный ID отчета.

POST /v1/report/transactions/create HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "date_from": "string",
  "date_to": "string",
  "language": "DEFAULT",
  "search": "string",
  "transaction_type": "ALL"
}

Response status  200

{
  "result": {
    "code": "string"
  }
}

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

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

/delivered

POST /v2/fbs/posting/delivered

Перевести отправление в статус "Доставлено", если используется сторонняя служба доставки.
Swagger

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

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

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

Ошибка при обработке запроса.

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

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

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

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

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

Ошибка при обработке запроса.

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

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

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

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

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

Ошибка при обработке запроса.

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

tracking_numbers * object

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

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

Массив с парами идентификатор отправления — трек-номер.

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

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

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

Ошибка при обработке запроса.

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

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

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

Shipment ID.

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

Request processing error.

Shipment number.

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

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

Shipment ID.

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

Request processing error.

Shipment number.

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

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

Shipment ID.

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

Request processing error.

Shipment number.

tracking_numbers * object

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

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

Array with shipment ID — track number pairs.

Shipment ID.

Tracking number.

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

Request processing error.

Shipment number.

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

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

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

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

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

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

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

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

Контактные данные получателя.

Имя покупателя.

Контактный телефон.

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

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

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

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

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

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

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

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

Служба доставки.

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

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

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

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

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

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

Информация об отмене.

True, если отмена влияет на рейтинг продавца.

Причина отмены.

Идентификатор причины отмены отправления.

Инициатор отмены отправления.

Тип отмены.

True, если отмена произошла после передачи отправления в службу доставки.

Данные о покупателе.

Информация об адресе доставки.

Адрес в текстовом формате.

Город доставки.

Комментарий к заказу.

Страна доставки.

Район доставки.

Широта.

Долгота.

Код ПВЗ.

Регион доставки.

Почтовый индекс получателя.

Email покупателя.

Идентификатор покупателя.

Имя покупателя.

Контактный телефон.

Дата доставки.

Метод доставки.

Идентификатор способа доставки

Название способа доставки.

Служба доставки.

Идентификатор службы доставки.

Название склада.

Идентификатор склада.

delivery_price string

Стоимость доставки.

Данные о стоимости товара, размере скидки, выплате и комиссии.

Массив товаров в отправлении.

Цена, по которой купили товар.

Размер комиссии за товар.

Процент комиссии.

Цена до учета скидок, на карточке товара отображается зачеркнутой.

Выплата продавцу.

Информация про доставку.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Идентификатор товара.

Количество товара.

Процент скидки.

Сумма скидки.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Размеры товара.

Высота упаковки.

Длина товара.

Вес товара в упаковке.

Ширина упаковки.

Обязательная маркировка товара.

Название.

Идентификатор товара в системе продавца — артикул.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Количество товара.

provider_status out.provider_status

Идентификатор товара на Ozon.

Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

Статус отправления.

Тип интеграции со службой доставки.
ozon— доставка службой Ozon.
tpl_tracking— доставка интегрированной службой.
non_integrated— доставка сторонней службой.

Трек-номер отправления.

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

Параметры запроса

Направление сортировки.

asc — по возрастанию,
desc — по убыванию.

delivery_method_id integer

Идентификатор способа доставки.

order_id string

Идентификатор заказа.

Идентификатор службы доставки.

since datetime

Начало периода в формате YYYY-MM-DD.

Конец периода в формате YYYY-MM-DD.

Статус отправления.

awaiting_approve — ожидает подтверждения,
awaiting_packaging — ожидает упаковки,
awaiting_deliver — ожидает отгрузки,
delivering — доставляется,
driver_pickup — у водителя,
delivered — доставлено,
cancelled — отменено.

Идентификатор склада.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

Дополнительные поля, которые нужно добавить в ответ.

Добавить в ответ данные аналитики.

Добавить в ответ штрихкоды отправления.

Добавить в ответ финансовые данные.

Параметры ответа

Массив отправлений и подробная информация по каждому. В этот параметр вложены остальные, перечисленные ниже.

Контактные данные получателя.

Имя покупателя.

Контактный телефон.

Аналитические данные.

Город доставки.

Дата и время начала доставки.

Дата и время конца доставки.

Способ доставки.

Наличие подписки Премиум.

Способ оплаты.

Регион доставки.

Служба доставки.

Идентификатор службы доставки.

Идентификатор склада.

Название склада отправки заказа.

Штрихкоды отправления.

Верхний штрихкод на маркировке отправления.

Нижний штрихкод на маркировке отправления.

Информация об отмене.

True, если отмена влияет на рейтинг продавца.

Причина отмены.

Идентификатор причины отмены отправления.

Инициатор отмены отправления.

Тип отмены.

True, если отмена произошла после передачи отправления в службу доставки.

Данные о покупателе.

Информация об адресе доставки.

Адрес в текстовом формате.

Город доставки.

Комментарий к заказу.

Страна доставки.

Район доставки.

Широта.

Долгота.

Код ПВЗ.

Регион доставки.

Почтовый индекс получателя.

Email покупателя.

Идентификатор покупателя.

Имя покупателя.

Контактный телефон.

Дата доставки.

Метод доставки.

Идентификатор способа доставки

Название способа доставки.

Служба доставки.

Идентификатор службы доставки.

Название склада.

Идентификатор склада.

Данные о стоимости товара, размере скидки, выплате и комиссии.

Массив товаров в отправлении.

Цена, по которой купили товар.

Размер комиссии за товар.

Процент комиссии.

Цена до учета скидок, на карточке товара отображается зачеркнутой.

Выплата продавцу.

Информация про доставку.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Идентификатор товара.

Количество товара.

Процент скидки.

Сумма скидки.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Статус отправления.

Трек-номер отправления.

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

Параметры запроса

Направление сортировки.

asc — по возрастанию,
desc — по убыванию.

delivering_date_from datetime

cutoff_from datetime

cutoff_to datetime

Минимальная дата доставки.

delivering_date_to datetime

Максимальная дата доставки.

delivery_method_id integer

Идентификатор способа доставки.

Идентификатор службы доставки.

Статус отправления.

awaiting_approve — ожидает подтверждения,
awaiting_packaging — ожидает упаковки,
awaiting_deliver — ожидает отгрузки,
delivering — доставляется,
driver_pickup — у водителя,
delivered — доставлено,
cancelled — отменено.

Идентификатор склада.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

Дополнительные поля, которые нужно добавить в ответ.

Добавить в ответ данные аналитики.

Добавить в ответ штрихкоды отправления.

Добавить в ответ финансовые данные.

Параметры ответа

count integer

Счетчик элементов в ответе.

Контактные данные получателя.

Имя покупателя.

Контактный телефон.

Аналитические данные.

Город доставки.

Дата и время начала доставки.

Дата и время конца доставки.

Способ доставки.

Наличие подписки Премиум.

Способ оплаты.

Регион доставки.

Служба доставки.

Идентификатор службы доставки.

Идентификатор склада.

Название склада отправки заказа.

Штрихкоды отправления.

Верхний штрихкод на маркировке отправления.

Нижний штрихкод на маркировке отправления.

Информация об отмене.

True, если отмена влияет на рейтинг продавца.

Причина отмены.

Идентификатор причины отмены отправления.

Инициатор отмены отправления.

Тип отмены.

True, если отмена произошла после передачи отправления в службу доставки.

Данные о покупателе.

Информация об адресе доставки.

Адрес в текстовом формате.

Город доставки.

Комментарий к заказу.

Страна доставки.

Район доставки.

Широта.

Долгота.

Код ПВЗ.

Регион доставки.

Почтовый индекс получателя.

Email покупателя.

Идентификатор покупателя.

Имя покупателя.

Контактный телефон.

Дата доставки.

Метод доставки.

Идентификатор способа доставки

Название способа доставки.

Служба доставки.

Идентификатор службы доставки.

Название склада.

Идентификатор склада.

Данные о стоимости товара, размере скидки, выплате и комиссии.

Массив товаров в отправлении.

Цена, по которой купили товар.

Размер комиссии за товар.

Процент комиссии.

Цена до учета скидок, на карточке товара отображается зачеркнутой.

Выплата продавцу.

Информация про доставку.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Идентификатор товара.

Количество товара.

Процент скидки.

Сумма скидки.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Статус отправления.

Трек-номер отправления.

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

Параметры запроса

Shipment ID.

Additional data that can be requested.

True to add analytics data.

True to add shipment barcodes.

True to add financial data.

Параметры ответа

The customer's details.

The customer's name.

The customer's phone number.

Analytics data.

Delivery city.

Delivery start date and time.

Delivery end date and time.

Delivery type.

True if the customer has Premium subscription.

Payment method.

Delivery region.

Delivery service.

Delivery service ID.

Warehouse ID.

The warehouse name from where order dispatched.

Shipment barcodes.

The upper barcode on the shipment label.

The lower barcode on the shipment label.

Cancellation data.

True, if cancellation affects seller's rating.

Cancellation reason.

Cancellation reason ID.

Cancellation requestor.

Cancellation type.

True, if cancellation occured after the shipment had been transferred to the delivery service.

The customer's details.

Delivery address.

Address in text format.

addressee string

Name and surname of the recipient.

Delivery city.

Additional information from the customer.

country string

Delivery country.

district string

Delivery district.

The customer's phone number.

Delivery region.

zip_code string

ZIP or postal code.

The customer's e-mail.

Customer ID.

The customer's name.

The customer's phone number.

Delivery date.

Delivery method.

Delivery method ID.

Delivery method name.

Delivery service.

Delivery service ID.

Warehouse name.

Warehouse ID.

delivery_price string

Delivery price.

Data on the cost of the product, the amount of the discount, payment and commission.

Array of products in the shipment.

The price at which the product was purchased.

Commission amount for the product

Commission percentage.

The price before discounts, displayed strikethrough on the PDP.

Payment to the seller.

Delivery details.

The product price including discounts. This value is displayed on the PDP.

Product ID.

Number of items.

Discount percentage.

Discount amount.

Date and time when the shipment processing started.

Order ID.

Order number.

Shipment number.

dimensions object

Product dimensions.

The height of the package.

length integer

The length of the package.

The weight of the product in the package.

The width of the package.

Mandatory marking.

Name.

Seller Product ID.

The product price including discounts. This value is displayed on the PDP.

Number of items.

Ozon ID.

provider_status string

Shipment status from a delivery service.

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.

Shipment status.

The type of integration with a delivery service.
ozon— Ozon Logistics.
tpl_tracking— integrated delivery service.
non_integrated— non-integrated delivery service.

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

Параметры запроса

Sorting direction.

asc — ascending
desc — descending

delivery_method_id integer

Delivery method ID.

order_id string

Order ID.

Delivery service ID.

since datetime

The start of the period in the YYYY-MM-DD format.

The end of the period in the YYYY-MM-DD format.

Shipment status.

awaiting_approve
awaiting_packaging
awaiting_deliver — awaiting shipping
delivering — in transit
driver_pickup — a driver is delivering a package
delivered
cancelled

Warehouse ID.

Number of shipments in a response. Maximum — 50, minimum — 1.

Number of omitted items in a response. For example, if the value of offset is 10, the response starts from the 11th item.

Additional data that can be requested.

True to add analytics data.

True to add shipment barcodes.

True to add financial data.

Параметры ответа

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.

An array of shipments with the detailed information on each.

The customer's details.

The customer's name.

The customer's phone number.

Analytics data.

Delivery city.

Delivery start date and time.

Delivery end date and time.

Delivery type.

True if the customer has Premium subscription.

Payment method.

Delivery region.

Delivery service.

Delivery service ID.

Warehouse ID.

The warehouse name from where order dispatched.

Shipment barcodes.

The upper barcode on the shipment label.

The lower barcode on the shipment label.

Cancellation data.

True, if cancellation affects seller's rating.

Cancellation reason.

Cancellation reason ID.

Cancellation requestor.

Cancellation type.

True, if cancellation occured after the shipment had been transferred to the delivery service.

The customer's details.

Delivery address.

Address in text format.

addressee string

Name and surname of the recipient.

Delivery city.

Additional information from the customer.

country string

Delivery country.

district string

Delivery district.

The customer's phone number.

Delivery region.

zip_code string

ZIP or postal code.

The customer's e-mail.

Customer ID.

The customer's name.

The customer's phone number.

Delivery date.

Delivery method.

Delivery method ID.

Delivery method name.

Delivery service.

Delivery service ID.

Warehouse name.

Warehouse ID.

Data on the cost of the product, the amount of the discount, payment and commission.

Array of products in the shipment.

The price at which the product was purchased.

Commission amount for the product

Commission percentage.

The price before discounts, displayed strikethrough on the PDP.

Payment to the seller.

Delivery details.

The product price including discounts. This value is displayed on the PDP.

Product ID.

Number of items.

Discount percentage.

Discount amount.

Date and time when the shipment processing started.

Order ID.

Order number.

Shipment number.

Liat of products in the shipment.

Mandatory marking.

Product name.

Seller Product ID.

Product price.

Number of items in the shipment.

Ozon ID.

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.

Shipment status.

The type of integration with a delivery service.
ozon— Ozon Logistics.
tpl_tracking— integrated delivery service.
non_integrated— non-integrated delivery service.

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

Параметры запроса

filter in.filter_rfbs2-en

Sorting direction.

asc — ascending
desc — descending

Number of shipments in a response. Maximum — 50, minimum — 1.

Number of omitted items in a response. For example, if the value of offset is 10, the response starts from the 11th item.

Additional data that can be requested.

True to add analytics data.

True to add shipment barcodes.

True to add financial data.

Параметры ответа

count out.count-en

An array of shipments with the detailed information on each.

The customer's details.

The customer's name.

The customer's phone number.

Analytics data.

Delivery city.

Delivery start date and time.

Delivery end date and time.

Delivery type.

True if the customer has Premium subscription.

Payment method.

Delivery region.

Delivery service.

Delivery service ID.

Warehouse ID.

The warehouse name from where order dispatched.

Shipment barcodes.

The upper barcode on the shipment label.

The lower barcode on the shipment label.

Cancellation data.

True, if cancellation affects seller's rating.

Cancellation reason.

Cancellation reason ID.

Cancellation requestor.

Cancellation type.

True, if cancellation occured after the shipment had been transferred to the delivery service.

The customer's details.

Delivery address.

Address in text format.

addressee string

Name and surname of the recipient.

Delivery city.

Additional information from the customer.

country string

Delivery country.

district string

Delivery district.

The customer's phone number.

Delivery region.

zip_code string

ZIP or postal code.

The customer's e-mail.

Customer ID.

The customer's name.

The customer's phone number.

Delivery date.

Delivery method.

Delivery method ID.

Delivery method name.

Delivery service.

Delivery service ID.

Warehouse name.

Warehouse ID.

Data on the cost of the product, the amount of the discount, payment and commission.

Array of products in the shipment.

The price at which the product was purchased.

Commission amount for the product

Commission percentage.

The price before discounts, displayed strikethrough on the PDP.

Payment to the seller.

Delivery details.

The product price including discounts. This value is displayed on the PDP.

Product ID.

Number of items.

Discount percentage.

Discount amount.

Date and time when the shipment processing started.

Order ID.

Order number.

Shipment number.

Liat of products in the shipment.

Mandatory marking.

Product name.

Seller Product ID.

Product price.

Number of items in the shipment.

Ozon ID.

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.

Shipment status.

The type of integration with a delivery service.
ozon— Ozon Logistics.
tpl_tracking— integrated delivery service.
non_integrated— non-integrated delivery service.

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

Период времени.

Начало периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Конец периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Номер отправления.

Тип транзакции

all — все,
orders — заказы,
returns — возвраты,
services — сервисные сборы.

page * integer

Номер страницы, возвращаемой в запросе.

page_size * integer

Количество элементов на странице.

Параметры ответа

item_delivery_amount integer

Сумма комиссии.

details string

Информация о товаре в транзакции.

discount_amount integer

Сумма скидки.

Количество доставленных товаров.

item_return_amount integer

Сумма скидки.

order_amount integer

Сумма заказа.

order_date datetime

Дата заказа в формате YYYY-MM-DDTHH:mm:ss.sssZ.

transaction_date datetime

Номер заказа.

order_state string

Статус отправления

total_amount string

Итоговый размер начислений.

Дата транзакции в формате YYYY-MM-DDTHH:mm:ss.sssZ.

transaction_number integer

Идентификатор транзакции.

transaction_type_slug string

Тип транзакции.

Тип транзакции в системном виде

POST /v2/finance/transaction/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "filter": {
    "date": {
      "from": "2021-03-02T10:17:12.739Z",
      "to": "2021-03-02T10:17:12.739Z"
    },
    "posting_number": "string",
    "transaction_type": "string"
  },
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": [
    {
      "commission_amount": 0,
      "details": "string",
      "discount_amount": 0,
      "item_delivery_amount": 0,
      "item_return_amount": 0,
      "order_amount": 0,
      "order_date": "2021-03-02T10:23:58.217Z",
      "order_number": "string",
      "order_state": "string",
      "total_amount": 0,
      "transaction_date": "2021-03-02T10:23:58.217Z",
      "transaction_number": 0,
      "transaction_type": "string",
      "transaction_type_slug": "string"
    }
  ]
}

/transaction/totals

POST /v2/finance/transaction/totals

Возвращает итоговые суммы по транзакциям за указанный период.

Параметры запроса

filter * object

Фильтр для поиска транзакций.

date object

Период времени.

Начало периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Конец периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Номер отправления.

Тип транзакции

all — все,
orders — заказы,
returns — возвраты,
services — сервисные сборы.

page * integer

Номер страницы, возвращаемой в запросе.

page_size * integer

Количество элементов на странице.

Параметры ответа

item_delivery_amount integer

Размер комиссии за товар.

discount_amount integer

Сумма скидки.

Количество доставленных товаров.

item_return_amount integer

Количество возвратов.

order_amount integer

Сумма заказа.

total_amount integer

Итоговый размер начислений.

POST /v2/finance/transaction/totals HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "filter": {
    "date": {
      "from": "2021-04-14T15:38:20.247Z",
      "to": "2021-04-14T15:38:20.247Z"
    },
    "posting_number": "string",
    "transaction_type": "string"
  },
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "commission_amount": 0,
  "discount_amount": 0,
  "item_delivery_amount": 0,
  "item_return_amount": 0,
  "order_amount": 0,
  "total_amount": 0
}

/v3/finance/transaction

Список транзакций

POST /v3/finance/transaction/list

Возвращает подробную информацию по всем начислениям. Можно указать номер отправления (posting_number), чтобы получить все начисления за указанный период, связанные с отправлением. Можно выбрать начисления определенного типа.

Параметры запроса

filter * object

Фильтр для поиска транзакций.

date object

Период времени.

Начало промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Конец промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.

operation_type string

Типы операций:
- ClientReturnAgentOperation — Получение возврата, отмены, невыкупа от покупателя,
- MarketplaceMarketingActionCostOperation — Услуги продвижения товаров,
- MarketplaceSaleReviewsOperation — Приобретение отзывов на платформе,
- MarketplaceSellerCompensationOperation — Прочие компенсации,
- OperationAgentDeliveredToCustomer — Доставка покупателю,
- OperationAgentDeliveredToCustomerCanceled — Доставка покупателю — исправленное начисление,
- OperationAgentStornoDeliveredToCustomer — Доставка покупателю — отмена начисления,
- OperationClaim — Начисление по претензии,
- OperationCorrectionSeller — Инвентаризация взаиморасчетов,
- OperationDefectiveWriteOff — Компенсация за поврежденный на складе товар,
- OperationItemReturn — Доставка и обработка возврата, отмены, невыкупа,
- OperationLackWriteOff — Компенсация за утерянный на складе товар,
- OperationMarketplaceCrossDockServiceWriteOff — Доставка товаров на склад Ozon (кросс-докинг),
- OperationMarketplaceServiceStorage — Услуга размещения товаров на складе,
- OperationSetOff — Взаимозачет с другими договорами контрагента,
- MarketplaceSellerReexposureDeliveryReturnOperation — Перечисление за доставку от покупателя,
- OperationReturnGoodsFBSofRMS — Доставка и обработка возврата, отмены, невыкупа,
- ReturnAgentOperationRFBS — Возврат перечисления за доставку покупателю,
- MarketplaceSellerShippingCompensationReturnOperation — Компенсация перечисления за доставку.

Номер отправления.

accruals_for_sale integer

Тип операции. Некоторые операции могут быть разделены во времени. Например, при приеме возврата от покупателя списывается стоимость товара и возвращается комиссия, а когда товар возвращается на склад, начисляется услуга по обработке возврата.
Типы начисления:
- all — все,
- orders — заказы,
- returns — возвраты и отмены,
- services — сервисные сборы,
- compensation,
- transferDelivery — стоимость на доставку,
- other — прочее.

page * integer

Номер страницы, возвращаемой в запросе.

page_size * integer

Количество элементов на странице.

Параметры ответа

operations object

Информация об операциях.

Стоимость товаров с учётом скидок продавца.

amount integer

Итоговая сумма операции.

delivery_charge integer

Стоимость доставки для начислений по тарифам действовавшим до 1 февраля 2021 года, а также начислений для КГТ товаров.

Информация о товаре.

Название товара.

operation_type_name string

Идентификатор товара в системе Ozon.

operation_date string

Дата операции.

operation_id integer

Идентификатор операции.

operation_type string

Тип операции.

Название типа операции.

posting object

Информация об отправлении.

delivery_schema string

Схема доставки. Например, FBO, FBS, RFBS или Crossborder.

order_date string

Дата принятия отправления в обработку.

Номер отправления.

return_delivery_charge integer

Идентификатор склада.

Плата за возвраты и отмены для начислений по тарифам действовавшим до 1 февраля 2021 года, а также начислений для КГТ товаров.

sale_commission integer

Комиссия за продажу/возврат комиссии за продажу.

services object

Информация об услугах. Типы услуг:
- MarketplaceNotDeliveredCostItem — Возврат невостребованного товара от покупателя на склад,
- MarketplaceReturnAfterDeliveryCostItem — Возврат от покупателя на склад после доставки,
- MarketplaceDeliveryCostItem — Доставка товара до покупателя,
- MarketplaceSaleReviewsItem — Приобретение отзывов на платформе,
- ItemAdvertisementForSupplierLogistic — Доставка товаров на склад Ozon (кросс-докинг),
- MarketplaceServiceStorageItem — Размещения товаров,
- MarketplaceMarketingActionCostItem — Продвижение товаров,
- MarketplaceServiceItemInstallment — Продвижению и продажа в рассрочку,
- MarketplaceServiceItemMarkingItems — Обязательная маркировка товаров,
- MarketplaceServiceItemFlexiblePaymentSchedule — Гибкий график выплат,
- MarketplaceServiceItemReturnFromStock — Комплектация товаров для вывоза продавцом,
- ItemAdvertisementForSupplierLogisticSeller — Транспортно-экспедиционные услуги,
- MarketplaceServiceItemDelivToCustomer — Последняя миля,
- MarketplaceServiceItemDirectFlowTrans — Магистраль,
- MarketplaceServiceItemDropoffFF — Обработка отправления,
- MarketplaceServiceItemDropoffPVZ — Обработка отправления,
- MarketplaceServiceItemDropoffSC — Обработка отправления,
- MarketplaceServiceItemFulfillment — Сборка заказа,
- MarketplaceServiceItemPickup — Выезд транспортного средства по адресу продавца для забора отправлений (Pick-up),
- MarketplaceServiceItemReturnAfterDelivToCustomer — Обработка возврата,
- MarketplaceServiceItemReturnFlowTrans — Обратная магистраль,
- MarketplaceServiceItemReturnNotDelivToCustomer — Обработка отмен,
- MarketplaceServiceItemReturnPartGoodsCustomer — Обработка невыкупа."

Название услуги.

Стоимость услуги.

Типы начисления:
- all — все,
- orders — заказы,
- returns — возвраты и отмены,
- services — сервисные сборы,
- compensation,
- transferDelivery — стоимость на доставку,
- other — прочее.

page_count integer

Количество страниц.

row_count integer

Количество товаров.

POST /v3/finance/transaction/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "filter": {
    "date": {
      "from": "2021-03-11T14:19:08.570Z",
      "to": "2021-03-11T14:19:08.570Z"
    },
    "operation_type": [
      "string"
    ],
    "posting_number": "string",
    "transaction_type": "string"
  },
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": {
    "operations": [
      {
        "accruals_for_sale": 0,
        "amount": 0,
        "delivery_charge": 0,
        "items": [
          {
            "name": "string",
            "sku": 0
          }
        ],
        "operation_date": "string",
        "operation_id": 0,
        "operation_type": "string",
        "operation_type_name": "string",
        "posting": {
          "delivery_schema": "string",
          "order_date": "string",
          "posting_number": "string",
          "warehouse_id": 0
        },
        "return_delivery_charge": 0,
        "sale_commission": 0,
        "services": [
          {
            "name": "string",
            "price": 0
          }
        ],
        "type": "string"
      }
    ],
    "page_count": 0,
    "row_count": 0
  }
}

Суммы транзакций

POST /v3/finance/transaction/totals

Возвращает итоговые суммы по транзакциям за указанный период.

Параметры запроса

company_id integer

Идентификатор компании.

period object

Период.

Начало промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Конец промежутка для фильтра по начислениям в формате YYYY-MM-DDTHH:mm:ss.sssZ.