Ozon Delivery API
⌘K

Ozon Delivery API

Полная документация по API Ozon Доставки для бизнеса: 18 методов, авторизация, статусная модель и коды ошибок. Собрано из официальной OpenAPI-спеки и Базы знаний продавца.

Базовый URL https://api-delivery.ozon.ru OpenAPI 3.0.4 18 методов Актуально на 2026-08-24
Начало работыПриложение, scopes, OAuth-токен, testcookie, примеры на bash Порядок работыСценарии от расчёта доставки до возвратов, со схемами Справочник методовВсе 18 методов с параметрами, схемами и примерами Статусы и ошибкиСтатусная модель отправлений и возвратов, коды ошибок

Все методы#

Метод Назначение Группа
POST /v1/delivery/check-client Проверить доступность доставки для покупателя (по телефону) Оформление заказа
POST /v1/delivery/location Предварительный срок доставки до локации покупателя Оформление заказа
POST /v1/order/checkout Проверить доступность доставки и рассчитать условия по заказу Оформление заказа
POST /v1/order/create Создать заказ и отправления Оформление заказа
POST /v1/delivery-point/list Список всех пунктов выдачи ПВЗ
POST /v1/delivery-point/check-availability Доступность конкретных ПВЗ для отправлений ПВЗ
POST /v1/delivery-point/info Информация о пунктах выдачи (адрес, график) ПВЗ
POST /v1/posting/approve Подтвердить отправление к отгрузке Отгрузка
POST /v1/posting/label Получить этикетку (PDF) Отгрузка
POST /v1/posting/search Найти отправления (фильтры, пагинация) Обработка
POST /v1/posting/info Информация об отправлении Обработка
POST /v1/posting/status-history История статусов отправления Обработка
POST /v1/posting/cancel Запустить отмену отправления Обработка
POST /v1/return/search Найти возвраты Возвраты
POST /v1/return/info Информация о возвратах Возвраты
POST /v1/return/status-history История статусов возврата Возвраты
POST /v1/return/download_barcode Штрихкод получения возвратов (PDF) Возвраты
POST /v1/return/reset_barcode Сбросить штрихкод получения возвратов Возвраты

Уровни доступа (scopes)#

Scope Что открывает
delivery-api.delivery проверка доступности доставки и сроков
delivery-api.delivery-point информация по пунктам выдачи
delivery-api.order оформление заказа
delivery-api.posting работа с отправлениями
delivery-api.return работа с возвратами
delivery-api.all все методы

Что важно учесть при интеграции#

  • testcookie / защита от DDoS. Сервер может ответить 302/307 с Location и Set-Cookie. HTTP-клиент обязан повторить запрос с тем же телом по адресу из Location, приложив полученную куку, и хранить её для последующих вызовов. В curl это -L -c cookies -b cookies.
  • Идемпотентность. /v1/order/create принимает заголовок Idempotency-Key (UUID) — повторный запрос с тем же ключом возвращает исходный ответ.
  • shipment_method_id обязателен для каждого отправления и создаётся только в личном кабинете.
  • Порядок вызовов при оформлении: check-client → (location / delivery-point/*) → order/checkout → order/create → posting/approve → posting/info (проверка ready_for_shipping) → posting/label.
  • Баланс. posting/approve не пройдёт при недостатке средств (NotEnoughBalance).
  • Отмена доступна до статуса delivered; отменённое отправление далее отслеживается методами возвратов.
  • x-o3-trace-id возвращается во всех ответах — сохраняйте для обращений в поддержку.
  • Сейчас доступен единственный способ передачи отправлений — самостоятельная отгрузка в пункт Ozon. В спеке зарезервированы (закомментированы) будущие разделы: грузоместа для доверительной приёмки, управление методами доставки и точками отгрузки/возврата через API.

Источники#

Что Ссылка
Техническая документация (Redoc) https://docs.ozon.ru/api/ozon-delivery/
OpenAPI-спека (оригинал) https://docs.ozon.ru/api/ozon-delivery/swagger.json
База знаний продавца — работа через API https://seller-edu.ozon.ru/libra/ozon-logistika/dostavka-dlya-biznesa/rabota-s-ozon-dostavkoi-dlya-biznesa-cherez-api
База знаний — раздел «Ozon Доставка для бизнеса» https://seller-edu.ozon.ru/libra/ozon-logistika/dostavka-dlya-biznesa
Управление частными приложениями (ЛК) https://seller.ozon.ru/app/settings/private-apps
Методы доставки (ЛК) https://seller.ozon.ru/app/delivery/delivery-methods
Выдача доступа разработчикам к приложению https://docs.ozon.ru/api/applications/
Тарифы и расходы на Ozon Доставку https://seller-edu.ozon.ru/libra/commissions-tariffs/commissions-tariffs-ozon/rashody-ozon-dostavka-dlya-biznesa
Гайд по отображению доставки Ozon на своём сайте https://brandlab.ozon.ru/guide/ozondostavka

Скачать#