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

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.

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

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

/list

POST /v1/delivery-method/list

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

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

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

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

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

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

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

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

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

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

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

company_id integer

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

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

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

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

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

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

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

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

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

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

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.

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

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

v1 Characteristics and categories

/tree

POST /v1/category/tree

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

/v2/category

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

/attribute

POST /v2/category/attribute

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

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

attribute_type string

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

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

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

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

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

Название.

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

group_name out.group_name

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

group_id out.group_id

dictionary_id out.dictionary_id

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

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

last_value_id in.last_value_id

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

attribute_id in.attribute_id

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

POST /v2/category/attribute HTTP/1.1

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

{
  "category_id": 17036076,
  "attribute_id": 8229,
  "language": "EN",
  "last_value_id": 0,
  "limit": 1
}

/value/by-option

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

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

options in.options

option_id in.option_id

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

POST /v2/category/attribute HTTP/1.1

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

{
  "options": [
    {
      "attribute_id": 8229,
      "option_id": 400
    }
  ],
  "language": "EN"
}

v2 Characteristics and categories

A group of methods for working with product categories

/attribute

POST /v2/category/attribute

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

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.

Name.

True if the characteristic is a number of values.

group_name out.group_name

True if the characteristic is required.

group_id out.group_id

dictionary_id out.dictionary_id

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

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

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

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

attribute_id in.attribute_id

The number of the task for generating documents.

value out.value

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

/values/by-option

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

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

options in.options

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.

option_id integer

ID of the preset value of the characteristic.

attribute_id integer

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

Text for the preset value of the characteristic.

POST /v2/category/attribute HTTP/1.1

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

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

Response status  200

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

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

/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

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

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

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

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

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

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

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

Код ошибки.

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

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

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

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"

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

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

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

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

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

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

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

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

Код ошибки

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

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

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. Устаревший параметр, больше не используется.

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

created_at string

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

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

Массив 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 символов.

vendor string

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

vendor_code string

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

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

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

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

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

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

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

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

images object

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

file_name string

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

default_img in.bool

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

attributes object

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

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

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

complex_collection object

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

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

POST /v1/product/import-by-sku

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

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

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

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

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

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

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

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

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

unmatched_sku_list integer

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

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

POST /v1/product/import-by-sku HTTP/1.1

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

{
  "items": [
    {
      "name": "string",
      "offer_id": "string",
      "old_price": "string",
      "premium_price": "string",
      "price": "string",
      "sku": 0,
      "vat": "string"
    }
  ]
}

Response status  200

{
  "result": {
    "task_id": 0,
    "unmatched_sku_list": [
      0
    ]
  }
}

/import/info

POST /v1/product/import/info

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

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

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.

vendor string

The manufacturer of the product. Up to 100 characters.

vendor_code string

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

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

attributes object

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.

complex_collection object

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

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

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

attributes object

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

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

complex object

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

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

complex_collection object

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

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

collection object

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

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

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

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

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

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

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

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

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

images object

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

default boolean

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

file_name string

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

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

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

vendor string

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

vendor_code string

Код производителя. До 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. Устаревший параметр, больше не используется.

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

created_at string

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

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

Массив 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%.

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

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

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

dictionary_value_id integer

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

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

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

values object

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

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

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

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

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

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

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

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

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

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

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

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

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

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

attribute_id integer

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

Код ошибки.

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.

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

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

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

attribute_id integer

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

Код ошибки.

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

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

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

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

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

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

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

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

dictionary_value_id integer

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

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

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

Тип склада.

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

POST /v2/product/info/stocks HTTP/1.1

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

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

Response status  200

{
  "result": {
    "items": [
      {
        "offer_id": "string",
        "product_id": 0,
        "stocks": [
          {
            "present": 0,
            "reserved": 0,
            "type": "string"
          }
        ]
      }
    ],
    "total": 0
  }
}

v2 Products and prices

/import

POST /v2/product/import

Upload your products to Ozon. You can send up to 100 products in a single request. Each product is a separate item in the items array. Specify all the information about the product: its characteristics, barcode, images, dimensions and price.

The characteristics depend on the product category — you can see the list of required characteristics for some categories using the method POST /v2/category/attribute.

After moderation, the product will appear in your personal account, but will not be visible to customers until you put it up for sale.

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

attributes * object

An array with product characteristics.

complex_id integer

ID of the characteristic that supports nested properties. For example, the "Processor" characteristic has nested characteristics "Manufacturer", "L2 Cache", and others. Each of the nested characteristics can have several variants of values.

