NAV Navbar

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

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

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

Запросы выполняются по протоколу HTTP методами POST или GET. Входные и выходные структуры данных передаются в теле запроса и ответа. API поддерживает формат взаимодействия JSON. В ответе в HTTP-заголовке передается идентификатор связки запрос-ответ — Trace-ID.

Авторизация

Пример запроса:

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

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

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

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

Пример запроса:

GET / HTTP/1.1
Host: cb-api.ozonru.me
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

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

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

Параметр Описание
Client-Id 836
Api-Key 0296d4f2-70a1-4c09-b507-904fd05567b9

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

Пример запроса:

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

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

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

Созданные товары можно посмотреть по ссылке вида
https://www.ozon.ru/context/detail/id/SKU
где вместо SKU нужно указать значение для созданного товара.

Взаимодействие методов

Атрибуты и категории товаров

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

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

Дерево категорий товаров

Пример запроса:

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

Пример ответа:

{
  "result": [
    {
      "category_id": 1,
      "title": "Books",
      "children": [
        {
          "category_id": 2,
          "title": "Glossary",
          "children": []
        },
        {
          "category_id": 3,
          "title": "Science Fiction",
          "children": []
        }
      ]
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
category_id int Нет Идентификатор категории.
language string Нет Язык на котором будет выдан результат. Доступные варианты: EN (английский), RU (русский). По умолчанию, если параметр не указан, используется русский язык

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

Параметр Тип Описание
result array Список категорий.
category_id int Идентификатор категории.
title string Название категории
children array Дерево подкатегорий

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

Пример запроса:

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

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

Пример ответа:

{
  "result": [
    {
      "id": 1,
      "name": "Explosive",
      "description": "Mark for product if it is explosive",
      "type": "bool",
      "is_collection": false,
      "is_required": false,
      "option": [],
      "child": []
    },
    {
      "id": 2,
      "name": "Product name",
      "description": "Full product name",
      "type": "text",
      "is_collection": false,
      "is_required": true,
      "option": [],
      "child": []
    },
    {
      "id": 3,
      "name": "Size",
      "description": "List of possible sizes",
      "type": "text",
      "is_collection": true,
      "is_required": false,
      "option": [],
      "child": []
    },
    {
      "id": 4,
      "name": "Color",
      "description": "Main color",
      "type": "option",
      "is_collection": false,
      "is_required": false,
      "option": [
        {
          "id": 1,
          "value": "black"
        },
        {
          "id": 2,
          "value": "white"
        }
      ],
      "child": []
    },
    {
      "id": 5,
      "name": "Colors",
      "description": "List of possible colors",
      "type": "option",
      "is_collection": true,
      "is_required": false,
      "option": [
        {
          "id": 1,
          "value": "yellow"
        },
        {
          "id": 2,
          "value": "green"
        }
      ],
      "child": []
    },
    {
      "id": 6,
      "name": "Video",
      "description": "Main video",
      "type": "child",
      "is_collection": false,
      "is_required": false,
      "option": [],
      "child": [
        {
          "id": 10,
          "name": "Name",
          "description": "Name of video",
          "type": "text",
          "is_collection": false,
          "is_required": false,
          "option": []
        },
        {
          "id": 11,
          "name": "Url",
          "description": "Url to video",
          "type": "text",
          "is_collection": false,
          "is_required": false,
          "option": []
        }
      ]
    },
    {
      "id": 7,
      "name": "Videos",
      "description": "List of videos",
      "type": "child",
      "is_collection": true,
      "is_required": false,
      "option": [],
      "child": [
        {
          "id": 10,
          "name": "Name",
          "description": "Name of video",
          "type": "text",
          "is_collection": false,
          "is_required": false,
          "option": []
        },
        {
          "id": 11,
          "name": "Url",
          "description": "Url to video",
          "type": "text",
          "is_collection": false,
          "is_required": false,
          "option": []
        }
      ]
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
category_id int Да Идентификатор категории.
attribute_type string Нет Фильтр атрибутов, возможные значения: "required", "optional"
language string Нет Язык на котором будет выдан результат. Доступные варианты: EN (английский), RU (русский). По умолчанию, если параметр не указан, используется русский язык

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

Параметр Тип Описание
result array Список атрибутов категории.
id int Идентификатор атрибута
name string Название товара. До 500 знаков
description string Описание атрибута
type string Тип атрибута, возможные значения: bool, text, option, child
is_collection bool Атрибут является набором значений
is_required bool Обязательный атрибут
option array Массив предустановленных значений атрибута
option.id int Идентификатор предустановленного значения атрибута
option.value string Текст для предустановленного значения атрибута
child array Массив атрибутов потомков. Структура потомков совпадает с родительскими атрибутами

Определение категории товара

Пример запроса:

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

{
  "products": [
    {
      "offer_id": "147190464",
      "shop_category_full_path": "Электроника/Телефоны и аксессуары/Смартфоны",
      "shop_category": "Смартфоны",
      "shop_category_id": 15502,
      "vendor": "Apple, Inc",
      "model": "iPhone XS 256GB Space Grey",
      "name": "Смартфон Apple iPhone XS 256GB Space Grey",
      "price": "100990",
      "offer_url": "https://www.ozon.ru/context/detail/id/147190464/",
      "img_url": "https://ozon-st.cdn.ngenix.net/multimedia/1024351473.jpg",
      "vendor_code": "apple_inc",
      "barcode": "190198794017"
    }
  ]
}

Пример ответа:

{
  "result": [
    {
      "offer_id": "147190464",
      "category_id": 17039977,
      "classifier_status": "CLASSIFIED"
    }
  ]
}

Классификация товара по набору параметров в категорию на OZON. Обратите внимание, что классификатор работает в тестовом режиме, доступен только для товаров с описанием на русском языке и возвращает category_id для Production среды разработки. Возможна классификация до 100 товаров в одном запросе

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

Параметр Тип Обязательный Описание
barcode string Нет Штрих-код товара.
img_url string Нет Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.
model string Нет Модель товара. Например, "iPhone XS 256 GB Space Grey" - это модель, а "Apple, Inc" - производитель (vendor)
name string Да Название товара. До 500 знаков
offer_id string Да Идентификатор товара в системе продавца
offer_url string Нет Ссылка на товар на сайте продавца
price string Нет Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.
shop_category string Нет Категория, в которой находится товар, на сайте или в ERP системе продавца
shop_category_full_path string Нет Полный путь к категории на сайте или в ERP системе продавца
shop_category_id int Нет ID категории на сайте или в ERP системе продавца
vendor string Нет Производитель. До 100 знаков
vendor_code string Нет Код производителя. До 100 знаков

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

Параметр Тип Описание
offer_id string Идентификатор товара в системе продавца
category_id int Идентификатор категории.
status string Результат обработки товара классификатором (CLASSIFIED/NOT_CLASSIFIED)

Управление товарами и ценами

Существует ряд инструментов для заведения товаров на площадке Озон. Есть возможность загружать товары пакетно, или создавать и обновлять потоварно.
На этапе пробной интеграции рекомендуется пользоваться потоварным созданием, поскольку в этом случае сразу выполняется валидация данных.
Создание товара включает в себя несколько этапов и не происходит сразу после того, как вы отправили запрос - это конвеерная обработка заявок на создание товаров. Существует несколько этапов обработки, каждый из которых может привести к ошибке. Часть ошибок относится к валидации входных данных, или выявлена в ходе модерации товара. В таком случае необходимо загрузить новый
Есть несколько ограничений по обновлению данных товара:

Добавить товары

Пример запроса:

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

{
  "items": [{
    "barcode": "8801643566784",
    "description": "Red Samsung Galaxy S9 with 512GB",
    "category_id": 17030819,
    "name": "Samsung Galaxy S9",
    "offer_id": "REDSGS9-512",
    "price": "79990",
    "old_price": "89990",
    "premium_price": "75555",
    "vat": "0",
    "vendor": "Samsung",
    "vendor_code": "SM-G960UZPAXAA",
    "height": 77,
    "depth": 11,
    "width": 120,
    "dimension_unit": "mm",
    "weight": 120,
    "weight_unit": "g",
    "images": [
       {
         "file_name": "https://ozon-st.cdn.ngenix.net/multimedia/c1200/1022555115.jpg",
         "default": true
       },
       {
         "file_name": "https://ozon-st.cdn.ngenix.net/multimedia/c1200/1022555110.jpg",
         "default": false
       },
       {
         "file_name": "https://ozon-st.cdn.ngenix.net/multimedia/c1200/1022555111.jpg",
         "default": false
       }
     ],
    "attributes": [
      {
        "id": 8229,
        "value": "4747"
      },
      {
        "id": 9048,
        "value": "Samsung Galaxy S9"
      },
      {
        "id": 4742,
        "value": "512 ГБ"
      },
      {
        "id": 4413,
        "collection": ["1", "2", "13"]
      },
      {
        "id": 4018,
        "complex_collection": [
          {
            "collection": [
              {
                "id": 4068,
                "value": "Additional video"
              },
              {
                "id": 4074,
                "value": "5_-NKRVn7IQ"
              }
            ]
          },
          {
            "collection": [
              {
                "id": 4068,
                "value": "Another one video"
              },
              {
                "id": 4074,
                "value": "5_-NKRVn7IQ"
              }
            ]
          }
        ]
      }
  ]
 }]
}

Пример ответа:

{
  "result": {
    "task_id": 123
  }
}

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

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

Параметр Тип Обязательный Описание
barcode string Нет Штрих-код товара.
description string Да Описание товара. Для переноса строки в описании необходимо использовать HTML-тег br
category_id int Да Идентификатор категории. При создании товара в выбранной категории не должно быть других вложенных категорий
name string Да Название товара. До 500 знаков
offer_id string Да Идентификатор товара в системе продавца
price string Да Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.
old_price string Нет Цена до скидок (будет зачеркнута на карточке товара). Указывается в рублях. Разделитель дробной части — точка, до двух знаков после точки
premium_price string Нет Цена для клиентов с подпиской Ozon Premium.
vat string Да Ставка НДС для товара:
  • 0 — не облагается НДС;
  • 0.1 — 10%;
  • 0.2 — 20%.
vendor string Нет Производитель. До 100 знаков
vendor_code string Нет Код производителя. До 100 знаков
attributes array Да Массив атрибутов товара
attributes.id int Да Идентификатор атрибута
attributes.value string Нет Значение атрибута
attributes.collection array Нет Массив значений атрибута. Например, атрибут Цвет может включать два значения: черный и белый
attributes.complex array Нет Массив атрибутов, которые поддерживают вложенные свойства. Например, у атрибута Процессор есть вложенные атрибуты Производитель, L2 Cache, и другие. У каждого из вложенных атрибутов может быть несколько вариантов значений
attributes.complex_collection array Нет Массив атрибутов с одинаковым названием, но разными значениями. Например, у CD диска с аудиокнигой может быть несколько атрибутов Аудио дорожка, каждый из который будет иметь разные значения вложенных атрибутов Длина дорожки, Битрейт и т.д.
attributes.complex_collection. collection array Нет Массив комплексных атрибутов с мультивыбором
images array Да Массив с изображениями, не более 10
images.file_name string Да Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.
images.default bool Да Признак, позволяющий установить изображение основным
height int Да Высота упаковки Предельное значение - 10 метров (для Crossborder параметр опционален)
depth int Да Глубина упаковки Предельное значение - 10 метров (для Crossborder параметр опционален)
width int Да Ширина упаковки. Предельное значение - 10 метров (для Crossborder параметр опционален)
dimension_unit string Да Единица измерения габаритов. Доступные варианты: mm (миллиметры), cm (сантиметры), in (дюймы)
weight int Да Вес товара в упаковке. Предельное значение - 1000 килограмм (или конвертированная величина в других единицах измерения)
weight_unit string Да Единицы измерения веса. Доступные варианты: g (граммы), kg (килограммы), lb (фунты)

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

Параметр Тип Описание
result array Список идентификаторов заказов.
task_id int Код задачи на импорт товаров. Статус выполнения задачи можно получить, используя метод Статус создания товара.

Для того чтобы создать карточку товара с несколькими цветами/размерами, необходимо заполнить атрибут "Название модели" (8292). Товары одной модели, разных размеров и цветов должны иметь одинаковое значение в атрибуте 8292.

Например, есть товар двух цветов (черный, белый) и 3 размеров (40, 42, 43). У всех этих товаров должно быть одинаковое значение атрибута 8292.

Цвет Размер 8292 Название модели
Черный 40 SAME_MODEL_NAME
Черный 42 SAME_MODEL_NAME
Черный 43 SAME_MODEL_NAME
Белый 40 SAME_MODEL_NAME
Белый 42 SAME_MODEL_NAME
Белый 43 SAME_MODEL_NAME

Все продукты с одинаковым атрибутом 8292 будут отображаться в одной товарной карточке.

Узнать статус добавления товара

Пример запроса:

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

Пример ответа:

{
  "result": {
    "items": [
      {
        "offer_id": "Offer_RbtbQseqtTeBlHB8AjF9t-23",
        "product_id": 5376526,
        "status": "processed"
      }
    ],
    "total": 1
  }
}

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

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

Параметр Тип Обязательный Описание
task_id int Да Код задачи на импорт товаров.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
items array Информация о товарах.
items.offer_id string Идентификатор товара в системе продавца
items.product_id int Идентификатор товара.
items.status string Статус создания товара. Информация о товаре обрабатывается очередями. Возможные значения параметра processing, moderating, processed, failed_moderation, failed_validation, failed. Актуальный статус обновления информации о товаре можно проверить методом Информация о товаре.

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

Пример запроса:

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": [
    "Offer_RbtbQseqtTeBlHB8AjF9t-23"
  ],
  "products_ids": [
    5376526
  ]
}

Пример ответа:

{
  "result": {
    "item_updated": [
      {
        "success": true,
        "product_id": 0,
        "offer_id": "Offer_RbtbQseqtTeBlHB8AjF9t-23"
      },
      {
        "success": false,
        "product_id": 5376526,
        "offer_id": ""
      }
    ]
  }
}

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

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

Параметр Тип Обязательный Описание
is_prepayment boolean Да Флаг обязательной предоплаты для товара:
  • true — чтобы купить товар, нужно внести предоплату;
  • false — предоплата не обязательна.
offers_ids array Нет Массив идентификаторов товаров в системе продавца.
products_ids array Нет Массив идентификаторов товаров в системе Ozon.

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

Параметр Тип Описание
item_updated array Информация об обновленных товарах.
item_updated.offer_id string Идентификатор товара в системе продавца.
item_updated.product_id int Идентификатор товара.
item_updated.success boolean Результат запроса:
  • true — изменения сохранены;
  • false — изменения не применились.

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

Пример запроса:

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": "item_6060091",
  "product_id": 7154396,
  "sku": 150583609
}

Пример ответа:

{
  "result": {
    "barcode": "",
    "buybox_price": "3599.0000",
    "category_id": 17034461,
    "created_at": "2019-11-26T10:40:44.940Z",
    "id": 7154396,
    "images": [
      "https://cdn1.ozone.ru/multimedia/1028110514.jpg"
    ],
    "marketing_price": "",
    "min_ozon_price": "3599.0000",
    "name": "Туалетная вода VALENTINO UOMO ACQUA spray 75 ml",
    "offer_id": "item_6060091",
    "old_price": "",
    "premium_price": "",
    "price": "3599.0000",
    "recommended_price": " ",
    "sku": 150583609,
    "sources": [
      {
        "is_enabled": true,
        "sku": 150583609,
        "source": "fbo"
      }
    ],
    "state": "processed",
    "stock": 120,
    "stocks": {
      "coming": 0,
      "present": 120,
      "reserved": 0
    },
    "validation_errors": [],
    "vat": "0.2",
    "visibility_details": {
      "has_price": true,
      "has_stock": true,
      "active_product": true
    },
    "visible": true
  }
}

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

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

Параметр Тип Обязательный Описание
product_id int Нет Идентификатор товара.
sku int Нет Идентификатор товара в системе Ozon.
offer_id string Нет Идентификатор товара в системе продавца

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

Параметр Тип Описание
barcode string Штрих-код товара.
buybox_price string Цена главного предложения на Ozon.
category_id int Идентификатор категории товара.
created_at string Дата и время создания товара.
id int Идентификтаор атрибута товара.
images array Массив url для изображений товара.
marketing_price string Цена на товар с учетом всех акций. Это значение будет указано на витрине Ozon.
min_ozon_price sting Минимальная цена на аналогичный товара на Ozon.
name string Название товара. До 500 символов.
offer_id string Идентификатор товара в системе продавца.
old_price string Цена до учета скидок, на карточке товара отображается зачеркнутой.
premium_price string Цена для клиентов с подпиской Ozon Premium.
price string Информация о цене товара.
recommended_price string Цена на товар, рекомендованная системой на основании схожих предложений.
sku int Идентификатор товара в системе Ozon.
sources array Информация о SKU Ozon.
sources.is_enabled bool Видимость SKU товара в системе Ozon.
sources.sku int Номер Ozon-SKU.
sources.source string Тип SKU Ozon:
  • fbo
  • fbs
  • crossborder
state string Статус добваления товара с систему:
  • processing — информация о товара добавляется в систему, ожидайте;
  • moderating — товар проходит модерацию, ожидайте;
  • processed — информация обновлена;
  • failed_moderation — товар не прошел модерацию;
  • failed_validation — товар не прошел валидацию;
  • failed — возникла ошибка.
stock int Количество товара в наличии.
stocks object Информация о количестве товара.
stocks.coming int Товары, которые ожидают поставки.
stocks.present int Товары в наличии.
stocks.reserved int Товары в резерве.
validation_errors array Информация об ошибках валидации.
validation_errors.code string Код ошибки.
validation_errors.error string Описание ошибки.
validation_errors.field string Поле, в котором возникла ошибка.
vat string Ставка НДС для товара:
  • 0 — не облагается НДС;
  • 0.1 — 10%;
  • 0.2 — 20%.
visible bool Товар доступен на Ozon для покупки.
visibility_details object Параметры видимости товара.
visibility_details.active_product bool Товар активирован.
visibility_details.has_price bool У товара есть цена.
visibility_details.has_stock bool Товар доступен на складе.

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

Пример запроса:

POST /v1/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": 1,
  "page_size": 100
}

Пример ответа:

{
  "result": [
    {
      "product_id": 123,
      "offer_id": "SAMSGGLXS10",
      "stock": {
        "coming": 0,
        "present": 12,
        "reserved": 0
      }
    },
    {
      "product_id": 345,
      "offer_id": "SAMSGGLXS30",
      "stock": {
        "coming": 0,
        "present": 24,
        "reserved": 2
      }
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
page int Нет Количество страниц в ответе.
page_size int Нет Количество товаров на странице. По умолчанию значение 20. Максимальное значение 1000

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

Параметр Тип Описание
result array Информация о стоках товаров
product_id int Идентификатор товара.
offer_id string Идентификатор товара в системе продавца
stock array Количество товара в наличии.
stock.coming int Количество товаров, ожидаемых к поставке
stock.present int Количество товаров в наличии
stock.reserved int Количество товаров в резерве

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

Пример запроса:

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
}

Пример ответа:

{
  "result": {
    "items": [
      {
        "product_id": 253611,
        "offer_id": "УТ-00007992",
        "price": {
          "price": "2489.0000",
          "old_price": "2489.0000",
          "premium_price": "",
          "recommended_price": "",
          "retail_price": "",
          "vat": "0.000000",
          "buybox_price": "2489.0000",
          "min_ozon_price": "2489.0000",
          "marketing_price": "2489.0000"
        }
      }
    ],
    "total": 5594
  }
}

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

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

Параметр Тип Обязательный Описание
page int Нет Количество страниц в ответе.
page_size int Нет Количество товаров на странице. По умолчанию значение 20. Максимальное значение 1000

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

Параметр Тип Описание
items array Информация о товарах.
product_id int Идентификатор товара.
offer_id string Идентификатор товара в системе продавца.
price object Информация о цене товара.
price.price string Цена товара с учетом скидок — это значение показывается на карточке товара.
price.old_price string Цена до учета скидок, на карточке товара отображается зачеркнутой.
price.premium_price string Цена для клиентов с подпиской Ozon Premium.
price.recommended_price string Цена на товар, рекомендованная системой на основании схожих предложений.
price.retail_price string Цена товара для поставщиков.
price.vat string Ставка НДС для товара:
  • 0 — не облагается НДС;
  • 0.1 — 10%;
  • 0.2 — 20%.
price.buybox_price string Цена главного предложения на Ozon.
price.min_ozon_price sting Минимальная цена на аналогичный товара на Ozon.
price.marketing_price string Цена на товар с учетом всех акций. Это значение будет указано на витрине Ozon.

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

Пример запроса:

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": [
      "1255959"
    ],
    "product_id": [
      552526
    ],
    "visibility": "ALL"
  },
  "page": 1,
  "page_size": 100
}

Пример ответа:

{
  "result": {
    "items": [
      {
        "product_id": 124100,
        "offer_id": "REDSGS10-128"
      },
      {
        "product_id": 124201,
        "offer_id": "REDSGS10-512"
      }
    ],
    "total": 4
  }
}

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

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

Параметр Тип Обязательный Описание
filter array Нет Массив фильтра по дополнительным параметрам
filter.offer_id string array Нет Фильтр по параметру offer_id. Возможно передавать список значений
filter.product_id int array Нет Фильтр по параметру product_id. Возможно передавать список значений
filter.visibility string Нет Фильтр по видимости товара, возможные значения:
  • ALL: все товары
  • VISIBLE: товары, которые видны покупателям
  • INVISIBLE: товары, которые по какой-то из причин не видны покупателям
  • EMPTY_STOCK: товары, у которых не указано наличие
  • READY_TO_SUPPLY: товары, которым можно установить наличие
  • STATE_FAILED: товары, создание которых завершилось ошибкой
page int Нет Количество страниц в ответе.
page_size int Нет Количество товаров на странице. По умолчанию значение 20. Максимальное значение 1000

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

Параметр Тип Описание
result array Список идентификаторов заказов.
product_id int Идентификатор товара.
offer_id string Идентификатор товара в системе продавца

Обновление цены

Пример запроса:

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": [
    {
      "product_id": 120000,
      "offer_id": "PRD-1",
      "price": "79990",
      "old_price": "89990",
      "premium_price": "75555",
      "vat": "0.1"
    },
    {
      "product_id": 124100,
      "offer_id": "PRD-2",
      "price": "79990",
      "old_price": "89990",
      "premium_price": "75555",
      "vat": "0.2"
    },
    {
      "product_id": 124201,
      "offer_id": "PRD-3",
      "price": "89990",
      "old_price": "79990",
      "premium_price": "75555",
      "vat": "0"
    }
  ]
}

