Перейти до основного вмісту
Якщо ваш магазин продає фізичні товари, використовуйте ці ендпоінти, щоб підключити свій склад або програмне забезпечення для доставки. Ваш магазин має бути схвалений для фізичних товарів у розділі Settings › Physical goods.

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.