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

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

POST /pass/update HTTP/1.1

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

{
  "car_model": "string",
  "car_number": "string",
  "driver_name": "string",
  "driver_patronymic": "string",
  "driver_surname": "string",
  "end_unloading_time": "string",
  "is_regular_pass": true,
  "start_unloading_time": "string",
  "telephone": "string",
  "trailer_number": "string",
  "unload_date": "string"
}

Response status  200

{
  "result": true
}

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

/warehouse/list

POST /v1/warehouse/list

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

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

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

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

is_rfbs boolean

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

POST /v1/warehouse/list HTTP/1.1

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

{}

Response status  200

{
  "result": [
    {
      "warehouse_id": int64,
      "name": "string",
      "is_rfbs": true
    }
  ]
}

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

/list

POST /v1/delivery-method/list

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

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

filter object

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

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

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

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

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

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

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

has_next boolean

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

result object

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

company_id integer

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

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

cutoff string

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

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

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

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

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

template_id integer

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

updated_at datetime

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

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

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

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

date_from datetime

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

date_to datetime

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

dimension string

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

filters object

key string

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

op string

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

value number

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

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

metrics string

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

sort object

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

key string

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

order string

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

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

data object

dimensions string

metrics number

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

totals integer

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

timestamp string

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

POST /v1/analytics/data HTTP/1.1

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

{
  "date_from": "string",
  "date_to": "string",
  "dimension": [
    "string"
  ],
  "filters": [
    {
      "key": "string",
      "op": "EQ",
      "value": "string"
    }
  ],
  "limit": 0,
  "metrics": [
    "string"
  ],
  "offset": 0,
  "sort": [
    {
      "key": "string",
      "order": "ASC"
    }
  ]
}

Response status  200

{
  "result": {
    "data": [
      {
        "dimensions": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "metrics": [
          0
        ]
      }
    ],
    "totals": [
      0
    ]
  },
  "timestamp": "string"
}

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

/company-certification/list

POST /v1/brand/company-certification/list

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

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

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

brand_certification object

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

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

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

brand_id integer

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

brand_name string

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

has_certificate boolean

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

total integer

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

POST /v1/brand/company-certification/list HTTP/1.1

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

{
  "page": 1,
  "page_size": 2
}

Response status  200

{
  "result": {
    "brand_certification": [
      {
        "brand_id": 19709360,
        "brand_name": "Select",
        "has_certificate": false
      },
      {
        "brand_id": 78055689,
        "brand_name": "Start Line",
        "has_certificate": false
      }
    ],
    "total": 2
  }
}

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

/tree

GET /v1/categories/tree

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

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

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

children array

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

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

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]

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

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

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

children array

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

description out.description

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

GET /v1/category/tree/[categoryId] HTTP/1.1

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

Can not resolve examples/v1/categories/tree/categoryId/in.json

Response status  200

Can not resolve examples/v1/category/tree/categoryId/out.json

/tree/[categoryId]/attributes

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

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

child array

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

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

is_collection boolean

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

is_required boolean

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

Название.

option array

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

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

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

Can not resolve examples/v1/categories/tree/categoryId/attributes/in.json

Response status  200

Can not resolve examples/v1/categories/tree/categoryId/attributes/out.json

/v1/category

/tree

POST /v1/category/tree

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

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

category_id * integer

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

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

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

result array

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

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

children array

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

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

POST /v1/category/tree HTTP/1.1

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

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

Response status  200

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

/v2/category

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

/attribute

POST /v2/category/attribute

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

category_id * integer

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

attribute_type string

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

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

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

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

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

description out.description

Название.

group_name out.group_name

is_collection boolean

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

is_required boolean

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

group_id out.group_id

dictionary_id out.dictionary_id

POST /v2/category/attribute HTTP/1.1

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

{
  "attribute_type": "ALL",
  "category_id": 0,
  "language": "DEFAULT"
}

Response status  200

{
  "result": [
    {
      "description": "string",
      "dictionary_id": 0,
      "group_id": 0,
      "group_name": "string",
      "id": 0,
      "is_collection": true,
      "is_required": true,
      "name": "string",
      "type": "string"
    }
  ]
}

/attribute/values

POST /v2/category/attribute/values

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

category_id * integer

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

attribute_id * in.attribute_id

last_value_id in.last_value_id

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

attribute_id in.attribute_id

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

POST /v2/category/attribute HTTP/1.1

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

{
  "category_id": 17036076,
  "attribute_id": 8229,
  "language": "EN",
  "last_value_id": 0,
  "limit": 1
}

/value/by-option

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

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

options in.options

option_id in.option_id

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

POST /v2/category/attribute HTTP/1.1

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

{
  "options": [
    {
      "attribute_id": 8229,
      "option_id": 400
    }
  ],
  "language": "EN"
}

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

/list

POST /v1/chat/list

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

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

chat_id_list string

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

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

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

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

id string

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

last_message_id string

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

users object

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

id string

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

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

POST /v1/chat/list HTTP/1.1

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

{
  "chat_id_list": [
    "string"
  ],
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": [
    {
      "id": "string",
      "last_message_id": "string",
      "users": [
        {
          "id": "string",
          "type": "string"
        }
      ]
    }
  ]
}

/history

POST /v1/chat/history

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

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

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

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

from_message_id string

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

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

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

context object

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

order object

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

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

postings object

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

delivery_schema string

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

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

sku_list array

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

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

file object

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

mime string

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

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

size integer

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

url string

URL файла.

text string

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

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

user array

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

POST /v1/chat/history/ HTTP/1.1

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

{
  "chat_id": "3cdf5407-9f90-4752-8105-8f1d4cd427f5",
  "from_message_id": "986714",
  "limit": 10
}

Response status  200

{
  "result": [
    {
      "context": {
        "item": {
          "sku": 0
        },
        "order": {
          "order_number": "123456-0001",
          "postings": [
            {
              "delivery_schema": "fbs",
              "posting_number": "13076543-0001-1",
              "sku_list": [
                149512345
              ]
            }
          ]
        }
      },
      "created_at": "2019-11-25T10:43:06.518Z",
      "file": {
        "mime": "image/jpeg",
        "name": "32679625.jpg",
        "size": 815313,
        "url": "http://api-seller.ozon.ru/v1/chat/file/3cdf5407-9f90-4752-8105-8f1d4cd427f563f87e6da3651007ab96185f38772032b3918e31.jpg",
      },
      "id": "1931356687558511593",
      "text": "hello",
      "type": "file",
      "user": {
        "id": "30735682",
        "type": "customer"
      }
    }
  ]
}

/send/file

POST /v1/chat/send/file

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

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

base64_content string

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

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

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

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

result string

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

POST /v1/chat/send/file HTTP/1.1

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

{
  "base64_content": "string",
  "chat_id": "string",
  "name": "string"
}

Response status  200

{
  "result": "string"
}

/send/message

POST /v1/chat/send/message

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

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

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

text string

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

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

result string

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

POST /v1/chat/send/message HTTP/1.1

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

{
  "chat_id": "string",
  "text": "string"
}

Response status  200

{
  "result": "string"
}

/start

POST /v1/chat/start

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

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

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

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

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

POST /v1/chat/start HTTP/1.1

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

{
  "posting_number": "string"
}

Response status  200

{
  "result": {
    "chat_id": "string"
  }
}

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

/archive

POST /v1/product/archive

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

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

product_id * integer

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

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

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

POST /v1/product/archive HTTP/1.1

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

{
  "product_id": [
    14929,
    244206,
    458202,
    710646
  ]
}

Response status  200

{
  "result": true
}

/certificate/accordance-types

GET /v1/product/certificate/accordance-types

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

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

result object

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

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

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

POST /v1/product/certificate/accordance-types HTTP/1.1

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

{}

Response status  200

Can not resolve examples/v1/product/certificate/accordance-type/out.json

/certificate/bind

POST /v1/product/certificate/bind

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

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

certificate_id integer

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

item_id integer

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

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

accordance_type_code * string

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

POST /v1/product/certificate/bind HTTP/1.1

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

{
  "certificate_id": 0,
  "item_id": [
    0
  ]
}

