Справочник методов Seller API для Ozon Доставки на продавцов

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

1. POST v1/delivery/check — Проверка доступности доставки Ozon для покупателя

Метод позволяет определить, доступна ли доставка Ozon для конкретного покупателя. Важно: проверка не учитывает ограничения по сумме покупки, категории товаров и географии.

Рекомендации: 

• Передавайте мобильный номер телефона с кодом страны без символа "+". Продавец должен самостоятельно убедиться в принадлежности номера покупателю и отсутствии мошеннических действий.
• Ранняя проверка номера позволяет показать покупателю на сайте возможность доставки товаров, которые также продаются на Ozon.

2. POST v1/delivery/map — Получение списка точек самовывоза на карте

Метод предназначен для отрисовки карты точек самовывоза. Он отображает агрегированные точки ("кластеры") при сильном отдалении. Ответ метода содержит координаты кластеров, которые можно использовать для их "раскрытия" и получения списка точек или более мелких кластеров.

Рекомендации: 

• Автоматизация агрегации точек избавляет продавца от необходимости хранить и постоянно обновлять весь список.
• Метод не предоставляет подробную информацию о точке. Для этого используйте v1/delivery/point/info.
• Сочетание методов отрисовки карты и получения информации о точке позволяет воспроизвести функционал карты Ozon.

3. POST v1/delivery/point/list — Получение списка всех точек самовывоза

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

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

4. POST v1/delivery/point/info — Получение информации о выбранной точке самовывоза

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

Отображение этой информации поможет покупателю выбрать наиболее подходящую точку самовывоза.

5. POST v2/delivery/checkout — Определение доступности товара и расчет сроков доставки и предрасчет комиссий

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

Рекомендуется использовать не только при формировании корзины, но и непосредственно перед оформлением заказа для проверки актуальности остатков и маршрутов. Это гарантирует, что сформированный заказ будет соответствовать заявленным срокам.

6. POST v2/order/create — Создание заказа

Метод позволяет создать заказ для выбранного покупателя и получателя в системе Ozon. Необходимо передавать актуальную информацию из метода "чекаута".

Рекомендации: 

• В результате метод отдает созданный заказ и отправления (постинги) внутри него.
• Пример ссылки на заказ для покупателей в приложении Ozon: https://www.ozon.ru/my/orderdetails/?order={order_number}
• В ответе могут вернуться не все постинги. После получения ответа необходимо вызвать POST v3/posting/fbo/list - Список отправлений по схеме FBO (или POST v4/posting/fbs/list - Список постингов FBS  для FBS) для получения всех постингов по "order_number".

7. POST v1/posting/marks — Получение списка кодов маркировок товаров “Честный знак”

Метод позволяет получить статус выдачи экземпляра и коды маркировки "Честный знак" для каждого отправления.

Рекомендации: 

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

8. POST v1/cancel-reason/list — Список причин отмен заказа

Метод позволяет записать в систему все доступные причины отмены.

Рекомендации: 

Список обновляется редко, но может быть изменен Ozon. Для поддержания актуальности рекомендуется обновлять список раз в неделю.

Примеры причин отмен заказа:

• 501 - Ozon перенес срок доставки
• 502 - Отменили часть товаров из заказа
• 503 - Не применилась скидка или промокод
• 504 - Хочу изменить заказ и оформить заново
• 505 - Слишком долго ждать
• 506 - Нашел дешевле
• 508 - Не нашел нужную причину
• 710 - Указал неверный адрес

9. POST v1/cancel-reason/list-by-order — Динамический список отмен заказа

Метод предоставляет список причин отмены, которые можно использовать для отмены всего заказа в момент запроса.

Список причин может меняться в зависимости от логистического статуса заказа. Рекомендуем использовать этот метод только в тех случаях, когда покупатель инициировал процесс отмены заказа.

10. POST v1/cancel-reason/list-by-posting — Динамический список отмен постинга из заказа

Метод предоставляет список причин отмены, которые можно использовать для отмены постинга/отправления из заказа в момент запроса.

Список причин может меняться в зависимости от логистического статуса постинга/отправления. Рекомендуем использовать этот метод только в тех случаях, когда покупатель инициировал процесс отмены заказа.

11. POST v1/order/cancel/check — Проверка доступности отмены

Метод позволяет определить, возможна ли отмена заказа в данный момент.

Рекомендуем использовать этот метод для информирования покупателя о возможности отмены заказа.

12. POST v1/order/cancel — Метод отмены заказа

Метод отменяет весь заказ со всеми постингами/отправлениями.

При отмене заказа используйте только причины отмены, полученные из динамического списка отмен заказа. (v1/cancel-reason/list-by-order)

13. POST v1/posting/cancel — Метод отмены постинга из заказа

Метод отменяет постинг/отправление из заказа.

При отмене постинга/отправления используйте только причины отмены, полученные из динамического списка отмен постинга/отправления. (v1/cancel-reason/list-by-posting)

14. POST v1/order/cancel/status — Статус отмены заказа

Метод позволяет проверить статус отмены заказа.

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

15. POST v1/posting/cancel/status — Статус отмены постинга из заказа

Метод позволяет проверить статус отмены постинга/отправления.

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

16. POST v3/posting/fbo/list — Список отправлений по схеме FBO

Метод возвращает актуальную информацию об отправлениях FBO.

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

Рекомендации:

• Следите за отправлениями, так как возможен перенос даты доставки.
• Описание возможных статусов описано ниже

17. POST v2/posting/fbo/get — Информация об отправлении по схеме FBO

Метод возвращает актуальную информацию об отправлении FBO.

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

Рекомендации:

• Следите за отправлениями, так как возможен перенос даты доставки.
• Описание возможных статусов из параметра substatus.

18. POST v1/returns/list — Информация о возвратах

Если покупатель при получении отправления отказался от одного из товаров, то отправление останется в статусе "Доставлено" и дополнительно будет заведено еще одно отправление, которое будет в статусе "Отменено". Информацию по отмене можно будет получить через метод v1/returns/list. У такой отмены будет тип type: PartialReturn.

19. POST v1/analytics/stocks — Данные по остаткам на складах Ozon для схемы FBO (для планирования поставок)

20. POST v4/product/info/stocks — Данные по остаткам товаров в Ozon

21. POST v1/product/info/stocks-by-warehouse/fbo – Данные по остаткам в разрезе складов FBO

22. POST v1/warehouse/ozon/list – Информация по складам FBO. Используется для определения стока на Fresh складе, для отсечения.

23. POST v3/posting/fbs/get — Информация о постинге FBS

Метод возвращает актуальную информацию об отправлении FBS. В отличие от v3/posting/fbs/list, принимает на вход только одно отправление, но предоставляет более подробную информацию.

24. POST v2/posting/fbs/product/cancel — Отмена отправления нескольких товаров из постинга FBS

Метод используется для отмены части товаров из отправления, которые невозможно доставить.

25. POST v2/posting/fbs/cancel — Отмена постинга FBS

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

Схема работы с заказами FBS-отправлениями доступна по ссылке

Схема работа с заказами FBO-отправлениями доступна по ссылке