Начало работы
В документе описаны методы 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 апреля:
Метод позволяет изменить информацию о количестве товара в наличии.
POST /v1/product/import/stocks
Метод позволяет получить информацию о товаре по идентификатору.
Метод позволяет получить список товаров.
Метод позволяет установить продажу товара только по предоплате.
POST /v1/product/prepayment/set
Метод позволяет получить информацию о списке товаров.
Метод выводит список сертифицируемых категорий.
POST /v1/product/certification/list
Метод создает товар по указанному Ozon ID.
POST /v1/product/import-by-sku
Метод возвращает описание товара.
POST /v1/product/info/description
Метод позволяет получить информацию о товаре.
GET /v1/products/info/{product_id}
Метод позволяет обновить цены товаров.
Метод позволяет получить информацию о товарах.
Метод позволяет получить статус создания карточки товара.
Метод позволяет изменить цену одного или нескольких товаров.
POST /v1/product/import/prices
Метод позволяет обновить количество товаров.
Метод позволяет обновить информацию о товаре.
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/ — обновленная версия. Рекомендуем перейти на неё, чтобы всё работало как задумано.
Про все важные изменения мы сообщаем по электронной почте, которую вы указали в личном кабинете.
Если у вас остались вопросы или появились идеи — напишите нам.
Getting started
The document describes the methods of the Ozon Seller API used to work with Ozon Marketplace.
Main categories of the Seller API methods:
- products
- shipments
- chat with customer
- reports
Authorization
Only users of the Ozon Seller Center can access the API.
For each request, you must specify the client ID and its API key:
- In your account, go to settings, and select the API keys tab.
- Enter a name for the key and click "Create a key" — a list of your API keys will appear below.
- You can create multiple API keys, for example, if you have multiple stores on Ozon Marketplace.
Test environment
The test environment duplicates the methods of the Seller API, but is completely isolated from the real data. Here you can try to call API methods, get responses, and observe changes in test data.
Requests to the test environment do not change the data in Ozon Seller Account, the created products and orders are not shown anywhere.
Test environment URL: cb-api.ozonru.me
Parameter | Description |
---|---|
Client-Id | 836 |
Api-Key | 0296d4f2-70a1-4c09-b507-904fd05567b9 |
Production environment
API requests in the production environment changes real data, so be careful — created products and orders affect real users.
Production environment URL: api-seller.ozon.ru
The created products can be viewed at the link of the following form
https://www.ozon.ru/context/detail/id/SKU
where instead of the SKU, you need to specify the value for the created product.
Request format:
GET / HTTP/1.1
Host: api-seller.ozon.ru
Client-Id:
Api-Key:
Content-Type: application/json
Characteristics and categories
On Ozon, products have categories and characteristics, so users can find the product they need. Therefore, when creating a product, specify the detailed information: select a category and fill in the characteristics. For each product category, there is a standard set of characteristics — you can use them or add your own. Categories below the second level usually have the same characteristics.
The list of categories and characteristics of products on Ozon may change. We make a newsletter about all major updates. Make sure that there is the up-to-date contact information in your account.
List of methods
GET /v1/categories/tree
GET /v1/categories/tree/[categoryId]
GET /v1/categories/tree/[categoryId]/attributes
v1 Characteristics and categories
POST /v1/category/tree
v2 Characteristics and categories
POST /v2/category/attribute
POST /v2/category/attribute/values
POST /v2/category/attribute/values/values/by-option
Products and prices
You can add products to Ozon in your account, via an XLS template or using the Seller API methods.
Products are moderated before being published on the marketplace.
For trial integration, we recommend uploading products one at a time, rather than in batches. This way they will pass verification faster.
If errors occur when adding products, correct them and upload products again.
Some of the product information cannot be changed:
- supplier code — offer_id
- product category — category_id
- if our employees have measured the products in the warehouse — the dimensions of the product
If the products are already merged into one PDP (product description page), they cannot be edited.
List of methods
Warehouse
Returns a list of your warehouses.
Returns a list of delivery methods for your warehouse.
POST /v1/product/archive
GET /v1/product/certificate/accordance-types
POST /v1/product/certificate/bind
POST /v1/product/certificate/create
GET /v1/product/certificate/types
POST /v1/product/import/info
POST /v1/product/import/prices
POST /v1/product/info/prices
POST /v1/product/unarchive
POST /v1/product/update
POST /v1/products/prices
POST /v1/products/stocks
POST /v2/product/import
POST /v2/product/info
POST /v2/product/info/stocks
POST /v2/products/delete
POST /v2/products/stocks
Orders and shipments
Orders on Ozon are split into shipments: even if the order contains one shipment, all actions will relate to the shipment, not the order.
You can split an order into multiple shipments yourself, for example, if the products cannot be stored together or if they are located in different warehouses. Learn more about how the delivery and packaging of orders works in Help Center.
To work with shipments via the API, add products, wait for moderation, and update the stock. All new orders create shipments with the status "awaiting_packaging".
List of methods
POST /v2/posting/fbs/act/check-status
POST /v2/posting/fbs/act/create
POST /v2/posting/fbs/act/get-container-labels
POST /v2/posting/fbs/act/get-pdf
POST /v2/posting/fbs/arbitration
POST /v2/posting/fbs/awaiting-delivery
POST /v2/posting/fbs/cancel
POST /v2/posting/fbs/cancel-reason/list
POST /v2/posting/fbs/get
POST /v2/posting/fbs/get-by-barcode
POST /v2/posting/fbs/package-label
POST /v2/posting/fbs/product/mandatory-mark/is-required
POST /v2/posting/fbs/product/mandatory-mark/validate
POST /v2/posting/fbs/ship
POST /v3/posting/fbs/get
POST /v3/posting/fbs/list
POST /v3/posting/fbs/unfulfilled/list
Shipment status and tracking numbers
POST /v2/fbs/posting/delivered
Change status to "Delivered".
POST /v2/fbs/posting/delivering
Change status to "In Transit".
POST /v2/fbs/posting/last-mile
Change status to "Courier is on the way".
POST /v2/fbs/posting/tracking-number/set
Assign tracking numbers to shipments.
Seller API methods
Here is a detailed description of the parameters, and sample requests and responses for the methods of the Ozon Seller API. Note that there is a v2/ (updated version) for some methods. We recommend switching to it so that everything works as intended.
We inform you about all important changes by e-mail, which you specified in your account.
If you have any questions or ideas, contact us.
Пропуск на склад для водителя
/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 of warehouses
/warehouse/list
POST /v1/warehouse/list
Returns a list of your warehouses. No parameters. Your company is identified by the 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
}
]
}
List of delivery methods for a warehouse
/list
POST /v1/delivery-method/list
Returns a list of delivery methods for your warehouse.
Параметры запроса
Параметры ответа
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
Product categories
/tree
GET /v1/categories/tree
Returns categories for products in a tree view. Creating products is only available in the last level categories, so you need to match these categories with your categories. Categories are not created at the user's request.
Параметры ответа
GET /v1/categories/tree/ HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Response status 200
{
"result": [
{
"category_id": 0,
"children": [
null
],
"title": "string"
}
]
}
/tree/[categoryId]
GET /v1/categories/tree/[categoryId]
Returns a tree of nested categories by the ID of the parent category.
Параметры ответа
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": []
}
]
}
]
}
v1 Characteristics and categories
/tree
POST /v1/category/tree
Returns categories for products in a tree view. Creating products is only available in the last level categories, so you need to match these categories with your categories. Categories are not created at the user's request.
To get the full tree, you can use the GET /v1/categories/tree request. The GET request does not need any input parameters.
Параметры запроса
Параметры ответа
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"
}
v2 Characteristics and categories
A group of methods for working with product categories
/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
Can not resolve examples/v2/category/attribute/values/in.json
Response status 200
Can not resolve examples/v2/category/attribute/values/out.json
/values/by-option
POST /v2/category/attribute/values/values/by-option
Параметры запроса
Параметры ответа
POST /v2/category/attribute HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Can not resolve examples/v2/category/attribute/values/by-option/in.json
Response status 200
Can not resolve examples/v2/category/attribute/values/by-option/out.json
Чат с покупателями
/list
POST /v1/chat/list
Возвращает информацию о чатах с указанными идентификаторами.
Параметры запроса
Параметры ответа
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
}
]
}
Обновить остатки
POST /v1/product/import/stocks
Позволяет изменить информацию о количестве товара в наличии. За один запрос можно изменить наличие для 100 товаров. Задать наличие товару возможно только после того, как статус товара сменился на "processed"
Параметры запроса
Параметры ответа
POST /v1/product/import/stocks HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"stocks": [
{
"offer_id": "string",
"product_id": 0,
"stock": 0
}
]
}
Response status 200
{
"result": [
{
"errors": [
{
"code": "string",
"message": "string"
}
],
"offer_id": "string",
"product_id": 0,
"updated": true
}
]
}
Информация о товаре
POST /v1/product/info
Позволяет получить информацию о товаре по идентификатору. С 01 марта можно пользоваться новой версией этого метода:POST /v2/product/info. Пожалуйста, перейдите на новую версию до 01 июня — потом мы отключим поддержку первой версии.
Параметры запроса
Параметры ответа
POST /v1/product/info HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"offer_id": "string",
"product_id": 0,
"sku": 0
}
Response status 200
{
"result": {
"barcode": "string",
"buybox_price": "string",
"category_id": 0,
"created_at": "2021-03-24T12:31:04.417Z",
"id": 0,
"images": [
"string"
],
"marketing_price": "string",
"min_ozon_price": "string",
"name": "string",
"offer_id": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"recommended_price": "string",
"sku": 0,
"sources": [
{
"is_enabled": true,
"sku": 0,
"source": "string"
}
],
"state": "string",
"stock": 0,
"stocks": {
"coming": 0,
"present": 0,
"reserved": 0
},
"validation_errors": [
{
"code": "string",
"error": "string",
"field": "string"
}
],
"vat": "string",
"visibility_details": {
"active_product": true,
"has_stock": true
},
"visible": true
}
}
/info/prices
POST /v1/product/info/prices
Получить информацию о цене товара. Swagger
Параметры запроса
Параметры ответа
POST /v1/product/info/prices HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"page": 1,
"page_size": 100
}
Response status 200
{
"result": {
"items": [
{
"commissions": [
{
"deliveryAmount": 0,
"minValue": 0,
"percent": 0,
"returnAmount": 0,
"saleSchema": "string",
"value": 0
}
],
"marketing_actions": {
"actions": [
{
"date_from": "2021-02-03T09:08:26.082Z",
"date_to": "2021-02-03T09:08:26.082Z",
"discountValue": "string",
"title": "string"
}
],
"current_period_from": "2021-02-03T09:08:26.082Z",
"current_period_to": "2021-02-03T09:08:26.082Z",
"ozon_actions_exist": true
},
"offer_id": "string",
"price": {
"buybox_price": "string",
"marketing_price": "string",
"marketing_seller_price": "string",
"min_ozon_price": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"recommended_price": "string",
"retail_price": "string",
"vat": "string"
},
"price_index": "string",
"product_id": 0,
"volume_weight": 0
}
],
"total": 0
}
}
Список товаров
POST /v1/product/list
Позволяет получить список товаров.
Параметры запроса
Параметры ответа
POST /v1/product/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"filter": {
"offer_id": [
"string"
],
"product_id": [
0
],
"visibility": "ALL"
},
"page": 0,
"page_size": 0
}
Response status 200
{
"result": {
"items": [
{
"offer_id": "string",
"product_id": 0
}
],
"total": 0
}
}
Продажа по предоплате
POST /v1/product/prepayment/set
Чтобы включить продажу товара только по предоплате, установите для него значение is_prepayment: true. В запросе обязательно укажите один из идентификаторов товара: product_id или offer_id.
Параметры запроса
Параметры ответа
POST /v1/product/prepayment/set HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"is_prepayment": true,
"offers_ids": [
"string"
],
"products_ids": [
0
]
}
Response status 200
{
"result": {
"item_updated": [
{
"offer_id": "string",
"product_id": 0,
"success": true
}
]
}
}
/unarchive
POST /v1/product/unarchive
Вернуть товар из архива. Swagger
Параметры запроса
Параметры ответа
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
}
}
Work with products
POST /v1/product/archive HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"product_id": [
14929,
244206,
458202,
710646
]
}
Response status 200
{
"result": true
}
/certificate/accordance-types
GET /v1/product/certificate/accordance-types
Directory of accordance types. Swagger
Параметры ответа
POST /v1/product/certificate/accordance-types HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
Can not resolve examples/v1/product/certificate/accordance-type/out.json
/certificate/bind
POST /v1/product/certificate/bind
Bind the certificate to the product. Swagger
Параметры запроса
Параметры ответа
POST /v1/product/certificate/bind HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"certificate_id": 0,
"item_id": [
0
]
}
/certificate/create
POST /v1/product/certificate/create
Method for adding certificates for products. Swagger
Параметры запроса
Параметры ответа
POST /v1/product/certificate/create HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
{
"id": 123
}
/certificate/types
GET /v1/product/certificate/types
Directory of document types. Swagger
Параметры ответа
POST /v1/product/certificate/types HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{}
Response status 200
{
"result": [
{
"name": "string",
"value": "string"
}
]
}
/certification/list
POST /v1/product/certification/list
Выводит список сертифицируемых категорий. Swagger
Параметры запроса
Параметры ответа
POST /v1/product/certification/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"page": 0,
"page_size": 0
}
Response status 200
{
"result": {
"certification": [
{
"category_name": "string",
"is_required": true
}
],
"total": 0
}
}
/import-by-sku
POST /v1/product/import-by-sku
Создает товар по указанному Ozon ID. Количество товарова не ограничено. Вам нужно заполнить поля offer_id, price, sku, vat. Swagger
Параметры запроса
Параметры ответа
POST /v1/product/import-by-sku HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"items": [
{
"name": "string",
"offer_id": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"sku": 0,
"vat": "string"
}
]
}
Response status 200
{
"result": {
"task_id": 0,
"unmatched_sku_list": [
0
]
}
}
/import/info
POST /v1/product/import/info
Get the status of creating a PDP (product description page).
Параметры запроса
Параметры ответа
POST /v1/product/import/info HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"task_id": 0
}
Response status 200
{
"result": {
"items": [
{
"offer_id": "string",
"product_id": 0,
"status": "string"
}
],
"total": 0
}
}
Update price
POST /v1/product/import/prices
Allows you to change the price of one or more products. You can change the prices for 1000 products in one request. To reset old_price or premium_price, set these parameters to 0.
Параметры запроса
Параметры ответа
POST /v1/product/import/prices HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"prices": [
{
"offer_id": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"product_id": 0
}
]
}
Response status 200
{
"result": [
{
"errors": [
{
"code": "string",
"message": "string"
}
],
"offer_id": "string",
"product_id": 0,
"updated": true
}
]
}
/info/description
POST /v1/product/info/description
Возвращает описание товара. Swagger
Параметры запроса
Параметры ответа
POST /v1/product/info/description HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"offer_id": "string",
"product_id": 0
}
Response status 200
{
"result": {
"description": "string",
"id": 0,
"name": "string",
"offer_id": "string"
}
}
/info/prices
POST /v1/product/info/prices
Get information about the product price. Swagger
Параметры запроса
Параметры ответа
POST /v1/product/info/prices HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"page": 1,
"page_size": 100
}
Response status 200
{
"result": {
"items": [
{
"commissions": [
{
"deliveryAmount": 0,
"minValue": 0,
"percent": 0,
"returnAmount": 0,
"saleSchema": "string",
"value": 0
}
],
"marketing_actions": {
"actions": [
{
"date_from": "2021-02-03T09:08:26.082Z",
"date_to": "2021-02-03T09:08:26.082Z",
"discountValue": "string",
"title": "string"
}
],
"current_period_from": "2021-02-03T09:08:26.082Z",
"current_period_to": "2021-02-03T09:08:26.082Z",
"ozon_actions_exist": true
},
"offer_id": "string",
"price": {
"buybox_price": "string",
"marketing_price": "string",
"marketing_seller_price": "string",
"min_ozon_price": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"recommended_price": "string",
"retail_price": "string",
"vat": "string"
},
"price_index": "string",
"product_id": 0,
"volume_weight": 0
}
],
"total": 0
}
}
POST /v1/product/unarchive HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"product_id": [
14929,
244206,
458202,
710646
]
}
Response status 200
{
"result": true
}
/update
POST /v1/product/update
Change the data on the PDP, except for the price and number of items in the warehouses.
Параметры запроса
Параметры ответа
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
}
]
}
/update
POST /v1/products/update
Метод для обновления информации о товаре. Количество не ограничено.
Параметры запроса
Параметры ответа
POST /v1/products/update HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"attributes": [
{
"collection": [
"string"
],
"complex": [
{
"id": 0,
"value": "string"
}
],
"complex_collection": [
{
"collection": [
{
"id": 0,
"value": "string"
}
]
}
],
"id": 0,
"value": "string"
}
],
"barcode": "string",
"depth": 0,
"description": "string",
"dimension_unit": "string",
"height": 0,
"images": [
{
"default": true,
"file_name": "string"
}
],
"name": "string",
"product_id": 0,
"vendor": "string",
"vendor_code": "string",
"weight": 0,
"weight_unit": "string",
"width": 0
}
Response status 200
{
"result": [
{
"errors": [
{
"code": "string",
"message": "string"
}
],
"offer_id": "string",
"product_id": 0,
"updated": true
}
]
}
v1 Products and prices
/prices
POST /v1/products/prices
Update product prices.
Параметры запроса
Параметры ответа
POST /v1/products/prices HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"prices": [
{
"offer_id": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"product_id": 0
}
]
}
Response status 200
{
"result": [
{
"errors": [
{
"code": "string",
"message": "string"
}
],
"offer_id": "string",
"product_id": 0,
"updated": true
}
]
}
/stocks
POST /v1/products/stocks
Method for updating the number of products. It is not recommended to update more than 500 products in a single request.
Параметры запроса
Параметры ответа
POST /v1/products/stocks HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"stocks": [
{
"offer_id": "string",
"product_id": 0,
"stock": 0
}
]
}
Response status 200
{
"result": [
{
"errors": [
{
"code": "string",
"message": "string"
}
],
"offer_id": "string",
"product_id": 0,
"updated": true
}
]
}
Информация о товаре.
GET /v1/products/info/{product_id}
Позволяет получить информацию о товаре.
URI Parameters
Параметры запроса
Параметры ответа
GET /v1/products/info/{product_id} HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
Response status 200
{
"result": {
"barcode": "string",
"buybox_price": "string",
"category_id": 0,
"created_at": "2021-03-25T17:37:39.802Z",
"id": 0,
"images": [
"string"
],
"marketing_price": "string",
"min_ozon_price": "string",
"name": "string",
"offer_id": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"recommended_price": "string",
"sku": 0,
"sources": [
{
"is_enabled": true,
"sku": 0,
"source": "string"
}
],
"state": "string",
"stock": 0,
"stocks": {
"coming": 0,
"present": 0,
"reserved": 0
},
"validation_errors": [
{
"code": "string",
"error": "string",
"field": "string"
}
],
"vat": "string",
"visibility_details": {
"active_product": true,
"has_stock": true
},
"visible": true
}
}
/v2/product
/import
POST /v2/product/import
Загрузите свои товары на Ozon. В одном запросе можно передать до 100 товаров. Каждый товар — это отдельный элемент в массиве items. Укажите всю информацию о товаре: его характеристики, штрихкод, изображения, габариты и цену.
Характеристики зависят от категории товара — вы можете посмотреть список обязательных характеристик для некоторых категорий в Помощи или методом POST /v2/category/attribute.
После модерации товар появится в вашем личном кабинете, но не будет виден пользователям, пока вы не выставите его на продажу.
Каждый товар в запросе — отдельный элемент массива items.
Параметры запроса
Параметры ответа
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/list
POST /v2/product/info/list
Информация о списке товаров. Чтобы получить массив товаров по их идентификаторам, можно использовать метод POST v2/product/info/list. В теле запроса должен быть массив однотипных идентификаторов, в ответе будет массив items. Внутри items для каждого отправления поля совпадают с POST v2/product/info/. Swagger
Параметры запроса
Параметры ответа
POST /v2/product/info/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"offer_id": [
"string"
],
"product_id": [
0
],
"sku": [
0
]
}
Response status 200
{
"result": {
"items": [
{
"barcode": "string",
"buybox_price": "string",
"category_id": 0,
"created_at": "2021-03-25T12:02:19.901Z",
"errors": [
{
"attribute_id": 0,
"code": "string",
"field": "string",
"level": "string"
}
],
"id": 0,
"images": [
"string"
],
"marketing_price": "string",
"min_ozon_price": "string",
"name": "string",
"offer_id": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"price_index": "string",
"recommended_price": "string",
"sources": [
{
"is_enabled": true,
"sku": 0,
"source": "string"
}
],
"state": "string",
"stocks": {
"coming": 0,
"present": 0,
"reserved": 0
},
"vat": "string",
"visibility_details": {
"active_product": true,
"has_price": true,
"has_stock": true,
"reasons": {
"additionalProp1": {
"reasons": [
{
"description": "string",
"id": 0
}
]
},
"additionalProp2": {
"reasons": [
{
"description": "string",
"id": 0
}
]
},
"additionalProp3": {
"reasons": [
{
"description": "string",
"id": 0
}
]
}
}
},
"visible": true
}
]
}
}
/info/stocks
POST /v2/product/info/stocks
Информация о товарах. Количество задается в запросе. Swagger
Параметры запроса
Параметры ответа
POST /v2/product/info/stocks HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"page": 0,
"page_size": 0
}
Response status 200
{
"result": {
"items": [
{
"offer_id": "string",
"product_id": 0,
"stocks": [
{
"present": 0,
"reserved": 0,
"type": "string"
}
]
}
],
"total": 0
}
}
v2 Products and prices
/import
POST /v2/product/import
Upload your products to Ozon. You can send up to 100 products in a single request. Each product is a separate item in the items array. Specify all the information about the product: its characteristics, barcode, images, dimensions and price.
The characteristics depend on the product category — you can see the list of required characteristics for some categories using the method POST /v2/category/attribute.
After moderation, the product will appear in your personal account, but will not be visible to customers until you put it up for sale.
Параметры запроса
Параметры ответа
POST /v2/product/import HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"items": [
{
"attributes": [
{
"complex_id": 0,
"id": 0,
"values": [
{
"dictionary_value_id": 0,
"value": "string"
}
]
}
],
"barcode": "string",
"category_id": 0,
"complex_attributes": [
{
"attributes": [
{
"complex_id": 0,
"id": 0,
"values": [
{
"dictionary_value_id": 0,
"value": "string"
}
]
}
]
}
],
"depth": 0,
"dimension_unit": "string",
"height": 0,
"image_group_id": "string",
"images": [
"string"
],
"images360": [
"string"
],
"name": "string",
"offer_id": "string",
"old_price": "string",
"pdf_list": [
{
"index": 0,
"name": "string",
"src_url": "string"
}
],
"premium_price": "string",
"price": "string",
"vat": "string",
"weight": 0,
"weight_unit": "string",
"width": 0
}
]
}
Response status 200
{
"result": {
"task_id": 0
}
}
/info
POST /v2/product/info
Product details. Swagger
Параметры запроса
Параметры ответа
POST /v2/product/info HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"offer_id": "107112",
"product_id": 15214026,
"sku": 0
}
Response status 200
{
"result": {
"barcode": "string",
"buybox_price": "string",
"category_id": 0,
"commissions": [
{
"deliveryAmount": 0,
"minValue": 0,
"percent": 0,
"returnAmount": 0,
"salaeSchema": "string",
"value": 0
}
],
"created_at": "2021-02-05T07:08:17.131Z",
"errors": [
{
"attribute_id": 0,
"code": "string",
"field": "string",
"level": "string"
}
],
"id": 0,
"images": [
"string"
],
"marketing_price": "string",
"min_ozon_price": "string",
"name": "string",
"offer_id": "string",
"old_price": "string",
"premium_price": "string",
"price": "string",
"price_index": "string",
"recommended_price": "string",
"sources": [
{
"is_enabled": true,
"sku": 0,
"source": "string"
}
],
"state": "string",
"stocks": {
"coming": 0,
"present": 0,
"reserved": 0
},
"vat": "string",
"visibility_details": {
"active_product": true,
"has_price": true,
"has_stock": true
},
"visible": true,
"volume_weight": 0
}
}
/info/stocks
POST /v2/product/info/stocks
Information about products. The quantity is specified in the request. Swagger
Параметры запроса
Параметры ответа
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
/v2/products
/delete
POST /v2/products/delete
Method for deleting products without an SKU from the archive. Up to 1000 IDs can be sent in a single request.
Параметры запроса
Параметры ответа
POST /v2/products/delete HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
}
Response status 200
{
}
/stocks
POST /v2/products/stocks
Method for updating the number of products in warehouses. Swagger
Параметры запроса
Параметры ответа
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
}
]
}
Shipment status
Methods for changing the status of shipments manually, and assigning tracking numbers.
/delivered
POST /v2/fbs/posting/delivered
Change to "Delivered", if you use a third-party delivery service.
Swagger
Параметры запроса
Параметры ответа
POST /v2/posting/fbs/delivered HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"posting_number": [
"string"
]
}
Response status 200
{
"result": [
{
"error": "string",
"posting_number": "string",
"result": true
}
]
}
/delivering
POST /v2/fbs/posting/delivering
Change to "In Transit", if you use a third-party delivery service.
Swagger
Параметры запроса
Параметры ответа
POST /v2/posting/fbs/delivering HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"posting_number": [
"string"
]
}
Response status 200
{
"result": [
{
"error": "string",
"posting_number": "string",
"result": true
}
]
}
/last-mile
POST /v2/fbs/posting/last-mile
Change to "Courier is on the way", if you use a third-party delivery service.
Swagger
Параметры запроса
Параметры ответа
POST /v2/fbs/posting/last-mile HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"posting_number": [
"string"
]
}
Response status 200
{
"result": [
{
"error": "string",
"posting_number": "string",
"result": true
}
]
}
/tracking-number/set
POST /v2/fbs/posting/tracking-number/set
Assign tracking numbers to shipments.
Swagger
Параметры запроса
Параметры ответа
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": {
"additional_data": [
{
"key": "string",
"value": "string"
}
],
"addressee": {
"name": "string",
"phone": "string"
},
"analytics_data": {
"city": "string",
"delivery_date_begin": "2021-04-09T08:18:29.541Z",
"delivery_date_end": "2021-04-09T08:18:29.541Z",
"delivery_type": "string",
"is_premium": true,
"payment_type_group_name": "string",
"region": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"barcodes": {
"lower_barcode": "string",
"upper_barcode": "string"
},
"cancellation": {
"affect_cancellation_rating": true,
"cancel_reason": "string",
"cancel_reason_id": 0,
"cancellation_initiator": "string",
"cancellation_type": "string",
"cancelled_after_ship": true
},
"customer": {
"address": {
"address_tail": "string",
"city": "string",
"comment": "string",
"country": "string",
"district": "string",
"latitude": 0,
"longitude": 0,
"pvz_code": 0,
"region": "string",
"zip_code": "string"
},
"customer_email": "string",
"customer_id": 0,
"name": "string",
"phone": "string"
},
"delivering_date": "2021-04-09T08:18:29.541Z",
"delivery_method": {
"id": 0,
"name": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"delivery_price": "string",
"financial_data": {
"products": [
{
"actions": [
"string"
],
"client_price": "string",
"commission_amount": 0,
"commission_percent": 0,
"old_price": 0,
"payout": 0,
"picking": {
"amount": 0,
"moment": "2021-04-09T08:18:29.541Z",
"tag": "string"
},
"price": 0,
"product_id": 0,
"quantity": 0,
"total_discount_percent": 0,
"total_discount_value": 0
}
]
},
"in_process_at": "2021-04-09T08:18:29.541Z",
"order_id": 0,
"order_number": "string",
"posting_number": "string",
"products": [
{
"dimensions": {
"height": "string",
"length": "string",
"weight": "string",
"width": "string"
},
"mandatory_mark": [
"string"
],
"name": "string",
"offer_id": "string",
"price": "string",
"quantity": 0,
"sku": 0
}
],
"provider_status": "string",
"shipment_date": "2021-04-09T08:18:29.541Z",
"status": "string",
"tpl_integration_type": "string",
"tracking_number": "string"
}
}
/list
POST /v3/posting/fbs/list
Параметры запроса
Параметры ответа
POST /v3/posting/fbs/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"dir": "string",
"filter": {
"delivery_method_id": [
0
],
"order_id": 0,
"provider_id": [
0
],
"since": "2020-12-09T18:53:03.052Z",
"status": "string",
"to": "2020-12-09T18:53:03.052Z",
"warehouse_id": [
0
]
},
"limit": 0,
"offset": 0,
"with": {
"analytics_data": true,
"barcodes": true,
"financial_data": true
}
}
Response status 200
{
"result": {
"has_next": true,
"postings": [
{
"addressee": {
"name": "string",
"phone": "string"
},
"analytics_data": {
"city": "string",
"delivery_date_begin": "2021-04-09T08:09:19.463Z",
"delivery_date_end": "2021-04-09T08:09:19.463Z",
"delivery_type": "string",
"is_premium": true,
"payment_type_group_name": "string",
"region": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"barcodes": {
"lower_barcode": "string",
"upper_barcode": "string"
},
"cancellation": {
"affect_cancellation_rating": true,
"cancel_reason": "string",
"cancel_reason_id": 0,
"cancellation_initiator": "string",
"cancellation_type": "string",
"cancelled_after_ship": true
},
"customer": {
"address": {
"address_tail": "string",
"city": "string",
"comment": "string",
"country": "string",
"district": "string",
"latitude": 0,
"longitude": 0,
"pvz_code": 0,
"region": "string",
"zip_code": "string"
},
"customer_email": "string",
"customer_id": 0,
"name": "string",
"phone": "string"
},
"delivering_date": "2021-04-09T08:09:19.463Z",
"delivery_method": {
"id": 0,
"name": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"financial_data": {
"products": [
{
"actions": [
"string"
],
"client_price": "string",
"commission_amount": 0,
"commission_percent": 0,
"old_price": 0,
"payout": 0,
"picking": {
"amount": 0,
"moment": "2021-04-09T08:09:19.463Z",
"tag": "string"
},
"price": 0,
"product_id": 0,
"quantity": 0,
"total_discount_percent": 0,
"total_discount_value": 0
}
]
},
"in_process_at": "2021-04-09T08:09:19.463Z",
"order_id": 0,
"order_number": "string",
"posting_number": "string",
"products": [
{
"mandatory_mark": [
"string"
],
"name": "string",
"offer_id": "string",
"price": "string",
"quantity": 0,
"sku": 0
}
],
"shipment_date": "2021-04-09T08:09:19.463Z",
"status": "string",
"tpl_integration_type": "string",
"tracking_number": "string"
}
]
}
}
/unfulfilled/list
POST /v3/posting/fbs/unfulfilled/list
Параметры запроса
Параметры ответа
POST /v3/posting/fbs/unfulfilled/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"dir": "string",
"filter": {
"cutoff_from": "2020-12-09T19:05:41.040Z",
"cutoff_to": "2020-12-09T19:05:41.040Z",
"delivering_date_from": "2020-12-09T19:05:41.040Z",
"delivering_date_to": "2020-12-09T19:05:41.040Z",
"delivery_method_id": [
0
],
"provider_id": [
0
],
"status": "string",
"warehouse_id": [
0
]
},
"limit": 0,
"offset": 0,
"with": {
"analytics_data": true,
"barcodes": true,
"financial_data": true
}
}
Response status 200
{
"result": {
"count": 0,
"postings": [
{
"addressee": {
"name": "string",
"phone": "string"
},
"analytics_data": {
"city": "string",
"delivery_date_begin": "2021-04-09T07:39:22.867Z",
"delivery_date_end": "2021-04-09T07:39:22.867Z",
"delivery_type": "string",
"is_premium": true,
"payment_type_group_name": "string",
"region": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"barcodes": {
"lower_barcode": "string",
"upper_barcode": "string"
},
"cancellation": {
"affect_cancellation_rating": true,
"cancel_reason": "string",
"cancel_reason_id": 0,
"cancellation_initiator": "string",
"cancellation_type": "string",
"cancelled_after_ship": true
},
"customer": {
"address": {
"address_tail": "string",
"city": "string",
"comment": "string",
"country": "string",
"district": "string",
"latitude": 0,
"longitude": 0,
"pvz_code": 0,
"region": "string",
"zip_code": "string"
},
"customer_email": "string",
"customer_id": 0,
"name": "string",
"phone": "string"
},
"delivering_date": "2021-04-09T07:39:22.868Z",
"delivery_method": {
"id": 0,
"name": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"financial_data": {
"products": [
{
"actions": [
"string"
],
"client_price": "string",
"commission_amount": 0,
"commission_percent": 0,
"old_price": 0,
"payout": 0,
"picking": {
"amount": 0,
"moment": "2021-04-09T07:39:22.868Z",
"tag": "string"
},
"price": 0,
"product_id": 0,
"quantity": 0,
"total_discount_percent": 0,
"total_discount_value": 0
}
]
},
"in_process_at": "2021-04-09T07:39:22.868Z",
"order_id": 0,
"order_number": "string",
"posting_number": "string",
"products": [
{
"mandatory_mark": [
"string"
],
"name": "string",
"offer_id": "string",
"price": "string",
"quantity": 0,
"sku": 0
}
],
"shipment_date": "2021-04-09T07:39:22.868Z",
"status": "string",
"tpl_integration_type": "string",
"tracking_number": "string"
}
]
}
}
Shipment details
/get
POST /v3/posting/fbs/get
Get shipment details. Swagger
Параметры запроса
Параметры ответа
POST /v3/posting/fbs/get HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"posting_number": "string",
"with": {
"analytics_data": true,
"barcodes": true,
"financial_data": true
}
}
Response status 200
{
"result": {
"additional_data": [
{
"key": "string",
"value": "string"
}
],
"addressee": {
"name": "string",
"phone": "string"
},
"analytics_data": {
"city": "string",
"delivery_date_begin": "2021-04-09T08:18:29.541Z",
"delivery_date_end": "2021-04-09T08:18:29.541Z",
"delivery_type": "string",
"is_premium": true,
"payment_type_group_name": "string",
"region": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"barcodes": {
"lower_barcode": "string",
"upper_barcode": "string"
},
"cancellation": {
"affect_cancellation_rating": true,
"cancel_reason": "string",
"cancel_reason_id": 0,
"cancellation_initiator": "string",
"cancellation_type": "string",
"cancelled_after_ship": true
},
"customer": {
"address": {
"address_tail": "string",
"city": "string",
"comment": "string",
"country": "string",
"district": "string",
"latitude": 0,
"longitude": 0,
"pvz_code": 0,
"region": "string",
"zip_code": "string"
},
"customer_email": "string",
"customer_id": 0,
"name": "string",
"phone": "string"
},
"delivering_date": "2021-04-09T08:18:29.541Z",
"delivery_method": {
"id": 0,
"name": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"delivery_price": "string",
"financial_data": {
"products": [
{
"actions": [
"string"
],
"client_price": "string",
"commission_amount": 0,
"commission_percent": 0,
"old_price": 0,
"payout": 0,
"picking": {
"amount": 0,
"moment": "2021-04-09T08:18:29.541Z",
"tag": "string"
},
"price": 0,
"product_id": 0,
"quantity": 0,
"total_discount_percent": 0,
"total_discount_value": 0
}
]
},
"in_process_at": "2021-04-09T08:18:29.541Z",
"order_id": 0,
"order_number": "string",
"posting_number": "string",
"products": [
{
"dimensions": {
"height": "string",
"length": "string",
"weight": "string",
"width": "string"
},
"mandatory_mark": [
"string"
],
"name": "string",
"offer_id": "string",
"price": "string",
"quantity": 0,
"sku": 0
}
],
"provider_status": "string",
"shipment_date": "2021-04-09T08:18:29.541Z",
"status": "string",
"tpl_integration_type": "string",
"tracking_number": "string"
}
}
/list
POST /v3/posting/fbs/list
Параметры запроса
Параметры ответа
POST /v3/posting/fbs/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"dir": "string",
"filter": {
"delivery_method_id": [
0
],
"order_id": 0,
"provider_id": [
0
],
"since": "2020-12-09T18:53:03.052Z",
"status": "string",
"to": "2020-12-09T18:53:03.052Z",
"warehouse_id": [
0
]
},
"limit": 0,
"offset": 0,
"with": {
"analytics_data": true,
"barcodes": true,
"financial_data": true
}
}
Response status 200
{
"result": {
"has_next": true,
"postings": [
{
"addressee": {
"name": "string",
"phone": "string"
},
"analytics_data": {
"city": "string",
"delivery_date_begin": "2021-04-09T08:09:19.463Z",
"delivery_date_end": "2021-04-09T08:09:19.463Z",
"delivery_type": "string",
"is_premium": true,
"payment_type_group_name": "string",
"region": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"barcodes": {
"lower_barcode": "string",
"upper_barcode": "string"
},
"cancellation": {
"affect_cancellation_rating": true,
"cancel_reason": "string",
"cancel_reason_id": 0,
"cancellation_initiator": "string",
"cancellation_type": "string",
"cancelled_after_ship": true
},
"customer": {
"address": {
"address_tail": "string",
"city": "string",
"comment": "string",
"country": "string",
"district": "string",
"latitude": 0,
"longitude": 0,
"pvz_code": 0,
"region": "string",
"zip_code": "string"
},
"customer_email": "string",
"customer_id": 0,
"name": "string",
"phone": "string"
},
"delivering_date": "2021-04-09T08:09:19.463Z",
"delivery_method": {
"id": 0,
"name": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"financial_data": {
"products": [
{
"actions": [
"string"
],
"client_price": "string",
"commission_amount": 0,
"commission_percent": 0,
"old_price": 0,
"payout": 0,
"picking": {
"amount": 0,
"moment": "2021-04-09T08:09:19.463Z",
"tag": "string"
},
"price": 0,
"product_id": 0,
"quantity": 0,
"total_discount_percent": 0,
"total_discount_value": 0
}
]
},
"in_process_at": "2021-04-09T08:09:19.463Z",
"order_id": 0,
"order_number": "string",
"posting_number": "string",
"products": [
{
"mandatory_mark": [
"string"
],
"name": "string",
"offer_id": "string",
"price": "string",
"quantity": 0,
"sku": 0
}
],
"shipment_date": "2021-04-09T08:09:19.463Z",
"status": "string",
"tpl_integration_type": "string",
"tracking_number": "string"
}
]
}
}
/unfulfilled/list
POST /v3/posting/fbs/unfulfilled/list
Параметры запроса
Параметры ответа
POST /v3/posting/fbs/unfulfilled/list HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json
{
"dir": "string",
"filter": {
"cutoff_from": "2020-12-09T19:05:41.040Z",
"cutoff_to": "2020-12-09T19:05:41.040Z",
"delivering_date_from": "2020-12-09T19:05:41.040Z",
"delivering_date_to": "2020-12-09T19:05:41.040Z",
"delivery_method_id": [
0
],
"provider_id": [
0
],
"status": "string",
"warehouse_id": [
0
]
},
"limit": 0,
"offset": 0,
"with": {
"analytics_data": true,
"barcodes": true,
"financial_data": true
}
}
Response status 200
{
"result": {
"count": 0,
"postings": [
{
"addressee": {
"name": "string",
"phone": "string"
},
"analytics_data": {
"city": "string",
"delivery_date_begin": "2021-04-09T07:39:22.867Z",
"delivery_date_end": "2021-04-09T07:39:22.867Z",
"delivery_type": "string",
"is_premium": true,
"payment_type_group_name": "string",
"region": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"barcodes": {
"lower_barcode": "string",
"upper_barcode": "string"
},
"cancellation": {
"affect_cancellation_rating": true,
"cancel_reason": "string",
"cancel_reason_id": 0,
"cancellation_initiator": "string",
"cancellation_type": "string",
"cancelled_after_ship": true
},
"customer": {
"address": {
"address_tail": "string",
"city": "string",
"comment": "string",
"country": "string",
"district": "string",
"latitude": 0,
"longitude": 0,
"pvz_code": 0,
"region": "string",
"zip_code": "string"
},
"customer_email": "string",
"customer_id": 0,
"name": "string",
"phone": "string"
},
"delivering_date": "2021-04-09T07:39:22.868Z",
"delivery_method": {
"id": 0,
"name": "string",
"tpl_provider": "string",
"tpl_provider_id": 0,
"warehouse": "string",
"warehouse_id": 0
},
"financial_data": {
"products": [
{
"actions": [
"string"
],
"client_price": "string",
"commission_amount": 0,
"commission_percent": 0,
"old_price": 0,
"payout": 0,
"picking": {
"amount": 0,
"moment": "2021-04-09T07:39:22.868Z",
"tag": "string"
},
"price": 0,
"product_id": 0,
"quantity": 0,
"total_discount_percent": 0,
"total_discount_value": 0
}
]
},
"in_process_at": "2021-04-09T07:39:22.868Z",
"order_id": 0,
"order_number": "string",
"posting_number": "string",
"products": [
{
"mandatory_mark": [
"string"
],
"name": "string",
"offer_id": "string",
"price": "string",
"quantity": 0,
"sku": 0
}
],
"shipment_date": "2021-04-09T07:39:22.868Z",
"status": "string",
"tpl_integration_type": "string",
"tracking_number": "string"
}
]
}
}
Информация о транзакциях
Информация о транзакциях за указанный период, по конкретным отправлениями или определенного типа.
/transaction/list
POST /v2/finance/transaction/list
Список транзакций Возвращает подробную информацию по транзакциям для отправления. Если в запросе не указывать posting_number, в ответе будут все отправления за указанный период или определенного типа.
Параметры запроса
Параметры ответа
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"
]
}