Ozon API: подключение Seller API и примеры задач

Пример работы через Ozon API (программный интерфейс: способ обмена данными между программами) есть у интернет-магазина Zarina. По опубликованному Ozon кейсу, за первые месяцы после подключения (кейс опубликован в марте 2026 года) через Ozon Логистику доставили больше 30 000 товаров с сайта бренда, а сроки доставки, по данным Ozon, сократились в 2 раза (период и база сравнения в кейсе не раскрыты). Заказы передавались из системы компании в кабинет маркетплейса через Seller API. Это результат конкретного проекта, а не обещание для любого магазина.

#Что такое Seller API и кому он нужен?

Seller API связывает программу продавца с кабинетом Ozon. Заказ Zarina оформлялся на сайте бренда, а собирал и доставлял его Ozon. Схема FBO означает, что товар хранится на складе площадки. Через интеграцию на сайт передавался ассортимент со складов Ozon, чтобы покупатель видел доступные позиции и размеры.

Другой пример — документы качества: площадка объявила о методах управления ими через интеграцию. Отдельный сценарий — автоматизация отзывов, которую Ozon включил в подписку «Управление отзывами». Возможность обмена данными и доступ к конкретному инструменту нужно проверять отдельно.

Для выбора задачи полезно записать, что сейчас переносится руками: заказ с сайта в кабинет, данные о доставке обратно на сайт или документ к товару. Общий план работы с площадкой собран в разделе Ozon для продавцов. Если ручного переноса нет, начинать разработку только ради подключения API незачем.

#Как выбрать Ozon API и где его документация?

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

Ozon описал у Delivery API (он нужен интернет-магазинам, которые отправляют заказы через Ozon Доставку для бизнеса) создание заказов и получение этикеток, расчёт сроков и стоимости, отслеживание статусов. Для подключения указан раздел «Управление частными приложениями» в личном кабинете Доставки. Это подтверждённый путь для Доставки, а не универсальная настройка всех интеграций Ozon.

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

#Что подготовить заранее и где получить API-ключи Ozon?

До выдачи доступа стоит записать задачу интеграции и список действий программы. Разделите чтение данных и изменения: получить расчёт доставки, создать заказ, изменить видимость товара. Так проще проверить, действительно ли подключаемой программе нужны все запрошенные возможности.

Точную последовательность создания ключа Seller API в проверенных объявлениях подтвердить не удалось. Поэтому здесь нет выдуманного пути по меню, названий ролей или срока действия ключа. Для самостоятельного подключения нужна действующая инструкция в кабинете продавца либо у выбранной интеграции.

Для обсуждения настройки нужны название программы и снимок раздела кабинета без секретов. Сам API-ключ в переписку не включают. В рабочем чек-листе полезно оставить владельца подключения и задачу, ради которой выдали доступ, чтобы при смене подрядчика было понятно назначение интеграции.

#Как пройти подключение по шагам?

Ниже порядок проверки интеграции, а не инструкция по кнопкам выдачи ключа. Для первого запуска выбирают 1 объект: товар либо заказ. Массовые изменения цен и остатков до проверки результата в кабинете в такой запуск включать не стоит.

1. 1

   Определить задачу

   Записать результат для 1 заказа: например, получить предварительную стоимость доставки с сайта.

2. 2

   Выбрать продукт и способ обмена

   Проверить, нужен Seller API или Delivery API, готовая интеграция либо собственная программа.

3. 3

   Оформить доступ по действующей инструкции

   Сверить кабинет и требования выбранного метода. Не переносить настройки из другого продукта Ozon.

4. 4

   Сравнить результат с кабинетом

   Проверить 1 заказ или товар. Сохранить время проверки и расхождения до запуска на всём ассортименте.

В задании разработчику полезно описать и неудачный результат. Например, если расчёт доставки не получен, программа должна показать ошибку, а не подставить 0 ₽. Это предложенное условие приёмки интеграции, не правило Ozon. Его согласуют до запуска обмена: покупатель не должен видеть бесплатную доставку вместо сообщения о неудачном расчёте.

#Какой пример проверить через v2 и чем он полезен?

