Начало работы
В документе описаны методы Ozon Seller API — программного интерфейса для работы с маркетплейсом Ozon.
Основные категории методов Seller API:
- товары,
- отправления,
- чат с покупателями,
- отчеты.
Авторизация
Доступ к API могут получить только пользователи зарегистрированные в Ozon Seller.
Для каждого запроса нужно указывать идентификатор клиента и его API-ключ:
- В личном кабинете перейдите в настройки, на вкладку API-ключи.
- Введите название для ключа и нажмите "Создать ключ" — ниже появится список ваших API-ключей.
- Вы можете создать несколько API-ключей, например, если у вас несколько магазинов на Маркетплейсе Ozon.
Тестовая среда
Тестовая среда дублирует методы Seller API, но полностью изолирована от настоящих данных. Здесь можно пробовать вызывать методы API, получать ответы, наблюдать изменение тестовых данных.
Запросы к тестовой среде не изменяют данные в Ozon Seller, созданные товары и заказы нигде не показываются.
Адрес для отправки тестовых запросов: cb-api.ozonru.me
Параметр | Описание |
---|---|
Client-Id | 836 |
Api-Key | 0296d4f2-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 может меняться — обо всех крупных обновлениях мы делаем рассылку. Проверьте, что в личном кабинете указаны актуальные контактные данные.
Список методов
Полное дерево категорий товаров на Ozon.
GET /v1/categories/tree/{categoryId}
Дерево подкатегорий. Аналигочен GET /v1/categories/tree, но для конкретной категории.
GET /v1/categories/{categoryId}/attributes
Характеристики отдельной категории. Идентификатор категории указывается в адресе запроса.
Работает до 1.06.2020: список характеристик для категории, идентификатор которой указан в теле запроса.
Дерево категорий. В теле запроса можно передать идентификатор категории, для которой надо построить дерево вложенных категорий.
Обновленная версия списка характеристик для категории, идентификатор которой указан в теле запроса.
POST /v2/category/attribute/value/by-option
Если идентификатор справочника или харектеристики изменился, можно узнать его новое значение по старому идендификатору.
POST /v2/category/attribute/values
Справочник для указанной в теле запроса категории или характеристики.
Товары и цены
Добавить товары на Ozon можно в личном кабинете, через XLS-шаблон или с помощью методов Seller API.
Перед публикацией на Маркетплейсе товары проходят модерацию.
Для пробной интеграции рекомендуем загружать товары по одному, а не пакетами — так они быстрее пройдут проверку.
Если при добавлении товаров возникли ошибки, исправьте их и загрузите товары ещё раз.
Часть данных о товаре нельзя изменить:
- код поставщика — offer_id;
- категорию товара — category_id;
- если наши сотрудники измерили товар на складе — габариты товара.
Если товар уже объединен в карточку, его нельзя редактировать.
Список методов
Метод для первичной загрузки товаров. В одном запросе можно передать до 1000 товаров.
Возвращает информацию о товаре по его идентификатору. Если указать только 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, ценовой индекс и подобное.
Возвращает информацию о количестве товаров на складах: сколько единиц есть в наличии, сколько ожидается в поставке и сколько разерезервировано покупателями.
Заказы и отправления
Заказы на Ozon делятся на отправления: даже если в заказе одно отправление, все действия будут касаться именно отправления, а не заказа.
Можно самостоятельно разбить заказ на несколько отправлений, например, если товары нельзя хранить вместе или если они находятся на разных складах. Подробно о том, как работает поставка и сбор заказов есть в Помощи: FBS, FBO.
Чтобы работать с отправлениями через API, добавьте товары, дождитесь модерации и обновите остатки. Все новые заказы создают отправления в статусе «awaiting_packaging».
FBS
FBO
Crossborder
Обновления
13 января: Чат с покупателем
Метод для возвращения информации о чате с указанными идентификаторами:
Метод для отправления файла в существующий чат по его идентификатору:
Метод для отправления сообщения в существующий чат по его идентификатору:
Метод для cоздания нового чата с покупателем:
25 декабря: Чат с покупателем
Добавили метод для запроса истории чата.
15 декабря: Данные аналитики
Добавили метод для генерации отчетов.
Укажите период и метрики, которые нужно посчитать — в ответе будет аналитика, сгруппированная по параметру 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/unfulfilled/list
Метод обновления остатков товаров на складах:
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 июня: Грузовые места
Если для вашего способа отгрузки настроена доверительная приемка, вам потребуется отгружать отправления не поштучно, а грузовыми местами — большими упаковками, в которых находятся отправления. Тогда наш курьер или сотрудник пункта приема получит от вас грузовое место с отправлениями. Он не будет распаковывать его и проверять состав отправлений при отгрузке. Это мы сделаем позже, когда будем готовить доставку отправлений покупателям. Подробнее в Помощи
- Теперь в методе, который формирует акт отгрузки POST: /v2/posting/fbs/act/create, можно указать количество грузовых мест.
- Этикетку для грузового места можно подготовить методом POST: /v2/posting/fbs/act/get-container-labels.
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
Параметры запроса
Параметры ответа
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
}
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"
}
POST /pass/update HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"car_model": "string",
"car_number": "string",
"driver_name": "string",
"driver_patronymic": "string",
"driver_surname": "string",
"end_unloading_time": "string",
"is_regular_pass": true,
"start_unloading_time": "string",
"telephone": "string",
"trailer_number": "string",
"unload_date": "string"
}
Response status 200
{
"result": true
}
Список складов
/warehouse/list
POST /v1/warehouse/list
Выводит список складов. В запросе не нужно указывать параметры. Ваша компания будет определена по Client-ID.
Параметры ответа
POST /v1/warehouse/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
{
"result": [
{
"warehouse_id": int64,
"name": "string",
"is_rfbs": true
}
]
}
Список методов склада
/list
POST /v1/delivery-method/list
Возвращает список методов склада.
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Возвращает список брендов, для продажи которых небходимо загрузить подтверждающие документы. Подробнее о документах на бренды в Помощи.
Параметры запроса
Параметры ответа
POST /v1/brand/company-certification/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"page": 1,
"page_size": 2
}
Response status 200
{
"result": {
"brand_certification": [
{
"brand_id": 19709360,
"brand_name": "Select",
"has_certificate": false
},
{
"brand_id": 78055689,
"brand_name": "Start Line",
"has_certificate": false
}
],
"total": 2
}
}
Категории товаров
/tree
GET /v1/categories/tree
Возвращает категории для товаров в виде дерева. Создание товаров доступно только в категориях последнего уровня, соответственно вам необходимо сопоставить именно эти категории с категориями своей площадки. Категории не создаются по запросу пользователя.
Параметры ответа
GET /v1/categories/tree/ HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Response status 200
{
"result": [
{
"category_id": 0,
"children": [
null
],
"title": "string"
}
]
}
/tree/[categoryId]
GET /v1/categories/tree/[categoryId]
Возвращает дерево вложенных категории по иденификатору родительской.
Параметры ответа
GET /v1/category/tree/[categoryId] HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Can not resolve examples/v1/categories/tree/categoryId/in.json
Response status 200
Can not resolve examples/v1/category/tree/categoryId/out.json
/tree/[categoryId]/attributes
GET /v1/categories/tree/[categoryId]/attributes
Параметры ответа
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-запроса не нужны входные параметры.
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
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
Параметры запроса
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"
}
Чат с покупателями
/list
POST /v1/chat/list
Возвращает информацию о чатах с указанными идентификаторами.
Параметры запроса
Параметры ответа
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 одинаковая структура запроса и ответа.
Параметры запроса
Параметры ответа
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
Отправляет файл в существующий чат по его идентификатору.
Параметры запроса
Параметры ответа
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
Отправляет сообщение в существующий чат по его идентификатору.
Параметры запроса
Параметры ответа
POST /v1/chat/send/message HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"chat_id": "string",
"text": "string"
}
Response status 200
{
"result": "string"
}
/start
POST /v1/chat/start
Создает новый чат с покупателем по отправлению. Например, чтобы уточнить адрес или модель товара.
Параметры запроса
Параметры ответа
POST /v1/chat/start HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"posting_number": "string"
}
Response status 200
{
"result": {
"chat_id": "string"
}
}
Работа с товарами
POST /v1/product/archive HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"product_id": [
14929,
244206,
458202,
710646
]
}
Response status 200
{
"result": true
}
/certificate/accordance-types
GET /v1/product/certificate/accordance-types
Cправочник типов соответствия требованиям. Swagger
Параметры ответа
POST /v1/product/certificate/accordance-types HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
Can not resolve examples/v1/product/certificate/accordance-type/out.json
/certificate/bind
POST /v1/product/certificate/bind
Привязать сертификат к товару. Swagger
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
POST /v1/product/certificate/create HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
{
"id": 123
}
/certificate/types
GET /v1/product/certificate/types
Справочник типов документов. Swagger
Параметры ответа
POST /v1/product/certificate/types HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
{
"result": [
{
"name": "string",
"value": "string"
}
]
}
/import/info
POST /v1/product/import/info
Позволяет получить статус создания карточки товара.
Параметры запроса
Параметры ответа
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 у этих параметров.
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Изменить данные на карточке товара, кроме цены и количества товаров на складах.
Параметры запроса
Параметры ответа
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
Метод для обновления цен товаров.
Параметры запроса
Параметры ответа
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 товаров в одном запросе.
Параметры запроса
Параметры ответа
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.
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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 идентификаторов.
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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, в ответе будут все отправления за указанный период или определенного типа.
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
POST /v2/posting/crossborder/ship HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"items": [
{
"quantity": 2,
"sku": 100056
}
],
"posting_number": "39268230-0002-3",
"shipping_provider_id": 15109877837000,
"tracking_number": "AB123456CD"
}
Response status 200
{
"result": {
"package_number": "232123"
}
}
/shipping-provider/list
POST /v2/posting/crossborder/shipping-provider/list
Can not resolve handlers/cb_shipping_provider.md
Параметры ответа
POST /v2/posting/crossborder/shipping-provider/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
{
"result": [
{
"id": 15109877837000,
"name": "shiptor"
},
{
"id": 15308950689000,
"name": "china-post"
}
]
}
/unfulfilled/list
POST /v2/posting/crossborder/unfulfilled/list
Can not resolve handlers/cb_unfulfilled.md
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
POST /v2/posting/fbo/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"dir": "asc",
"filter":
{
"since": "2018-10-24T16:24:09.474Z",
"to": "2019-10-24T16:24:09.474Z"
},
"limit": 10,
"offset": 0,
"translit": true,
"with": {
"analytics_data": true,
"financial_data": true
}
}
Response status 200
{
"result":[
{
"order_id":152398500,
"order_number":"33920144-0066",
"posting_number":"33920144-0066-1",
"status":"awaiting_deliver",
"cancel_reason_id":0,
"created_at":"2020-06-24T01:23:45.51Z",
"in_process_at":"2020-06-24T01:23:45.387Z",
"products":
[
{
"sku":147524707,
"name":"DEFENDER Наушники вставки Basic 603 черный",
"quantity":1,
"offer_id":"63603",
"price":"77.00",
}
],
"analytics_data":
{
"region":"Москва",
"city":"Москва",
"delivery_type":"Courier",
"is_premium":false,
"payment_type_group_name":"Карты оплаты",
"warehouse_id":6048863967000,
"warehouse_name":"ТВЕРЬ_ХАБ",
},
"financial_data":
{
"products":
[
{
"commission_amount":0,
"commission_percent":0,
"payout":0,
"product_id":147524707,
"old_price":0,
"price":77,
"total_discount_value":0,
"total_discount_percent":0,
"actions":null,
"picking":null
}
]
}
}
]
}
Продажа со своего склада
Группа методов для работы с отправлениями со склада продавца.
/act/check-status
POST /v2/posting/fbs/act/check-status
Параметры запроса
Параметры ответа
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
Если вы используете Доверительную приемку грузового места, укажите в запросе количество грузовых мест, которое передадите к отгрузке.
Параметры запроса
Параметры ответа
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
Метод создает этикетки для грузового места.
Параметры запроса
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
Параметры запроса
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
POST /v2/posting/fbs/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"dir": "string",
"filter": {
"order_id": 0,
"order_number": "string",
"since": "2020-11-13T11:43:37.496Z",
"status": "string",
"to": "2020-11-13T11:43:37.496Z"
},
"limit": 0,
"offset": 0,
"sort_by": "string",
"with": {
"analytics_data": true,
"barcodes": true,
"financial_data": true
}
}
Response status 200
{
"result": [
{
"analytics_data": {
"city": "string",
"delivery_type": "string",
"is_premium": true,
"payment_type_group_name": "string",
"region": "string"
},
"barcodes": {
"lower_barcode": "string",
"upper_barcode": "string"
},
"cancel_reason_id": 0,
"created_at": "2020-07-06T06:23:14.627Z",
"financial_data": {
"products": [
{
"actions": [
"string"
],
"commission_amount": 0,
"commission_percent": 0,
"old_price": 0,
"payout": 0,
"picking": {
"amount": 0,
"moment": "2020-07-06T06:23:14.627Z",
"tag": "string"
},
"price": 0,
"product_id": 0,
"total_discount_percent": 0,
"total_discount_value": 0
}
]
},
"in_process_at": "2020-07-06T06:23:14.627Z",
"order_id": 0,
"order_number": "string",
"posting_number": "string",
"products": [
{
"mandatory_mark": [
"string"
],
"name": "string",
"offer_id": "string",
"price": "string",
"quantity": 0,
"sku": 0
}
],
"shipment_date": "2020-07-06T06:23:14.627Z",
"status": "string"
}
]
}
/package-label
POST /v2/posting/fbs/package-label
Параметры запроса
POST /v2/posting/fbs/package-label HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"posting_number":
[
"13076543-0001-1"
]
}
Response status 200
pdf-документ
/product/mandatory-mark/is-required
POST /v2/posting/fbs/product/mandatory-mark/is-required
Проверяет необходимость маркировки для товара по его SKU.
Подробнее про маркировку товаров в Помощи
Параметры запроса
Параметры ответа
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
Метод для валидации значения маркировки.
Подробнее про маркировку товаров в Помощи
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
Параметры запроса
Параметры ответа
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
URI Parameters
Параметры запроса
Параметры ответа
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}
URI Parameters
Параметры ответа
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
}