Пример ответа:

{
  "result": [
    {
      "product_id": 120000,
      "offer_id": "PRD-1",
      "updated": false,
      "errors": [
        {"code": "not_found", "message": "Product not found"}
      ]
    },
    {
      "product_id": 124100,
      "offer_id": "PRD-2",
      "updated": true,
      "errors": []
    },
    {
      "product_id": 124201,
      "offer_id": "PRD-3",
      "updated": true,
      "errors": []
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
product_id int Нет Идентификатор товара.
offer_id string Да Идентификатор товара в системе продавца
price string Да Цена товара с учетом скидок, отображается на карточке товара. Если на товар нет скидок — укажите значение old_price.
old_price string Нет Цена до скидок (будет зачеркнута на карточке товара). Указывается в рублях. Разделитель дробной части — точка, до двух знаков после точки
premium_price string Нет Цена для клиентов с подпиской Ozon Premium.
vat string Да Ставка НДС для товара:
  • 0 — не облагается НДС;
  • 0.1 — 10%;
  • 0.2 — 20%.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
product_id int Идентификатор товара.
offer_id string Идентификатор товара в системе продавца
updated bool Успешность обновления информации о товаре

Обновление остатков

Пример запроса:

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": [
    {
      "product_id": 120000,
      "offer_id": "PRD-1",
      "stock": 20
    },
    {
      "product_id": 124100,
      "offer_id": "PRD-2",
      "stock": 20
    }
  ]
}

Пример ответа:

{
  "result": [
    {
      "product_id": 120000,
      "offer_id": "PRD-1",
      "updated": false,
      "errors": [
        {"code": "offer_id_not_found", "message": "Product not found"}
      ]
    },
    {
      "product_id": 124100,
      "offer_id": "PRD-2",
      "updated": true,
      "errors": []
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
product_id int Нет Идентификатор товара.
offer_id string Да Идентификатор товара в системе продавца
stock int Да Количество товара в наличии.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
product_id int Идентификатор товара.
offer_id string Идентификатор товара в системе продавца
updated bool Успешность обновления информации о товаре
errors array Информация об ошибках
errors.code string Код ошибки:
  • OVER_MAX_OVH_KGT: Вес или габариты товара больше максимальных. Обновить количество не получится. Информация в помощи
  • OVER_MAX_OVH_NON_KGT: Вы не можете продавать крупногабаритные товары с этого склада. Информация в помощи
  • NON_KGT_ON_KGT_WAREHOUSE: Все ваши товары продаются как крупногабаритные, а вы хотите продавать обычный. Он попадет под условия продажи крупногабаритных. Информация в помощи
  • STOCK_TOO_BIG: Указано слишком большое количество, попробуйте уменьшить его
  • INVALID_STATE: Товар не прошел все этапы создания, проверьте его статус
  • CANNOT_CREATE_FBS_SKU: Произошла внутренняя ошибка при обновлении наличия, попробуйте еще раз
  • NOT_FOUND: Не удалось найти указанный товар
errors.message string Текст ошибки

Обновить карточку товара

Пример запроса:

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

Пример ответа:

{
  "result": {
    "updated": true
  }
}

Позволяет изменить данные в карточке товара. Обратите внимание, что через данный метод нельзя обновить информацию о ценах и остатках. Для этого необходимо использовать методы Обновление цены и Обновление остатков

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

Параметр Тип Обязательный Описание
product_id int Да Идентификатор товара.
barcode string Нет Штрих-код товара.
description string Нет Описание товара. Для переноса строки в описании необходимо использовать HTML-тег br
name string Нет Название товара. До 500 знаков
vendor string Нет Производитель. До 100 знаков
vendor_code string Нет Код производителя. До 100 знаков
attributes array Нет Массив атрибутов товара
attributes.id int Нет Идентификатор атрибута
attributes.value string Нет Массив значений атрибута. Например, атрибут Цвет может включать два значения: черный и белый
attributes.collection array Нет Массив значений атрибута. Например, атрибут Цвет может включать два значения: черный и белый
attributes.complex array Нет Массив атрибутов, которые поддерживают вложенные свойства. Например, у атрибута Процессор есть вложенные атрибуты Производитель, L2 Cache, и другие. У каждого из вложенных атрибутов может быть несколько вариантов значений
attributes.complex_collection array Нет Массив атрибутов с одинаковым названием, но разными значениями. Например, у CD диска с аудиокнигой может быть несколько атрибутов Аудио дорожка, каждый из который будет иметь разные значения вложенных атрибутов Длина дорожки, Битрейт и т.д.
attributes.complex_collection. collection array Нет Массив комплексных атрибутов с мультивыбором
images array Нет Массив с изображениями, не более 10
images.file_name string Нет Ссылка на изображение формата http:// или https://. До 1000 знаков, форматы изображения JPEG или PNG.
images.default bool Нет Признак, позволяющий установить изображение основным
height int Нет Высота упаковки Предельное значение - 10 метров (для Crossborder параметр опционален)
depth int Нет Глубина упаковки Предельное значение - 10 метров (для Crossborder параметр опционален)
width int Нет Ширина упаковки. Предельное значение - 10 метров (для Crossborder параметр опционален)
dimension_unit string Нет Единица измерения габаритов. Доступные варианты: mm (миллиметры), cm (сантиметры), in (дюймы)
weight int Нет Вес товара в упаковке. Предельное значение - 1000 килограмм (или конвертированная величина в других единицах измерения)
weight_unit string Нет Единицы измерения веса. Доступные варианты: g (граммы), kg (килограммы), lb (фунты)

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

Параметр Тип Описание
result array Список идентификаторов заказов.
updated bool Успешность обновления информации о товаре

Выставить товар на продажу

Пример запроса:

POST /v1/product/activate 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
}

Пример ответа:

{
  "result": "success"
}

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

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

Параметр Тип Обязательный Описание
product_id int Да Идентификатор товара.

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

Параметр Тип Описание
result string Результат обработки запроса.

Снять товар с продажи

Пример запроса:

POST /v1/product/deactivate 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
}

Пример ответа:

{
  "result": "success"
}

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

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

Параметр Тип Обязательный Описание
product_id int Да Идентификатор товара.

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

Параметр Тип Описание
result string Результат обработки запроса.

Удаление товара

Пример запроса:

POST /v1/product/delete 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,
  "offer_id": "PRD-12"
}

Пример ответа:

{
  "result": {
    "deleted": true
  }
}

Позволяет удалить товар при соблюдении нескольких условий:

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

Параметр Тип Обязательный Описание
product_id int Нет Идентификатор товара.
offer_id string Нет Идентификатор товара в системе продавца

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

Параметр Тип Описание
result array Результат обработки запроса.
result.deleted bool Результат удаления товара

Примеры атрибутов товара

Для каждого товара в Ozon создается карточка товара — страница с основной информацией о товаре и атрибутами. Набор атрибутов может быть разным и зависит от категории товара. Получить набор атрибутов можно с помощью метода Список атрибутов. Полученные значения атрибутов необходимо передавать при создании или обновлении информации в карточке товара (методы Создание карточки товара и Обновление карточки товара).

Булевое значение (type=bool)

Допустимые значения для этого атрибута: "true", "false"

Пример запроса:

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,
  "attributes": [
    {
      "id": 4652,
      "value": "true"
    }
  ]
}

