DocumentationNAV navbar
logo

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

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

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

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

Авторизация

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GET /v1​/categories​/tree

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

GET /v1/categories/tree/{categoryId}

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

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

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

POST /v1/category/attribute

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

POST /v1/category/tree

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

POST /v2​/category​/attribute

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

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

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

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

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

Товары и цены

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

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

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

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

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

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

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

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

POST /v2/product/import

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

POST /v2/product/info

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

POST /v2/products/info/attributes

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

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

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

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

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

POST /v1/product/info/stocks

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

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

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

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

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

FBS

FBO

Crossborder

Обновления

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Методы Seller API

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

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

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

/pass

/create

POST /pass/create

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


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

car_model * string

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

car_number * string

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

driver_name * string

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

driver_patronymic string

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

driver_surname * string

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

end_unloading_time string

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

is_regular_pass boolean

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

start_unloading_time * string

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

telephone string

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

trailer_number string

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

unload_date * string

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


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


pass_id integer

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

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

/get/last

POST /pass/get/last

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


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


car_model string

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

car_number string

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

driver_name string

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

driver_patronymic string

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

driver_surname string

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

end_unloading_time string

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

is_regular_pass boolean

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

start_unloading_time string

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

telephone string

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

trailer_number string

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

unload_date string

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

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

/update

POST /pass/update

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


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

car_model * string

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

car_number * string

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

driver_name * string

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

driver_patronymic string

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

driver_surname * string

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

end_unloading_time string

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

pass_id * integer

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

is_regular_pass boolean

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

start_unloading_time * string

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

telephone string

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

trailer_number string

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

unload_date * string

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


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


result boolean

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

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

/v1/brand

/company-certification/list

POST /v1/brand/company-certification/list

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


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

page integer

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

page_size integer

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


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


brand_certification object

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

brand_id integer

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

brand_name string

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

has_certificate boolean

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

total integer

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

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

/v1/categories

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

/tree

GET /v1/categories/tree

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


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


category_id integer

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

children array

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

title string

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

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

/tree/[categoryId]

GET /v1/categories/tree/[categoryId]

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


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


category_id integer

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

children array

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

title string

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

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

/tree/[categoryId]/attributes

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


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


child array

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

id integer

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

is_collection boolean

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

is_required boolean

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

name string

Название.

option array

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

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

/v1/category

/tree

POST /v1/category/tree

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

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


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

category_id * integer

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

language string

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


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


result array

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

category_id integer

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

children array

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

title string

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

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

/attribute

GET /v1/category/attribute

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

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

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

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


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

category_id * integer

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