/certificate/create

POST /v1/product/certificate/create

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

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

files * array

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

name * string

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

number * string

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

type_code * string

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

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

issue_date * datetime

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

expire_date datetime

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

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

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

POST /v1/product/certificate/create HTTP/1.1

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

{}

Response status  200

{
  "id": 123
}

/certificate/types

GET /v1/product/certificate/types

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

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

result object

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

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

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

POST /v1/product/certificate/types HTTP/1.1

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

{}

Response status  200

{
  "result": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

/import/info

POST /v1/product/import/info

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

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

task_id integer

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

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

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

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

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

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

total string

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

POST /v1/product/import/info HTTP/1.1

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

{
  "task_id": 0
}

Response status  200

{
  "result": {
    "items": [
      {
        "offer_id": "string",
        "product_id": 0,
        "status": "string"
      }
    ],
    "total": 0
  }
}

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

POST /v1/product/import/prices

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

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

prices object

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

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

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

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

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

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

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

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

Код ошибки.

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

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

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

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

POST /v1/product/import/prices HTTP/1.1

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

{
  "prices": [
    {
      "offer_id": "string",
      "old_price": "string",
      "premium_price": "string",
      "price": "string",
      "product_id": 0
    }
  ]
}

Response status  200

{
  "result": [
    {
      "errors": [
        {
          "code": "string",
          "message": "string"
        }
      ],
      "offer_id": "string",
      "product_id": 0,
      "updated": true
    }
  ]
}

/info/prices

POST /v1/product/info/prices

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

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

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

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

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

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

commissions object

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

deliveryAmount integer

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

minValue integer

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

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

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

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

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

marketing_actions object

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

actions object

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

date_from datetime

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

date_to datetime

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

discountValue string

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

current_period_from datetime

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

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

current_period_to datetime

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

ozon_actions_exist boolean

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

marketing_seller_price string

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

price object

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

buybox_price string

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

marketing_price string

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

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

min_ozon_price string

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

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

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

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

recommended_price string

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

retail_price string

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

vat string

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

price_index string

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

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

volume_weight integer

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

total integer

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

POST /v1/product/info/prices HTTP/1.1

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

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

Response status  200

{
  "result": {
    "items": [
      {
        "commissions": [
          {
            "deliveryAmount": 0,
            "minValue": 0,
            "percent": 0,
            "returnAmount": 0,
            "saleSchema": "string",
            "value": 0
          }
        ],
        "marketing_actions": {
          "actions": [
            {
              "date_from": "2021-02-03T09:08:26.082Z",
              "date_to": "2021-02-03T09:08:26.082Z",
              "discountValue": "string",
              "title": "string"
            }
          ],
          "current_period_from": "2021-02-03T09:08:26.082Z",
          "current_period_to": "2021-02-03T09:08:26.082Z",
          "ozon_actions_exist": true
        },
        "offer_id": "string",
        "price": {
          "buybox_price": "string",
          "marketing_price": "string",
          "marketing_seller_price": "string",
          "min_ozon_price": "string",
          "old_price": "string",
          "premium_price": "string",
          "price": "string",
          "recommended_price": "string",
          "retail_price": "string",
          "vat": "string"
        },
        "price_index": "string",
        "product_id": 0,
        "volume_weight": 0
      }
    ],
    "total": 0
  }
}

/unarchive

POST /v1/product/unarchive

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

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

product_id * integer

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

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

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

POST /v1/product/unarchive HTTP/1.1

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

{
  "product_id": [
    14929,
    244206,
    458202,
    710646
  ]
}

Response status  200

{
  "result": true
}

/update

POST /v1/product/update

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

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

product_id * integer

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

barcode string

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

description string

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

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

vendor string

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

vendor_code string

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

height integer

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

depth integer

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

width integer

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

dimension_unit string

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

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

weight integer

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

weight_unit string

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

images object

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

file_name string

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

default_img in.bool

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

attributes object

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

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

complex_collection object

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

collection array

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

complex array

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

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

collection array

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

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

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

POST /v1/product/update HTTP/1.1

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

{
  "product_id": 124100,
  "barcode": "8801643566784",
  "description": "Red Samsung Galaxy S10 with 512GB",
  "name": "Samsung Galaxy S10",
  "vendor": "Samsung",
  "vendor_code": "SM-G960UZPAXAA",
  "height": 77,
  "depth": 11,
  "width": 120,
  "dimension_unit": "mm",
  "weight": 120,
  "weight_unit": "g",
  "images": [
    {
      "file_name": "http://pic.com/1.jpg",
      "default": true
    },
    {
      "file_name": "http://pic.com/2.jpg",
      "default": false
    },
    {
      "file_name": "http://pic.com/3.jpg",
      "default": false
    }
  ],
  "attributes": [
    {
      "id": 1,
      "value": "Samsung Galaxy S10"
    },
    {
      "id": 2,
      "collection": [
        "128GB",
        "512GB"
      ]
    },
    {
      "id": 3,
      "complex": [
        {
          "id": 10,
          "value": "Unboxing video"
        },
        {
          "id": 11,
          "value": "http://videos.com/1.mp4"
        }
      ]
    },
    {
      "id": 4,
      "complex_collection": [
        {
          "collection": [
            {
              "id": 10,
              "value": "Additional video"
            },
            {
              "id": 11,
              "value": "http://videos.com/2.mp4"
            }
          ]
        },
        {
          "collection": [
            {
              "id": 10,
              "value": "Another one video"
            },
            {
              "id": 11,
              "value": "http://videos.com/3.mp4"
            }
          ]
        }
      ]
    }
  ]
}

Response status  200

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

/v1/products

/prices

POST /v1/products/prices

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

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

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

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

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

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

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

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

Код ошибки.

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

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

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

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

POST /v1/products/prices HTTP/1.1

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

{
  "prices": [
    {
      "offer_id": "string",
      "old_price": "string",
      "premium_price": "string",
      "price": "string",
      "product_id": 0
    }
  ]
}

Response status  200

{
  "result": [
    {
      "errors": [
        {
          "code": "string",
          "message": "string"
        }
      ],
      "offer_id": "string",
      "product_id": 0,
      "updated": true
    }
  ]
}

/stocks

POST /v1/products/stocks

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

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

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

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

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

stock integer

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

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

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

Код ошибки.

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

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

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

dictionary_value_id integer

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

POST /v1/products/stocks HTTP/1.1

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

{
  "stocks": [
    {
      "offer_id": "string",
      "product_id": 0,
      "stock": 0
    }
  ]
}

Response status  200

{
  "result": [
    {
      "errors": [
        {
          "code": "string",
          "message": "string"
        }
      ],
      "offer_id": "string",
      "product_id": 0,
      "updated": true
    }
  ]
}

/v2/product

/import

POST /v2/product/import

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

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

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

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

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

attributes * object

complex_id integer

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

id* integer

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

values object

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

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

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

barcode string

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

complex_attributes object

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

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

attributes array

depth integer

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

dimension_unit string

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

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

height integer

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

image_group_id string

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

images string

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

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

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

pdf_list array

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

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

vat string

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

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

weight integer

weight_unit string

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

width integer

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

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

task_id integer

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

POST /v2/product/import HTTP/1.1

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

{
  "items": [
    {
      "attributes": [
        {
          "complex_id": 0,
          "id": 0,
          "values": [
            {
              "dictionary_value_id": 0,
              "value": "string"
            }
          ]
        }
      ],
      "barcode": "string",
      "category_id": 0,
      "complex_attributes": [
        {
          "attributes": [
            {
              "complex_id": 0,
              "id": 0,
              "values": [
                {
                  "dictionary_value_id": 0,
                  "value": "string"
                }
              ]
            }
          ]
        }
      ],
      "depth": 0,
      "dimension_unit": "string",
      "height": 0,
      "image_group_id": "string",
      "images": [
        "string"
      ],
      "images360": [
        "string"
      ],
      "name": "string",
      "offer_id": "string",
      "old_price": "string",
      "pdf_list": [
        {
          "index": 0,
          "name": "string",
          "src_url": "string"
        }
      ],
      "premium_price": "string",
      "price": "string",
      "vat": "string",
      "weight": 0,
      "weight_unit": "string",
      "width": 0
    }
  ]
}

Response status  200

{
  "result": {
    "task_id": 0
  }
}

/info

POST /v2/product/info

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

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

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

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

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

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

barcode string

Штрихкод.

buybox_price string

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

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

commissions object

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

deliveryAmount integer

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

minValue integer

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

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

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

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

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

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

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

attribute_id integer

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

Код ошибки.

field string

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

level string

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

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

images array

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

marketing_price string

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

min_ozon_price string

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

Название.

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

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

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

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

price_index string

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

recommended_price string

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

sources object

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

is_enabled boolean

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

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

source string

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

state string

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

visibility_details object

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

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

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

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

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

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

has_price boolean

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

has_stock boolean

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

active_product boolean

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

visible boolean

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

volume_weight integer

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

POST /v2/product/info HTTP/1.1

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

{
  "offer_id": "107112",
  "product_id": 15214026,
  "sku": 0
}

Response status  200

{
  "result": {
    "barcode": "string",
    "buybox_price": "string",
    "category_id": 0,
    "commissions": [
      {
        "deliveryAmount": 0,
        "minValue": 0,
        "percent": 0,
        "returnAmount": 0,
        "salaeSchema": "string",
        "value": 0
      }
    ],
    "created_at": "2021-02-05T07:08:17.131Z",
    "errors": [
      {
        "attribute_id": 0,
        "code": "string",
        "field": "string",
        "level": "string"
      }
    ],
    "id": 0,
    "images": [
      "string"
    ],
    "marketing_price": "string",
    "min_ozon_price": "string",
    "name": "string",
    "offer_id": "string",
    "old_price": "string",
    "premium_price": "string",
    "price": "string",
    "price_index": "string",
    "recommended_price": "string",
    "sources": [
      {
        "is_enabled": true,
        "sku": 0,
        "source": "string"
      }
    ],
    "state": "string",
    "stocks": {
      "coming": 0,
      "present": 0,
      "reserved": 0
    },
    "vat": "string",
    "visibility_details": {
      "active_product": true,
      "has_price": true,
      "has_stock": true
    },
    "visible": true,
    "volume_weight": 0
  }
}

/info/stocks

POST /v2/product/info/stocks

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

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

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

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

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

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

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

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

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

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

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

Тип склада.

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

POST /v2/product/info/stocks HTTP/1.1

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

{
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": {
    "items": [
      {
        "offer_id": "string",
        "product_id": 0,
        "stocks": [
          {
            "present": 0,
            "reserved": 0,
            "type": "string"
          }
        ]
      }
    ],
    "total": 0
  }
}

