Как подключить Ozon Доставку для бизнеса через API и работать с отправлениями

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

Личный кабинет остаётся доступен: API — дополнительный способ работы с Ozon Доставкой, а не замена кабинета.

Отдельный материал по теме — «Рекомендации по отображению доставки Ozon на сторонних сайтах».

Статья «Ozon Доставка для бизнеса: расходы на доставку, невыкупы, отмены и другие услуги».

Статья «Настройка кабинета доставки».

Статья «Настройка метода доставки».

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

Ozon Delivery API позволяет встроить Ozon Доставку в оформление и обработку заказов интернет-магазина. Через API доступны следующие операции.

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

Как устроена работа с доставкой

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

Если при расчёте суммы для покупателя не учесть собственные расходы на доставку, разницу придётся покрывать за свой счёт — прибыль от заказа уменьшится.

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

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

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

1. Откройте в личном кабинете раздел «Управление частными приложениями».
2. Нажмите «Создать».
3. Выберите необходимые права доступа для Ozon Delivery API.
4. Создайте приложение.
5. Получите в личном кабинете Client ID и Client Secret. Эти данные используются для настройки авторизации приложения при обращении к API. Client Secret необходимо хранить в защищённом месте и не передавать посторонним.
6. Передайте данные и техническую документацию разработчику, который настроит интеграцию. Дополнительные сведения приведены в документации по авторизации.

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

Подключение через партнёра Ozon

Ozon Доставку для бизнеса можно подключить через ApiShip. Для подключения следуйте инструкции по интеграции через ApiShip.

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

Подготовка к работе

Перед созданием заказов через API необходимо настроить метод доставки в личном кабинете. Он определяет, откуда и каким способом вы будете передавать отправления Ozon.

Для работы с API пока доступен только один способ передачи отправлений — самостоятельная отгрузка в пункт Ozon.

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

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

• Метод доставки.
• Размеры и вес отправления.
• Способ получения, выбранный покупателем.
• Место получения.
• Объявленная стоимость.

В ответ на запрос Ozon может вернуть следующие предварительные данные.

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

Совет по контролю расчётов: сохраняйте предварительные суммы и после оказания услуг сопоставляйте их с итоговыми. Это поможет видеть расхождения и учитывать их при следующих расчётах. Важно сравнивать именно предварительную оценку с фактической стоимостью, а не считать оценку окончательной ценой.

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

1. После создания заказа соберите отправление.
2. Перед подтверждением готовности к отгрузке через API проверьте, достаточно ли средств на балансе. При подтверждении Ozon проверит баланс. Если денег недостаточно, подтвердить отправление не получится.
3. После успешного подтверждения получите через API этикетку в формате PDF. Распечатайте её и наклейте на отправление.
4. Заказ начнёт отображаться в приложении покупателя, и покупатель сможет его отслеживать.
5. Передайте отправление Ozon.

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

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

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

Через API можно получать сведения об отправлениях и ходе доставки.

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

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

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

Главное — различать отмену и фактическое возвращение товара: отменённое отправление, которое уже находится у Ozon, ещё движется обратно, а не лежит на вашем складе.

Следующий вопрос — как организовать учёт товаров, резервирование и контроль сборки рядом с процессом доставки. На демонстрации SelSup можно обсудить эти задачи и посмотреть, как работают учёт остатков, резервирование и контроль заказов.