Подтверждённый пример с обозначением v2 — метод v2/delivery/checkout. Он входит в Seller API и обслуживает доставку для продавцов; Delivery API из предыдущего раздела (для Ozon Доставки для бизнеса) — другой продукт со своими методами. Ozon указал, что метод показывает предварительные сроки и стоимость доставки. В кабинете тот же сценарий начинается с «Создать заказ» в разделе заказов FBO (товар лежит на складе Ozon) или FBS (товар хранит продавец), затем используется «Рассчитать доставку».

Проверка строится на одном заказе: одинаковые товары и адрес получателя вводят в программе и кабинете. Затем сравнивают предварительные сроки и стоимость. Если результаты расходятся, сначала сверяют исходные данные. Оценку доставки не стоит выдавать покупателю за окончательный счёт.

Сроки и стоимость рассчитывают оба продукта, но каждый своим методом: у Delivery API один, у Seller API — v2/delivery/checkout. Обозначение v2 в названии этой операции не означает, что весь Seller API имеет одну общую версию. Для подключения нужно проверять конкретный метод. В статье не приводится готовый запрос (POST — вид запроса, который отправляет данные): обязательные поля, заголовки авторизации и формат ответа из разрешённого источника не подтверждены.

#Как работать с товарами и что проверять в методах для товаров?

Для товарного сценария сначала нужно определить действие: создание карточки и изменение её видимости решают разные задачи. Для второго сценария Ozon указал операцию «ProductVisibilitySet» (название метода API, который меняет видимость товара) — с её помощью на маркетплейсе скрывают товары, которые продаются только на вашем сайте, но доставляются Ozon. Её название видно в ссылке на документацию из объявления. Создание карточки этим методом не подтверждено.

Ещё один подтверждённый сценарий — управление документами качества через Seller API. Для ручной работы Ozon указал раздел «Товары и цены» → «Сертификаты качества». Проверять результат интеграции с документами логично на выбранном товаре, отдельно от теста доставки.

В задании на создание карточек для маркетплейсов стоит разделить подготовку содержания и передачу данных. Сначала согласуют название и характеристики товара. Затем проверяют, что именно передала программа и к какой позиции. Для теста товарных методов, обозначенных словом product, фиксируют артикул и ожидаемое изменение карточки.

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

#Как подключиться через 1С или МойСклад?

Вариант без собственной разработки есть у Ozon Доставки через ApiShip — сервис, который подключает разные службы доставки в одном окне. В объявлении Ozon названы модули для 1С и «Битрикса», а также InSales. Подключение описано через регистрацию в ApiShip и предоставление доступа к интеграции с Ozon. Применимость этого варианта к своей задаче проверяют до настройки.

Для МойСклад здесь нет подтверждённой последовательности подключения. В задании поставщику интеграции нужно перечислить нужные действия и попросить показать их на 1 объекте. Наличие слова Ozon в названии модуля ещё не подтверждает поддержку расчёта доставки или работы с документами.

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

#Какие ошибки проверить при отказе?

При отказе сначала сохраняют текст ответа без ключей доступа и название операции. Затем проверяют продукт и кабинет, к которому подключали программу. Конкретные коды ошибок здесь не расшифрованы: подтверждённого справочника в использованных объявлениях нет.

Если программа получила данные, но они не совпали с кабинетом, сравнивают один и тот же объект. Для расчёта доставки это состав заказа и адрес. Для документов качества сравнивают товар и прикреплённый документ. Массовый повтор запроса до выяснения причины усложнит проверку изменений.

#Сколько стоит подключение и можно ли бесплатно?

Единую цену подключения Seller API и общие условия бесплатного доступа подтвердить не удалось. В бюджете проекта нужно отдельно запросить стоимость модуля и настройки. Услуги площадки тоже проверяют отдельно: Ozon, например, описывал автоматизацию отзывов через Seller API внутри подписки «Управление отзывами».

Перед запуском обмена остаётся согласовать один проверяемый результат: какой объект программа получает или меняет и где это видно в кабинете. В протоколе приёмки записывают исходные данные, время теста и результат. Секретный ключ в такой протокол не включают.