/v2/products

/delete

POST /v2/products/delete

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

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

products integer

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

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

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

deleted boolean

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

POST /v2/products/delete HTTP/1.1

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

{

}

Response status  200

{

}

/stocks

POST /v2/products/stocks

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

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

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

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

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

stock integer

Количество.

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

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

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

Код ошибки.

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

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

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

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

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

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

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

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

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

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

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

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

POST /v2/posting/fbs/delivered HTTP/1.1

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

{
  "posting_number": [
    "string"
  ]
}

Response status  200

{
  "result": [
    {
      "error": "string",
      "posting_number": "string",
      "result": true
    }
  ]
}

/delivering

POST /v2/fbs/posting/delivering

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

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

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

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

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

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

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

POST /v2/posting/fbs/delivering HTTP/1.1

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

{
  "posting_number": [
    "string"
  ]
}

Response status  200

{
  "result": [
    {
      "error": "string",
      "posting_number": "string",
      "result": true
    }
  ]
}

/last-mile

POST /v2/fbs/posting/last-mile

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

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

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

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

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

tracking_numbers * object

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

POST /v2/fbs/posting/last-mile HTTP/1.1

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

{
  "posting_number": [
    "string"
  ]
}

Response status  200

{
  "result": [
    {
      "error": "string",
      "posting_number": "string",
      "result": true
    }
  ]
}

/tracking-number/set

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

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

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

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

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

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

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

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

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

result array

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

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

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

{
  "tracking_numbers": [
    {
      "posting_number": "string",
      "tracking_number": "string"
    }
  ]
}

Response status  200

{
  "result": [
    {
      "error": "string",
      "posting_number": "string",
      "result": true
    }
  ]
}

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

/get

POST /v3/posting/fbs/get

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

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

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

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

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

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

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

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

addressee object

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

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

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

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

delivery_date_begin datetime

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

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

delivery_date_end datetime

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

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

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

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

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

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

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

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

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

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

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

affect_cancellation_rating boolean

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

cancellation object

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

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

cancel_reason string

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

cancellation_initiator string

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

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

cancellation_type string

Тип отмены.

cancelled_after_ship boolean

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

customer object

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

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

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

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

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

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

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

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

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

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

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

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

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

delivering_date datetime

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

delivery_method object

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

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

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

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

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

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

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

delivery_price string

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

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

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

client_price string

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

width integer

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

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

Название.

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

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

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

provider_status out.provider_status

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

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

tpl_integration_type string

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

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

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

POST /v3/posting/fbs/get HTTP/1.1

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

{
  "posting_number": "string",
  "with": {
    "analytics_data": true,
    "barcodes": true,
    "financial_data": true
  }
}

Response status  200

{
  "result": {
    "addressee": {
      "name": "string",
      "phone": "string"
    },
    "analytics_data": {
      "city": "string",
      "delivery_date_begin": "2020-12-09T17:02:31.626Z",
      "delivery_date_end": "2020-12-09T17:02:31.626Z",
      "delivery_type": "string",
      "is_premium": true,
      "payment_type_group_name": "string",
      "region": "string",
      "tpl_provider": "string",
      "tpl_provider_id": 0,
      "warehouse": "string",
      "warehouse_id": 0
    },
    "barcodes": {
      "lower_barcode": "string",
      "upper_barcode": "string"
    },
    "cancellation": {
      "affect_cancellation_rating": true,
      "cancel_reason": "string",
      "cancel_reason_id": 0,
      "cancellation_initiator": "string",
      "cancellation_type": "string",
      "cancelled_after_ship": true
    },
    "customer": {
      "address": {
        "address_tail": "string",
        "city": "string",
        "comment": "string",
        "country": "string",
        "district": "string",
        "region": "string",
        "zip_code": "string"
      },
      "customer_email": "string",
      "customer_id": 0,
      "name": "string",
      "phone": "string"
    },
    "delivering_date": "2020-12-09T17:02:31.626Z",
    "delivery_method": {
      "id": 0,
      "name": "string",
      "tpl_provider": "string",
      "tpl_provider_id": 0,
      "warehouse": "string",
      "warehouse_id": 0
    },
    "delivery_price": "string",
    "financial_data": {
      "products": [
        {
          "actions": [
            "string"
          ],
          "client_price": "string",
          "commission_amount": 0,
          "commission_percent": 0,
          "old_price": 0,
          "payout": 0,
          "picking": {
            "amount": 0,
            "moment": "2020-12-09T17:02:31.626Z",
            "tag": "string"
          },
          "price": 0,
          "product_id": 0,
          "quantity": 0,
          "total_discount_percent": 0,
          "total_discount_value": 0
        }
      ]
    },
    "in_process_at": "2020-12-09T17:02:31.626Z",
    "order_id": 0,
    "order_number": "string",
    "posting_number": "string",
    "products": [
      {
        "dimensions": {
          "height": "string",
          "length": "string",
          "weight": "string",
          "width": "string"
        },
        "mandatory_mark": [
          "string"
        ],
        "name": "string",
        "offer_id": "string",
        "price": "string",
        "quantity": 0,
        "sku": 0
      }
    ],
    "provider_status": "string",
    "shipment_date": "2020-12-09T17:02:31.626Z",
    "status": "string",
    "tpl_integration_type": "string",
    "tracking_number": "string"
  }
}

/list

POST /v3/posting/fbs/list

delivery_method_id integer

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

dir string

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

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

filter object

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

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

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

since datetime

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

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

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

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

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

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

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

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

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

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

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

