国際フルフィルメント概要
/v1/fulfillment/* は、商品が HIOBuy 倉庫に入庫した後の 国際 物流を扱います。国内での購入は Procurement orders を参照してください。
アプリで 倉庫フルフィルメント が必要です (ポータル認可)。自社フルフィルメントアプリは 403 FULFILLMENT_MODE_NOT_SUPPORTED を受け取ります。
API の提供状況 {#availability}
| パス | ステータス |
|---|---|
/v1/fulfillment/shipments/* | 予定 — 仕様は安定。Gateway への展開中 |
/v1/fulfillment/balance | 予定 |
/v1/shipments (legacy) | 非推奨 |
エンドツーエンドの流れ {#end-to-end-flow}
- 調達注文を作成 → 販売者が倉庫へ発送
- 注文詳細 → 入庫後に
parcel_nos[] - 送料見積もり →
shipping_channel_codeを選択 - 配送プレビュー → 正確な価格
- 配送を作成 →
shipment_id - 配送を支払い → ウォレットから差し引き
- 国際追跡
エンドポイントガイド
| トピック | パス | ドキュメント |
|---|---|---|
| 簡易送料見積もり | POST .../freight/estimate | Freight estimate |
| 正確な倉庫見積もり | POST .../preview | Shipment preview |
| 作成 / 支払い / キャンセル / 詳細 | POST .../shipments/* | Shipments |
| 国際追跡 | POST .../logistics/trace | Tracking |
| ウォレット残高 | GET /v1/fulfillment/balance | Balance |
| レスポンスフィールド | — | Fulfillment response models |
| 商品属性 | GET .../item-attributes | Freight estimate |
倉庫モードでの調達
/v1/orders/* パスは変わりません。Gateway が HIOBuy に転送します。商品 API は引き続きマーケットプレイスを直接呼び出します。
国内追跡: order logistics trace (倉庫モードではプロキシされます)。
エラー
FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE — Errors を参照してください。