Пример полученных значений атрибутов:

Параметр Значение
id 4652
name Признак 18+
description -
is_collection false
is_required false
type bool
option -
child -

Текстовое значение (type=text и is_collection=false)

Пример запроса:

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,
  "attributes": [
    {
      "id": 9164,
      "value": "Return possible only during 7 days"
    }
  ]
}

Пример полученных значений атрибутов:

Параметр Значение
id 9164
name Условия возврата
description -
is_collection false
is_required false
type text
option -
child -

Массив текстовых значений (type=text и is_collection=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,
  "attributes": [
    {
      "id": 4057,
      "collection": [
        "10",
        "20"
      ]
    }
  ]
}

Пример полученных значений атрибутов:

Параметр Значение
id 4057
name Страницы
description -
is_collection true
is_required false
type text
option -
child -

Фиксированное значение (type=option и is_collection=false)

Пример запроса:

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,
  "attributes": [
    {
      "id": 4061,
      "value": "14"
    }
  ]
}

Пример полученных значений атрибутов:

Параметр Значение
id 4061
name Техника изображения
description -
is_collection false
is_required false
type option
option
option.id 5
option.value Акварель
option.id 14
option.value Акватинта
child -

Массив фиксированных значений (type=option и is_collection=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,
  "attributes": [
    {
      "id": 4061,
      "collection": [
        "5",
        "14"
      ]
    }
  ]
}