has_next boolean

postings string

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

addressee object

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

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

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

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

delivery_date_begin datetime

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

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

delivery_date_end datetime

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

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

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

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

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

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

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

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

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

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

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

affect_cancellation_rating boolean

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

cancellation object

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

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

cancel_reason string

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

cancellation_initiator string

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

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

cancellation_type string

Тип отмены.

cancelled_after_ship boolean

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

customer object

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

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

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

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

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

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

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

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

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

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

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

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

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

delivering_date datetime

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

delivery_method object

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

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

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

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

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

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

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

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

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

client_price string

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

tpl_integration_type string

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

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

POST /v3/posting/fbs/list HTTP/1.1

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

{
  "dir": "string",
  "filter": {
    "delivery_method_id": [
      0
    ],
    "order_id": 0,
    "provider_id": [
      0
    ],
    "since": "2020-12-09T18:53:03.052Z",
    "status": "string",
    "to": "2020-12-09T18:53:03.052Z",
    "warehouse_id": [
      0
    ]
  },
  "limit": 0,
  "offset": 0,
  "with": {
    "analytics_data": true,
    "barcodes": true,
    "financial_data": true
  }
}

Response status  200

{
  "result": {
    "has_next": true,
    "postings": [
      {
        "addressee": {
          "name": "string",
          "phone": "string"
        },
        "analytics_data": {
          "city": "string",
          "delivery_date_begin": "2020-12-09T19:12:35.295Z",
          "delivery_date_end": "2020-12-09T19:12:35.295Z",
          "delivery_type": "string",
          "is_premium": true,
          "payment_type_group_name": "string",
          "region": "string",
          "tpl_provider": "string",
          "tpl_provider_id": 0,
          "warehouse": "string",
          "warehouse_id": 0
        },
        "barcodes": {
          "lower_barcode": "string",
          "upper_barcode": "string"
        },
        "cancellation": {
          "affect_cancellation_rating": true,
          "cancel_reason": "string",
          "cancel_reason_id": 0,
          "cancellation_initiator": "string",
          "cancellation_type": "string",
          "cancelled_after_ship": true
        },
        "customer": {
          "address": {
            "address_tail": "string",
            "city": "string",
            "comment": "string",
            "country": "string",
            "district": "string",
            "region": "string",
            "zip_code": "string"
          },
          "customer_email": "string",
          "customer_id": 0,
          "name": "string",
          "phone": "string"
        },
        "delivering_date": "2020-12-09T19:12:35.295Z",
        "delivery_method": {
          "id": 0,
          "name": "string",
          "tpl_provider": "string",
          "tpl_provider_id": 0,
          "warehouse": "string",
          "warehouse_id": 0
        },
        "financial_data": {
          "products": [
            {
              "actions": [
                "string"
              ],
              "client_price": "string",
              "commission_amount": 0,
              "commission_percent": 0,
              "old_price": 0,
              "payout": 0,
              "picking": {
                "amount": 0,
                "moment": "2020-12-09T19:12:35.295Z",
                "tag": "string"
              },
              "price": 0,
              "product_id": 0,
              "quantity": 0,
              "total_discount_percent": 0,
              "total_discount_value": 0
            }
          ]
        },
        "in_process_at": "2020-12-09T19:12:35.295Z",
        "order_id": 0,
        "order_number": "string",
        "posting_number": "string",
        "products": [
          {
            "mandatory_mark": [
              "string"
            ],
            "name": "string",
            "offer_id": "string",
            "price": "string",
            "quantity": 0,
            "sku": 0
          }
        ],
        "shipment_date": "2020-12-09T19:12:35.295Z",
        "status": "string",
        "tpl_integration_type": "string",
        "tracking_number": "string"
      }
    ]
  }
}

/unfulfilled/list

POST /v3/posting/fbs/unfulfilled/list

delivering_date_from datetime

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

dir string

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

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

filter object

cutoff_from datetime

cutoff_to datetime

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

delivering_date_to datetime

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

delivery_method_id integer

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

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

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

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

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

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

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

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

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

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

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

count integer

Счетчик элементов в ответе.

postings string

addressee object

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

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

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

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

delivery_date_begin datetime

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

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

delivery_date_end datetime

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

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

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

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

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

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

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

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

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

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

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

affect_cancellation_rating boolean

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

cancellation object

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

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

cancel_reason string

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

cancellation_initiator string

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

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

cancellation_type string

Тип отмены.

cancelled_after_ship boolean

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

customer object

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

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

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

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

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

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

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

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

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

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

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

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

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

delivering_date datetime

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

delivery_method object

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

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

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

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

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

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

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

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

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

client_price string

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цена товара.

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

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

tpl_integration_type string

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

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

POST /v3/posting/fbs/unfulfilled/list HTTP/1.1

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

{
  "dir": "string",
  "filter": {
    "cutoff_from": "2020-12-09T19:05:41.040Z",
    "cutoff_to": "2020-12-09T19:05:41.040Z",
    "delivering_date_from": "2020-12-09T19:05:41.040Z",
    "delivering_date_to": "2020-12-09T19:05:41.040Z",
    "delivery_method_id": [
      0
    ],
    "provider_id": [
      0
    ],
    "status": "string",
    "warehouse_id": [
      0
    ]
  },
  "limit": 0,
  "offset": 0,
  "with": {
    "analytics_data": true,
    "barcodes": true,
    "financial_data": true
  }
}

Response status  200

{
  "result": {
    "count": 0,
    "postings": [
      {
        "addressee": {
          "name": "string",
          "phone": "string"
        },
        "analytics_data": {
          "city": "string",
          "delivery_date_begin": "2020-12-09T19:05:41.119Z",
          "delivery_date_end": "2020-12-09T19:05:41.119Z",
          "delivery_type": "string",
          "is_premium": true,
          "payment_type_group_name": "string",
          "region": "string",
          "tpl_provider": "string",
          "tpl_provider_id": 0,
          "warehouse": "string",
          "warehouse_id": 0
        },
        "barcodes": {
          "lower_barcode": "string",
          "upper_barcode": "string"
        },
        "cancellation": {
          "affect_cancellation_rating": true,
          "cancel_reason": "string",
          "cancel_reason_id": 0,
          "cancellation_initiator": "string",
          "cancellation_type": "string",
          "cancelled_after_ship": true
        },
        "customer": {
          "address": {
            "address_tail": "string",
            "city": "string",
            "comment": "string",
            "country": "string",
            "district": "string",
            "region": "string",
            "zip_code": "string"
          },
          "customer_email": "string",
          "customer_id": 0,
          "name": "string",
          "phone": "string"
        },
        "delivering_date": "2020-12-09T19:05:41.119Z",
        "delivery_method": {
          "id": 0,
          "name": "string",
          "tpl_provider": "string",
          "tpl_provider_id": 0,
          "warehouse": "string",
          "warehouse_id": 0
        },
        "financial_data": {
          "products": [
            {
              "actions": [
                "string"
              ],
              "client_price": "string",
              "commission_amount": 0,
              "commission_percent": 0,
              "old_price": 0,
              "payout": 0,
              "picking": {
                "amount": 0,
                "moment": "2020-12-09T19:05:41.119Z",
                "tag": "string"
              },
              "price": 0,
              "product_id": 0,
              "quantity": 0,
              "total_discount_percent": 0,
              "total_discount_value": 0
            }
          ]
        },
        "in_process_at": "2020-12-09T19:05:41.119Z",
        "order_id": 0,
        "order_number": "string",
        "posting_number": "string",
        "products": [
          {
            "mandatory_mark": [
              "string"
            ],
            "name": "string",
            "offer_id": "string",
            "price": "string",
            "quantity": 0,
            "sku": 0
          }
        ],
        "shipment_date": "2020-12-09T19:05:41.119Z",
        "status": "string",
        "tpl_integration_type": "string",
        "tracking_number": "string"
      }
    ]
  }
}

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

Информация о транзакциях за указанный период, по конкретным отправлениями или определенного типа.

/transaction/list

POST /v2/finance/transaction/list

