NAV navbar
logo

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

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

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

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

Авторизация

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GET /v1​/categories​/tree

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

GET /v1/categories/tree/{categoryId}

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

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

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

POST /v1/category/attribute

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

POST /v1/category/tree

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

POST /v2​/category​/attribute

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

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

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

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

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

Товары и цены

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

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

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

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

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

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

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

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

POST /v2/product/import

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

POST /v2/product/info

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

POST /v2/products/info/attributes

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

POST /v1/product/update Меняет данные на карточке товара, кроме цены и количества товаров на складах.

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

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

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

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

POST /v1/product/info/stocks

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

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

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

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

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

FBS

FBO

Crossborder

Обновления

13 января: Чат с покупателем

Метод для возвращения информации о чате с указанными идентификаторами:

POST /v1/chat/list

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

POST /v1/chat/send/file

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

POST /v1/chat/send/message

Метод для cоздания нового чата с покупателем:

POST /v1/chat/start

25 декабря: Чат с покупателем

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

POST /v1/chat/history

15 декабря: Данные аналитики

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

POST /v1/analytics/data

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

9 декабря: Доставка по выбору продавца

Методы работают в тестовом режиме на органиченное количество продавцов.

Добавили группу методов для ручного обновления статусов:

POST /v2/fbs/posting/delivered

POST /v2/fbs/posting/delivering

POST /v2/fbs/posting/last-mile

Метод для добавления трек-номера к отправлениям:

POST /v2/fbs/posting/tracking-number/set

Методы для получения списков отправлений:

POST /v3/posting/fbs/get

POST /v3/posting/fbs/list

POST /v3/posting/fbs/unfulfilled/list

Метод обновления остатков товаров на складах:

POST /v2/products/stocks

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Методы Seller API

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

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

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

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

/create

POST /pass/create

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


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

car_model * string

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

car_number * string

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

driver_name * string

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

driver_patronymic string

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

driver_surname * string

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

end_unloading_time string

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

is_regular_pass boolean

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

start_unloading_time * string

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

telephone string

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

trailer_number string

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

unload_date * string

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


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


pass_id integer

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

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

/get/last

POST /pass/get/last

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


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


car_model string

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

car_number string

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

driver_name string

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

driver_patronymic string

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

driver_surname string

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

end_unloading_time string

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

is_regular_pass boolean

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

start_unloading_time string

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

telephone string

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

trailer_number string

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

unload_date string

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

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

/update

POST /pass/update

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


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

car_model * string

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

car_number * string

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

driver_name * string

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

driver_patronymic string

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

driver_surname * string

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

end_unloading_time string

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

pass_id * integer

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

is_regular_pass boolean

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

start_unloading_time * string

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

telephone string

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

trailer_number string

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

unload_date * string

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


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


result boolean

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

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

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

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

/warehouse/list

POST /v1/warehouse/list

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


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


warehouse_id integer

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

name string

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

is_rfbs boolean

True, если склад создан для схемы работы «Доставка по выбору продавца».

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

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

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

/list

POST /v1/delivery-method/list

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


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

filter object

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

warehouse_id integer

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

provider_id integer

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

status string

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

limit integer

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

offset integer

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


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


has_next boolean

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

result object

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

company_id integer

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

created_at datetime

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

cutoff string

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

id integer

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

name string

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

provider_id integer

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

status string

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

template_id integer

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

updated_at datetime

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

warehouse_id integer

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

POST /v1/delivery-method/list HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "filter": {
    "provider_id": 0,
    "status": "string",
    "warehouse_id": 0
  },
  "limit": 0,
  "offset": 0
}
Response status  200 
{
  "has_next": true,
  "result": [
    {
      "company_id": 0,
      "created_at": "2021-02-25T08:39:26.514Z",
      "cutoff": "string",
      "id": 0,
      "name": "string",
      "provider_id": 0,
      "status": "string",
      "template_id": 0,
      "updated_at": "2021-02-25T08:39:26.514Z",
      "warehouse_id": 0
    }
  ]
}

Данные аналитики

/data

POST /v1/analytics/data

Swagger


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

date_from datetime

Дата, с которой будут данные в отчете.

date_to datetime

Дата, до которой будут данные в отчете.

dimension string

Группировка данных в отчете.
sku— идентификатор товара,brand— бренд,
modelID— модель,
category1— категория первого уровня,
category2— категория второго уровня,
category3— категория третьего уровня,
day— день.

filters object

key string

Параметр сортировки — metrics или dimensions.

op string

Операция сравнения EQ — равно, GTE — больше или равно, GT — больше, LT — меньше, LTE — меньше или равно.

value number

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

limit integer

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

metrics string

Массив метрик, по которым будет сформирован отчет.
session_view_search— Сессии с показом в поиске или в категории
session_view— Сессии, всего
session_view_pdp— Сессии с показом на карточке товара
adv_view_pdp— Показы на карточке товара, спонсорские товары
position_category— Позиция в поиске и категории
adv_view_all— Показы всего, спонсорские товары
adv_view_search_category— Показы в поиске и в категории, спонсорские товары
hits_view— Показы, всего
hits_view_pdp— Показы на карточке товара
hits_view_search— Показы в поиске и в категории
hits_tocart— В корзину, всего
hits_tocart_pdp— В корзину из карточки товара
hits_tocart_search— В корзину из поиска или категории
conv_tocart— Конверсия в корзину, общая
conv_tocart_pdp— Конверсия в корзину из карточки товара
conv_tocart_search— Конверсия в корзину из поиска или категории
ordered_units— Заказано товаров
cancellations— Отменено товаров
delivered_units— Доставлено товаров
returns— Возвращено товаров
adv_sum_all— Расходы на рекламу, всего
postings_premium— Отправления с премиум-подпиской
revenue— Заказано на сумму
postings— Отправления

offset integer

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

sort object

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

key string

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

order string

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


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


data object

dimensions string

Группировка данных в отчете.
sku— идентификатор товара,brand— бренд,
modelID— модель,
category1— категория первого уровня,
category2— категория второго уровня,
category3— категория третьего уровня,
day— день.

metrics number

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

totals integer

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

timestamp string

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

POST /v1/analytics/data HTTP/1.1
Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
  "date_from": "string",
  "date_to": "string",
  "dimension": [
    "string"
  ],
  "filters": [
    {
      "key": "string",
      "op": "EQ",
      "value": "string"
    }
  ],
  "limit": 0,
  "metrics": [
    "string"
  ],
  "offset": 0,
  "sort": [
    {
      "key": "string",
      "order": "ASC"
    }
  ]
}
Response status  200 
{
  "result": {
    "data": [
      {
        "dimensions": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "metrics": [
          0
        ]
      }
    ],
    "totals": [
      0
    ]
  },
  "timestamp": "string"
}

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

/company-certification/list

POST /v1/brand/company-certification/list

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


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

page integer

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

page_size integer

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


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


brand_certification object

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

brand_id integer

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

brand_name string

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

has_certificate boolean

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

total integer

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

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

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

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

/tree

GET /v1/categories/tree

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


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


category_id integer

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

children array

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

title string

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

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

/tree/[categoryId]

GET /v1/categories/tree/[categoryId]

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


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


category_id integer

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

children array

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

title string

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

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

/tree/[categoryId]/attributes

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


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


child array

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

id integer

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

is_collection boolean

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

is_required boolean

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

name string

Название.

option array

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

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

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

/v2​/category​

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

/attribute​

POST /v2​/category​/attribute​


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

category_id * integer

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

