Перейти к основному содержанию
Если ваш магазин продает физические товары, используйте эти эндпоинты, чтобы подключить склад или программу для доставки. Магазин должен быть одобрен для продажи физических товаров в разделе Настройки › Физические товары.

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.