Список транзакций Возвращает подробную информацию по транзакциям для отправления. Если в запросе не указывать posting_number, в ответе будут все отправления за указанный период или определенного типа.

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

Фильтр для поиска транзакций.

date object

Период времени.

from datetime

Начало периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

Конец периода в формате YYYY-MM-DDTHH:mm:ss.sssZ.

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

transaction_type string

Тип транзакции

all — все,
orders — заказы,
returns — возвраты,
services — сервисные сборы.

page * integer

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

page_size * integer

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

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

item_delivery_amount integer

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

details string

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

discount_amount integer

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

Количество доставленных товаров.

item_return_amount integer

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

order_amount integer

Сумма заказа.

order_date datetime

Дата заказа в формате YYYY-MM-DDTHH:mm:ss.sssZ.

transaction_date datetime

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

order_state string

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

total_amount string

Итоговый размер начислений.

Дата транзакции в формате YYYY-MM-DDTHH:mm:ss.sssZ.

transaction_number integer

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

transaction_type string

Тип транзакции.

transaction_type_slug string

Тип транзакции в системном виде

POST /v2/finance/transaction/list HTTP/1.1

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

{
  "filter": {
    "date": {
      "from": "2021-03-02T10:17:12.739Z",
      "to": "2021-03-02T10:17:12.739Z"
    },
    "posting_number": "string",
    "transaction_type": "string"
  },
  "page": 0,
  "page_size": 0
}

Response status  200

{
  "result": [
    {
      "commission_amount": 0,
      "details": "string",
      "discount_amount": 0,
      "item_delivery_amount": 0,
      "item_return_amount": 0,
      "order_amount": 0,
      "order_date": "2021-03-02T10:23:58.217Z",
      "order_number": "string",
      "order_state": "string",
      "total_amount": 0,
      "transaction_date": "2021-03-02T10:23:58.217Z",
      "transaction_number": 0,
      "transaction_type": "string",
      "transaction_type_slug": "string"
    }
  ]
}

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

/approve

POST /v2/posting/crossborder/approve

pampam

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

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

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

cancel_reason_id * integer

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

POST /v2/posting/crossborder/approve HTTP/1.1

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

{
  "posting_number": "13009555-0001-1"
}

Response status  200

{
  "result": true
}

/cancel

POST /v2/posting/crossborder/cancel

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

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

cancel_reason_message string

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

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

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

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

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

POST /v2/posting/crossborder/cancel HTTP/1.1

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

{
  "cancel_reason_id": 361,
  "cancel_reason_message": "",
  "posting_number": "39268230-0002-3",
  "sku": [
    149123456
  ]
}

Response status  200

{
  "result": true
}

/cancel-reason/list

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

Can not resolve handlers/crossborder_cancel-reason.md

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

is_available_for_cancellation boolean

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

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

type_id string

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

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

POST /v2/posting/crossborder/cancel HTTP/1.1

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

Can not resolve examples/v2/posting/crossborder/cancel-reason/list/in.json

Response status  200

Can not resolve examples/v2/posting/crossborder/cancel-reason/list/out.json

/get

POST /v2/posting/crossborder/get

Can not resolve handlers/crossborder_get.md

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

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

translit boolean

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

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

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

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

addressee string

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

shipping_provider_id integer

Идентификатор службы доставки.

Результат обработки товара классификатором

CLASSIFIED — товар классифицирован,
NOT_CLASSIFIED — возникла ошибка.

Трек-номер отправления.

POST /v2/posting/crossborder/get HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "posting_number": "39268230-0002-3",
}

Response status  200

{
  "result": [
    {
      "address": {
        "address_tail": "г. Москва, ул. Центральная, 1",
        "addressee": "Петров Иван Владимирович",
        "city": "Москва",
        "comment": "",
        "country": "Россия",
        "district": "",
        "phone": "+7 495 123-45-67",
        "region": "Москва",
        "zip_code": "101000"
      },
      "auto_cancel_date": "2019-11-18T11:30:11.571Z",
      "cancel_reason_id": 76,
      "created_at": "2019-11-18T11:30:11.571Z",
      "customer_email": "petrov@email.com",
      "customer_id": 60006,
      "in_process_at": "2019-11-18T11:30:11.571Z",
      "order_id": 77712345,
      "order_nr": "1111444",
      "posting_number": "39268230-0002-3",
      "products": [
        {
          "name": "Фитнес-браслет",
          "offer_id": "DEP-1234",
          "price": "1900.00",
          "quantity": 1,
          "sku": 100056
        }
      ],
      "shipping_provider_id": 0,
      "status": "awaiting_approve",
      "tracking_number": ""
    }
  ]
}

/ship

POST /v2/posting/crossborder/ship

Can not resolve handlers/crossborder_ship.md

Параметры запроса

items * object

Массив товаров в ответе.

Значение обязательной маркировки для товара.

Количество товара.

Идентификатор товара в системе Ozon — SKU.

shipping_provider_id integer

Идентификатор отправления.

Идентификатор службы доставки.

Трек-номер отправления.

Параметры ответа

package_number string

Идентификатор посылки.

POST /v2/posting/crossborder/ship HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "items": [
    {
      "quantity": 2,
      "sku": 100056
    }
  ],
  "posting_number": "39268230-0002-3",
  "shipping_provider_id": 15109877837000,
  "tracking_number": "AB123456CD"
}

Response status  200

{
  "result": {
    "package_number": "232123"
  }
}

/shipping-provider/list

POST /v2/posting/crossborder/shipping-provider/list

Can not resolve handlers/cb_shipping_provider.md

Параметры ответа

Идентификатор службы доставки.

Название службы доставки.

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

Параметры запроса

cutoff_from * datetime

cutoff_to datetime

dir * string

Направление сортировки.

asc — по возрастанию,
desc — по убыванию.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

offset * integer

status * string

Статус отправления.

awaiting_approve — ожидает подтверждения,
awaiting_packaging — ожидает упаковки,
awaiting_deliver — ожидает отгрузки,
delivering — доставляется,
driver_pickup — у водителя,
delivered — доставлено,
cancelled — отменено.

translit * boolean

True, если включена транслитерация адреса из кириллицы в латиницу.

Параметры ответа

Информация об адресе доставки.

Адрес в текстовом формате.

addressee string

Имя и фамилия получателя.

Город доставки.

Комментарий к заказу.

Страна доставки.

Район доставки.

Контактный телефон.

Регион доставки.

Почтовый индекс получателя.

Идентификатор причины отмены отправления.

Дата и время создания отправления.

Email покупателя.

Идентификатор покупателя.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

shipping_provider_id integer

Идентификатор службы доставки.

Статус отправления.

Трек-номер отправления.

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

Параметры запроса

Идентификатор отправления.

Дополнительные поля, которые нужно добавить в ответ.

Добавить в ответ данные аналитики.

Добавить в ответ финансовые данные.

Параметры ответа

Аналитические данные.

Город доставки.

Способ доставки.

Наличие подписки Премиум.

Способ оплаты.

Регион доставки.

Идентификатор склада.

Название склада отправки заказа.

Идентификатор причины отмены отправления.

Дата и время создания отправления.

Финансовые данные.

Список товаров.

Размер комиссии за товар.

Процент комиссии.

Цена до учета скидок, на карточке товара отображается зачеркнутой.

Выплата продавцу.

Информация про доставку.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Идентификатор товара.

Процент скидки.

Сумма скидки.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Результат обработки товара классификатором

CLASSIFIED — товар классифицирован,
NOT_CLASSIFIED — возникла ошибка.

POST /v2/posting/fbo/get HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "posting_number": "13009555-0001-1",
  "with": {
    "analytics_data": true,
    "financial_data": true
  }
}

Response status  200