id* integer

Characteristic ID.

values object

Array of nested characteristic values.

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

{

}

/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

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

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

/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

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

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

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

Начало периода в формате 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.

Delivery service ID.

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

Период времени.

from datetime

Начало периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Конец периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

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

transaction_type string

Тип транзакции

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 string

Тип транзакции.

transaction_type_slug string

Тип транзакции в системном виде

POST /v2/finance/transaction/list HTTP/1.1

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

{
  "filter": {
    "date": {
      "from": "2021-03-02T10:17:12.739Z",
      "to": "2021-03-02T10:17:12.739Z"
    },
    "posting_number": "string",
    "transaction_type": "string"
  },
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": [
    {
      "commission_amount": 0,
      "details": "string",
      "discount_amount": 0,
      "item_delivery_amount": 0,
      "item_return_amount": 0,
      "order_amount": 0,
      "order_date": "2021-03-02T10:23:58.217Z",
      "order_number": "string",
      "order_state": "string",
      "total_amount": 0,
      "transaction_date": "2021-03-02T10:23:58.217Z",
      "transaction_number": 0,
      "transaction_type": "string",
      "transaction_type_slug": "string"
    }
  ]
}

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

/approve

POST /v2/posting/crossborder/approve

pampam

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

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

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

cancel_reason_id * integer

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

POST /v2/posting/crossborder/approve HTTP/1.1

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

{
  "posting_number": "13009555-0001-1"
}

Response status  200

{
  "result": true
}

/cancel

POST /v2/posting/crossborder/cancel

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

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

cancel_reason_message string

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

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

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

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

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

POST /v2/posting/crossborder/cancel HTTP/1.1

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

{
  "cancel_reason_id": 361,
  "cancel_reason_message": "",
  "posting_number": "39268230-0002-3",
  "sku": [
    149123456
  ]
}

Response status  200

{
  "result": true
}

/cancel-reason/list

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

Can not resolve handlers/crossborder_cancel-reason.md

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

is_available_for_cancellation boolean

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

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

type_id string

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

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

POST /v2/posting/crossborder/cancel HTTP/1.1

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

Can not resolve examples/v2/posting/crossborder/cancel-reason/list/in.json

Response status  200

Can not resolve examples/v2/posting/crossborder/cancel-reason/list/out.json

/get

POST /v2/posting/crossborder/get

Can not resolve handlers/crossborder_get.md

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

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

translit boolean

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

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

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

Адрес в текстовом формате.

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

Комментарий к заказу.

Страна доставки.

Район доставки.

Широта.

Долгота.

Код ПВЗ.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

shipping_provider_id integer

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

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

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

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

POST /v2/posting/crossborder/get HTTP/1.1

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

{
  "posting_number": "39268230-0002-3",
}

Response status  200

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

/ship

POST /v2/posting/crossborder/ship

Can not resolve handlers/crossborder_ship.md

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

items * object

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

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

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

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

shipping_provider_id integer

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

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

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

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

package_number string

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

POST /v2/posting/crossborder/ship HTTP/1.1

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

{
  "items": [
    {
      "quantity": 2,
      "sku": 100056
    }
  ],
  "posting_number": "39268230-0002-3",
  "shipping_provider_id": 15109877837000,
  "tracking_number": "AB123456CD"
}

Response status  200

{
  "result": {
    "package_number": "232123"
  }
}

/shipping-provider/list

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

Can not resolve handlers/cb_shipping_provider.md

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

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

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

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

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

{}

Response status  200

{
  "result": [
    {
      "id": 15109877837000,
      "name": "shiptor"
    },
    {
      "id": 15308950689000,
      "name": "china-post"
    }
  ]
}

/unfulfilled/list

POST /v2/posting/crossborder/unfulfilled/list

Can not resolve handlers/cb_unfulfilled.md

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

cutoff_from * datetime

cutoff_to datetime

dir * string

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

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

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

offset * integer

status * string

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

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

translit * boolean

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

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

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

Адрес в текстовом формате.

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

Комментарий к заказу.

Страна доставки.

Район доставки.

Широта.

Долгота.

Код ПВЗ.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

shipping_provider_id integer

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

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

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

POST /v2/posting/crossborder/unfulfilled/list HTTP/1.1

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

{
  "dir": "asc",
  "limit": 10,
  "offset": 0,
  "status": [
    "awaiting_packaging"
  ]
}