attribute_type string

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

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

    language string

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


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


    id integer

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

    name string

    Название.

    is_collection boolean

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

    is_required boolean

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

    POST /v2/category/attribute HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "attribute_type": "ALL",
      "category_id": 0,
      "language": "DEFAULT"
    }
    Response status  200 
    {
      "result": [
        {
          "description": "string",
          "dictionary_id": 0,
          "group_id": 0,
          "group_name": "string",
          "id": 0,
          "is_collection": true,
          "is_required": true,
          "name": "string",
          "type": "string"
        }
      ]
    }

    /attribute​/values

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


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

    category_id * integer

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

    limit * integer

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

    language string

    Язык в ответе: 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​/values/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"
    }

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

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

    /list

    POST /v1/chat/list

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


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

    chat_id_list string

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

    page integer

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

    page_size integer

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


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


    id string

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

    last_message_id string

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

    users object

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

    id string

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

    type string

    Тип участника чата:
    - customer — покупатель,
    - seller — продавец,
    - crm — системные сообщения,
    - courier — курьер.

    POST /v1/chat/list HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "chat_id_list": [
        "string"
      ],
      "page": 0,
      "page_size": 0
    }
    Response status  200 
    {
      "result": [
        {
          "id": "string",
          "last_message_id": "string",
          "users": [
            {
              "id": "string",
              "type": "string"
            }
          ]
        }
      ]
    }

    /history

    POST /v1/chat/history

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

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


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

    chat_id string

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

    from_message_id string

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

    limit integer

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


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


    context object

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

    order object

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

    order_number string

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

    postings object

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

    delivery_schema string

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

    posting_number string

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

    sku_list array

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

    created_at datetime

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

    file object

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

    mime string

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

    name string

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

    size integer

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

    url string

    URL файла.

    text string

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

    type string

    Тип сообщения:
    - text — текст,
    - file — файл.

    user array

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

    POST /v1/chat/history/ HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "chat_id": "3cdf5407-9f90-4752-8105-8f1d4cd427f5",
      "from_message_id": "986714",
      "limit": 10
    }
    Response status  200 
    {
      "result": [
        {
          "context": {
            "item": {
              "sku": 0
            },
            "order": {
              "order_number": "123456-0001",
              "postings": [
                {
                  "delivery_schema": "fbs",
                  "posting_number": "13076543-0001-1",
                  "sku_list": [
                    149512345
                  ]
                }
              ]
            }
          },
          "created_at": "2019-11-25T10:43:06.518Z",
          "file": {
            "mime": "image/jpeg",
            "name": "32679625.jpg",
            "size": 815313,
            "url": "http://api-seller.ozon.ru/v1/chat/file/3cdf5407-9f90-4752-8105-8f1d4cd427f563f87e6da3651007ab96185f38772032b3918e31.jpg",
          },
          "id": "1931356687558511593",
          "text": "hello",
          "type": "file",
          "user": {
            "id": "30735682",
            "type": "customer"
          }
        }
      ]
    }

    /send/file

    POST /v1/chat/send/file

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


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

    base64_content string

    Файл в виде строки base64.

    chat_id string

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

    name string

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


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


    result string

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

    POST /v1/chat/send/file HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "base64_content": "string",
      "chat_id": "string",
      "name": "string"
    }
    Response status  200 
    {
      "result": "string"
    }

    /send/message

    POST /v1/chat/send/message

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


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

    chat_id string

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

    text string

    Текст сообщения в формате plain text.


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


    result string

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

    POST /v1/chat/send/message HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "chat_id": "string",
      "text": "string"
    }
    Response status  200 
    {
      "result": "string"
    }

    /start

    POST /v1/chat/start

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


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

    posting_number string

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


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


    chat_id string

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

    POST /v1/chat/start HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "posting_number": "string"
    }
    Response status  200 
    {
      "result": {
        "chat_id": "string"
      }
    }

    Работа с товарами

    /archive

    POST /v1/product/archive

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


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

    product_id * integer

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


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


    result boolean

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

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

    /certificate/accordance-types

    GET /v1/product/certificate/accordance-types

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


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


    result object

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

    name string

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

    value string

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

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

    /certificate/bind

    POST /v1/product/certificate/bind

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


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

    certificate_id integer

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

    item_id integer

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


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


    result boolean

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

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

    /certificate/create

    POST /v1/product/certificate/create

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


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

    files * array

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

    name * string

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

    number * string

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

    type_code * string

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

    accordance_type_code * string

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

    issue_date * datetime

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

    expire_date datetime

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


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


    id integer

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

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

    /certificate/types

    GET /v1/product/certificate/types

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


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


    result object

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

    name string

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

    value string

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

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

    /import/info

    POST /v1/product/import/info

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


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

    task_id integer

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


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


    items object

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

    offer_id string

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

    product_id integer

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

    status string

    Статус создания товара. Информация о товаре обрабатывается очередями. Возможные значения параметра processing, moderating, processed, failed_moderation, failed_validation, failed. Актуальный статус обновления информации о товаре можно проверить методом

    total string

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

    POST /v1/product/import/info HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "task_id": 0
    }
    Response status  200 
    {
      "result": {
        "items": [
          {
            "offer_id": "string",
            "product_id": 0,
            "status": "string"
          }
        ],
        "total": 0
      }
    }

    Обновить цену

    POST /v1/product/import/prices

    Позволяет изменить цену одного или нескольких товаров. За один запрос можно изменить цены для 1000 товаров. Чтобы сбросить old_price или premium_price — поставьте 0 у этих параметров.


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

    prices object

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

    offer_id string

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

    old_price string

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

    premium_price string

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

    price string

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

    product_id integer

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


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


    errors object

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

    code string

    Код ошибки.

    message string

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

    offer_id string

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

    product_id integer

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

    updated boolean

    True, если информации о товаре успешно обновлена.

    POST /v1/product/import/prices HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "prices": [
        {
          "offer_id": "string",
          "old_price": "string",
          "premium_price": "string",
          "price": "string",
          "product_id": 0
        }
      ]
    }
    Response status  200 
    {
      "result": [
        {
          "errors": [
            {
              "code": "string",
              "message": "string"
            }
          ],
          "offer_id": "string",
          "product_id": 0,
          "updated": true
        }
      ]
    }

    /info/prices

    POST /v1/product/info/prices

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


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

    page integer

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

    page_size integer

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


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


    items object

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

    commissions object

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

    deliveryAmount integer

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

    minValue integer

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

    percent integer

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

    returnAmount integer

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

    saleSchema string

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

    value integer

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

    marketing_actions object

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

    actions object

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

    date_from datetime

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

    date_to datetime

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

    discountValue string

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

    title string

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

    current_period_from datetime

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

    current_period_to datetime

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

    ozon_actions_exist boolean

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

    offer_id string

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

    price object

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

    buybox_price string

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

    marketing_price string

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

    marketing_seller_price string

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

    min_ozon_price string

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

    old_price string

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

    premium_price string

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

    price string

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

    recommended_price string

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

    retail_price string

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

    vat string

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

    price_index string

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

    product_id integer

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

    volume_weight integer

    Объемный вес товара.

    total integer

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

    POST /v1/product/info/prices HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "page": 1,
      "page_size": 100
    }
    Response status  200 
    {
      "result": {
        "items": [
          {
            "commissions": [
              {
                "deliveryAmount": 0,
                "minValue": 0,
                "percent": 0,
                "returnAmount": 0,
                "saleSchema": "string",
                "value": 0
              }
            ],
            "marketing_actions": {
              "actions": [
                {
                  "date_from": "2021-02-03T09:08:26.082Z",
                  "date_to": "2021-02-03T09:08:26.082Z",
                  "discountValue": "string",
                  "title": "string"
                }
              ],
              "current_period_from": "2021-02-03T09:08:26.082Z",
              "current_period_to": "2021-02-03T09:08:26.082Z",
              "ozon_actions_exist": true
            },
            "offer_id": "string",
            "price": {
              "buybox_price": "string",
              "marketing_price": "string",
              "marketing_seller_price": "string",
              "min_ozon_price": "string",
              "old_price": "string",
              "premium_price": "string",
              "price": "string",
              "recommended_price": "string",
              "retail_price": "string",
              "vat": "string"
            },
            "price_index": "string",
            "product_id": 0,
            "volume_weight": 0
          }
        ],
        "total": 0
      }
    }

    /unarchive

    POST /v1/product/unarchive

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


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

    product_id * integer

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


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


    result boolean

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

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

    /update

    POST /v1/product/update

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


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

    product_id * integer

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

    barcode string

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

    description string

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

    name string

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

    vendor string

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

    vendor_code string

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

    height integer

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

    depth integer

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

    width integer

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

    dimension_unit string

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

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

    weight integer

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

    weight_unit string

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

    images object

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

    file_name string

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

    default_img in.bool

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

    attributes object

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

    id integer

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

    value string

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

    collection array

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

    complex array

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

    complex_collection object

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

    collection array

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


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


    result boolean

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

    POST /v1/product/update HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "product_id": 124100,
      "barcode": "8801643566784",
      "description": "Red Samsung Galaxy S10 with 512GB",
      "name": "Samsung Galaxy S10",
      "vendor": "Samsung",
      "vendor_code": "SM-G960UZPAXAA",
      "height": 77,
      "depth": 11,
      "width": 120,
      "dimension_unit": "mm",
      "weight": 120,
      "weight_unit": "g",
      "images": [
        {
          "file_name": "http://pic.com/1.jpg",
          "default": true
        },
        {
          "file_name": "http://pic.com/2.jpg",
          "default": false
        },
        {
          "file_name": "http://pic.com/3.jpg",
          "default": false
        }
      ],
      "attributes": [
        {
          "id": 1,
          "value": "Samsung Galaxy S10"
        },
        {
          "id": 2,
          "collection": [
            "128GB",
            "512GB"
          ]
        },
        {
          "id": 3,
          "complex": [
            {
              "id": 10,
              "value": "Unboxing video"
            },
            {
              "id": 11,
              "value": "http://videos.com/1.mp4"
            }
          ]
        },
        {
          "id": 4,
          "complex_collection": [
            {
              "collection": [
                {
                  "id": 10,
                  "value": "Additional video"
                },
                {
                  "id": 11,
                  "value": "http://videos.com/2.mp4"
                }
              ]
            },
            {
              "collection": [
                {
                  "id": 10,
                  "value": "Another one video"
                },
                {
                  "id": 11,
                  "value": "http://videos.com/3.mp4"
                }
              ]
            }
          ]
        }
      ]
    }
    Response status  200 
    {
      "result": {
        "updated": true
      }
    }

    /v1/products

    /prices

    POST /v1/products/prices

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


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

    stocks object

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

    offer_id string

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

    old_price string

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

    premium_price string

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

    price string

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

    product_id integer

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


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


    errors object

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

    code string

    Код ошибки.

    message string

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

    offer_id string

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

    product_id integer

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

    updated boolean

    True, если информации о товаре успешно обновлена.

    POST /v1/products/prices HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "prices": [
        {
          "offer_id": "string",
          "old_price": "string",
          "premium_price": "string",
          "price": "string",
          "product_id": 0
        }
      ]
    }
    Response status  200 
    {
      "result": [
        {
          "errors": [
            {
              "code": "string",
              "message": "string"
            }
          ],
          "offer_id": "string",
          "product_id": 0,
          "updated": true
        }
      ]
    }

    /stocks

    POST /v1/products/stocks

    Метод для обновления количества товаров. Не рекомендуется обновлять больше 500 товаров в одном запросе.


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

    stocks object

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

    offer_id string

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

    product_id integer

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

    stock integer

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


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


    errors object

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

    code string

    Код ошибки.

    message string

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

    offer_id string

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

    product_id integer

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

    updated boolean

    True, если информации о товаре успешно обновлена.

    POST /v1/products/stocks HTTP/1.1
    Host: api-seller.ozon.ru 
    Client-Id: 836
    Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
    Content-Type: application/json
    {
      "stocks": [
        {
          "offer_id": "string",
          "product_id": 0,
          "stock": 0
        }
      ]
    }
    Response status  200 
    {
      "result": [
        {
          "errors": [
            {
              "code": "string",
              "message": "string"
            }
          ],
          "offer_id": "string",
          "product_id": 0,
          "updated": true
        }
      ]
    }

    /v2/product

    /import

    POST /v2/product/import

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

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

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

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


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

    attributes * object

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

    complex_id integer

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

    id* integer

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

    values object

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

    dictionary_value_id integer

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

    value string

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

    barcode string

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

    category_id integer

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

    complex_attributes object

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

    attributes array

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

    depth integer

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

    dimension_unit string

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

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

    height integer

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

    image_group_id string

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

    images string

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

    name string

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

    offer_id string

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

    old_price string

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

    pdf_list array

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

    premium_price string

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

    price string

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

    vat string

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

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

      weight integer

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

      weight_unit string

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

      width integer

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


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


      task_id integer

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

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

      /info

      POST /v2/product/info

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


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

      offer_id string

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

      product_id integer

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

      sku integer

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


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


      barcode string

      Штрихкод.

      buybox_price string

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

      category_id integer

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

      commissions object

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

      deliveryAmount integer

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

      minValue integer

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

      percent integer

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

      returnAmount integer

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

      saleSchema string

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

      value integer

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

      created_at datetime

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

      errors object

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

      attribute_id integer

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

      code string

      Код ошибки.

      field string

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

      level string

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

      id integer

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

      images array

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

      marketing_price string

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

      min_ozon_price string

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

      name string

      Название.

      offer_id string

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

      old_price string

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

      premium_price string

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

      price string

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

      price_index string

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

      recommended_price string

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

      sources object

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

      is_enabled boolean

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

      sku integer

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

      source string

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

      state string

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

      stocks object

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

      coming integer

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

      present integer

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

      reserved integer

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

      vat string

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

      visibility_details object

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

      has_price boolean

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

      has_stock boolean

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

      active_product boolean

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

      visible boolean

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

      volume_weight integer

      Объемный вес товара.

      POST /v2/product/info HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "offer_id": "107112",
        "product_id": 15214026,
        "sku": 0
      }
      Response status  200 
      {
        "result": {
          "barcode": "string",
          "buybox_price": "string",
          "category_id": 0,
          "commissions": [
            {
              "deliveryAmount": 0,
              "minValue": 0,
              "percent": 0,
              "returnAmount": 0,
              "salaeSchema": "string",
              "value": 0
            }
          ],
          "created_at": "2021-02-05T07:08:17.131Z",
          "errors": [
            {
              "attribute_id": 0,
              "code": "string",
              "field": "string",
              "level": "string"
            }
          ],
          "id": 0,
          "images": [
            "string"
          ],
          "marketing_price": "string",
          "min_ozon_price": "string",
          "name": "string",
          "offer_id": "string",
          "old_price": "string",
          "premium_price": "string",
          "price": "string",
          "price_index": "string",
          "recommended_price": "string",
          "sources": [
            {
              "is_enabled": true,
              "sku": 0,
              "source": "string"
            }
          ],
          "state": "string",
          "stocks": {
            "coming": 0,
            "present": 0,
            "reserved": 0
          },
          "vat": "string",
          "visibility_details": {
            "active_product": true,
            "has_price": true,
            "has_stock": true
          },
          "visible": true,
          "volume_weight": 0
        }
      }
      
      
      
      
      
      

      /info/stocks

      POST /v2/product/info/stocks

      Информация о товарах. Количество задается в запросе. Swagger


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

      page integer

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

      page_size integer

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


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


      items object

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

      offer_id string

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

      product_id integer

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

      stocks object

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

      present integer

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

      reserved integer

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

      type string

      Тип склада.

      total integer

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

      POST /v2/product/info/stocks HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "page": 0,
        "page_size": 0
      }
      Response status  200 
      {
        "result": {
          "items": [
            {
              "offer_id": "string",
              "product_id": 0,
              "stocks": [
                {
                  "present": 0,
                  "reserved": 0,
                  "type": "string"
                }
              ]
            }
          ],
          "total": 0
        }
      }

      /v2/products

      /delete

      POST /v2/products/delete

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


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

      products integer

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

      offer_id string

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


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


      deleted boolean

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

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

      /stocks

      POST /v2/products/stocks

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


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

      stocks object

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

      offer_id string

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

      product_id integer

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

      stock integer

      Количество.

      warehouse_id integer

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


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


      errors object

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

      code string

      Код ошибки.

      message string

      Текст ошибки: SKU STOCK NOT CHANGED. Количество товара на стоке не изменилось, так как вы передаете тот же остаток.

      offer_id string

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

      product_id integer

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

      updated boolean

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

      warehouse_id integer

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

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

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

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

      /delivered

      POST /v2/fbs/posting/delivered

      Перевести отправление в статус "Доставлено", если используется сторонняя служба доставки.
      Swagger


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

      posting_number * string

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


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


      error integer

      Ошибка при обработке запроса.

      posting_number string

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

      result boolean

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

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

      /delivering

      POST /v2/fbs/posting/delivering

      Перевести отправление в статус "Доставляется", если используется сторонняя служба доставки.
      Swagger


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

      posting_number * string

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


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


      error integer

      Ошибка при обработке запроса.

      posting_number string

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

      result boolean

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

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

      /last-mile

      POST /v2/fbs/posting/last-mile

      Swagger


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

      posting_number * string

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


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


      error integer

      Ошибка при обработке запроса.

      posting_number string

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

      result boolean

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

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

      /tracking-number/set

      POST /v2/fbs/posting/tracking-number/set

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


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

      tracking_numbers * object

      Массив с парами идентификатор отправления — трек-номер.

      posting_number string

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

      tracking_number string

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


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


      error integer

      Ошибка при обработке запроса.

      posting_number string

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

      result array

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

      POST /v2/fbs/posting/tracking-number/set HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "tracking_numbers": [
          {
            "posting_number": "string",
            "tracking_number": "string"
          }
        ]
      }
      Response status  200 
      {
        "result": [
          {
            "error": "string",
            "posting_number": "string",
            "result": true
          }
        ]
      }

      Доставка по выбору продавца

      /get

      POST /v3/posting/fbs/get

      Получить данные отравлений. Swagger


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

      posting_number string

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

      with object

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

      analytics_data boolean

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

      barcodes boolean

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

      financial_data boolean

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


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


      addressee object

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

      name string

      Имя покупателя.

      phone string

      Контактный телефон.

      analytics_data object

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

      city string

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

      delivery_date_begin datetime

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

      delivery_date_end datetime

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

      delivery_type string

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

      is_premium boolean

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

      payment_type_group_name string

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

      region string

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

      tpl_provider string

      Служба доставки.

      tpl_provider_id integer

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

      warehouse_id integer

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

      warehouse string

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

      barcodes object

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

      upper_barcode string

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

      lower_barcode string

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

      cancellation object

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

      affect_cancellation_rating boolean

      True, если отмена влияет на рейтинг продавца.

      cancel_reason string

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

      cancel_reason_id integer

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

      cancellation_initiator string

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

      cancellation_type string

      Тип отмены.

      cancelled_after_ship boolean

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

      customer object

      Данные о покупателе.

      address object

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

      address_tail string

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

      city string

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

      comment string

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

      country string

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

      district string

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

      region string

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

      zip_code string

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

      customer_email string

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

      customer_id integer

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

      name string

      Имя покупателя.

      phone string

      Контактный телефон.

      delivering_date datetime

      Дата доставки.

      delivery_method object

      Метод доставки.

      id integer

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

      name string

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

      tpl_provider string

      Служба доставки.

      tpl_provider_id integer

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

      warehouse string

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

      warehouse_id integer

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

      delivery_price string

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

      financial_data object

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

      products object

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

      actions array

      client_price string

      Цена, по которой купили товар.

      commission_amount integer

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

      commission_percent integer

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

      old_price string

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

      payout integer

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

      picking object

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

      price string

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

      product_id integer

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

      quantity integer

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

      total_discount_percent integer

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

      total_discount_value integer

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

      in_process_at datetime

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

      order_id integer

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

      order_number string

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

      posting_number string

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

      products object

      dimensions object

      Размеры товара.

      height integer

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

      length integer

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

      weight integer

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

      width integer

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

      mandatory_mark string

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

      name string

      Название.

      offer_id string

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

      price string

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

      quantity integer

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

      sku integer

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

      shipment_date datetime

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

      status string

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

      tpl_integration_type string

      Тип интеграции со службой доставки.
      ozon— доставка службой Ozon.
      tpl_tracking— доставка интегрированной службой.
      non_integrated— доставка сторонней службой.

      tracking_number string

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

      POST /v3/posting/fbs/get HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "posting_number": "string",
        "with": {
          "analytics_data": true,
          "barcodes": true,
          "financial_data": true
        }
      }
      Response status  200 
      {
        "result": {
          "addressee": {
            "name": "string",
            "phone": "string"
          },
          "analytics_data": {
            "city": "string",
            "delivery_date_begin": "2020-12-09T17:02:31.626Z",
            "delivery_date_end": "2020-12-09T17:02:31.626Z",
            "delivery_type": "string",
            "is_premium": true,
            "payment_type_group_name": "string",
            "region": "string",
            "tpl_provider": "string",
            "tpl_provider_id": 0,
            "warehouse": "string",
            "warehouse_id": 0
          },
          "barcodes": {
            "lower_barcode": "string",
            "upper_barcode": "string"
          },
          "cancellation": {
            "affect_cancellation_rating": true,
            "cancel_reason": "string",
            "cancel_reason_id": 0,
            "cancellation_initiator": "string",
            "cancellation_type": "string",
            "cancelled_after_ship": true
          },
          "customer": {
            "address": {
              "address_tail": "string",
              "city": "string",
              "comment": "string",
              "country": "string",
              "district": "string",
              "region": "string",
              "zip_code": "string"
            },
            "customer_email": "string",
            "customer_id": 0,
            "name": "string",
            "phone": "string"
          },
          "delivering_date": "2020-12-09T17:02:31.626Z",
          "delivery_method": {
            "id": 0,
            "name": "string",
            "tpl_provider": "string",
            "tpl_provider_id": 0,
            "warehouse": "string",
            "warehouse_id": 0
          },
          "delivery_price": "string",
          "financial_data": {
            "products": [
              {
                "actions": [
                  "string"
                ],
                "client_price": "string",
                "commission_amount": 0,
                "commission_percent": 0,
                "old_price": 0,
                "payout": 0,
                "picking": {
                  "amount": 0,
                  "moment": "2020-12-09T17:02:31.626Z",
                  "tag": "string"
                },
                "price": 0,
                "product_id": 0,
                "quantity": 0,
                "total_discount_percent": 0,
                "total_discount_value": 0
              }
            ]
          },
          "in_process_at": "2020-12-09T17:02:31.626Z",
          "order_id": 0,
          "order_number": "string",
          "posting_number": "string",
          "products": [
            {
              "dimensions": {
                "height": "string",
                "length": "string",
                "weight": "string",
                "width": "string"
              },
              "mandatory_mark": [
                "string"
              ],
              "name": "string",
              "offer_id": "string",
              "price": "string",
              "quantity": 0,
              "sku": 0
            }
          ],
          "provider_status": "string",
          "shipment_date": "2020-12-09T17:02:31.626Z",
          "status": "string",
          "tpl_integration_type": "string",
          "tracking_number": "string"
        }
      }

      /list

      POST /v3/posting/fbs/list

      Swagger


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

      dir string

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

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

      filter object

      delivery_method_id integer

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

      order_id string

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

      provider_id integer

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

      since datetime

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

      to datetime

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

      status string

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

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

      warehouse_id integer

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

      limit integer

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

      offset integer

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

      with object

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

      analytics_data boolean

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

      barcodes boolean

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

      financial_data boolean

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


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


      has_next boolean

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

      postings string

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

      addressee object

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

      name string

      Имя покупателя.

      phone string

      Контактный телефон.

      analytics_data object

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

      city string

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

      delivery_date_begin datetime

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

      delivery_date_end datetime

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

      delivery_type string

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

      is_premium boolean

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

      payment_type_group_name string

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

      region string

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

      tpl_provider string

      Служба доставки.

      tpl_provider_id integer

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

      warehouse_id integer

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

      warehouse string

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

      barcodes object

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

      upper_barcode string

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

      lower_barcode string

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

      cancellation object

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

      affect_cancellation_rating boolean

      True, если отмена влияет на рейтинг продавца.

      cancel_reason string

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

      cancel_reason_id integer

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

      cancellation_initiator string

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

      cancellation_type string

      Тип отмены.

      cancelled_after_ship boolean

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

      customer object

      Данные о покупателе.

      address object

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

      address_tail string

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

      city string

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

      comment string

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

      country string

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

      district string

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

      region string

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

      zip_code string

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

      customer_email string

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

      customer_id integer

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

      name string

      Имя покупателя.

      phone string

      Контактный телефон.

      delivering_date datetime

      Дата доставки.

      delivery_method object

      Метод доставки.

      id integer

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

      name string

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

      tpl_provider string

      Служба доставки.

      tpl_provider_id integer

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

      warehouse string

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

      warehouse_id integer

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

      financial_data object

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

      products object

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

      actions array

      client_price string

      Цена, по которой купили товар.

      commission_amount integer

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

      commission_percent integer

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

      old_price string

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

      payout integer

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

      picking object

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

      price string

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

      product_id integer

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

      quantity integer

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

      total_discount_percent integer

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

      total_discount_value integer

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

      in_process_at datetime

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

      order_id integer

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

      order_number string

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

      posting_number string

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

      products object

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

      mandatory_mark string

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

      name string

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

      offer_id string

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

      price string

      Цена товара.

      quantity integer

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

      sku integer

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

      shipment_date datetime

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

      status string

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

      tpl_integration_type string

      Тип интеграции со службой доставки.
      ozon— доставка службой Ozon.
      tpl_tracking— доставка интегрированной службой.
      non_integrated— доставка сторонней службой.

      tracking_number string

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

      POST /v3/posting/fbs/list HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "dir": "string",
        "filter": {
          "delivery_method_id": [
            0
          ],
          "order_id": 0,
          "provider_id": [
            0
          ],
          "since": "2020-12-09T18:53:03.052Z",
          "status": "string",
          "to": "2020-12-09T18:53:03.052Z",
          "warehouse_id": [
            0
          ]
        },
        "limit": 0,
        "offset": 0,
        "with": {
          "analytics_data": true,
          "barcodes": true,
          "financial_data": true
        }
      }
      Response status  200 
      {
        "result": {
          "has_next": true,
          "postings": [
            {
              "addressee": {
                "name": "string",
                "phone": "string"
              },
              "analytics_data": {
                "city": "string",
                "delivery_date_begin": "2020-12-09T19:12:35.295Z",
                "delivery_date_end": "2020-12-09T19:12:35.295Z",
                "delivery_type": "string",
                "is_premium": true,
                "payment_type_group_name": "string",
                "region": "string",
                "tpl_provider": "string",
                "tpl_provider_id": 0,
                "warehouse": "string",
                "warehouse_id": 0
              },
              "barcodes": {
                "lower_barcode": "string",
                "upper_barcode": "string"
              },
              "cancellation": {
                "affect_cancellation_rating": true,
                "cancel_reason": "string",
                "cancel_reason_id": 0,
                "cancellation_initiator": "string",
                "cancellation_type": "string",
                "cancelled_after_ship": true
              },
              "customer": {
                "address": {
                  "address_tail": "string",
                  "city": "string",
                  "comment": "string",
                  "country": "string",
                  "district": "string",
                  "region": "string",
                  "zip_code": "string"
                },
                "customer_email": "string",
                "customer_id": 0,
                "name": "string",
                "phone": "string"
              },
              "delivering_date": "2020-12-09T19:12:35.295Z",
              "delivery_method": {
                "id": 0,
                "name": "string",
                "tpl_provider": "string",
                "tpl_provider_id": 0,
                "warehouse": "string",
                "warehouse_id": 0
              },
              "financial_data": {
                "products": [
                  {
                    "actions": [
                      "string"
                    ],
                    "client_price": "string",
                    "commission_amount": 0,
                    "commission_percent": 0,
                    "old_price": 0,
                    "payout": 0,
                    "picking": {
                      "amount": 0,
                      "moment": "2020-12-09T19:12:35.295Z",
                      "tag": "string"
                    },
                    "price": 0,
                    "product_id": 0,
                    "quantity": 0,
                    "total_discount_percent": 0,
                    "total_discount_value": 0
                  }
                ]
              },
              "in_process_at": "2020-12-09T19:12:35.295Z",
              "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-12-09T19:12:35.295Z",
              "status": "string",
              "tpl_integration_type": "string",
              "tracking_number": "string"
            }
          ]
        }
      }

      /unfulfilled/list

      POST /v3/posting/fbs/unfulfilled/list

      Swagger


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

      dir string

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

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

      filter object

      delivering_date_from datetime

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

      delivering_date_to datetime

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

      delivery_method_id integer

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

      provider_id integer

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

      status string

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

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

      warehouse_id integer

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

      limit integer

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

      offset integer

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

      with object

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

      analytics_data boolean

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

      barcodes boolean

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

      financial_data boolean

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


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


      count integer

      Счетчик элементов в ответе.

      postings string

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

      addressee object

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

      name string

      Имя покупателя.

      phone string

      Контактный телефон.

      analytics_data object

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

      city string

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

      delivery_date_begin datetime

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

      delivery_date_end datetime

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

      delivery_type string

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

      is_premium boolean

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

      payment_type_group_name string

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

      region string

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

      tpl_provider string

      Служба доставки.

      tpl_provider_id integer

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

      warehouse_id integer

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

      warehouse string

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

      barcodes object

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

      upper_barcode string

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

      lower_barcode string

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

      cancellation object

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

      affect_cancellation_rating boolean

      True, если отмена влияет на рейтинг продавца.

      cancel_reason string

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

      cancel_reason_id integer

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

      cancellation_initiator string

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

      cancellation_type string

      Тип отмены.

      cancelled_after_ship boolean

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

      customer object

      Данные о покупателе.

      address object

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

      address_tail string

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

      city string

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

      comment string

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

      country string

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

      district string

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

      region string

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

      zip_code string

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

      customer_email string

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

      customer_id integer

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

      name string

      Имя покупателя.

      phone string

      Контактный телефон.

      delivering_date datetime

      Дата доставки.

      delivery_method object

      Метод доставки.

      id integer

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

      name string

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

      tpl_provider string

      Служба доставки.

      tpl_provider_id integer

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

      warehouse string

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

      warehouse_id integer

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

      financial_data object

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

      products object

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

      actions array

      client_price string

      Цена, по которой купили товар.

      commission_amount integer

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

      commission_percent integer

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

      old_price string

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

      payout integer

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

      picking object

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

      price string

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

      product_id integer

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

      quantity integer

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

      total_discount_percent integer

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

      total_discount_value integer

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

      in_process_at datetime

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

      order_id integer

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

      order_number string

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

      posting_number string

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

      products object

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

      mandatory_mark string

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

      name string

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

      offer_id string

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

      price string

      Цена товара.

      quantity integer

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

      sku integer

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

      shipment_date datetime

      Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

      status string

      Статус отправления.

      tpl_integration_type string

      Тип интеграции со службой доставки.
      ozon— доставка службой Ozon.
      tpl_tracking— доставка интегрированной службой.
      non_integrated— доставка сторонней службой.

      tracking_number string

      Трек-номер отправления.

      POST /v3/posting/fbs/unfulfilled/list HTTP/1.1
      Host: api-seller.ozon.ru 
      Client-Id: 836
      Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
      Content-Type: application/json
      {
        "dir": "string",
        "filter": {
          "cutoff_from": "2020-12-09T19:05:41.040Z",
          "cutoff_to": "2020-12-09T19:05:41.040Z",
          "delivering_date_from": "2020-12-09T19:05:41.040Z",
          "delivering_date_to": "2020-12-09T19:05:41.040Z",
          "delivery_method_id": [
            0
          ],
          "provider_id": [
            0
          ],
          "status": "string",
          "warehouse_id": [
            0
          ]
        },
        "limit": 0,
        "offset": 0,
        "with": {
          "analytics_data": true,
          "barcodes": true,
          "financial_data": true
        }
      }
      Response status  200 
      {
        "result": {
          "count": 0,
          "postings": [
            {
              "addressee": {
                "name": "string",
                "phone": "string"
              },
              "analytics_data": {
                "city": "string",
                "delivery_date_begin": "2020-12-09T19:05:41.119Z",
                "delivery_date_end": "2020-12-09T19:05:41.119Z",
                "delivery_type": "string",
                "is_premium": true,
                "payment_type_group_name": "string",
                "region": "string",
                "tpl_provider": "string",
                "tpl_provider_id": 0,
                "warehouse": "string",
                "warehouse_id": 0
              },
              "barcodes": {
                "lower_barcode": "string",
                "upper_barcode": "string"
              },
              "cancellation": {
                "affect_cancellation_rating": true,
                "cancel_reason": "string",
                "cancel_reason_id": 0,
                "cancellation_initiator": "string",
                "cancellation_type": "string",
                "cancelled_after_ship": true
              },
              "customer": {
                "address": {
                  "address_tail": "string",
                  "city": "string",
                  "comment": "string",
                  "country": "string",
                  "district": "string",
                  "region": "string",
                  "zip_code": "string"
                },
                "customer_email": "string",
                "customer_id": 0,
                "name": "string",
                "phone": "string"
              },
              "delivering_date": "2020-12-09T19:05:41.119Z",
              "delivery_method": {
                "id": 0,
                "name": "string",
                "tpl_provider": "string",
                "tpl_provider_id": 0,
                "warehouse": "string",
                "warehouse_id": 0
              },
              "financial_data": {
                "products": [
                  {
                    "actions": [
                      "string"
                    ],
                    "client_price": "string",
                    "commission_amount": 0,
                    "commission_percent": 0,
                    "old_price": 0,
                    "payout": 0,
                    "picking": {
                      "amount": 0,
                      "moment": "2020-12-09T19:05:41.119Z",
                      "tag": "string"
                    },
                    "price": 0,
                    "product_id": 0,
                    "quantity": 0,
                    "total_discount_percent": 0,
                    "total_discount_value": 0
                  }
                ]
              },
              "in_process_at": "2020-12-09T19:05:41.119Z",
              "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-12-09T19:05:41.119Z",
              "status": "string",
              "tpl_integration_type": "string",
              "tracking_number": "string"
            }
          ]
        }
      }

      Информация о транзакциях

      Информация о транзакциях за указанный период, по конкретным отправлениями или определенного типа.

      /transaction​/list

      POST /v2/finance/transaction​/list

      Список транзакций Возвращает подробную информацию по транзакциям для отправления. Если в запросе не указывать posting_number, в ответе будут все отправления за указанный период или определенного типа.


      Параметры запроса

      filter * object

      Фильтр для поиска транзакций.

      date object

      Период времени.

      from datetime

      Начало периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

      to datetime

      Конец периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

      posting_number string

      Номер отправления.

      transaction_type string

      Тип транзакции

      • all — все,
      • orders — заказы,
      • returns — возвраты,
      • services — сервисные сборы.

        page * integer

        Номер страницы, возвращаемой в запросе.

        page_size * integer

        Количество элементов на странице.


        Параметры ответа


        commission_amount integer

        Сумма комиссии.

        details string

        Информация о товаре в транзакции.

        discount_amount integer

        Сумма скидки.

        item_delivery_amount integer

        Количество доставленных товаров.

        item_return_amount integer

        Сумма скидки.

        order_amount integer

        Сумма заказа.

        order_date datetime

        Дата заказа в формате YYYY-MM-DDTHH:mm:ss.sssZ.

        order_number string

        Номер заказа.

        order_state string

        Статус отправления

        total_amount string

        Итоговый размер начислений.

        transaction_date datetime

        Дата транзакции в формате YYYY-MM-DDTHH:mm:ss.sssZ.

        transaction_number integer

        Идентификатор транзакции.

        transaction_type string

        Тип транзакции.

        transaction_type_slug string

        Тип транзакции в системном виде

        POST /v2/finance/transaction/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "filter": {
            "date": {
              "from": "2021-03-02T10:17:12.739Z",
              "to": "2021-03-02T10:17:12.739Z"
            },
            "posting_number": "string",
            "transaction_type": "string"
          },
          "page": 0,
          "page_size": 0
        }
        Response status  200 
        {
          "result": [
            {
              "commission_amount": 0,
              "details": "string",
              "discount_amount": 0,
              "item_delivery_amount": 0,
              "item_return_amount": 0,
              "order_amount": 0,
              "order_date": "2021-03-02T10:23:58.217Z",
              "order_number": "string",
              "order_state": "string",
              "total_amount": 0,
              "transaction_date": "2021-03-02T10:23:58.217Z",
              "transaction_number": 0,
              "transaction_type": "string",
              "transaction_type_slug": "string"
            }
          ]
        }

        Отправления из-за рубежа

        /approve

        POST /v2/posting/crossborder/approve

        pampam


        Параметры запроса

        posting_number * string

        Идентификатор отправления.


        Параметры ответа


        result boolean

        Результат обработки запроса. True, если запрос выполнился без ошибок.

        POST /v2/posting/crossborder/approve HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number": "13009555-0001-1"
        }
        Response status  200 
        {
          "result": true
        }

        /cancel

        POST /v2/posting/crossborder/cancel


        Параметры запроса

        cancel_reason_id * integer

        Идентификатор причины отмены отправления.

        cancel_reason_message string

        Дополнительная информация по отмене. Если cancel_reason_id = 402, параметр обязательный.

        posting_number * string

        Идентификатор отправления.

        sku integer

        Идентификатор товара в системе Ozon — SKU.


        Параметры ответа


        result boolean

        Результат обработки запроса. True, если запрос выполнился без ошибок.

        POST /v2/posting/crossborder/cancel HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "cancel_reason_id": 361,
          "cancel_reason_message": "",
          "posting_number": "39268230-0002-3",
          "sku": [
            149123456
          ]
        }
        Response status  200 
        {
          "result": true
        }

        /cancel-reason/list

        POST /v2/posting/crossborder/cancel-reason/list

        Can not resolve handlers/crossborder_cancel-reason.md


        Параметры ответа


        id integer

        Номер задания на формирование документов.

        title string

        Название категории.

        type_id string

        Инициатор отмены отправления.

        • buyer — покупатель,
        • seller — продавец.

        POST /v2/posting/crossborder/cancel HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        Can not resolve examples/v2/posting/crossborder/cancel-reason/list/in.json
        Response status  200 
        Can not resolve examples/v2/posting/crossborder/cancel-reason/list/out.json

        /get

        POST /v2/posting/crossborder/get

        Can not resolve handlers/crossborder_get.md


        Параметры запроса

        posting_number * string

        Идентификатор отправления.

        translit boolean

        True, если включена транслитерация адреса из кириллицы в латиницу.


        Параметры ответа


        address object

        Информация об адресе доставки.

        address_tail string

        Адрес в текстовом формате.

        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": ""
            }
          ]
        }

        Продажа со склада Ozon

        /get

        POST /v2/posting/fbo/get

        Can not resolve handlers/fbo-get.md


        Параметры запроса

        posting_number * string

        Идентификатор отправления.

        with object

        Дополнительные поля, которые нужно добавить в ответ.

        analytics_data boolean

        Добавить в ответ данные аналитики.

        financial_data boolean

        Добавить в ответ финансовые данные.


        Параметры ответа


        analytics_data object

        Аналитические данные.

        city string

        Город доставки.

        delivery_type string

        Способ доставки.

        is_premium boolean

        Наличие подписки Премиум.

        payment_type_group_name string

        Способ оплаты.

        region string

        Регион доставки.

        warehouse_id integer

        Идентификатор склада.

        warehouse_name string

        Название склада отправки заказа.

        cancel_reason_id integer

        Идентификатор причины отмены отправления.

        created_at datetime

        Дата и время создания отправления.

        financial_data object

        Финансовые данные.

        products object

        Список товаров.

        actions array

        commission_amount integer

        Размер комиссии за товар.

        commission_percent integer

        Процент комиссии.

        old_price string

        Цена до учета скидок, на карточке товара отображается зачеркнутой.

        payout integer

        Выплата продавцу.

        picking object

        Информация про доставку.

        price string

        Цена товара с учетом скидок — это значение показывается на карточке товара.

        product_id integer

        Идентификатор товара.

        total_discount_percent integer

        Процент скидки.

        total_discount_value integer

        Сумма скидки.

        in_process_at datetime

        Дата и время начала обработки отправления.

        order_id integer

        Идентификатор заказа, к которому относится отправление.

        order_number string

        Номер заказа, к которому относится отправление.

        posting_number string

        Номер отправления.

        products object

        Список товаров в отправлении.

        mandatory_mark string

        Обязательная маркировка товара.

        name string

        Название товара.

        offer_id string

        Идентификатор товара в системе продавца — артикул.

        price string

        Цена товара.

        quantity integer

        Количество товара в отправлении.

        sku integer

        Идентификатор товара в системе Ozon.

        status string

        Результат обработки товара классификатором

        • CLASSIFIED — товар классифицирован,
        • NOT_CLASSIFIED — возникла ошибка.

        POST /v2/posting/fbo/get HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number": "13009555-0001-1",
          "with": {
            "analytics_data": true,
            "financial_data": true
          }
        }
        Response status  200 
        {
          "result": {
            "order_id": 152398500,
            "order_number": "33920144-0066",
            "posting_number": "33920144-0066-1",
            "status": "awaiting_deliver",
            "cancel_reason_id": 0,
            "created_at": "2020-06-24T01:23:45.51Z",
            "in_process_at": "2020-06-24T01:23:45.387Z",
            "products": [
              {
                "sku": 147524707,
                "name": "DEFENDER Наушники вставки Basic 603 черный",
                "quantity": 1,
                "offer_id": "63603",
                "price": "77.00",
              }
            ],
            "analytics_data": {
              "region": "Москва",
              "city": "Москва",
              "delivery_type": "Courier",
              "is_premium": false,
              "payment_type_group_name": "Карты оплаты",
              "warehouse_id": 6048863967000,
              "warehouse_name": "ТВЕРЬ_ХАБ"
            },
            "financial_data": {
              "products": [
                {
                  "commission_amount": 0,
                  "commission_percent": 0,
                  "payout": 0,
                  "product_id": 147524707,
                  "old_price": 0,
                  "price": 77,
                  "total_discount_value": 0,
                  "total_discount_percent": 0,
                  "actions": null,
                  "picking": null,
                }
              ]
            }
          }
        }

        /list

        POST /v2/posting/fbo/list

        Can not resolve handlers/fbo-list.md


        Параметры запроса

        dir * string

        Направление сортировки.

        • asc — по возрастанию,
        • desc — по убыванию.

        filter * object

        order_id string

        Идентификатор заказа.

        order_number string

        Номер заказа.

        since datetime

        Начало периода в формате YYYY-MM-DD.

        to datetime

        Конец периода в формате YYYY-MM-DD.

        status string

        Статус отправления.

        • awaiting_approve — ожидает подтверждения,
        • awaiting_packaging — ожидает упаковки,
        • awaiting_deliver — ожидает отгрузки,
        • delivering — доставляется,
        • driver_pickup — у водителя,
        • delivered — доставлено,
        • cancelled — отменено.

        limit * integer

        Количество отправлений в ответе. Максимум — 50, минимум — 1.

        offset integer

        Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.

        translit boolean

        True, если включена транслитерация адреса из кириллицы в латиницу.

        with object

        Дополнительные поля, которые нужно добавить в ответ.

        analytics_data boolean

        Добавить в ответ данные аналитики.

        financial_data boolean

        Добавить в ответ финансовые данные.


        Параметры ответа


        analytics_data object

        Аналитические данные.

        city string

        Город доставки.

        delivery_type string

        Способ доставки.

        is_premium boolean

        Наличие подписки Премиум.

        payment_type_group_name string

        Способ оплаты.

        region string

        Регион доставки.

        warehouse_id integer

        Идентификатор склада.

        warehouse_name string

        Название склада отправки заказа.

        cancel_reason_id integer

        Идентификатор причины отмены отправления.

        created_at datetime

        Дата и время создания отправления.

        financial_data object

        Финансовые данные.

        products object

        Список товаров.

        actions array

        commission_amount integer

        Размер комиссии за товар.

        commission_percent integer

        Процент комиссии.

        old_price string

        Цена до учета скидок, на карточке товара отображается зачеркнутой.

        payout integer

        Выплата продавцу.

        picking object

        Информация про доставку.

        price string

        Цена товара с учетом скидок — это значение показывается на карточке товара.

        product_id integer

        Идентификатор товара.

        total_discount_percent integer

        Процент скидки.

        total_discount_value integer

        Сумма скидки.

        in_process_at datetime

        Дата и время начала обработки отправления.

        order_id integer

        Идентификатор заказа, к которому относится отправление.

        order_number string

        Номер заказа, к которому относится отправление.

        posting_number string

        Номер отправления.

        products object

        Список товаров в отправлении.

        mandatory_mark string

        Обязательная маркировка товара.

        name string

        Название товара.

        offer_id string

        Идентификатор товара в системе продавца — артикул.

        price string

        Цена товара.

        quantity integer

        Количество товара в отправлении.

        sku integer

        Идентификатор товара в системе Ozon.

        status string

        Результат обработки товара классификатором

        • CLASSIFIED — товар классифицирован,
        • NOT_CLASSIFIED — возникла ошибка.

        POST /v2/posting/fbo/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "dir": "asc",
          "filter":
          {
            "since": "2018-10-24T16:24:09.474Z",
            "to": "2019-10-24T16:24:09.474Z"
          },
          "limit": 10,
          "offset": 0,
          "translit": true,
          "with": {
            "analytics_data": true,
            "financial_data": true
          }
        }
        Response status  200 
        {
          "result":[
            {
              "order_id":152398500,
              "order_number":"33920144-0066",
              "posting_number":"33920144-0066-1",
              "status":"awaiting_deliver",
              "cancel_reason_id":0,
              "created_at":"2020-06-24T01:23:45.51Z",
              "in_process_at":"2020-06-24T01:23:45.387Z",
              "products":
                [
                  {
                    "sku":147524707,
                    "name":"DEFENDER Наушники вставки Basic 603 черный",
                    "quantity":1,
                    "offer_id":"63603",
                    "price":"77.00",
                  }
                ],
              "analytics_data":
                {
                  "region":"Москва",
                  "city":"Москва",
                  "delivery_type":"Courier",
                  "is_premium":false,
                  "payment_type_group_name":"Карты оплаты",
                  "warehouse_id":6048863967000,
                  "warehouse_name":"ТВЕРЬ_ХАБ",
                },
              "financial_data":
                {
                  "products":
                    [
                      {
                        "commission_amount":0,
                        "commission_percent":0,
                        "payout":0,
                        "product_id":147524707,
                        "old_price":0,
                        "price":77,
                        "total_discount_value":0,
                        "total_discount_percent":0,
                        "actions":null,
                        "picking":null
                      }
                    ]
                }
            }
          ]
        }

        Продажа со своего склада

        Группа методов для работы с отправлениями со склада продавца.

        Swagger

        /act/check-status

        POST /v2/posting/fbs/act/check-status


        Параметры запроса

        id * integer

        Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.


        Параметры ответа


        added_to_act string

        Массив c номерами отправлений, которые добавлены в Акт приема-передачи. Эти отправления нужно передать сегодня.

        removed_from_act string

        Массив с номерами отправлений, которые не попали в Акт приема-передачи. Такие отправления нужно передавать со следующей отгрузкой.

        status string

        Статус запроса.

        • in_process — документы формируются, нужно подождать,
        • ready — документы сформированы и готовы для скачивания,
        • error — произошла ошибка при формировании документов, запросите документы повторно.

        POST /v2/posting/fbs/act/check-status HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "id": 15684442104000
        }
        Response status  200 
        {
          "result": {
            "status": "ready",
            "added_to_act": [
              "00420000-0030-2",
              "01560000-0096-4"
            ],
            "removed_from_act": [
              "03840000-0096-3"
            ]
          }
        }

        /act/create

        POST /v2/posting/fbs/act/create

        Если вы используете Доверительную приемку грузового места, укажите в запросе количество грузовых мест, которое передадите к отгрузке.


        Параметры запроса

        containers_count integer

        Количество грузовых мест. Подробнее в Помощи


        Параметры ответа


        id integer

        Номер задания на формирование документов.

        POST /v2/posting/fbs/act/create HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "containers_count": 5
        }
        Response status  200 
        {
          "result": {
            "id": 15684442104000
          }
        }

        /act​/get-container-labels

        POST /v2/posting/fbs/act​/get-container-labels

        Метод создает этикетки для грузового места.


        Параметры запроса

        id * integer

        Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.

        POST /v2/posting/fbs/act/get-container-labels HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "id": 0
        }
        Response status  200 
        pdf-документ

        /act​/get-pdf

        POST /v2/posting/fbs/act​/get-pdf


        Параметры запроса

        id * integer

        Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.

        POST /v2/posting/fbs/act/get-pdf HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "id": 15684442104000
        }
        Response status  200 
        pdf-документ

        /arbitration

        POST /v2/posting/fbs/arbitration


        Параметры запроса

        posting_number * string

        Идентификатор отправления.


        Параметры ответа


        result boolean

        Результат обработки запроса. True, если запрос выполнился без ошибок.

        POST /v2/posting/fbs/arbitration HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number":
          [
            "02898753-0009-1",
            "02898753-0009-2"
          ]
        }
        Response status  200 
        {
          "result": "true"
        }

        /awaiting-delivery

        POST /v2/posting/fbs/awaiting-delivery


        Параметры запроса

        posting_number * string

        Идентификатор отправления.


        Параметры ответа


        result boolean

        Результат обработки запроса. True, если запрос выполнился без ошибок.

        POST /v2/posting/fbs/awaiting-delivery HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number":
          [
            "02898753-0009-1",
            "02898753-0009-2"
          ]
        }
        Response status  200 
        {
          "result": "true"
        }

        /cancel

        POST /v2/posting/fbs/cancel


        Параметры запроса

        cancel_reason_id * integer

        Идентификатор причины отмены отправления.

        cancel_reason_message string

        Дополнительная информация по отмене. Если cancel_reason_id = 402, параметр обязательный.

        posting_number * string

        Идентификатор отправления.


        Параметры ответа


        result boolean

        Результат обработки запроса. True, если запрос выполнился без ошибок.

        POST /v2/posting/fbs/cancel HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "cancel_reason_id": 402,
          "cancel_reason_message": "Wrong seller id",
          "posting_number": 13076543-0001-1
        }
        Response status  200 
        {
          "result": "true"
        }

        /cancel-reason/list

        POST /v2/posting/fbs/cancel-reason/list


        Параметры ответа


        id integer

        Номер задания на формирование документов.

        title string

        Название категории.

        type_id string

        Инициатор отмены отправления.

        • buyer — покупатель,
        • seller — продавец.

        POST /v2/posting/fbs/cancel-reason/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {}
        Response status  200 
        {
          "result": [
            {
              "id": 123,
              "title": "Error",
              "type_id": "seller"
            }
          ]
        }

        /get

        POST /v2/posting/fbs/get


        Параметры запроса

        posting_number * string

        Идентификатор отправления.

        with object

        Дополнительные поля, которые нужно добавить в ответ.

        analytics_data boolean

        Добавить в ответ данные аналитики.

        barcodes boolean

        Добавить в ответ штрихкоды отправления.

        financial_data boolean

        Добавить в ответ финансовые данные.


        Параметры ответа


        analytics_data object

        Аналитические данные.

        city string

        Город доставки.

        delivery_type string

        Способ доставки.

        is_premium boolean

        Наличие подписки Премиум.

        payment_type_group_name string

        Способ оплаты.

        region string

        Регион доставки.

        warehouse_id integer

        Идентификатор склада.

        warehouse_name string

        Название склада отправки заказа.

        barcodes object

        Штрихкоды отправления.

        upper_barcode string

        Верхний штрихкод на маркировке отправления.

        lower_barcode string

        Нижний штрихкод на маркировке отправления.

        cancel_reason_id integer

        Идентификатор причины отмены отправления.

        created_at datetime

        Дата и время создания отправления.

        financial_data object

        Финансовые данные.

        products object

        Список товаров.

        actions array

        commission_amount integer

        Размер комиссии за товар.

        commission_percent integer

        Процент комиссии.

        old_price string

        Цена до учета скидок, на карточке товара отображается зачеркнутой.

        payout integer

        Выплата продавцу.

        picking object

        Информация про доставку.

        price string

        Цена товара с учетом скидок — это значение показывается на карточке товара.

        product_id integer

        Идентификатор товара.

        total_discount_percent integer

        Процент скидки.

        total_discount_value integer

        Сумма скидки.

        in_process_at datetime

        Дата и время начала обработки отправления.

        order_id integer

        Идентификатор заказа, к которому относится отправление.

        order_number string

        Номер заказа, к которому относится отправление.

        posting_number string

        Номер отправления.

        products object

        Список товаров в отправлении.

        mandatory_mark string

        Обязательная маркировка товара.

        name string

        Название товара.

        offer_id string

        Идентификатор товара в системе продавца — артикул.

        price string

        Цена товара.

        quantity integer

        Количество товара в отправлении.

        sku integer

        Идентификатор товара в системе Ozon.

        shipment_date datetime

        Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

        status string

        Статус отправления.

        POST /v2/posting/fbs/get HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number": "13076543-0001-1",
          "with": {
            "analytics_data": true,
            "barcodes": true,
            "financial_data": true
          }
        }
        Response status  200 
        {
          "result": {
            "analytics_data": {
              "city": "string",
              "delivery_type": "string",
              "is_premium": true,
              "payment_type_group_name": "string",
              "region": "string"
            },
            "barcodes": {
              "lower_barcode": "string",
              "upper_barcode": "string"
            },
            "cancel_reason_id": 0,
            "created_at": "2020-07-06T07:40:22.281Z",
            "financial_data": {
              "products": [
                {
                  "actions": [
                    "string"
                  ],
                  "commission_amount": 0,
                  "commission_percent": 0,
                  "old_price": 0,
                  "payout": 0,
                  "picking": {
                    "amount": 0,
                    "moment": "2020-07-06T07:40:22.281Z",
                    "tag": "string"
                  },
                  "price": 0,
                  "product_id": 0,
                  "total_discount_percent": 0,
                  "total_discount_value": 0
                }
              ]
            },
            "in_process_at": "2020-07-06T07:40:22.281Z",
            "order_id": 0,
            "order_number": "string",
            "posting_number": "string",
            "products": [
              {
                "mandatory_mark": [
                  "string"
                ],
                "name": "string",
                "offer_id": "string",
                "price": "string",
                "quantity": 0,
                "sku": 0
              }
            ],
            "shipment_date": "2020-07-06T07:40:22.281Z",
            "status": "string"
          }
        }
        

        /get-by-barcode

        POST /v2/posting/fbs/get-by-barcode


        Параметры запроса

        barcode * string

        Штрихкод отправления.


        Параметры ответа


        barcodes object

        Штрихкоды отправления.

        upper_barcode string

        Верхний штрихкод на маркировке отправления.

        lower_barcode string

        Нижний штрихкод на маркировке отправления.

        cancel_reason_id integer

        Идентификатор причины отмены отправления.

        created_at datetime

        Дата и время создания отправления.

        in_process_at datetime

        Дата и время начала обработки отправления.

        order_id integer

        Идентификатор заказа, к которому относится отправление.

        order_number string

        Номер заказа, к которому относится отправление.

        posting_number string

        Номер отправления.

        products object

        Список товаров в отправлении.

        mandatory_mark string

        Обязательная маркировка товара.

        name string

        Название товара.

        offer_id string

        Идентификатор товара в системе продавца — артикул.

        price string

        Цена товара.

        quantity integer

        Количество товара в отправлении.

        sku integer

        Идентификатор товара в системе Ozon.

        shipment_date datetime

        Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

        status string

        Статус отправления.

        POST /v2/posting/fbs/get-by-barcode HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "barcode": "string"
        }
        Response status  200 
        {
          "result": {
            "barcodes": {
              "lower_barcode": "string",
              "upper_barcode": "string"
            },
            "cancel_reason_id": 0,
            "created_at": "2020-06-16T15:11:06.995Z",
            "in_process_at": "2020-06-16T15:11:06.995Z",
            "order_id": 0,
            "order_number": "string",
            "posting_number": "string",
            "products": [
              {
                "mandatory_mark": [
                  "string"
                ],
                "name": "string",
                "offer_id": "string",
                "price": "string",
                "quantity": 0,
                "sku": 0
              }
            ],
            "shipment_date": "2020-06-16T15:11:06.995Z",
            "status": "string"
          }
        }

        /list

        POST /v2/posting/fbs/list


        Параметры запроса

        dir * string

        Направление сортировки.

        • asc — по возрастанию,
        • desc — по убыванию.

        filter * object

        order_id string

        Идентификатор заказа.

        order_number string

        Номер заказа.

        since datetime

        Начало периода в формате YYYY-MM-DD.

        to datetime

        Конец периода в формате YYYY-MM-DD.

        status string

        Статус отправления.

        • awaiting_approve — ожидает подтверждения,
        • awaiting_packaging — ожидает упаковки,
        • awaiting_deliver — ожидает отгрузки,
        • delivering — доставляется,
        • driver_pickup — у водителя,
        • delivered — доставлено,
        • cancelled — отменено.

        limit * integer

        Количество отправлений в ответе. Максимум — 50, минимум — 1.

        offset integer

        Количество элементов, которое будет пропущено в ответе. Например, если offset=10, то ответ начнется с 11-го найденного элемента.

        sort_by string

        Сортировка в ответе
        updated_at— по дате обновления,
        in_process_at— по времени обработки,
        order_created_at— по дате создания.

        with object

        Дополнительные поля, которые нужно добавить в ответ.

        analytics_data boolean

        Добавить в ответ данные аналитики.

        barcodes boolean

        Добавить в ответ штрихкоды отправления.

        financial_data boolean

        Добавить в ответ финансовые данные.


        Параметры ответа


        analytics_data object

        Аналитические данные.

        city string

        Город доставки.

        delivery_type string

        Способ доставки.

        is_premium boolean

        Наличие подписки Премиум.

        payment_type_group_name string

        Способ оплаты.

        region string

        Регион доставки.

        warehouse_id integer

        Идентификатор склада.

        warehouse_name string

        Название склада отправки заказа.

        barcodes object

        Штрихкоды отправления.

        upper_barcode string

        Верхний штрихкод на маркировке отправления.

        lower_barcode string

        Нижний штрихкод на маркировке отправления.

        cancel_reason_id integer

        Идентификатор причины отмены отправления.

        created_at datetime

        Дата и время создания отправления.

        financial_data object

        Финансовые данные.

        products object

        Список товаров.

        actions array

        commission_amount integer

        Размер комиссии за товар.

        commission_percent integer

        Процент комиссии.

        old_price string

        Цена до учета скидок, на карточке товара отображается зачеркнутой.

        payout integer

        Выплата продавцу.

        picking object

        Информация про доставку.

        price string

        Цена товара с учетом скидок — это значение показывается на карточке товара.

        product_id integer

        Идентификатор товара.

        total_discount_percent integer

        Процент скидки.

        total_discount_value integer

        Сумма скидки.

        in_process_at datetime

        Дата и время начала обработки отправления.

        order_id integer

        Идентификатор заказа, к которому относится отправление.

        order_number string

        Номер заказа, к которому относится отправление.

        posting_number string

        Номер отправления.

        products object

        Список товаров в отправлении.

        mandatory_mark string

        Обязательная маркировка товара.

        name string

        Название товара.

        offer_id string

        Идентификатор товара в системе продавца — артикул.

        price string

        Цена товара.

        quantity integer

        Количество товара в отправлении.

        sku integer

        Идентификатор товара в системе Ozon.

        shipment_date datetime

        Дата и время, до которой необходимо собрать отправление. Если отправление не собрать к этой дате — оно автоматически отменится.

        status string

        Статус отправления.

        POST /v2/posting/fbs/list HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "dir": "string",
          "filter": {
            "order_id": 0,
            "order_number": "string",
            "since": "2020-11-13T11:43:37.496Z",
            "status": "string",
            "to": "2020-11-13T11:43:37.496Z"
          },
          "limit": 0,
          "offset": 0,
          "sort_by": "string",
          "with": {
            "analytics_data": true,
            "barcodes": true,
            "financial_data": true
          }
        }
        Response status  200 
        {
          "result": [
            {
              "analytics_data": {
                "city": "string",
                "delivery_type": "string",
                "is_premium": true,
                "payment_type_group_name": "string",
                "region": "string"
              },
              "barcodes": {
                "lower_barcode": "string",
                "upper_barcode": "string"
              },
              "cancel_reason_id": 0,
              "created_at": "2020-07-06T06:23:14.627Z",
              "financial_data": {
                "products": [
                  {
                    "actions": [
                      "string"
                    ],
                    "commission_amount": 0,
                    "commission_percent": 0,
                    "old_price": 0,
                    "payout": 0,
                    "picking": {
                      "amount": 0,
                      "moment": "2020-07-06T06:23:14.627Z",
                      "tag": "string"
                    },
                    "price": 0,
                    "product_id": 0,
                    "total_discount_percent": 0,
                    "total_discount_value": 0
                  }
                ]
              },
              "in_process_at": "2020-07-06T06:23:14.627Z",
              "order_id": 0,
              "order_number": "string",
              "posting_number": "string",
              "products": [
                {
                  "mandatory_mark": [
                    "string"
                  ],
                  "name": "string",
                  "offer_id": "string",
                  "price": "string",
                  "quantity": 0,
                  "sku": 0
                }
              ],
              "shipment_date": "2020-07-06T06:23:14.627Z",
              "status": "string"
            }
          ]
        }
        

        /package-label

        POST /v2/posting/fbs/package-label


        Параметры запроса

        posting_number * string

        Идентификатор отправления.

        POST /v2/posting/fbs/package-label HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "posting_number":
          [
            "13076543-0001-1"
          ]
        }
        Response status  200 
        pdf-документ

        /product/mandatory-mark/is-required

        POST /v2/posting/fbs/product/mandatory-mark/is-required

        Проверяет необходимость маркировки для товара по его SKU.

        Подробнее про маркировку товаров в Помощи


        Параметры запроса

        sku * integer

        Идентификатор товара в системе Ozon — SKU.


        Параметры ответа


        is_required boolean

        Флаг обязательной характеристики.

        sku integer

        Идентификатор товара на Ozon.

        POST /v2/posting/fbs/product/mandatory-mark/is-required HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "sku": [
            0
          ]
        }
        Response status  200 
        {
          "result": [
            {
              "is_required": true,
              "sku": 0
            }
          ]
        }

        /product/mandatory-mark/validate

        POST /v2/posting/fbs/product/mandatory-mark/validate

        Метод для валидации значения маркировки.

        Подробнее про маркировку товаров в Помощи


        Параметры запроса

        mandatory_mark * string

        Обязательная маркировка товара.


        Параметры ответа


        mandatory_mark string

        Обязательная маркировка товара.

        result boolean

        True, если маркировка валидна.

        POST /v2/posting/fbs/product/mandatory-mark/validate HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "mandatory_mark": [
            "string"
          ]
        }
        Response status  200 
        {
          "result": [
            {
              "mandatory_mark": "string",
              "result": true
            }
          ]
        }

        /ship

        POST /v2/posting/fbs/ship


        Параметры запроса

        packages * object

        items object

        Массив товаров в ответе.

        mandatory_mark string

        Значение обязательной маркировки для товара.

        quantity integer

        Количество товара.

        sku integer

        Идентификатор товара в системе Ozon — SKU.

        posting_number string

        Идентификатор отправления.


        Параметры ответа


        result boolean

        Результат обработки запроса. True, если запрос выполнился без ошибок.

        POST /v2/posting/fbs/ship HTTP/1.1
        Host: api-seller.ozon.ru 
        Client-Id: 836
        Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
        Content-Type: application/json
        {
          "packages": [
            {
              "items": [
                {
                  "mandatory_mark": [
                    "string"
                  ],
                  "quantity": 0,
                  "sku": 0
                }
              ]
            }
          ],
          "posting_number": "string"
        }
        Response status  200 
        {
          "result": [
            "string"
          ]
        }

        /unfulfilled/list

        POST /v2/posting/fbs/unfulfilled/list


        Параметры запроса

        dir string

        Направление сортировки.

        • asc — по возрастанию,
        • desc — по убыванию.

        limit integer

        Количество отправлений в ответе. Максимум — 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/unfulfilled/list 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"
            }
          ]
        }

        Возвраты

        /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
              }
            ]
          }
        }

        Работа с накладными

        /orders​/{orderId}/waybill_acceptance_results

        GET /v1/supplier/orders​/{orderId}/waybill_acceptance_results

        Swagger


        URI Parameters


        Параметры запроса

        orderId * string

        Идентификатор заказа.


        Параметры ответа


        order object

        Информация о заказе.

        contract object

        contract_id integer

        Идентификатор контракта.

        name string

        Название контракта.

        document_number string

        Идентификатор документа.

        id integer

        Номер задания на формирование документов.

        storage_warehouse object

        Склад, на котором хранятся товары.

        name string

        Название склада.

        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


        URI Parameters


        Параметры ответа


        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
        }