{
  "result": {
    "order_id": 152398500,
    "order_number": "33920144-0066",
    "posting_number": "33920144-0066-1",
    "status": "awaiting_deliver",
    "cancel_reason_id": 0,
    "created_at": "2020-06-24T01:23:45.51Z",
    "in_process_at": "2020-06-24T01:23:45.387Z",
    "products": [
      {
        "sku": 147524707,
        "name": "DEFENDER Наушники вставки Basic 603 черный",
        "quantity": 1,
        "offer_id": "63603",
        "price": "77.00",
      }
    ],
    "analytics_data": {
      "region": "Москва",
      "city": "Москва",
      "delivery_type": "Courier",
      "is_premium": false,
      "payment_type_group_name": "Карты оплаты",
      "warehouse_id": 6048863967000,
      "warehouse_name": "ТВЕРЬ_ХАБ"
    },
    "financial_data": {
      "products": [
        {
          "commission_amount": 0,
          "commission_percent": 0,
          "payout": 0,
          "product_id": 147524707,
          "old_price": 0,
          "price": 77,
          "total_discount_value": 0,
          "total_discount_percent": 0,
          "actions": null,
          "picking": null,
        }
      ]
    }
  }
}

/list

POST /v2/posting/fbo/list

Can not resolve handlers/fbo-list.md

Параметры запроса

dir * string

Направление сортировки.

asc — по возрастанию,
desc — по убыванию.

Идентификатор заказа.

Номер заказа.

since datetime

Начало периода в формате YYYY-MM-DD.

Конец периода в формате YYYY-MM-DD.

Статус отправления.

awaiting_approve — ожидает подтверждения,
awaiting_packaging — ожидает упаковки,
awaiting_deliver — ожидает отгрузки,
delivering — доставляется,
driver_pickup — у водителя,
delivered — доставлено,
cancelled — отменено.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

translit boolean

True, если включена транслитерация адреса из кириллицы в латиницу.

Дополнительные поля, которые нужно добавить в ответ.

Добавить в ответ данные аналитики.

Добавить в ответ финансовые данные.

Параметры ответа

Аналитические данные.

Город доставки.

Способ доставки.

Наличие подписки Премиум.

Способ оплаты.

Регион доставки.

Идентификатор склада.

Название склада отправки заказа.

Идентификатор причины отмены отправления.

Дата и время создания отправления.

Финансовые данные.

Список товаров.

Размер комиссии за товар.

Процент комиссии.

Цена до учета скидок, на карточке товара отображается зачеркнутой.

Выплата продавцу.

Информация про доставку.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Идентификатор товара.

Процент скидки.

Сумма скидки.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Результат обработки товара классификатором

CLASSIFIED — товар классифицирован,
NOT_CLASSIFIED — возникла ошибка.

POST /v2/posting/fbo/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "dir": "asc",
  "filter":
  {
    "since": "2018-10-24T16:24:09.474Z",
    "to": "2019-10-24T16:24:09.474Z"
  },
  "limit": 10,
  "offset": 0,
  "translit": true,
  "with": {
    "analytics_data": true,
    "financial_data": true
  }
}

Response status  200

{
  "result":[
    {
      "order_id":152398500,
      "order_number":"33920144-0066",
      "posting_number":"33920144-0066-1",
      "status":"awaiting_deliver",
      "cancel_reason_id":0,
      "created_at":"2020-06-24T01:23:45.51Z",
      "in_process_at":"2020-06-24T01:23:45.387Z",
      "products":
        [
          {
            "sku":147524707,
            "name":"DEFENDER Наушники вставки Basic 603 черный",
            "quantity":1,
            "offer_id":"63603",
            "price":"77.00",
          }
        ],
      "analytics_data":
        {
          "region":"Москва",
          "city":"Москва",
          "delivery_type":"Courier",
          "is_premium":false,
          "payment_type_group_name":"Карты оплаты",
          "warehouse_id":6048863967000,
          "warehouse_name":"ТВЕРЬ_ХАБ",
        },
      "financial_data":
        {
          "products":
            [
              {
                "commission_amount":0,
                "commission_percent":0,
                "payout":0,
                "product_id":147524707,
                "old_price":0,
                "price":77,
                "total_discount_value":0,
                "total_discount_percent":0,
                "actions":null,
                "picking":null
              }
            ]
        }
    }
  ]
}

Продажа со своего склада

Группа методов для работы с отправлениями со склада продавца.

/act/check-status

POST /v2/posting/fbs/act/check-status

Параметры запроса

id * integer

Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.

Параметры ответа

added_to_act string

Массив c номерами отправлений, которые добавлены в Акт приема-передачи. Эти отправления нужно передать сегодня.

removed_from_act string

Массив с номерами отправлений, которые не попали в Акт приема-передачи. Такие отправления нужно передавать со следующей отгрузкой.

Статус запроса.

in_process — документы формируются, нужно подождать,
ready — документы сформированы и готовы для скачивания,
error — произошла ошибка при формировании документов, запросите документы повторно.

POST /v2/posting/fbs/act/check-status HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "id": 15684442104000
}

Response status  200

{
  "result": {
    "status": "ready",
    "added_to_act": [
      "00420000-0030-2",
      "01560000-0096-4"
    ],
    "removed_from_act": [
      "03840000-0096-3"
    ]
  }
}

/act/create

POST /v2/posting/fbs/act/create

Если вы используете Доверительную приемку грузового места, укажите в запросе количество грузовых мест, которое передадите к отгрузке.

Параметры запроса

containers_count integer

Количество грузовых мест. Подробнее в Помощи

Параметры ответа

Номер задания на формирование документов.

POST /v2/posting/fbs/act/create HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "containers_count": 5
}

Response status  200

{
  "result": {
    "id": 15684442104000
  }
}

/act/get-container-labels

POST /v2/posting/fbs/act/get-container-labels

Метод создает этикетки для грузового места.

Параметры запроса

id * integer

Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.

POST /v2/posting/fbs/act/get-container-labels HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "id": 0
}

Response status  200

pdf-документ

/act/get-pdf

POST /v2/posting/fbs/act/get-pdf

Параметры запроса

id * integer

Номер задания на формирование документов из метода POST /v2/posting/fbs/act/create.

POST /v2/posting/fbs/act/get-pdf HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "id": 15684442104000
}

Response status  200

pdf-документ

/arbitration

POST /v2/posting/fbs/arbitration

Параметры запроса

Идентификатор отправления.

Параметры ответа

Результат обработки запроса. True, если запрос выполнился без ошибок.

POST /v2/posting/fbs/arbitration HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "posting_number":
  [
    "02898753-0009-1",
    "02898753-0009-2"
  ]
}

Response status  200

{
  "result": "true"
}

/awaiting-delivery

POST /v2/posting/fbs/awaiting-delivery

Параметры запроса

Идентификатор отправления.

Параметры ответа

cancel_reason_id * integer

Результат обработки запроса. True, если запрос выполнился без ошибок.

POST /v2/posting/fbs/awaiting-delivery HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "posting_number":
  [
    "02898753-0009-1",
    "02898753-0009-2"
  ]
}

Response status  200

{
  "result": "true"
}

/cancel

POST /v2/posting/fbs/cancel

Параметры запроса

Идентификатор причины отмены отправления.

cancel_reason_message string

Дополнительная информация по отмене. Если cancel_reason_id = 402, параметр обязательный.

Идентификатор отправления.

Параметры ответа

Результат обработки запроса. True, если запрос выполнился без ошибок.

POST /v2/posting/fbs/cancel HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "cancel_reason_id": 402,
  "cancel_reason_message": "Wrong seller id",
  "posting_number": 13076543-0001-1
}

Response status  200

{
  "result": "true"
}

/cancel-reason/list

POST /v2/posting/fbs/cancel-reason/list

Параметры ответа

is_available_for_cancellation boolean

Номер задания на формирование документов.

Название категории.

type_id string

Инициатор отмены отправления.

buyer — покупатель,
seller — продавец.

POST /v2/posting/fbs/cancel-reason/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{}

Response status  200

{
  "result": [
    {
      "id": 123,
      "title": "Error",
      "type_id": "seller"
    }
  ]
}

/get

POST /v2/posting/fbs/get

Параметры запроса

Идентификатор отправления.

Дополнительные поля, которые нужно добавить в ответ.

Добавить в ответ данные аналитики.

Добавить в ответ штрихкоды отправления.

Добавить в ответ финансовые данные.

Параметры ответа

Аналитические данные.

Город доставки.

Способ доставки.

Наличие подписки Премиум.