Пример полученных значений атрибутов:

Параметр Значение
id 4061
name Техника изображения
description -
is_collection true
is_required false
type option
option
option.id 5
option.value Акварель
option.id 14
option.value Акватинта
child -

Вложенные атрибуты (type=child и is_collection=false)

Пример запроса:

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,
  "attributes": [
    {
      "id": 4018,
      "complex": [
        {
          "id": 4068,
          "value": "Unboxing video"
        },
        {
          "id": 4074,
          "value": "JXSibCy2-As"
        }
      ]
    }
  ]
}

Пример полученных значений атрибутов:

Параметр Значение
id 4018
name Видеоролик
description -
is_collection false
is_required false
type child
option -
child
child.id 4068
child.name Название
child.description Наименование видеоролика на сайте
child.is_collection false
child.is_required false
child.type text
child.id 4074
child.name Код ролика на YouTube
child.description Часть ссылки на ролик с сайта youtube после watch?v=
child.is_collection false
child.is_required false
child.type text

Массив вложенных атрибутов (type=child и is_collection=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,
  "attributes": [
    {
      "id": 4018,
      "complex_collection": [
        {
          "collection": [
            {
              "id": 4068,
              "value": "Additional video"
            },
            {
              "id": 4074,
              "value": "JXSibCy3-As"
            }
          ]
        },
        {
          "collection": [
            {
              "id": 4068,
              "value": "Another one video"
            },
            {
              "id": 4074,
              "value": "JXSibCy4-As"
            }
          ]
        }
      ]
    }
  ]
}

Пример полученных значений атрибутов:

Параметр Значение
id 4018
name Видеоролик
description -
is_collection true
is_required false
type child
option -
child
child.id 4068
child.name Название
child.description Наименование видеоролика на сайте
child.is_collection false
child.is_required false
child.type text
child.option -
child.id 4074
child.name Код ролика на YouTube
child.description Часть ссылки на ролик с сайта youtube после watch?v=
child.is_collection false
child.is_required false
child.type text
child.option -

Отправления со склада продавца

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

Пример запроса:

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": "asc", 
    "filter": 
    { 
        "since": "2018-10-24T16:24:09.474Z", 
        "to": "2019-10-24T16:24:09.474Z" 
    }, 
    "limit": 10,
    "offset": 0
}

Пример ответа:

{
  "result": 
  [
    {
      "shipment_date": "2019-11-01T13:11:13.973Z",
      "order_id": 77712345,
      "order_number": "",
      "posting_number": "25312345-0021-2",
      "status": "cancelled",
      "cancel_reason_id": 76,
      "created_at": "2019-03-21T14:51:01Z",
      "in_process_at": "2019-03-21T14:52:07Z",       
      "products": 
      [
        {
          "sku": 149123456,
          "name": "AUX аудиокабель 3.5мм",
          "quantity": 1,
          "offer_id": "DEP-12345",
          "price": "270.0000"
        }
      ]
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
dir str Да Направление сортировки:
  • asc — по возрастанию,
  • desc — по убыванию.
filter array Да Фильтр для поиска отправлений.
since datetime Да Начало периода в формате YYYY-MM-DD.
to datetime Да Конец периода в формате YYYY-MM-DD.
status str Нет Статус отправления:
  • awaiting_packaging — ожидает упаковки,
  • not_accepted — не принят в сортировочном центре,
  • arbitration — ожидает решения спора,
  • awaiting_deliver — ожидает отгрузки,
  • delivering — доставляется,
  • delivered — доставлено,
  • cancelled — отменено.
limit int Да Количество отправлений в ответе. Максимум — 50.
offset int Нет Количество элементов, которое будет пропущено в ответе.
Например, если offset=10, то ответ начнется с 11-го найденного элемента.

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

Параметр Тип Описание
shipment_date ddtt Дата и время, до которой необходимо собрать отправление.
Если отправление не собрать к этой дате — оно автоматически отменится.
cancel_reason_Id int Идентификатор причины отмены отправления.
created_at ddtt Дата и время создания отправления.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number str Номер заказа, к которому относится отправление.
posting_number str Номер отправления.
products array Список товаров в отправлении.
products.name str Название товара.
products.offer_id str Артикул товара.
products.price str Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
status str Статус отправления.

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

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

Пример ответа:

{
  "result": {
    "shipment_date": "2019-11-01T13:11:13.973Z",
    "cancel_reason_id": 0,
    "created_at": "2019-11-01T13:11:13.973Z",
    "in_process_at": "2019-11-01T13:11:13.973Z",
    "order_id": 86765466,
    "order_number": "",
    "posting_number": "13076543-0001-1",
    "products": [
      {
        "name": "BLF ПЗУ",
        "offer_id": "BLF-BM12345",
        "price": "690.0000",
        "quantity": 1,
        "sku": 149512345
      }
    ],
    "status": "string"
  }
}

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

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

Параметр Тип Обязательный Описание
posting_number str Да Номер отправления.

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

Параметр Тип Описание
shipment_date ddtt Дата и время, до которой необходимо собрать отправление.
Если отправление не собрать к этой дате — оно автоматически отменится.
cancel_reason_Id int Идентификатор причины отмены отправления.
created_at ddtt Дата и время создания отправления.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number str Номер заказа, к которому относится отправление.
posting_number str Номер отправления.
products array Список товаров в отправлении.
products.name str Название товара.
products.offer_id str Артикул товара.
products.price str Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
status str Статус отправления.

Список необработанных отправлений

Пример запроса:

POST /v2/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": "asc", 
    "limit": 10,
    "offset": 0,
    "status": [
        "not_accepted"
      ]
}

Пример ответа:

{
  "result": {
    "shipment_date": "2019-11-01T13:11:13.973Z",
    "created_at": "2019-11-01T13:11:13.973Z",
    "in_process_at": "2019-11-01T13:11:13.973Z",
    "order_id": 86765466,
    "order_number": "",
    "posting_number": "13076543-0001-1",
    "products": [
      {
        "name": "BLF ПЗУ",
        "offer_id": "BLF-BM12345",
        "price": "690.0000",
        "quantity": 1,
        "sku": 149512345
      }
    ],
    "status": "string"
  }
}

Возвращает список отправлений, которые ожидают сборки (статус awaiting_packaging).

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

Параметр Тип Обязательный Описание
dir string Да Направление сортировки:
  • asc — по возрастанию,
  • desc — по убыванию.
limit int Да Количество отправлений в ответе. Максимум — 50.
offset int Нет Количество элементов, которое будет пропущено в ответе.
Например, если offset=10, то ответ начнется с 11-го найденного элемента.
status string Да Статус отправления:
  • awaiting_packaging — ожидает упаковки,
  • not_accepted — не принят в сортировочном центре,
  • awaiting_deliver — ожидает отгрузки.

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

Параметр Тип Описание
shipment_date ddtt Дата и время, до которой необходимо собрать отправление.
Если отправление не собрать к этой дате — оно автоматически отменится.
created_at ddtt Дата и время создания отправления.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number str Номер заказа, к которому относится отправление.
posting_number str Номер отправления.
products array Список товаров в отправлении.
products.name str Название товара.
products.offer_id str Артикул товара.
products.price str Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
status str Статус отправления.

Собрать заказ

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": [
            {
                "quantity": 3,
                "sku": 123065
            }
        ]
        }
    ],
    "posting_number": "13076543-0001-1"
}

