Порядок работы с методами

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

Чтобы добавить метод доставки, в разделе Методы доставки нажмите Создать метод доставки. Укажите, как и куда будете передавать нам отправления. Вы можете добавить несколько методов доставки с разными точками отгрузки.
Подробнее о настройке методов доставки в Базе знаний продавца

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

Предварительный расчёт и оформление заказа#

Покупатель авторизуется на сайте продавца.
Продавец проверяет доступность доставки Ozon для покупателя по его номеру телефона: /v1/delivery/check-client. Доставка доступна только для покупателей, которые зарегистрированы на Ozon.
Продавец может показать примерный срок доставки товаров на основе местоположения покупателя: /v1/delivery/location. Рекомендуем использовать метод в случае, если покупатель ещё не выбрал товар, так как срок доставки предварительный и не учитывает параметры конкретного товара и точки доставки.

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

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

При доставке в пункт выдачи продавец может:
- Получить список всех доступных пунктов: /v1/delivery-point/list. Из них продавец самостоятельно может отфильтровать пункты по местоположению и показать их покупателю списком или на карте.
- Проверить доступность пунктов выдачи для доставки выбранных товаров: /v1/delivery-point/check-availability. Доступность пунктов зависит от метода доставки, габаритов и объявленной стоимости заказа.
- Получить информацию о пункте, включая его адрес и график работы: /v1/delivery-point/info.
Продавец проверяет возможность доставки отправлений из заказа: /v1/order/checkout. В запросе передаётся:
- метод доставки, через который будет отгружаться товар;
- предполагаемые объёмно-весовые характеристики (ОВХ) отправления;
- тип доставки — в пункт выдачи или курьером;
- объявленная стоимость отправления.
Если доставка отправления возможна, в ответе возвращается предварительный расчёт срока, стоимости доставки и страховки.
Покупатель оформляет заказ на сайте продавца.
Продавец создаёт заказ в Ozon методом /v1/order/create. В запросе передаётся:

метод доставки;
предполагаемые ОВХ отправления;
тип доставки;
объявленная стоимость отправления;
описание содержимого отправления.

Чтобы проверить актуальность предварительного расчёта, перед методом /v1/order/create используйте метод /v1/order/checkout с теми же параметрами.

Подтверждение и отгрузка отправлений#

Если товар в наличии, продавец подтверждает начало сборки: /v1/posting/approve.
Мы проверяем баланс продавца для возможности отгружать отправления. Посмотреть и пополнить баланс можно в личном кабинете Ozon Доставки.
Продавец может узнать результат подтверждения сборки: /v1/posting/info. Если подтверждение успешно, отправление переходит в статус ready_for_shipping.
Продавец получает этикетку отправления: /v1/posting/label. Она обязательна для приёмки в логистику Ozon. Получить этикетку можно только для отправлений в статусе ready_for_shipping.

Обработка отправлений#

Продавец может:

Получить информацию обо всех своих отправлениях и их актуальных статусах: /v1/posting/search. Можно фильтровать список по статусу, методу доставки, дате создания отправления.
Получить параметры и статус конкретного отправления: /v1/posting/info.
Запросить историю статусов отправления: /v1/posting/status-history. История учитывает только статусы отправления на прямом потоке.

Если покупатель отменяет заказ на сайте продавца или продавец не может выполнить заказ, для отмены отправлений в этом заказе используется метод /v1/posting/cancel. Отмена доступна до перехода отправления в статус delivered.

Продавец может узнать результат отмены: /v1/posting/info. Если отмена успешна, отправление переходит в статус canceled. Движение отменённого отправления обратно к продавцу можно отслеживать через методы по возвратам.

Обработка возвратов#

Продавец может:

Получить список всех своих отменённых отправлений и возвратов: v1/return/search.
Получить параметры и статус по конкретному возврату: v1/return/info.
Запросить историю статусов возвратов: /v1/return/status-history. История учитывает только статусы отправления на возвратном потоке.
Скачать PDF-файл со штрихкодом для получения возвратов: /v1/return/download-barcode. Срок действия штрихкода указан в файле. Получайте штрихкод непосредственно перед получением возвратов.

Чтобы обновить действующий штрихкод, используйте: /v1/return/reset-barcode.