Способ оплаты.

Регион доставки.

Идентификатор склада.

Название склада отправки заказа.

Штрихкоды отправления.

Верхний штрихкод на маркировке отправления.

Нижний штрихкод на маркировке отправления.

Идентификатор причины отмены отправления.

Дата и время создания отправления.

Финансовые данные.

Список товаров.

Размер комиссии за товар.

Процент комиссии.

Цена до учета скидок, на карточке товара отображается зачеркнутой.

Выплата продавцу.

Информация про доставку.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Идентификатор товара.

Процент скидки.

Сумма скидки.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Статус отправления.

POST /v2/posting/fbs/get HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "posting_number": "13076543-0001-1",
  "with": {
    "analytics_data": true,
    "barcodes": true,
    "financial_data": true
  }
}

Response status  200

{
  "result": {
    "analytics_data": {
      "city": "string",
      "delivery_type": "string",
      "is_premium": true,
      "payment_type_group_name": "string",
      "region": "string"
    },
    "barcodes": {
      "lower_barcode": "string",
      "upper_barcode": "string"
    },
    "cancel_reason_id": 0,
    "created_at": "2020-07-06T07:40:22.281Z",
    "financial_data": {
      "products": [
        {
          "actions": [
            "string"
          ],
          "commission_amount": 0,
          "commission_percent": 0,
          "old_price": 0,
          "payout": 0,
          "picking": {
            "amount": 0,
            "moment": "2020-07-06T07:40:22.281Z",
            "tag": "string"
          },
          "price": 0,
          "product_id": 0,
          "total_discount_percent": 0,
          "total_discount_value": 0
        }
      ]
    },
    "in_process_at": "2020-07-06T07:40:22.281Z",
    "order_id": 0,
    "order_number": "string",
    "posting_number": "string",
    "products": [
      {
        "mandatory_mark": [
          "string"
        ],
        "name": "string",
        "offer_id": "string",
        "price": "string",
        "quantity": 0,
        "sku": 0
      }
    ],
    "shipment_date": "2020-07-06T07:40:22.281Z",
    "status": "string"
  }
}

/get-by-barcode

POST /v2/posting/fbs/get-by-barcode

Параметры запроса

barcode * string

Штрихкод отправления.

Параметры ответа

Штрихкоды отправления.

Верхний штрихкод на маркировке отправления.

Нижний штрихкод на маркировке отправления.

Идентификатор причины отмены отправления.

Дата и время создания отправления.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Статус отправления.

POST /v2/posting/fbs/get-by-barcode HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "barcode": "string"
}

Response status  200

{
  "result": {
    "barcodes": {
      "lower_barcode": "string",
      "upper_barcode": "string"
    },
    "cancel_reason_id": 0,
    "created_at": "2020-06-16T15:11:06.995Z",
    "in_process_at": "2020-06-16T15:11:06.995Z",
    "order_id": 0,
    "order_number": "string",
    "posting_number": "string",
    "products": [
      {
        "mandatory_mark": [
          "string"
        ],
        "name": "string",
        "offer_id": "string",
        "price": "string",
        "quantity": 0,
        "sku": 0
      }
    ],
    "shipment_date": "2020-06-16T15:11:06.995Z",
    "status": "string"
  }
}

/list

POST /v2/posting/fbs/list

Параметры запроса

dir * string

Направление сортировки.

asc — по возрастанию,
desc — по убыванию.

Идентификатор заказа.

Номер заказа.

since datetime

Начало периода в формате YYYY-MM-DD.

Конец периода в формате YYYY-MM-DD.

Статус отправления.

awaiting_approve — ожидает подтверждения,
awaiting_packaging — ожидает упаковки,
awaiting_deliver — ожидает отгрузки,
delivering — доставляется,
driver_pickup — у водителя,
delivered — доставлено,
cancelled — отменено.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

sort_by string

Сортировка в ответе
updated_at— по дате обновления,
in_process_at— по времени обработки,
order_created_at— по дате создания.

Дополнительные поля, которые нужно добавить в ответ.

Добавить в ответ данные аналитики.

Добавить в ответ штрихкоды отправления.

Добавить в ответ финансовые данные.

Параметры ответа

Аналитические данные.

Город доставки.

Способ доставки.

Наличие подписки Премиум.

Способ оплаты.

Регион доставки.

Идентификатор склада.

Название склада отправки заказа.

Штрихкоды отправления.

Верхний штрихкод на маркировке отправления.

Нижний штрихкод на маркировке отправления.

Идентификатор причины отмены отправления.

Дата и время создания отправления.

Финансовые данные.

Список товаров.

Размер комиссии за товар.

Процент комиссии.

Цена до учета скидок, на карточке товара отображается зачеркнутой.

Выплата продавцу.

Информация про доставку.

Цена товара с учетом скидок — это значение показывается на карточке товара.

Идентификатор товара.

Процент скидки.

Сумма скидки.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Статус отправления.

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.

Подробнее про маркировку товаров в Помощи

Параметры запроса

sku * integer

Идентификатор товара в системе Ozon — SKU.

Параметры ответа

is_required boolean

Флаг обязательной характеристики.

Идентификатор товара на Ozon.

POST /v2/posting/fbs/product/mandatory-mark/is-required HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "sku": [
    0
  ]
}

Response status  200

{
  "result": [
    {
      "is_required": true,
      "sku": 0
    }
  ]
}

/product/mandatory-mark/validate

POST /v2/posting/fbs/product/mandatory-mark/validate

Метод для валидации значения маркировки.

Подробнее про маркировку товаров в Помощи

Параметры запроса

mandatory_mark * string

Обязательная маркировка товара.

Параметры ответа

Обязательная маркировка товара.

True, если маркировка валидна.

POST /v2/posting/fbs/product/mandatory-mark/validate HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "mandatory_mark": [
    "string"
  ]
}

Response status  200

{
  "result": [
    {
      "mandatory_mark": "string",
      "result": true
    }
  ]
}

/ship

POST /v2/posting/fbs/ship

Параметры запроса

packages * object

Массив товаров в ответе.

Значение обязательной маркировки для товара.

Количество товара.

Идентификатор товара в системе Ozon — SKU.

Идентификатор отправления.

Параметры ответа

Результат обработки запроса. True, если запрос выполнился без ошибок.

POST /v2/posting/fbs/ship HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "packages": [
    {
      "items": [
        {
          "mandatory_mark": [
            "string"
          ],
          "quantity": 0,
          "sku": 0
        }
      ]
    }
  ],
  "posting_number": "string"
}

Response status  200

{
  "result": [
    "string"
  ]
}

/unfulfilled/list

POST /v2/posting/fbs/unfulfilled/list

Параметры запроса

cutoff_from * datetime

cutoff_to datetime

dir string

Направление сортировки.

asc — по возрастанию,
desc — по убыванию.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

Статус отправления.

awaiting_approve — ожидает подтверждения,
awaiting_packaging — ожидает упаковки,
awaiting_deliver — ожидает отгрузки,
delivering — доставляется,
driver_pickup — у водителя,
delivered — доставлено,
cancelled — отменено.

Дополнительные поля, которые нужно добавить в ответ.

Добавить в ответ данные аналитики.

Добавить в ответ штрихкоды отправления.

Добавить в ответ финансовые данные.

Параметры ответа

Штрихкоды отправления.

Верхний штрихкод на маркировке отправления.

Нижний штрихкод на маркировке отправления.

Идентификатор причины отмены отправления.

Дата и время создания отправления.

Дата и время начала обработки отправления.

Идентификатор заказа, к которому относится отправление.

Номер заказа, к которому относится отправление.

Номер отправления.

Список товаров в отправлении.

Обязательная маркировка товара.

Название товара.

Идентификатор товара в системе продавца — артикул.

Цена товара.

Количество товара в отправлении.

Идентификатор товара в системе Ozon.

Статус отправления.

POST /v2/posting/fbs/unfulfilled/list HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "cutoff_from": "2020-06-16T10:38:00.605Z",
  "cutoff_to": "2020-06-16T10:38:00.605Z",
  "dir": "string",
  "limit": 0,
  "offset": 0,
  "status": [
    "string"
  ],
  "with": {
    "barcodes": true
  }
}