Пример ответа:

{
  "result": [
    "OK"
  ]
}

Делит заказ на отправления и переводит его в статус awaiting_deliver.
Каждый элемент items описывает отдельное отправление в заказе. Разделить заказ нужно, если:

Подробнее про сбор заказов и требования к упаковке отправлений в Помощи для партнеров.

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

Параметр Тип Обязательный Описание
packages array Да Список отправлений в заказе.
items array Да Список товаров в отправлении.
items.quantity str Да Количество товара.
items.sku int Да Идентификатор товара.
posting_number str Да Номер отправления.

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

Параметр Тип Описание
result str Список идентификаторов отправлений.

Получить передаточные документы

Формирует передаточные документы: акт приема-передачи и транспортную накладную.
Документы формируются в асинхронном режиме:

  1. Отправляем запрос на формирование документов через метод POST /v2/posting/fbs/act/create и получаем номер задания на формирование документа
  2. Опрашиваем статус формирования документов через метод POST /v2/posting/fbs/act/check-status
  3. После получения статуса "ready" скачиваем документы через метод POST /v2/posting/fbs/act/get-pdf

Формирование акта и накладной.

Пример запроса:

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

{}

Пример ответа:

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

Запускает процедуру формирования передаточных документов: акта приема-передачи и транспортной накладной.

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

Параметр Тип Описание
result.id int Номер задания на формирование документов.
error.code string При формировании передаточных документов возникла ошибка:
  • not_found_in_sortingNOT_FOUND_IN_SORTING_CENTER — не все отправления приняты сортировочным центром. Добавьте такие отправления к отгрузке на сегодня, откройте спор или отмените отправления.
  • INCLUDES_NOT_PACKAGED_POSTINGS — не все отправления собраны к отгрузке на сегодня. Соберите их и повторите попытку.
  • PACKAGE_TIME_ALREADY_PASSED — продолжается прием заказов на сбор и передачу отправлений. Повторите попытку позже.

Статус акта и накладной

Пример запроса:

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
}

Пример ответа:

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

Получение текущего статуса формирования акта приема-передачи и транспортной накладной

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

Параметр Тип Обязательный Описание
id int Да Номер задания на формирование документов

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

Параметр Тип Описание
result.status string Возможные статусы
  • in_process: документы в процессе формирования
  • ready: документы сформированы и готовы для скачивания
  • error: произошла ошибка при формировании документов, необходимо запросить документы повторно
result.added_to_act string array Массив номеров отправлений, которые были добавлены в Акт приема-передачи и должны быть переданы в Озон в тот же день
result.removed_from_act string array Массив номеров отправлений, которые не попали в Акт приема-передачи. Такие отправления нужно передавать со следующей отгрузкой

Получение акта и накладной

Пример запроса:

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
}

Пример ответа:

Pdf документ

Получить сформированные передаточные документы, а именно Акт приема-передачи и Транспортную накладную в формате PDF

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

Параметр Тип Обязательный Описание
id int Да Номер задания на формирование документов

Напечатать маркировку

Пример запроса:

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

Пример ответа:

Pdf документ

Генерирует PDF-файл с маркировкой для указанных отправлений. В одном запросе можно передать не больше 20 идентификаторов. Если хотя бы для одного отправления возникнет ошибка, маркировка не будет подготовлена для всех отправлений в запросе.

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

Параметр Тип Обязательный Описание
posting_number string Да Номера отправлений через запятую.

Возможные ошибки:

POSTINGS_NOT_READY — отправление не готово к маркировке, повторите попытку позже.

Открыть спор по отправлению

Пример запроса:

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

Пример ответа:

{
  "result": "true"
}

Если отправление передано в доставку, но не просканированно в сортировочном центре, можно открыть спор. Открытый спор переведет отправление в статус ARBITRATION.

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

Параметр Тип Обязательный Описание
posting_number array Да Номера отправлений через запятую.

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

Параметр Тип Описание
result bool Результат обработки запроса:
  • true — изменения внесены,
  • false — возникла ошибка.

Передать отправление к отгрузке

Пример запроса:

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

Пример ответа:

{
  "result": "true"
}

Передает спорные заказы к отгрузке. Статус отправления изменится на awaiting_deliver.

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

Параметр Тип Обязательный Описание
posting_number array Да Номера отправлений через запятую.

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

Параметр Тип Описание
result bool Результат обработки запроса:
  • true — изменения внесены,
  • false — возникла ошибка.

Отменить отправление

Пример запроса:

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
}

Пример ответа:

{
  "result": "true"
}

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

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

Параметр Тип Обязательный Описание
cancel_reason_id int Да Идентификатор причины отмены:
  • 352 — товар закончился,
  • 400 — остался только товар с недостатками,
  • 402 — другая прична.
cancel_reason_message str Нет Дополнительная информация по отмене.
Если cancel_reason_id=402, параметр обязательный.
posting_number str Да Номера отправлений через запятую.

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

Параметр Тип Описание
result bool Результат обработки запроса:
  • true — изменения внесены,
  • false — возникла ошибка.

Причины отмены

Пример запроса:

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

{
}

Пример ответа:

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

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

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

Параметр Тип Описание
result array Список идентификаторов отправлений.
result.id int Идентификатор причины отмены отправления.
result.title str Описание причины отмены отправления.
result.type_id str Инициатор отмены отправления:
  • buyer — покупатель,
  • seller — продавец.

Отправления со склада Ozon

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

Пример запроса:

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
}

Пример ответа:

