Работа с Ozon Доставкой для бизнеса через API (обзор из Базы знаний)

Источник: https://seller-edu.ozon.ru/libra/ozon-logistika/dostavka-dlya-biznesa/rabota-s-ozon-dostavkoi-dlya-biznesa-cherez-api

С помощью Ozon Delivery API можете подключить Ozon Доставку для бизнеса к своему интернет-магазину или внутренней системе и автоматизировать работу с доставкой. Например, вместо создания каждого заказа в личном кабинете вручную — можете автоматически передавать заказы в Ozon, рассчитывать условия доставки и получать статусы отправлений. Личный кабинет при этом остаётся доступен — API является дополнительным способом работы с Ozon Доставкой.

Что можно делать через API#

Ozon Delivery API даёт возможность встроить Ozon Доставку в процесс оформления и обработки заказов вашего интернет-магазина. Это позволяет:

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

Как это работает#

Покупатель оформляет заказ на вашем сайте.
Вы проверяете, доступна ли Ozon Доставка покупателю.
Если доставка доступна, показываете покупателю варианты получения заказа. Клиент выбирает подходящий ПВЗ Ozon или курьерскую доставку.
Рассчитываете условия. Перед созданием заказа получаете предварительные сроки и стоимость доставки, стоимость страхования. Ozon не проверяет, какую итоговую сумму вы передадите клиенту. Стоимость доставки спишется с вашего баланса после оказания услуг. Подробнее о расходах на Ozon Доставку
После подтверждения покупки передаёте данные о заказе и получателе в Ozon и создаёте заказ.
Готовите отправление. Когда заказ собран, подтверждаете готовность к отгрузке. Ozon проверяет, что у вас на балансе достаточно средств. Получаете этикетку и наклеиваете её на отправление.
Передаёте отправление Ozon. После приёмки Ozon доставит его получателю.
Отслеживаете доставку. Получаете актуальный статус отправления и историю его изменений.

Работа с финансами, спорами, закрывающими документами, настройками личного кабинета и настройками логистики происходит в личном кабинете.

Как подключить API#

Перейдите в личном кабинете в раздел Управление частными приложениями.
Нажмите Создать.
Выберите необходимые права доступа для Ozon Delivery API.
Создайте приложение.
Получите в личном кабинете Client ID и Client Secret — используйте их для настройки авторизации вашего приложения при обращении к API.

Client Secret нужно хранить в защищённом месте и не передавать посторонним.

После создания приложения передайте данные и техническую документацию вашему разработчику для настройки интеграции. Технические детали — в 01-vvedenie-i-nachalo-raboty.md.

Как работать с API#

Подготовка к работе с API#

Перед созданием заказов через API необходимо настроить метод доставки в личном кабинете — он определяет, откуда и каким способом вы будете передавать отправления. Пока для работы с API доступен только один способ передачи отправлений — самостоятельная отгрузка в пункт Ozon. См. 06-nastroika-metoda-dostavki.md.

Расчёт условий доставки#

Перед созданием заказа рекомендуется выполнить предварительный расчёт. При расчёте учитываются:

метод доставки;
размеры и вес отправления;
выбранный покупателем способ получения;
место получения;
объявленная стоимость.

В ответ Ozon может вернуть предварительные:

сроки доставки;
стоимость доставки и страхования — рассчитывается по предполагаемым параметрам заказа: в тариф «Доставка» входят все базовые услуги доставки, в тариф «Страховка» — цена страховки. Итоговая стоимость определяется по фактическим параметрам доставки, поэтому суммы могут отличаться.

Подготовка заказа к отгрузке#

После создания заказа соберите отправление.
Перед подтверждением готовности отправления к отгрузке через API убедитесь, что на балансе достаточно средств. При подтверждении Ozon проверит баланс; если средств окажется недостаточно, подтвердить отправление не получится.
После успешного подтверждения получите через API этикетку в формате PDF, распечатайте её и наклейте на отправление.
В приложении у покупателя начнёт отображаться заказ, и клиент сможет его отслеживать.
Передайте отправление в Ozon.

Отслеживание отправления#

Через API можно получить:

подробную информацию о конкретном отправлении;
список отправлений;
статус — текущий и историю изменений. Например, отправление может последовательно перейти в состояния Создано → Готово к отгрузке → Доставляется → В пункте выдачи / У курьера → Доставлено. Также предусмотрены отдельные статусы для ошибок, отмены и проблем при приёмке.

Отмена отправления#

Отправление можно отменить через API, пока оно не доставлено получателю. Если отменить уже переданное Ozon отправление, оно начнёт двигаться обратно к вам как возврат — через API можно отслеживать его статус.