Response status  200

{
  "result": [
    {
      "barcodes": {
        "lower_barcode": "string",
        "upper_barcode": "string"
      },
      "cancel_reason_id": 0,
      "created_at": "2020-06-16T15:20:41.547Z",
      "in_process_at": "2020-06-16T15:20:41.547Z",
      "order_id": 0,
      "order_number": "string",
      "posting_number": "string",
      "products": [
        {
          "mandatory_mark": [
            "string"
          ],
          "name": "string",
          "offer_id": "string",
          "price": "string",
          "quantity": 0,
          "sku": 0
        }
      ],
      "shipment_date": "2020-06-16T15:20:41.547Z",
      "status": "string"
    }
  ]
}

Возвраты

/company/fbo

POST /v2/returns/company/fbo

Информация о возвратах. Swagger

Параметры запроса

Фильтр по отправлениям и статусам возврата.

Идентификатор отправления.

Статус возврата.
Created — возврат создан.
ReturnedToOzon — возврат на складе Ozon.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

accepted_from_customer_moment datetime

Параметры ответа

count integer

Счетчик элементов в ответе.

returns object

Информация о возврате

Время приема возврата от покупателя.

company_id integer

Идентификатор продавца.

current_place_name string

Текущее местонахождение возврата.

dst_place_name string

Место назначения возврата.

Идентификатор возврата.

is_opened boolean

True, если возврат в работе.

return_reason_name string

Номер отправления.

Причина возврата.

returned_to_ozon_moment datetime

Время доставки возврата на склад Ozon.

Идентификатор товара на Ozon.

status_name string

Статус возврата.

POST /v2/returns/company/fbo HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "filter": {
    "posting_number": "string",
    "status": [
      "string"
    ]
  },
  "limit": 0,
  "offset": 0
}

Response status  200

{
  "count": 0,
  "returns": [
    {
      "accepted_from_customer_moment": "2020-07-29T11:23:53.995Z",
      "company_id": 0,
      "current_place_name": "string",
      "dst_place_name": "string",
      "id": 0,
      "is_opened": true,
      "posting_number": "string",
      "return_reason_name": "string",
      "returned_to_ozon_moment": "2020-07-29T11:23:53.995Z",
      "sku": 0,
      "status_name": "string"
    }
  ]
}

/company/fbs

POST /v2/returns/company/fbs

Информация о возвратах. Swagger

Параметры запроса

accepted_from_customer_moment datetime

Время приема возврата от покупателя.

last_free_waiting_day datetime

Время приема возврата от покупателя.

Идентификатор заказа.

Идентификатор отправления.

product_name string

Название товара.

product_offer_id string

Статус отправления.

awaiting_approve — ожидает подтверждения,
awaiting_packaging — ожидает упаковки,
awaiting_deliver — ожидает отгрузки,
delivering — доставляется,
driver_pickup — у водителя,
delivered — доставлено,
cancelled — отменено.

Количество отправлений в ответе. Максимум — 50, минимум — 1.

accepted_from_customer_moment datetime

Параметры ответа

count integer

Счетчик элементов в ответе.

returns object

Информация о возврате

Время приема возврата от покупателя.

company_id integer

Идентификатор продавца.

current_place_name string

Текущее местонахождение возврата.

dst_place_name string

Место назначения возврата.

Идентификатор возврата.

is_opened boolean

True, если возврат в работе.

return_reason_name string

Номер отправления.

Причина возврата.

returned_to_ozon_moment datetime

Время доставки возврата на склад Ozon.

Идентификатор товара на Ozon.

status_name string

Статус возврата.

POST /v2/returns/company/fbs HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

{
  "filter": {
    "accepted_from_customer_moment": {
      "time_from": "2020-11-16T15:15:10.854Z",
      "time_to": "2020-11-16T15:15:10.854Z"
    },
    "last_free_waiting_day": {
      "time_from": "2020-11-16T15:15:10.854Z",
      "time_to": "2020-11-16T15:15:10.854Z"
    },
    "order_id": 0,
    "posting_number": [
      "string"
    ],
    "product_name": "string",
    "product_offer_id": "string",
    "status": "string"
  },
  "limit": 0,
  "offset": 0
}

Response status  200

{
  "result": {
    "count": 0,
    "returns": [
      {
        "accepted_from_customer_moment": "string",
        "clearing_id": 0,
        "commission": 0,
        "commission_percent": 0,
        "id": 0,
        "is_moving": true,
        "is_opened": true,
        "last_free_waiting_day": "string",
        "moving_to_place_name": "string",
        "picking_amount": 0,
        "place_id": 0,
        "posting_number": "string",
        "price": 0,
        "price_without_commission": 0,
        "product_id": 0,
        "product_name": "string",
        "quantity": 0,
        "return_date": "string",
        "return_reason_name": "string",
        "returned_to_seller_date_time": "string",
        "returns_keeping_cost": 0,
        "sku": 0,
        "status": "string",
        "waiting_for_seller_date_time": "string",
        "waiting_for_seller_days": 0
      }
    ]
  }
}

Работа с накладными

/orders/{orderId}/waybill_acceptance_results

GET /v1/supplier/orders/{orderId}/waybill_acceptance_results

URI Parameters

orderId string

Параметры запроса

orderId * string

Идентификатор заказа.

Параметры ответа

order object

Информация о заказе.

contract object

contract_id integer

Идентификатор контракта.

Название контракта.

Идентификатор документа.

Номер задания на формирование документов.

storage_warehouse object

Склад, на котором хранятся товары.

Название склада.

supply_date datetime

Дата поставки.

supply_warehouse object

Склад поставки.

Название склада.

discrepancy_report object

Идентификатор склада.

waybills object

Информация о накладных.

Информация о расхождениях.

discrepancy_report_id integer

Идентификатор акта о расхождениях.

document_date string

Дата формирования документа.

Идентификатор документа.

document_type string

Тип документа.

document_date string

Дата формирования документа.

total_item_amount_by_document integer

Идентификатор документа.

item_count integer

Количество товаров в заказе.

state string

Статус товара.

sum_with_vat integer

Сумма заказа с учётом НДС.

Количество товаров в документе.

total_item_amount_by_fact integer

Фактическое количество товаров.

vat_sum integer

Сумма НДС.

waybill_id integer

Идентификатор накладной.

GET /v1/supplier/orders/[orderId]/waybill_acceptance_results HTTP/1.1

Host: api-seller.ozon.ru 
Client-Id: 836
Api-Key: 0296d4f2-70a1-4c09-b507-904fd05567b9
Content-Type: application/json

Response status  200

{
  "order": {
    "contract": {
      "contract_id": 0,
      "name": "string"
    },
    "document_number": "string",
    "id": 0,
    "storage_warehouse": {
      "name": "string",
      "warehouse_id": 0
    },
    "supply_date": "string",
    "supply_warehouse": {
      "name": "string",
      "warehouse_id": 0
    }
  },
  "waybills": [
    {
      "discrepancy_report": [
        {
          "discrepancy_report_id": 0,
          "document_date": "string",
          "document_number": "string",
          "document_type": "string"
        }
      ],
      "document_date": "string",
      "document_number": "string",
      "item_count": 0,
      "state": "string",
      "sum_with_vat": 0,
      "total_item_amount_by_document": 0,
      "total_item_amount_by_fact": 0,
      "vat_sum": 0,
      "waybill_id": 0
    }
  ]
}

/waybill_acceptance_results/{waybillId}

GET /v1/supplier/waybill_acceptance_results/{waybillId}

URI Parameters

waybillId string

Параметры ответа

document_date string

Дата формирования документа.

Идентификатор документа.

amount_by_document integer

Информация о товарах.

Количество в документе.

amount_by_fact integer

Количество по факту поставки.

amount_of_accepted integer

Количество принятых товаров

amount_of_defect integer

Количество товаров с браком.

amount_of_shortage integer

Количество недостающих товаров.

amount_of_surplus integer

Количество лишних товаров.

contractor_item_code string

defect_reason string

Причина брака.