{
  "result": 
  [
    {
      "order_id": 77712345,
      "order_number": "",
      "posting_number": "25312345-0021-2",
      "status": "cancelled",
      "cancel_reason_id": 76,
      "created_at": "2019-03-21T14:51:01Z",
      "in_process_at": "2019-03-21T14:52:07Z",       
      "products": 
      [
        {
          "sku": 149123456,
          "name": "AUX аудиокабель 3.5мм",
          "quantity": 1,
          "offer_id": "DEP-12345",
          "price": "270.0000"
        }
      ]
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
dir str Да Направление сортировки:
  • asc — по возрастанию,
  • desc — по убыванию.
filter array Да Фильтр для поиска отправлений.
since datetime Да Начало периода в формате YYYY-MM-DD.
to datetime Да Конец периода в формате YYYY-MM-DD.
status str Нет Статус отправления:
  • awaiting_approve — ожидает подтверждения,
  • awaiting_packaging — ожидает упаковки,
  • awaiting_deliver — ожидает отгрузки,
  • delivering — доставляется,
  • delivered — доставлено,
  • cancelled — отменено.
limit int Да Количество отправлений в ответе. Максимум — 50.
offset int Нет Количество элементов, которое будет пропущено в ответе.
Например, если offset=10, то ответ начнется с 11-го найденного элемента.

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

Параметр Тип Описание
cancel_reason_Id int Идентификатор причины отмены отправления.
created_at ddtt Дата и время создания отправления.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number str Номер заказа, к которому относится отправление.
posting_number str Номер отправления.
products array Список товаров в отправлении.
products.name str Название товара.
products.offer_id str Артикул товара.
products.price str Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
status str Статус отправления.

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

Пример запроса:

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

Пример ответа:

{
  "result": 
  {
    "order_id": 86765466,
    "order_number": "",
    "posting_number": "13076543-0001-1",
    "status": "cancelled",
    "cancel_reason_id": 0,
    "created_at": "2019-05-31T19:22:34Z",
    "in_process_at": "2019-05-31T19:53:01Z",
    "products": 
    [
      {
        "sku": 149512345,
        "name": "BLF ПЗУ",
        "quantity": 1,
        "offer_id": "BLF-BM12345",
        "price": "690.0000"
      }
    ]
  }
}

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

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

Параметр Тип Обязательный Описание
posting_number str Да Номер отправления.

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

Параметр Тип Описание
cancel_reason_Id int Идентификатор причины отмены отправления.
created_at ddtt Дата и время создания отправления.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number str Номер заказа, к которому относится отправление.
posting_number str Номер отправления.
products array Список товаров в отправлении.
products.name str Название товара.
products.offer_id str Артикул товара.
products.price str Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
status str Статус отправления.

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

На маркетплейсе Ozon можно размещать товары магазинов, которые находятся за пределами Российской Федерации. Подробнее про схему работы см. Инструкции по работе с товарами из-за рубежа в Помощи Ozon.
Чтобы подготовить заказ к отправке покупателю, подтвердите отправление. Если какие-то товары отсутствуют, можно скорректировать заказ: отмените товары, которых нет в наличии и подтвердите только те отправления, которые будут переданы в доставку.

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

Пример запроса:

POST /v2/posting/crossborder/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-11-18T11:27:45.154Z",
    "status": "awaiting_approve",
    "to": "2019-11-18T11:27:45.154Z"
  },
  "limit": 10,
  "offset": 0
}

Пример ответа:

{
  "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": ""
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
dir string Да Направление сортировки:
  • asc — по возрастанию,
  • desc — по убыванию.
filter object Да Фильтр для поиска отправлений.
filter.since ddtt Нет Начало периода в формате YYYY-MM-DD.
filter.status string Нет Статус отправления:
  • awaiting_approve — ожидает подтверждения,
  • awaiting_packaging — ожидает упаковки,
  • awaiting_deliver — ожидает отгрузки,
  • delivering — доставляется,
  • delivered — доставлено,
  • cancelled — отменено.
filter.to ddtt Нет Конец периода в формате YYYY-MM-DD.
limit int Да Количество отправлений в ответе. Максимум — 50.
offset int Нет Количество элементов, которое будет пропущено в ответе.
Например, если offset=10, то ответ начнется с 11-го найденного элемента.

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

Параметр Тип Описание
address array Информация об адресе.
address.address_tail string Адрес в текстовом формате.
address.addressee string ФИО получателя.
address.city string Город доставки.
address.comment string Комментарий к заказу.
address.country string Страна.
address.district string Район.
address.phone string Телефон.
address.region string Регион.
address.zip_code string Индекс.
shipment_date ddtt Дата и время, до которой необходимо собрать отправление.
Если отправление не собрать к этой дате — оно автоматически отменится.
cancel_reason_id int Идентификатор причины отмены отправления.
created_at ddtt Дата и время создания отправления.
customer_email string Email покупателя.
customer_id int Идентификатор покупателя.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number string Номер заказа, к которому относится отправление.
posting_number string Номер отправления.
products array Список товаров в отправлении.
products.name string Название товара.
products.offer_id string Артикул товара.
products.price string Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
shipping_provider_id int Идентификатор службы доставки.
status string Статус отправления.
tracking_number string Трек-номер отправления.

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

Пример запроса:

POST /v2/posting/crossborder/get HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

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

Пример ответа:

{
  "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": ""
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
posting_number str Да Номер отправления.

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

Параметр Тип Описание
address array Информация об адресе.
address.address_tail string Адрес в текстовом формате.
address.addressee string ФИО получателя.
address.city string Город доставки.
address.comment string Комментарий к заказу.
address.country string Страна.
address.district string Район.
address.phone string Телефон.
address.region string Регион.
address.zip_code string Индекс.
shipment_date ddtt Дата и время, до которой необходимо собрать отправление.
Если отправление не собрать к этой дате — оно автоматически отменится.
cancel_reason_id int Идентификатор причины отмены отправления.
created_at ddtt Дата и время создания отправления.
customer_email string Email покупателя.
customer_id int Идентификатор покупателя.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number string Номер заказа, к которому относится отправление.
posting_number string Номер отправления.
products array Список товаров в отправлении.
products.name string Название товара.
products.offer_id string Артикул товара.
products.price string Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
shipping_provider_id int Идентификатор службы доставки.
status string Статус отправления.
tracking_number string Трек-номер отправления.

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

Пример запроса:

POST /v2/posting/crossborder/unfulfilled/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "dir": "asc",
  "limit": 10,
  "offset": 0,
  "status": "delivered"
}

Пример ответа:

{
  "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": ""
    }
  ]
}

Возвращает список отправлений, которые готовы к сборке (статус awaiting_packaging).

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

Параметр Тип Обязательный Описание
dir string Да Направление сортировки:
  • asc — по возрастанию,
  • desc — по убыванию.
limit int Да Количество отправлений в ответе. Максимум — 50.
offset int Да Количество элементов, которое будет пропущено в ответе.
Например, если offset=10, то ответ начнется с 11-го найденного элемента.
status string Да Статус отправления:
  • awaiting_packaging — ожидает упаковки,
  • not_accepted — не принят в сортировочном центре,
  • awaiting_deliver — ожидает отгрузки.

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

Параметр Тип Описание
address array Информация об адресе.
address.address_tail string Адрес в текстовом формате.
address.addressee string ФИО получателя.
address.city string Город доставки.
address.comment string Комментарий к заказу.
address.country string Страна.
address.district string Район.
address.phone string Телефон.
address.region string Регион.
address.zip_code string Индекс.
shipment_date ddtt Дата и время, до которой необходимо собрать отправление.
Если отправление не собрать к этой дате — оно автоматически отменится.
cancel_reason_id int Идентификатор причины отмены отправления.
created_at ddtt Дата и время создания отправления.
customer_email string Email покупателя.
customer_id int Идентификатор покупателя.
in_process_at ddtt Дата и время начала обработки отправления.
order_id int Идентификатор заказа, к которому относится отправление.
order_number string Номер заказа, к которому относится отправление.
posting_number string Номер отправления.
products array Список товаров в отправлении.
products.name string Название товара.
products.offer_id string Артикул товара.
products.price string Цена товара.
products.quantity int Количество товара в отправлении.
products.sku int Идентификатор товара в системе Ozon.
shipping_provider_id int Идентификатор службы доставки.
status string Статус отправления.
tracking_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"
}

Пример ответа:

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

Делит заказ на отправления и переводит его в статус awaiting_deliver.
Каждый элемент items описывает отдельное отправление в заказе. Разделить заказ нужно, если:

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

Параметр Тип Обязательный Описание
items object Да Список товаров в отправлении.
items.quantity int Да Количество товара.
items.sku int Да Идентификатор товара.
posting_number string Да Номер отправления.
shipping_provider_id int Да Идентификатор службы доставки.
tracking_number string Да Трек-номер отправления.

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

Параметр Тип Описание
result string Результат обработки запроса.

Список курьерских компаний

Пример запроса:

POST /v2/posting/crossborder/shipping-provider/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
}

Пример ответа:

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

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

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

Параметр Тип Описание
result array Список доступных служб доставки.
id int Идентификатор службы доставки.
name string Название службы доставки.

Подтвердить отправление

Пример запроса:

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

Пример ответа:

{
  "result": true
}

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

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

Параметр Тип Обязательный Описание
posting_number str Да Номер отправления.

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

Параметр Тип Описание
result boolean Результат обработки запроса:
  • true — изменения внесены,
  • false — возникла ошибка.

Отменить заказ

Пример запроса:

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

Пример ответа:

{
  "result": true
}

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

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

Параметр Тип Обязательный Описание
cancel_reason_id int Да Идентификатор причины отмены:
  • 352 — товар закончился,
  • 400 — остался только товар с недостатками,
  • 402 — другая прична.
cancel_reason_message string Нет Дополнительная информация по отмене.
Если cancel_reason_id=402, параметр обязательный.
posting_number string Да Номер отправления.
sku int Нет Список идентификаторов товаров в отправлении.

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

Параметр Тип Описание
result boolean Результат обработки запроса:
  • true — изменения внесены,
  • false — возникла ошибка.

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

POST /v2/posting/crossborder/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

{
}

Пример ответа:

{
  "result": [
    {
      "id": 361,
      "title": "Other",
      "type_id": "buyer"
    },
    {
      "id": 352,
      "title": "Product is out of stock",
      "type_id": "seller"
    }
  ]
}

Возвращает список возможных причин отмены заказа.

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

Параметр Тип Описание
result boolean Список причин для отмены отправления.
result.id int Идентификатор причины отмены отправления.
result.title string Описание причины отмены отправления.
result.type_id string Инициатор отмены отправления:
  • buyer — покупатель,
  • seller — продавец.

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

Покупатель может задавать вопросы о товаре или заказе в чате. С чатом можно работать через Seller API:

Список чатов

Пример запроса:

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": [
    "6639ec81-616e-480d-82b6-111dec41f674",
    "3cdf5407-9f90-4752-8105-8f1d4cd427f5"
  ],
  "page": 1,
  "page_size": 100
}

Пример ответа:

{
  "result": [
    {
      "id": "6639ec81-616e-480d-82b6-111dec41f674",
      "users": [
        {
          "id": "501",
          "type": "seller"
        },
        {
          "id": "5mzh1lzfuhq4jcs2ufoxpnoa",
          "type": "customer"
        }
      ],
      "last_message_id": "1933333401419385131"
    },
    {
      "id": "3cdf5407-9f90-4752-8105-8f1d4cd427f5",
      "users": [
        {
          "id": "501",
          "type": "seller"
        },
        {
          "id": "31494738",
          "type": "customer"
        }
      ],
      "last_message_id": "1933404740364797568"
    }
  ]
}

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

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

Параметр Тип Обязательный Описание
chat_id_list string array Нет Массив с идентификаторами чатов, для которых нужно вывести информацию.
page int Нет Количество страниц в ответе.
page_size int Нет Количество заказов на странице.
Значение по умолчанию: 100. Максимальное значение: 1000.

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

Параметр Тип Описание
id string Идентификатор чата.
users array Cписок участников чата.
users.id string Идентификатор участника чата.
users.type string Тип участника чата:
  • customer — покупатель,
  • seller — продавец,
  • crm — системные сообщения,
  • courier — курьер.