Response status  200

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

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

/get

POST /v2/posting/fbo/get

Can not resolve handlers/fbo-get.md

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

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

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

POST /v2/posting/fbo/get HTTP/1.1

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

{
  "posting_number": "13009555-0001-1",
  "with": {
    "analytics_data": true,
    "financial_data": true
  }
}

Response status  200

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

/list

POST /v2/posting/fbo/list

Can not resolve handlers/fbo-list.md

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

dir * string

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

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

filter * object

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

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

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

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

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

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

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

translit boolean

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

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

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

POST /v2/posting/fbo/list HTTP/1.1

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

{
  "dir": "asc",
  "filter":
  {
    "since": "2018-10-24T16:24:09.474Z",
    "to": "2019-10-24T16:24:09.474Z"
  },
  "limit": 10,
  "offset": 0,
  "translit": true,
  "with": {
    "analytics_data": true,
    "financial_data": true
  }
}

Response status  200

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

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

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

/act/check-status

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

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

id * integer

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

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

added_to_act string

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

removed_from_act string

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

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

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

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

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

{
  "id": 15684442104000
}

Response status  200

{
  "result": {
    "status": "ready",
    "added_to_act": [
      "00420000-0030-2",
      "01560000-0096-4"
    ],
    "removed_from_act": [
      "03840000-0096-3"
    ]
  }
}

/act/create

POST /v2/posting/fbs/act/create

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

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

containers_count integer

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

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

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

POST /v2/posting/fbs/act/create HTTP/1.1

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

{
  "containers_count": 5
}

Response status  200

{
  "result": {
    "id": 15684442104000
  }
}

/act/get-container-labels

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

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

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

id * integer

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

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

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

{
  "id": 0
}

Response status  200

pdf-документ

/act/get-pdf

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

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

id * integer

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

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

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

{
  "id": 15684442104000
}

Response status  200

pdf-документ

/arbitration

POST /v2/posting/fbs/arbitration

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

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

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

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

POST /v2/posting/fbs/arbitration HTTP/1.1

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

{
  "posting_number":
  [
    "02898753-0009-1",
    "02898753-0009-2"
  ]
}

Response status  200

{
  "result": "true"
}

/awaiting-delivery

POST /v2/posting/fbs/awaiting-delivery

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

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

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

cancel_reason_id * integer

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

POST /v2/posting/fbs/awaiting-delivery HTTP/1.1

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

{
  "posting_number":
  [
    "02898753-0009-1",
    "02898753-0009-2"
  ]
}

Response status  200

{
  "result": "true"
}

/cancel

POST /v2/posting/fbs/cancel

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

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

cancel_reason_message string

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

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

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

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

POST /v2/posting/fbs/cancel HTTP/1.1

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

{
  "cancel_reason_id": 402,
  "cancel_reason_message": "Wrong seller id",
  "posting_number": 13076543-0001-1
}

Response status  200

{
  "result": "true"
}

/cancel-reason/list

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

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

is_available_for_cancellation boolean

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

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

type_id string

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

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

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

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

{}

Response status  200

{
  "result": [
    {
      "id": 123,
      "title": "Error",
      "type_id": "seller"
    }
  ]
}

/get

POST /v2/posting/fbs/get

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

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

POST /v2/posting/fbs/get HTTP/1.1

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

{
  "posting_number": "13076543-0001-1",
  "with": {
    "analytics_data": true,
    "barcodes": true,
    "financial_data": true
  }
}

Response status  200

{
  "result": {
    "analytics_data": {
      "city": "string",
      "delivery_type": "string",
      "is_premium": true,
      "payment_type_group_name": "string",
      "region": "string"
    },
    "barcodes": {
      "lower_barcode": "string",
      "upper_barcode": "string"
    },
    "cancel_reason_id": 0,
    "created_at": "2020-07-06T07:40:22.281Z",
    "financial_data": {
      "products": [
        {
          "actions": [
            "string"
          ],
          "commission_amount": 0,
          "commission_percent": 0,
          "old_price": 0,
          "payout": 0,
          "picking": {
            "amount": 0,
            "moment": "2020-07-06T07:40:22.281Z",
            "tag": "string"
          },
          "price": 0,
          "product_id": 0,
          "total_discount_percent": 0,
          "total_discount_value": 0
        }
      ]
    },
    "in_process_at": "2020-07-06T07:40:22.281Z",
    "order_id": 0,
    "order_number": "string",
    "posting_number": "string",
    "products": [
      {
        "mandatory_mark": [
          "string"
        ],
        "name": "string",
        "offer_id": "string",
        "price": "string",
        "quantity": 0,
        "sku": 0
      }
    ],
    "shipment_date": "2020-07-06T07:40:22.281Z",
    "status": "string"
  }
}

