Обзор международного фулфилмента
/v1/fulfillment/* покрывает международную логистику после того, как товары находятся на складе HIOBuy. Внутренняя покупка: заказы закупки.
Требуется warehouse fulfillment для вашего приложения (авторизация в портале). Self-fulfillment apps получают 403 FULFILLMENT_MODE_NOT_SUPPORTED.
Доступность API {#availability}
| Путь | Статус |
|---|---|
/v1/fulfillment/shipments/* | Запланировано — спецификация стабильна; rollout Gateway в процессе |
/v1/fulfillment/balance | Запланировано |
/v1/shipments (legacy) | Deprecated |
Сквозной поток {#end-to-end-flow}
- Создать заказ закупки → продавец отправляет на склад
- Детали заказа →
parcel_nos[], когда поступило - Freight estimate → выбрать
shipping_channel_code - Shipment preview → точная цена
- Создать отправление →
shipment_id - Оплатить отправление → списание wallet
- Международное отслеживание
Справочник endpoint
| Тема | Путь | Документация |
|---|---|---|
| Быстрая freight quote | POST .../freight/estimate | Freight estimate |
| Точная warehouse quote | POST .../preview | Shipment preview |
| Create / pay / cancel / detail | POST .../shipments/* | Отправления |
| International trace | POST .../logistics/trace | Отслеживание |
| Баланс wallet | GET /v1/fulfillment/balance | Баланс |
| Поля ответа | — | Модели ответов fulfillment |
| Атрибуты товара | GET .../item-attributes | Freight estimate |
Закупка в warehouse-mode
Пути /v1/orders/* не меняются; Gateway пересылает в HIOBuy. Product APIs по-прежнему вызывают маркетплейсы напрямую.
Domestic trace: order logistics trace (proxied в warehouse mode).
Ошибки
FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE — см. ошибки.