last_message_id string Идентификатор последнего сообщения в чате.

История сообщений

Пример запроса:

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
}

Пример ответа:

{
  "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": {
        "url": "http://api-seller.ozon.ru/v1/chat/file/3cdf5407-9f90-4752-8105-8f1d4cd427f563f87e6da3651007ab96185f38772032b3918e31.jpg",
        "mime": "image/jpeg",
        "size": 815313,
        "name": "32679625.jpg"
      },
      "id": "1931356687558511593",
      "text": "hello",
      "type": "file",
      "user": {
        "id": "30735682",
        "type": "customer"
      }
    }
  ]
}

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

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

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

Параметр Тип Обязательный Описание
chat_id string Да Идентификатор чата.
from_message_id string Нет Идентификатор сообщения, с которого начать вывод истории чата.
limit int Нет Количество сообщений в ответе.

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

Параметр Тип Описание
context object Заказ или отдельный товар, о котором пользователь написал в чат.
context.item object Информация о товаре.
item.sku int Идентификатор товара в системе Ozon.
context.order object Информация о заказе.
order.order_number string Номер заказа, к которому относится отправление.
order.postings object Информация об отправлении.
postings.delivery_schema string Схема доставки заказа:
  • fbs — доставка со склада продавца,
  • crossborder — доставка из-за рубежа.
postings.posting_number string Номер отправления.
postings.sku_list array Список идентификаторов товаров в отправлении.
created_at ddtt Дата и время создания сообщения.
file object Информация о файле в чате. Отображается только для сообщений с параметром type = file.
file.mime string Тип файла. Список и примеры допустимых значений на github.
file.name string Название файла.
file.size int Размер файла в байтах.
file.url string URL файла.
id string Идентификатор сообщения в чате.
text string Сообщение, только для type: text.
type string Тип сообщения:
  • text — текст,
  • file — файл.
user array Информация об авторе сообщения.
user.id string Идентификатор участника чата.
user.type string Тип участника чата:
  • customer — покупатель,
  • seller — продавец,
  • crm — системные сообщения,
  • courier — курьер.

Отправить сообщение

Пример запроса:

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": "3cdf5407-9f90-4752-8105-8f1d4cd427f5",
  "text": "Test Message"
}

Пример ответа:

{
  "result": "success"
}

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

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

Параметр Тип Обязательный Описание
chat_id string Да Идентификатор чата.
text string Да Текст сообщения в формате plain text.

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

Параметр Тип Описание
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

{
  "chat_id": "3cdf5407-9f90-4752-8105-8f1d4cd427f5",
  "base64_content": "MSwgMiwgMwo=",
  "name": "test.txt"
}

Пример ответа:

{
  "result": "success"
}

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

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

Параметр Тип Обязательный Описание
base64_content string Да Файл в виде строки base64.
chat_id string Да Идентификатор чата.
name string Да Название файла с расширением.

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

Параметр Тип Описание
result string Результат обработки запроса.

Создать чат

Пример запроса:

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

{
  "order_id": 598586936
}

Пример ответа:

{
  "result": {
    "chat_id": "3cdf5407-9f90-4752-8105-8f1d4cd427f5"
  }
}

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

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

Параметр Тип Обязательный Описание
order_id int Да Идентификатор заказа.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
result.chat_id string Идентификатор чата.

Отчеты по продуктам и транзакциям

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

Доступны следующие возможности:

  1. Получение списка отчетов
  2. Получение информации об отчете
  3. Создание отчета по товарам
  4. Создание отчета по транзакциям

Список отчетов

Пример запроса:

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

{
  "page": 1,
  "page_size": 100,
  "report_type": "SELLER_TRANSACTIONS"
}

Пример ответа:

{
  "result": {
    "reports": [
      {
        "code": "63d60fd4-1959-4087-89fa-2afa320eb2fb",
        "status": "success",
        "error": "",
        "file": "http://api-seller.ozon.ru/v1/report/file/a7/76/a776a9c05f1c5e67.csv",
        "report_type": "seller_transactions",
        "params": {
          "date_from": "2019-01-01",
          "date_to": "2019-01-15",
          "search": "",
          "transaction_type": ""
        },
        "created_at": "2019-01-23T10:22:46.414747Z"
      }
    ],
    "total": 1
  }
}

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

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

Параметр Тип Обязательный Описание
page int Нет Количество страниц в ответе.
page_size int Нет Количество заказов на странице.
Значение по умолчанию: 100. Максимальное значение: 1000.
report_type string Нет Фильтр по типу отчета, возможные значения "SELLER_PRODUCTS", "SELLER_TRANSACTIONS"

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

Параметр Тип Описание
reports array Массив со всеми сгенерированными отчетами
code string Уникальный ID отчета
status string Статус генерации отчета, возможные значения "success", "failed"
error string Код ошибки при генерации отчета
file string Ссылка на файл формата CSV
report_type string Фильтр по типу отчета, возможные значения "SELLER_PRODUCTS", "SELLER_TRANSACTIONS"
params array Массив с фильтрами, указанными при создании отчета продавцом
created_at string Дата создания отчета
total int Суммарное количество отчетов

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

Пример запроса:

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

{
  "code": "63d60fd4-1959-4087-89fa-2afa320eb2fb"
}

Пример ответа:

{
    "result": {
        "code": "63d60fd4-1959-4087-89fa-2afa320eb2fb",
        "status": "success",
        "error": "",
        "file": "http://api-seller.ozon.ru/v1/report/file/a7/76/a776a9c05f1c5e67.csv",
        "report_type": "seller_transactions",
        "params": {
            "date_from": "2019-01-01",
            "date_to": "2019-01-15",
            "search": "",
            "transaction_type": ""
        },
        "created_at": "2019-01-23T10:22:46.414747Z"
    }
}

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

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

Параметр Тип Обязательный Описание
code string Нет Уникальный ID отчета

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

Параметр Тип Описание
code string Уникальный ID отчета
status string Статус генерации отчета, возможные значения "success", "failed"
error string Код ошибки при генерации отчета
file string Ссылка на файл формата CSV
report_type string Фильтр по типу отчета, возможные значения "SELLER_PRODUCTS", "SELLER_TRANSACTIONS"
params array Массив с фильтрами, указанными при создании отчета продавцом
created_at string Дата создания отчета

Отчет по товарам

Пример запроса:

POST /v1/report/products/create HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "offer_id": [
    "GJ5O52T5"
  ],
  "search": "SAMSUNG",
  "sku": [
    555929582
  ],
  "visibility": "VISIBLE"
}

Пример ответа:

{
    "result": {
        "code": "da9af288-2724-4f0e-8b15-37cf061d4817"
    }
}

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

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

Параметр Тип Обязательный Описание
offer_id string array Нет Идентификатор товара в системе продавца
search string Нет Поиск по содержанию записи, проверяет наличие
sku int array Нет Идентификатор товара в системе Ozon.
visibility string Нет Фильтр по видимости товара, возможные значения:
  • ALL: все товары
  • VISIBLE: товары, которые видны покупателям
  • INVISIBLE: товары, которые по какой-то из причин не видны покупателям
  • EMPTY_STOCK: товары, у которых не указано наличие
  • READY_TO_SUPPLY: товары, которым можно установить наличие
  • STATE_FAILED: товары, создание которых завершилось ошибкой

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

Параметр Тип Описание
code string Уникальный ID отчета

Отчет по транзакциям

Пример запроса:

POST /v1/report/transactions/create HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "date_from": "2019-01-01",
  "date_to": "2019-01-15",
  "search": "MEIZU",
  "transaction_type": "ORDERS"
}

Пример ответа:

{
    "result": {
        "code": "da9af288-2724-4f0e-8b15-37cf061d4817"
    }
}

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

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

Параметр Тип Обязательный Описание
date_from string Да Дата с которой рассчитывается отчет по транзакциям. Формат YYYY-MM-DD
date_to string Да Дата по которую рассчитывается отчет по транзакциям. Формат YYYY-MM-DD
search string Нет Поиск по содержанию записи, проверяет наличие
transaction_type string Нет Фильтр по типу транзакции, возможные варианты: "ALL", "ORDERS", "RETURNS", "SERVICES", "OTHER", "DEPOSIT"

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

Параметр Тип Описание
code string Уникальный ID отчета

Старая версия API

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

Пример запроса:

GET /v1/order/123456?translit=true HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Пример ответа:

{
  "result": {
    "order_id": 123456,
    "order_number": "123456-0001",
    "status": "delivered",
    "customer_id": 122334,
    "delivery_schema": "fbo",
    "last_updated": "2018-09-25T12:41:48.932Z",
    "order_time": "2018-09-25T12:41:48.932Z",
    "address": {
      "address_tail": "Vlogogradskaya st. 12 - 23",
      "addressee": "Ivan Ivanov",
      "city": "Moscow",
      "comment": "pass code #123",
      "country": "Russia",
      "district": "Central",
      "phone": "7903XXXXXXX",
      "email": "test@ozon.ru",
      "region": "Moscow",
      "zip_code": "112334"
    },
    "items": [
      {
        "product_id": 124525,
        "item_id": 325441,
        "quantity": 1,
        "offer_id": "124100",
        "price": "79999",
        "tracking_number": "XZY1111111",
        "status": "delivered",
        "cancel_reason_id": 0,
        "auto_cancel_date": "2019-01-09T09:56:53.587Z",
        "shipping_provider_id": 5
      }
    ]
  }
}