/get-by-barcode

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

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

barcode * string

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

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

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

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

{
  "barcode": "string"
}

Response status  200

{
  "result": {
    "barcodes": {
      "lower_barcode": "string",
      "upper_barcode": "string"
    },
    "cancel_reason_id": 0,
    "created_at": "2020-06-16T15:11:06.995Z",
    "in_process_at": "2020-06-16T15:11:06.995Z",
    "order_id": 0,
    "order_number": "string",
    "posting_number": "string",
    "products": [
      {
        "mandatory_mark": [
          "string"
        ],
        "name": "string",
        "offer_id": "string",
        "price": "string",
        "quantity": 0,
        "sku": 0
      }
    ],
    "shipment_date": "2020-06-16T15:11:06.995Z",
    "status": "string"
  }
}

/list

POST /v2/posting/fbs/list

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

dir * string

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

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

filter * object

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

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

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

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

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

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

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

sort_by string

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

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

POST /v2/posting/fbs/list HTTP/1.1

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

{
  "dir": "string",
  "filter": {
    "order_id": 0,
    "order_number": "string",
    "since": "2020-11-13T11:43:37.496Z",
    "status": "string",
    "to": "2020-11-13T11:43:37.496Z"
  },
  "limit": 0,
  "offset": 0,
  "sort_by": "string",
  "with": {
    "analytics_data": true,
    "barcodes": true,
    "financial_data": true
  }
}

Response status  200

{
  "result": [
    {
      "analytics_data": {
        "city": "string",
        "delivery_type": "string",
        "is_premium": true,
        "payment_type_group_name": "string",
        "region": "string"
      },
      "barcodes": {
        "lower_barcode": "string",
        "upper_barcode": "string"
      },
      "cancel_reason_id": 0,
      "created_at": "2020-07-06T06:23:14.627Z",
      "financial_data": {
        "products": [
          {
            "actions": [
              "string"
            ],
            "commission_amount": 0,
            "commission_percent": 0,
            "old_price": 0,
            "payout": 0,
            "picking": {
              "amount": 0,
              "moment": "2020-07-06T06:23:14.627Z",
              "tag": "string"
            },
            "price": 0,
            "product_id": 0,
            "total_discount_percent": 0,
            "total_discount_value": 0
          }
        ]
      },
      "in_process_at": "2020-07-06T06:23:14.627Z",
      "order_id": 0,
      "order_number": "string",
      "posting_number": "string",
      "products": [
        {
          "mandatory_mark": [
            "string"
          ],
          "name": "string",
          "offer_id": "string",
          "price": "string",
          "quantity": 0,
          "sku": 0
        }
      ],
      "shipment_date": "2020-07-06T06:23:14.627Z",
      "status": "string"
    }
  ]
}

/package-label

POST /v2/posting/fbs/package-label

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

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

POST /v2/posting/fbs/package-label HTTP/1.1

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

{
  "posting_number":
  [
    "13076543-0001-1"
  ]
}

Response status  200

pdf-документ

/product/mandatory-mark/is-required

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

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

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

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

sku * integer

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

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

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

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

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

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

{
  "sku": [
    0
  ]
}

Response status  200

{
  "result": [
    {
      "is_required": true,
      "sku": 0
    }
  ]
}

/product/mandatory-mark/validate

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

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

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

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

mandatory_mark * string

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

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

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

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

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

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

{
  "mandatory_mark": [
    "string"
  ]
}

Response status  200

{
  "result": [
    {
      "mandatory_mark": "string",
      "result": true
    }
  ]
}

/ship

POST /v2/posting/fbs/ship

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

packages * object

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

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

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

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

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

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

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

POST /v2/posting/fbs/ship HTTP/1.1

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

{
  "packages": [
    {
      "items": [
        {
          "mandatory_mark": [
            "string"
          ],
          "quantity": 0,
          "sku": 0
        }
      ]
    }
  ],
  "posting_number": "string"
}

Response status  200

{
  "result": [
    "string"
  ]
}

/unfulfilled/list

POST /v2/posting/fbs/unfulfilled/list

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

cutoff_from * datetime

cutoff_to datetime

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

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