1. Найдите заказы к отправке
to_ship возвращает оплаченные заказы с еще не отправленными позициями, начиная с самых старых. Другие фильтры: in_transit, delivered, issues (неудачные доставки, возвраты) и all.
GET /orders/{invoiceId} возвращает адрес, каждую позицию с shipped_quantity, отправления, возвраты и заметки.
2. Создайте отправление
- Не передавайте
items, чтобы отправить все оставшееся. Для частичной отправки передайтеitems: [{ "invoice_item_id": 55, "qty": 1 }]. - Клиент получит письмо со ссылкой для отслеживания. Передайте
notify_customer: false, чтобы не отправлять его. - Ссылка для отслеживания формируется по перевозчику.
GET /shippingвозвращает коды перевозчиков.
3. Обновите статус
label_created, shipped, in_transit, out_for_delivery, delivered, failed_attempt, returned_to_sender. Каждый из них добавляется в хронологию отслеживания, которую видит клиент. fulfillment_status заказа автоматически следует за отправлениями.
Возвраты
Клиенты запрашивают возврат со страницы своего заказа в течение срока возврата, заданного для товара. Обрабатывайте запросы с помощьюPATCH /orders/{invoiceId}/returns/{returnId}:
GET /returns?status=requested возвращает открытые запросы по всем заказам.
Настройки доставки
Просматривайте и изменяйте зоны, тарифы и адреса складов через/shipping/zones и /shipping/locations. Рассчитайте стоимость доставки корзины с помощью POST /shipping/quote.