Возращает информацию о заказе по его идентификатору.

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

Параметр Тип Обязательный Описание
order_id int Да Идентификатор заказа.
translit bool Нет Транслитерация адреса из кириллицы в латиницу

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

Параметр Тип Описание
order_id int Идентификатор заказа.
order_number string Номер заказа.
status string Статус заказа.
customer_id int Идентификатор покупателя.
delivery_schema string Схема доставки заказа, возможные значения: "fbo", "fbs", "crossborder"
last_updated string Последнее изменение информации о заказе.
order_time string Дата и время создания заказа.
address array Информация об адресе.
address.address_tail string Адрес в текстовом формате.
address.addressee string ФИО получателя.
address.city string Город доставки.
address.comment string Комментарий к заказу.
address.country string Страна.
address.district string Район.
address.phone string Телефон.
address.email string E-mail.
address.region string Регион.
address.zip_code string Индекс.
items array Информация о товарах.
items.product_id int Идентификатор товара.
items.item_id int Идентификатор позиции товара в заказе.
items.quantity int Количество товара.
items.offer_id string Идентификатор товара в системе продавца
items.price string Итоговая цена товара с учетом скидок в рублях. Разделитель дробной части — точка, до двух знаков после точки.
items.tracking_number string Номер отслеживания посылки.
items.status string Статус товара в заказе.
items.cancel_reason_id int Код причины отмены заказа.
items.auto_cancel_date string Дата автоматической отмены заказа (в будущем).
items.shipping_provider_id int Идентификатор компании, которая доставляет заказ.

Получить список заказов

Пример запроса:

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

{
  "since": "2018-12-19T14:39:46.033Z",
  "to": "2018-12-19T14:39:46.033Z",
  "delivery_schema": "fbs",
  "statuses": ["DELIVERED"],
  "page": 1,
  "page_size": 100
}

Пример ответа:

{
  "result": {
    "orders": [
      {
        "order_id": 19294655,
        "delivery_schema": "fbo",
        "status": "cancelled",
        "items": [
          {
            "item_id": 67696756,
            "product_id": 28987,
            "offer_id": "02905340-43",
            "cancel_reason_id": 0,
            "quantity": 1
          }
        ]
      },
      {
        "order_id": 19305509,
        "delivery_schema": "fbo",
        "status": "delivered",
        "items": [
          {
            "item_id": 67735563,
            "product_id": 29187,
            "offer_id": "25605010-37",
            "cancel_reason_id": 0,
            "quantity": 2
          }
        ]
      }
    ],
    "total": 121
  }
}

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

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

Параметр Тип Обязательный Описание
since string Да Дата начала периода в формате YYYY-MM-DD.
to string Да Дата окончания периода в формате YYYY-MM-DD.
delivery_schema string Да Схема доставки заказа, возможные значения: "fbs", "fbo", "crossborder"
statuses string array Нет Статус заказа, возможные значения: "awaiting_approve", "awaiting_packaging", "awaiting_deliver", "delivering", "delivered", "cancelled"
page int Нет Количество страниц в ответе.
page_size int Нет Количество заказов на странице.
Значение по умолчанию: 100. Максимальное значение: 1000.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
result.total int Общее число позиций.
orders.order_id int Идентификатор заказа.
orders.delivery_schema string Схема доставки заказа, возможные значения: "fbo", "fbs", "crossborder"
orders.status string Статус заказа.
orders.items array Информация о товарах.
orders.items.product_id int Идентификатор товара.
orders.items.item_id int Идентификатор позиции товара в заказе.
orders.items.offer_id string Идентификатор товара в системе продавца
orders.items.quantity string Количество товара.
orders.items.cancel_reason_id int Код причины отмены заказа.

Невыполненные заказы

Пример запроса:

POST /v1/order/unfulfilled 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": 10
}

Пример ответа:

{
  "result": [
    {
      "order_id": 123456,
      "items": [
        {
          "item_id": 12345,
          "product_id": 123456,
          "offer_id": "PRD-123",
          "quantity": 2
        }
      ]
    }
  ],
  "total": 121
}

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

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

Параметр Тип Обязательный Описание
page int Нет Количество страниц в ответе.
page_size int Нет Количество заказов на странице.
Значение по умолчанию: 100. Максимальное значение: 1000.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
total int Общее число позиций.
result.order_id int Идентификатор заказа.
result.items array Информация о товарах.
items.item_id int Идентификатор позиции товара в заказе.
items.product_id int Идентификатор товара.
items.offer_id string Идентификатор товара в системе продавца
items.quantity string Количество товара.

Подтвердить заказ для Crossborder

Пример запроса:

POST /v1/order/approve/crossborder HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "order_id": 123456
}

Пример ответа:

{
  "result": "success"
}

Позволяет подтвердить список позиций в заказе.

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

Параметр Тип Обязательный Описание
order_id int Да Идентификатор заказа.

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

Параметр Тип Описание
result string Результат обработки запроса.

Курьерские компании для CB

Пример запроса:

POST /v1/order/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

{}

Пример ответа:

{
  "result": [
    {
      "id": 1,
      "name": "DPD"
    },
    {
      "id": 2,
      "name": "USPS"
    }
  ]
}

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

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

Параметр Тип Описание
result array Список идентификаторов заказов.
id int Идентификатор компании, которая доставляет заказ.
name string Название товара. До 500 знаков

Отправка заказа для CB

Пример запроса:

POST /v1/order/ship/crossborder HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "order_id": 123456,
  "shipping_provider_id": 2,
  "tracking_number": "AA123456789AA",
  "items": [
    {
      "item_id": 123,
      "quantity": 1
    }
  ]
}

Пример ответа:

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

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

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

Параметр Тип Обязательный Описание
order_id int Да Идентификатор заказа.
tracking_number string Да Номер отслеживания посылки.
shipping_provider_id int Да Идентификатор компании, которая доставляет заказ.
items array Да Информация о товарах.
items.item_id int Да Идентификатор позиции товара в заказе.
items.quantity int Да Количество товара.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
package_number string Номер посылки (отправления).

Отправка заказа для FBS

Пример запроса:

POST /v1/order/ship/fbs HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "order_id": 123456,
  "packages": [
    {
      "items": [
        {
          "item_id": 123,
          "quantity": 1
        }
      ]
    }
  ]
}

Пример ответа:

{
  "result": {
    "package_numbers": [
      "232123"
    ]
  }
}

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

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

Параметр Тип Обязательный Описание
order_id int Да Идентификатор заказа.
packages array Да Информация о посылке.
packages.items array Да Информация о товарах в посылке и их количество.
packages.items.item_id int Да Идентификатор позиции товара в заказе.
packages.items.quantity int Да Количество товара.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
package_numbers string array Массив с номерами посылок (отправлений).

Package label for FBS

Пример запроса:

POST /v1/order/package-label/fbs HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "order_ids": [
    35536499
  ]
}

Пример ответа:

{
  "result": {
    "content_type": "application/pdf",
    "base64_content": "dGVzdF9zdHJpbmc="
  }
}

Returns an FBS package label for one or several orders

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

Параметр Тип Обязательный Описание
order_ids int array Да Идентификатор заказа.

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

Параметр Тип Описание
result array Список идентификаторов заказов.
content_type string Content-Type возвращаемого файла.
base64_content string Файл в виде строки base64.

Акт и накладная FBS

Отмена заказа для CB

Пример запроса:

POST /v1/order/items/cancel/crossborder HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "order_id": 123456,
  "reason_code": 2,
  "item_ids": [
    123,
    456
  ]
}

Пример ответа:

{
  "result": "success"
}

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

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

Параметр Тип Обязательный Описание
order_id int Да Идентификатор заказа.
reason_code int Да Код причины отмены заказа.
item_ids int array Да Список идентификаторов позиций товара в заказе.

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

Параметр Тип Описание
result string Результат обработки запроса.

Отмена заказа для FBS

Пример запроса:

POST /v1/order/cancel/fbs HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "order_id": 2563636,
  "cancel_reason_id": 2
}

Пример ответа:

{
  "result": "success"
}

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

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

Параметр Тип Обязательный Описание
order_id int Да Идентификатор заказа.
cancel_reason_id int Да Код причины отмены заказа.

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

Параметр Тип Описание
result string Результат обработки запроса.

Причины отмены

Пример запроса:

POST /v1/order/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

{}

Пример ответа:

{
  "result": [
    {
      "id": 352,
      "title": "Product is out of stock"
    },
    {
      "id": 353,
      "title": "Product with wrong price"
    },
    {
      "id": 358,
      "title": "Canceled by seller"
    }
  ]
}

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

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

Параметр Тип Описание
result array Список идентификаторов заказов.
id int Идентификатор компании, которая доставляет заказ.
title string Название компании, которая доставляет заказ.

Changelog

v2 (2019-11-12)

Features

v1.1.1 (2019-03-19):

Features

v1.1.0 (2019-01-22):

Features

v1.0.9 (2019-01-09):

Features

v1.0.8 (2018-12-19):

Features

v1.0.7 (2018-12-05):

Features

v1.0.6 (2018-11-28):

Features

v1.0.5 (2018-11-21):

Features

v1.0.4 (2018-11-06):

Features

v1.0.3 (2018-10-30)

Features

Bugs

v1.0.2 (2018-10-22)

Bugs

Features

v1.0.1 (2018-10-05)

Features