attribute_type string

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

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

    language string

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


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


    result array

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

    id integer

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

    name string

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

    description string

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

    type string

    Тип характеристики: bool, text, option.

    is_collection boolean

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

    is_required boolean

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

    option array

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

    option.id integer

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

    option.value string

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

    child 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"
    }
    Response status  200 
    {
      "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": []
            }
          ]
        }
      ]
    }

    /v2​/category​

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

    /attribute​

    POST /v2​/category​/attribute​


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

    category_id * integer

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

    attribute_type string

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

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

      language string

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

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

      /values

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


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

      category_id * integer

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

      limit * integer

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

      language string

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

      POST /v2/category/attribute HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "category_id": 17036076,
        "attribute_id": 8229,
        "language": "EN",
        "last_value_id": 0,
        "limit": 1
      }

      /value​/by-option

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


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

      language string

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

      POST /v2/category/attribute HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "options": [
          {
            "attribute_id": 8229,
            "option_id": 400
          }
        ],
        "language": "EN"
      }

      /v1/product

      /archive

      POST /v1/product/archive

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


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

      product_id * integer

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


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


      result boolean

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

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

      /certificate/accordance-types

      GET /v1/product/certificate/accordance-types

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


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


      result object

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

      name string

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

      value string

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

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

      /certificate/bind

      POST /v1/product/certificate/bind

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


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

      certificate_id integer

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

      item_id integer

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


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


      result boolean

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

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

      /certificate/create

      POST /v1/product/certificate/create

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


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

      files * array

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

      name * string

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

      number * string

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

      type_code * string

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

      accordance_type_code * string

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

      issue_date * datetime

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

      expire_date datetime

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


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


      id integer

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

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

      /certificate/types

      GET /v1/product/certificate/types

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


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


      result object

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

      name string

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

      value string

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

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

      /info/prices

      POST /v1/product/info/prices

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


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

      page integer

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

      page_size integer

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


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


      items object

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

      commissions object

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

      sales_schema string

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

      percent integer

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

      value integer

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

      min_value integer

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

      delivery_amount integer

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

      return_amount integer

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

      offer_id string

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

      price object

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

      buybox_price string

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

      marketing_price string

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

      min_ozon_price string

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

      old_price string

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

      premium_price string

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

      price string

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

      recommended_price string

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

      retail_price string

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

      vat string

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

      price_index string

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

      product_id integer

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

      POST /v1/product/info/prices HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "page": 1,
        "page_size": 100
      }
      Response status  200 
      {
        "result": {
          "items": [
            {
              "product_id": 15214026,
              "offer_id": "107112",
              "price": {
                "price": "1950.0000",
                "old_price": "2790.0000",
                "premium_price": "",
                "recommended_price": "",
                "retail_price": "",
                "vat": "0.000000",
                "buybox_price": "",
                "min_ozon_price": "",
                "marketing_price": "1950.0000"
              },
              "price_index": "0.00",
              "commissions": [
                {
                  "percent": 15,
                  "min_value": 50,
                  "value": 292.5,
                  "sale_schema": "FBO",
                  "delivery_amount": 75,
                  "return_amount": 75
                },
                {
                  "percent": 15,
                  "min_value": 50,
                  "value": 292.5,
                  "sale_schema": "FBS",
                  "delivery_amount": 75,
                  "return_amount": 75
                }
              ]
            }
          ]
        }
      }

      /unarchive

      POST /v1/product/unarchive

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


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

      product_id * integer

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


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


      result2 array

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

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

      /v2/product

      /import

      POST /v2/product/import

      Загрузите свои товары на Ozon. В одном запросе можно передать до 1000 товаров. Каждый товар — это отдельный элемент в массиве items. Укажите всю информацию о товаре: его характеристики, штрихкод, изображения, габариты и цену.

      Характеристики зависят от категории товара — вы можете посмотреть список обязательных характеристик для некоторых категорий в Помощи или методом POST /v2/category/attribute.

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

      Каждый товар в запросе — отдельный элемент массива items.


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

      attributes * object

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

      complex_id integer

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

      id* integer

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

      values object

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

      dictionary_value_id integer

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

      value string

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

      barcode string

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

      category_id integer

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

      complex_attributes object

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

      attributes array

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

      depth integer

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

      dimension_unit string

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

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

      height integer

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

      image_group_id string

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

      images string

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

      name string

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

      offer_id string

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

      old_price string

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

      pdf_list array

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

      premium_price string

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

      price string

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

      vat string

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

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

        weight integer

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

        weight_unit string

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

        width integer

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


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


        task_id integer

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

        POST /v2/product/import HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "items": [
            {
              "attributes": [
                {
                  "complex_id": 0,
                  "id": 0,
                  "values": [
                    {
                      "dictionary_value_id": 0,
                      "value": "string"
                    }
                  ]
                }
              ],
              "barcode": "string",
              "category_id": 0,
              "complex_attributes": [
                {
                  "attributes": [
                    {
                      "complex_id": 0,
                      "id": 0,
                      "values": [
                        {
                          "dictionary_value_id": 0,
                          "value": "string"
                        }
                      ]
                    }
                  ]
                }
              ],
              "depth": 0,
              "dimension_unit": "string",
              "height": 0,
              "image_group_id": "string",
              "images": [
                "string"
              ],
              "images360": [
                "string"
              ],
              "name": "string",
              "offer_id": "string",
              "old_price": "string",
              "pdf_list": [
                {
                  "index": 0,
                  "name": "string",
                  "src_url": "string"
                }
              ],
              "premium_price": "string",
              "price": "string",
              "vat": "string",
              "weight": 0,
              "weight_unit": "string",
              "width": 0
            }
          ]
        }
        Response status  200 
        {
          "result": {
            "task_id": 0
          }
        }

        /info

        POST /v2/product/info

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


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

        offer_id string

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

        product_id integer

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

        sku integer

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


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


        barcode string

        Штрихкод.

        buybox_price string

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

        category_id integer

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

        commissions object

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

        sales_schema string

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

        percent integer

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

        value integer

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

        min_value integer

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

        delivery_amount integer

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

        return_amount integer

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

        created_at datetime

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

        errors object

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

        attribute_id integer

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

        code string

        Код ошибки.

        field string

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

        level string

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

        id integer

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

        images array

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

        marketing_price string

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

        min_ozon_price string

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

        name string

        Название.

        offer_id string

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

        old_price string

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

        premium_price string

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

        price string

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

        price_index string

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

        recommended_price string

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

        sources object

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

        is_enabled boolean

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

        sku integer

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

        source string

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

        state string

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

        stocks object

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

        coming integer

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

        present integer

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

        reserved integer

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

        vat string

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

        visibility_details object

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

        has_price boolean

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

        has_stock boolean

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

        active_product boolean

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

        visible boolean

        True, если товар выставлен на продажу.

        POST /v2/product/info HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "offer_id": "107112",
          "product_id": 15214026,
          "sku": 0
        }
        Response status  200 
        {
          "result": {
            "id": 15214026,
            "name": "Подушка German Grass 95C GRASS регулируемая 50х70",
            "offer_id": "107112",
            "barcode": "4630016982289",
            "buybox_price": "",
            "category_id": 17037326,
            "created_at": "2019-07-23T19:12:34.178486Z",
            "images": [
              "https://cdn1.ozone.ru/s3/multimedia-0/6012407760.jpg",
              "https://cdn1.ozone.ru/s3/multimedia-v/6012407755.jpg",
              "https://cdn1.ozone.ru/s3/multimedia-9/6012407769.jpg"
            ],
            "marketing_price": "1950.0000",
            "min_ozon_price": "",
            "old_price": "2790.0000",
            "premium_price": "",
            "price": "1950.0000",
            "recommended_price": "",
            "sources": [
              {
                "is_enabled": true,
                "sku": 154993078,
                "source": "fbo"
              },
              {
                "is_enabled": true,
                "sku": 155112592,
                "source": "fbs"
              }
            ],
            "state": "processed",
            "stocks": {
              "coming": 0,
              "present": 1,
              "reserved": 0
            },
            "errors": [],
            "vat": "0.000000",
            "visible": true,
            "visibility_details": {
              "has_price": true,
              "has_stock": true,
              "active_product": true
            },
            "price_index": "0.00",
            "commissions": [
              {
                "percent": 15,
                "min_value": 50,
                "value": 292.5,
                "sale_schema": "FBO",
                "delivery_amount": 75,
                "return_amount": 75
              },
              {
                "percent": 15,
                "min_value": 50,
                "value": 292.5,
                "sale_schema": "FBS",
                "delivery_amount": 75,
                "return_amount": 75
              }
            ]
          }
        }

        /v2/products

        /delete

        POST /v2/products/delete

        Метод для удаления товаров без SKU из архива. В одном запросе можно передать до 1000 идентификаторов.


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

        products integer

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

        offer_id string

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


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


        deleted boolean

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

        POST /v2/products/delete HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
        
        }
        Response status  200 
        {
        
        }

        /v2/posting/crossborder

        /approve

        POST /v2/posting/crossborder/approve

        pampam


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

        posting_number * string

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


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


        result boolean

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

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

        /cancel

        POST /v2/posting/crossborder/cancel


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

        cancel_reason_id * integer

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

        cancel_reason_message string

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

        posting_number * string

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

        sku integer

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


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


        result boolean

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

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

        /cancel-reason/list

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

        Can not resolve handlers/crossborder_cancel-reason.md


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


        id integer

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

        title string

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

        type_id string

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

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

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

        /get

        POST /v2/posting/crossborder/get

        Can not resolve handlers/crossborder_get.md


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

        posting_number * string

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

        translit boolean

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


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


        address object

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

        address_tail string

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

        addressee string

        Имя и фамилия получателя.

        city string

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

        comment string

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

        country string

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

        district string

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

        phone string

        Контактный телефон получателя.

        region string

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

        zip_code string

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

        cancel_reason_id integer

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

        created_at datetime

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

        customer_email string

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

        customer_id integer

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        shipment_date datetime

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

        shipping_provider_id integer

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

        status string

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

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

        tracking_number string

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

        POST /v2/posting/crossborder/get HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number": "39268230-0002-3",
        }
        Response status  200 
        {
          "result": [
            {
              "address": {
                "address_tail": "г. Москва, ул. Центральная, 1",
                "addressee": "Петров Иван Владимирович",
                "city": "Москва",
                "comment": "",
                "country": "Россия",
                "district": "",
                "phone": "+7 495 123-45-67",
                "region": "Москва",
                "zip_code": "101000"
              },
              "auto_cancel_date": "2019-11-18T11:30:11.571Z",
              "cancel_reason_id": 76,
              "created_at": "2019-11-18T11:30:11.571Z",
              "customer_email": "petrov@email.com",
              "customer_id": 60006,
              "in_process_at": "2019-11-18T11:30:11.571Z",
              "order_id": 77712345,
              "order_nr": "1111444",
              "posting_number": "39268230-0002-3",
              "products": [
                {
                  "name": "Фитнес-браслет",
                  "offer_id": "DEP-1234",
                  "price": "1900.00",
                  "quantity": 1,
                  "sku": 100056
                }
              ],
              "shipping_provider_id": 0,
              "status": "awaiting_approve",
              "tracking_number": ""
            }
          ]
        }

        /ship

        POST /v2/posting/crossborder/ship

        Can not resolve handlers/crossborder_ship.md


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

        items * object

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

        mandatory_mark string

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

        quantity integer

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

        sku integer

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

        posting_number string

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

        shipping_provider_id integer

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

        tracking_number string

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


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


        package_number string

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

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

        /shipping-provider/list

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

        Can not resolve handlers/cb_shipping_provider.md


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


        id integer

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

        name string

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

        POST /v2/posting/crossborder/shipping-provider/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {}
        Response status  200 
        {
          "result": [
            {
              "id": 15109877837000,
              "name": "shiptor"
            },
            {
              "id": 15308950689000,
              "name": "china-post"
            }
          ]
        }

        /unfulfilled/list

        POST /v2/posting/crossborder/unfulfilled/list

        Can not resolve handlers/cb_unfulfilled.md


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

        dir * string

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

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

        limit * integer

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

        offset * integer

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

        status * string

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

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

        translit * boolean

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


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


        address object

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

        address_tail string

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

        addressee string

        Имя и фамилия получателя.

        city string

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

        comment string

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

        country string

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

        district string

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

        phone string

        Контактный телефон получателя.

        region string

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

        zip_code string

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

        cancel_reason_id integer

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

        created_at datetime

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

        customer_email string

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

        customer_id integer

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        shipment_date datetime

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

        shipping_provider_id integer

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

        status string

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

        tracking_number string

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

        POST /v2/posting/crossborder/unfulfilled/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "dir": "asc",
          "limit": 10,
          "offset": 0,
          "status": [
            "awaiting_packaging"
          ]
        }
        Response status  200 
        {
          "result": [
            {
              "address": {
                "address_tail": "г. Москва, ул. Центральная, 1",
                "addressee": "Петров Иван Владимирович",
                "city": "Москва",
                "comment": "",
                "country": "Россия",
                "district": "",
                "phone": "+7 495 123-45-67",
                "region": "Москва",
                "zip_code": "101000"
              },
              "auto_cancel_date": "2019-11-18T11:30:11.571Z",
              "cancel_reason_id": 76,
              "created_at": "2019-11-18T11:30:11.571Z",
              "customer_email": "petrov@email.com",
              "customer_id": 60006,
              "in_process_at": "2019-11-18T11:30:11.571Z",
              "order_id": 77712345,
              "order_nr": "1111444",
              "posting_number": "39268230-0002-3",
              "products": [
                {
                  "name": "Фитнес-браслет",
                  "offer_id": "DEP-1234",
                  "price": "1900.00",
                  "quantity": 1,
                  "sku": 100056
                }
              ],
              "shipping_provider_id": 0,
              "status": "awaiting_approve",
              "tracking_number": ""
            }
          ]
        }

        /v2/posting/fbo

        /get

        POST /v2/posting/fbo/get

        Can not resolve handlers/fbo-get.md


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

        posting_number * string

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

        with object

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

        analytics_data boolean

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

        financial_data boolean

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


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


        analytics_data object

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

        city string

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

        delivery_type string

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

        is_premium boolean

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

        payment_type_group_name string

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

        region string

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

        warehouse_id integer

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

        warehouse_name string

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

        cancel_reason_id integer

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

        created_at datetime

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

        financial_data object

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

        products object

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

        actions array

        commission_amount integer

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

        commission_percent integer

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

        old_price integer

        Цена до скидки.

        payout integer

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

        picking object

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

        picking.amount integer

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

        picking.moment datetime

        Дата начисления за доставку

        picking.tag string

        Тэг доставки.

        price integer

        Цена.

        product_id integer

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

        total_discount_percent integer

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

        total_discount_value integer

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        status string

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

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

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

        /list

        POST /v2/posting/fbo/list

        Can not resolve handlers/fbo-list.md


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

        dir * string

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

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

        filter * object

        order_id string

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

        order_number string

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

        since datetime

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

        to datetime

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

        status string

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

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

        limit * integer

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

        offset integer

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

        translit boolean

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

        with object

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

        analytics_data boolean

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

        financial_data boolean

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


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


        analytics_data object

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

        city string

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

        delivery_type string

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

        is_premium boolean

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

        payment_type_group_name string

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

        region string

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

        warehouse_id integer

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

        warehouse_name string

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

        cancel_reason_id integer

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

        created_at datetime

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

        financial_data object

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

        products object

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

        actions array

        commission_amount integer

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

        commission_percent integer

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

        old_price integer

        Цена до скидки.

        payout integer

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

        picking object

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

        picking.amount integer

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

        picking.moment datetime

        Дата начисления за доставку

        picking.tag string

        Тэг доставки.

        price integer

        Цена.

        product_id integer

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

        total_discount_percent integer

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

        total_discount_value integer

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        status string

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

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

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

        /v2/posting/fbs

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

        Swagger

        /act/check-status

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


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

        id * integer

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


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


        added_to_act string

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

        removed_from_act string

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

        status string

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

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

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

        /act/create

        POST /v2/posting/fbs/act/create

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


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

        containers_count integer

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


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


        id integer

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

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

        /act​/get-container-labels

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

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


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

        id * integer

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

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

        /act​/get-pdf

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


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

        id * integer

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

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

        /arbitration

        POST /v2/posting/fbs/arbitration


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

        posting_number * string

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


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


        result boolean

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

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

        /awaiting-delivery

        POST /v2/posting/fbs/awaiting-delivery


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

        posting_number * string

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


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


        result boolean

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

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

        /cancel

        POST /v2/posting/fbs/cancel


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

        cancel_reason_id * integer

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

        cancel_reason_message string

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

        posting_number * string

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


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


        result boolean

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

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

        /cancel-reason/list

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


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


        id integer

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

        title string

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

        type_id string

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

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

        POST /v2/posting/fbs/cancel-reason/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {}
        Response status  200 
        {
          "result": [
            {
              "id": 123,
              "title": "Error",
              "type_id": "seller"
            }
          ]
        }

        /get

        POST /v2/posting/fbs/get


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

        posting_number * string

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

        with object

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

        analytics_data boolean

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

        barcodes boolean

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

        financial_data boolean

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


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


        analytics_data object

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

        city string

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

        delivery_type string

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

        is_premium boolean

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

        payment_type_group_name string

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

        region string

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

        warehouse_id integer

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

        warehouse_name string

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

        barcodes object

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

        upper_barcode string

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

        lower_barcode string

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

        cancel_reason_id integer

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

        created_at datetime

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

        financial_data object

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

        products object

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

        actions array

        commission_amount integer

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

        commission_percent integer

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

        old_price integer

        Цена до скидки.

        payout integer

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

        picking object

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

        picking.amount integer

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

        picking.moment datetime

        Дата начисления за доставку

        picking.tag string

        Тэг доставки.

        price integer

        Цена.

        product_id integer

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

        total_discount_percent integer

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

        total_discount_value integer

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        shipment_date datetime

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

        status string

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

        POST /v2/posting/fbs/get HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number": "13076543-0001-1",
          "with": {
            "analytics_data": true,
            "barcodes": true,
            "financial_data": true
          }
        }
        Response status  200 
        {
          "result": {
            "analytics_data": {
              "city": "string",
              "delivery_type": "string",
              "is_premium": true,
              "payment_type_group_name": "string",
              "region": "string"
            },
            "barcodes": {
              "lower_barcode": "string",
              "upper_barcode": "string"
            },
            "cancel_reason_id": 0,
            "created_at": "2020-07-06T07:40:22.281Z",
            "financial_data": {
              "products": [
                {
                  "actions": [
                    "string"
                  ],
                  "commission_amount": 0,
                  "commission_percent": 0,
                  "old_price": 0,
                  "payout": 0,
                  "picking": {
                    "amount": 0,
                    "moment": "2020-07-06T07:40:22.281Z",
                    "tag": "string"
                  },
                  "price": 0,
                  "product_id": 0,
                  "total_discount_percent": 0,
                  "total_discount_value": 0
                }
              ]
            },
            "in_process_at": "2020-07-06T07:40:22.281Z",
            "order_id": 0,
            "order_number": "string",
            "posting_number": "string",
            "products": [
              {
                "mandatory_mark": [
                  "string"
                ],
                "name": "string",
                "offer_id": "string",
                "price": "string",
                "quantity": 0,
                "sku": 0
              }
            ],
            "shipment_date": "2020-07-06T07:40:22.281Z",
            "status": "string"
          }
        }
        

        /get-by-barcode

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


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

        barcode * string

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


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


        barcodes object

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

        upper_barcode string

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

        lower_barcode string

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

        cancel_reason_id integer

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

        created_at datetime

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        shipment_date datetime

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

        status string

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

        POST /v2/posting/fbs/get-by-barcode HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "barcode": "string"
        }
        Response status  200 
        {
          "result": {
            "barcodes": {
              "lower_barcode": "string",
              "upper_barcode": "string"
            },
            "cancel_reason_id": 0,
            "created_at": "2020-06-16T15:11:06.995Z",
            "in_process_at": "2020-06-16T15:11:06.995Z",
            "order_id": 0,
            "order_number": "string",
            "posting_number": "string",
            "products": [
              {
                "mandatory_mark": [
                  "string"
                ],
                "name": "string",
                "offer_id": "string",
                "price": "string",
                "quantity": 0,
                "sku": 0
              }
            ],
            "shipment_date": "2020-06-16T15:11:06.995Z",
            "status": "string"
          }
        }

        /list

        POST /v2/posting/fbs/list


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

        dir * string

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

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

        filter * object

        order_id string

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

        order_number string

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

        since datetime

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

        to datetime

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

        status string

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

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

        limit * integer

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

        offset integer

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

        sort_by string

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

        with object

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

        analytics_data boolean

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

        barcodes boolean

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

        financial_data boolean

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


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


        analytics_data object

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

        city string

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

        delivery_type string

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

        is_premium boolean

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

        payment_type_group_name string

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

        region string

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

        warehouse_id integer

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

        warehouse_name string

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

        barcodes object

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

        upper_barcode string

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

        lower_barcode string

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

        cancel_reason_id integer

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

        created_at datetime

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

        financial_data object

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

        products object

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

        actions array

        commission_amount integer

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

        commission_percent integer

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

        old_price integer

        Цена до скидки.

        payout integer

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

        picking object

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

        picking.amount integer

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

        picking.moment datetime

        Дата начисления за доставку

        picking.tag string

        Тэг доставки.

        price integer

        Цена.

        product_id integer

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

        total_discount_percent integer

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

        total_discount_value integer

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        shipment_date datetime

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

        status string

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

        POST /v2/posting/fbs/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "dir": "string",
          "filter": {
            "order_id": 0,
            "order_number": "string",
            "since": "2020-11-13T11:43:37.496Z",
            "status": "string",
            "to": "2020-11-13T11:43:37.496Z"
          },
          "limit": 0,
          "offset": 0,
          "sort_by": "string",
          "with": {
            "analytics_data": true,
            "barcodes": true,
            "financial_data": true
          }
        }
        Response status  200 
        {
          "result": [
            {
              "analytics_data": {
                "city": "string",
                "delivery_type": "string",
                "is_premium": true,
                "payment_type_group_name": "string",
                "region": "string"
              },
              "barcodes": {
                "lower_barcode": "string",
                "upper_barcode": "string"
              },
              "cancel_reason_id": 0,
              "created_at": "2020-07-06T06:23:14.627Z",
              "financial_data": {
                "products": [
                  {
                    "actions": [
                      "string"
                    ],
                    "commission_amount": 0,
                    "commission_percent": 0,
                    "old_price": 0,
                    "payout": 0,
                    "picking": {
                      "amount": 0,
                      "moment": "2020-07-06T06:23:14.627Z",
                      "tag": "string"
                    },
                    "price": 0,
                    "product_id": 0,
                    "total_discount_percent": 0,
                    "total_discount_value": 0
                  }
                ]
              },
              "in_process_at": "2020-07-06T06:23:14.627Z",
              "order_id": 0,
              "order_number": "string",
              "posting_number": "string",
              "products": [
                {
                  "mandatory_mark": [
                    "string"
                  ],
                  "name": "string",
                  "offer_id": "string",
                  "price": "string",
                  "quantity": 0,
                  "sku": 0
                }
              ],
              "shipment_date": "2020-07-06T06:23:14.627Z",
              "status": "string"
            }
          ]
        }
        

        /package-label

        POST /v2/posting/fbs/package-label


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

        posting_number * string

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

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

        /product/mandatory-mark/is-required

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

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

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


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

        sku * integer

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


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


        is_required boolean

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

        sku integer

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

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

        /product/mandatory-mark/validate

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

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

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


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

        mandatory_mark * string

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


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


        mandatory_mark string

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

        result boolean

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

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

        /ship

        POST /v2/posting/fbs/ship


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

        packages * object

        items object

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

        mandatory_mark string

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

        quantity integer

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

        sku integer

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

        posting_number string

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


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


        result boolean

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

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

        /unfulfilled/list

        POST /v2/posting/fbs/unfulfilled/list


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

        dir string

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

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

        limit integer

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

        offset integer

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

        status string

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

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

        with object

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

        analytics_data boolean

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

        barcodes boolean

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

        financial_data boolean

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


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


        barcodes object

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

        upper_barcode string

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

        lower_barcode string

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

        cancel_reason_id integer

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

        created_at datetime

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

        in_process_at datetime

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

        order_id integer

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

        order_number string

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

        posting_number string

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

        products object

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

        mandatory_mark string

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

        name string

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

        offer_id string

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

        price string

        Цена товара.

        quantity integer

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

        sku integer

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

        shipment_date datetime

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

        status string

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

        POST /v2/posting/fbs/ship HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "cutoff_from": "2020-06-16T10:38:00.605Z",
          "cutoff_to": "2020-06-16T10:38:00.605Z",
          "dir": "string",
          "limit": 0,
          "offset": 0,
          "status": [
            "string"
          ],
          "with": {
            "barcodes": true
          }
        }
        Response status  200 
        {
          "result": [
            {
              "barcodes": {
                "lower_barcode": "string",
                "upper_barcode": "string"
              },
              "cancel_reason_id": 0,
              "created_at": "2020-06-16T15:20:41.547Z",
              "in_process_at": "2020-06-16T15:20:41.547Z",
              "order_id": 0,
              "order_number": "string",
              "posting_number": "string",
              "products": [
                {
                  "mandatory_mark": [
                    "string"
                  ],
                  "name": "string",
                  "offer_id": "string",
                  "price": "string",
                  "quantity": 0,
                  "sku": 0
                }
              ],
              "shipment_date": "2020-06-16T15:20:41.547Z",
              "status": "string"
            }
          ]
        }

        /v2/returns

        /company/fbo

        POST /v2/returns/company/fbo

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


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

        filter * object

        Фильтр по отправлениям и статусам возврата.

        posting_number string

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

        status string

        Статус возврата.
        Created — возврат создан.
        ReturnedToOzon — возврат на складе Ozon.

        limit integer

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

        offset integer

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


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


        count integer

        Счетчик элементов в ответе.

        returns object

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

        accepted_from_customer_moment datetime

        Время приема возврата от покупателя.

        company_id integer

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

        current_place_name string

        Текущее местонахождение возврата.

        dst_place_name string

        Место назначения возврата.

        id integer

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

        is_opened boolean

        True, если возврат в работе.

        posting_number string

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

        return_reason_name string

        Причина возврата.

        returned_to_ozon_moment datetime

        Время доставки возврата на склад Ozon.

        sku integer

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

        status_name string

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

        POST /v2/returns/company/fbo HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "filter": {
            "posting_number": "string",
            "status": [
              "string"
            ]
          },
          "limit": 0,
          "offset": 0
        }
        Response status  200 
        {
          "count": 0,
          "returns": [
            {
              "accepted_from_customer_moment": "2020-07-29T11:23:53.995Z",
              "company_id": 0,
              "current_place_name": "string",
              "dst_place_name": "string",
              "id": 0,
              "is_opened": true,
              "posting_number": "string",
              "return_reason_name": "string",
              "returned_to_ozon_moment": "2020-07-29T11:23:53.995Z",
              "sku": 0,
              "status_name": "string"
            }
          ]
        }

        /company/fbs

        POST /v2/returns/company/fbs

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


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

        filter * object

        accepted_from_customer_moment datetime

        Время приема возврата от покупателя.

        last_free_waiting_day datetime

        Время приема возврата от покупателя.

        order_id string

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

        posting_number string

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

        product_name string

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

        status string

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

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

        limit integer

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

        offset integer

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


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


        count integer

        Счетчик элементов в ответе.

        returns object

        Информация о возврате

        accepted_from_customer_moment datetime

        Время приема возврата от покупателя.

        company_id integer

        Идентификатор продавца.

        current_place_name string

        Текущее местонахождение возврата.

        dst_place_name string

        Место назначения возврата.

        id integer

        Идентификатор возврата.

        is_opened boolean

        True, если возврат в работе.

        posting_number string

        Номер отправления.

        return_reason_name string

        Причина возврата.

        returned_to_ozon_moment datetime

        Время доставки возврата на склад Ozon.

        sku integer

        Идентификатор товара на Ozon.

        status_name string

        Статус возврата.

        POST /v2/returns/company/fbs HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "filter": {
            "accepted_from_customer_moment": {
              "time_from": "2020-11-16T15:15:10.854Z",
              "time_to": "2020-11-16T15:15:10.854Z"
            },
            "last_free_waiting_day": {
              "time_from": "2020-11-16T15:15:10.854Z",
              "time_to": "2020-11-16T15:15:10.854Z"
            },
            "order_id": 0,
            "posting_number": [
              "string"
            ],
            "product_name": "string",
            "product_offer_id": "string",
            "status": "string"
          },
          "limit": 0,
          "offset": 0
        }
        Response status  200 
        {
          "result": {
            "count": 0,
            "returns": [
              {
                "accepted_from_customer_moment": "string",
                "clearing_id": 0,
                "commission": 0,
                "commission_percent": 0,
                "id": 0,
                "is_moving": true,
                "is_opened": true,
                "last_free_waiting_day": "string",
                "moving_to_place_name": "string",
                "picking_amount": 0,
                "place_id": 0,
                "posting_number": "string",
                "price": 0,
                "price_without_commission": 0,
                "product_id": 0,
                "product_name": "string",
                "quantity": 0,
                "return_date": "string",
                "return_reason_name": "string",
                "returned_to_seller_date_time": "string",
                "returns_keeping_cost": 0,
                "sku": 0,
                "status": "string",
                "waiting_for_seller_date_time": "string",
                "waiting_for_seller_days": 0
              }
            ]
          }
        }

        /v1/supplier

        /orders​/{orderId}/waybill_acceptance_results

        GET /v1/supplier/orders​/{orderId}/waybill_acceptance_results

        Swagger


        Параметры запроса

        orderId * string

        Идентификатор заказа.


        Параметры ответа


        order object

        Информация о заказе.

        contract object

        contract_id integer

        Идентификатор контракта.

        name string

        Название контракта.

        document_number string

        Идентификатор документа.

        id integer

        Номер задания на формирование документов.

        storage_warehouse object

        Склад, на котором хранятся товары.

        name string

        Название склада.

        warehouse_id integer

        Идентификатор склада.

        supply_date datetime

        Дата поставки.

        supply_warehouse object

        Склад поставки.

        name string

        Название склада.

        warehouse_id integer

        Идентификатор склада.

        waybills object

        Информация о накладных.

        discrepancy_report object

        Информация о расхождениях.

        discrepancy_report_id integer

        Идентификатор акта о расхождениях.

        document_date string

        Дата формирования документа.

        document_number string

        Идентификатор документа.

        document_type string

        Тип документа.

        document_date string

        Дата формирования документа.

        document_number string

        Идентификатор документа.

        item_count integer

        Количество товаров в заказе.

        state string

        Статус товара.

        sum_with_vat integer

        Сумма заказа с учётом НДС.

        total_item_amount_by_document integer

        Количество товаров в документе.

        total_item_amount_by_fact integer

        Фактическое количество товаров.

        vat_sum integer

        Сумма НДС.

        waybill_id integer

        Идентификатор накладной.

        GET ​/v1​/supplier​/orders​/[orderId]​/waybill_acceptance_results HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        Response status  200 
        {
          "order": {
            "contract": {
              "contract_id": 0,
              "name": "string"
            },
            "document_number": "string",
            "id": 0,
            "storage_warehouse": {
              "name": "string",
              "warehouse_id": 0
            },
            "supply_date": "string",
            "supply_warehouse": {
              "name": "string",
              "warehouse_id": 0
            }
          },
          "waybills": [
            {
              "discrepancy_report": [
                {
                  "discrepancy_report_id": 0,
                  "document_date": "string",
                  "document_number": "string",
                  "document_type": "string"
                }
              ],
              "document_date": "string",
              "document_number": "string",
              "item_count": 0,
              "state": "string",
              "sum_with_vat": 0,
              "total_item_amount_by_document": 0,
              "total_item_amount_by_fact": 0,
              "vat_sum": 0,
              "waybill_id": 0
            }
          ]
        }

        /waybill_acceptance_results/{waybillId}

        GET /v1/supplier/waybill_acceptance_results/{waybillId}

        Swagger


        Параметры ответа


        document_date string

        Дата формирования документа.

        document_number string

        Идентификатор документа.

        items object

        Информация о товарах.

        amount_by_document integer

        Количество в документе.

        amount_by_fact integer

        Количество по факту поставки.

        amount_of_accepted integer

        Количество принятых товаров

        amount_of_defect integer

        Количество товаров с браком.

        amount_of_shortage integer

        Количество недостающих товаров.

        amount_of_surplus integer

        Количество лишних товаров.

        defect_reason string

        Причина брака.

        name string

        Название.

        ozon_id integer

        Идентификатор товара на Ozon.

        price_without_wat integer

        Цена без учета НДС.

        vat_rate string

        Ставка НДС для товара.

        vat_sum integer

        Сумма НДС.

        waybill_id integer

        Идентификатор накладной.

        GET ​/v1​/supplier​/waybill_acceptance_results/[waybillId] HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        Response status  200 
        {
          "document_date": "string",
          "document_number": "string",
          "items": [
            {
              "amount_by_document": 0,
              "amount_by_fact": 0,
              "amount_of_accepted": 0,
              "amount_of_defect": 0,
              "amount_of_shortage": 0,
              "amount_of_surplus": 0,
              "contractor_item_code": "string",
              "defect_reason": "string",
              "name": "string",
              "ozon_id": 0,
              "price_without_wat": 0,
              "total_sum_with_vat": 0,
              "vat_rate": 0,
              "vat_sum": 0
            }
          ],
          "waybill_id": 0
        }