調達注文概要
/v1/orders/* は 国内調達 を扱います。1688/Taobao の販売者へ注文し、中国国内の入庫先住所へ配送する注文です。国際配送ではありません。入庫後は Fulfillment を使用してください。
金額は CNY fen (分) です。Response format に従って response_format を設定します。
Products から商品 ID を注文明細へマッピングします: source_product_id → lines[].offer_id, variants[].sku_id → lines[].spec_id。
ライフサイクル {#lifecycle}
- Preview — 明細、価格、送料を検証
- Create — 調達注文を作成
- Pay — マーケットプレイスのウォレットで決済
- Detail / list — ステータスを追跡
- Domestic trace — 販売者 → 倉庫
- Cancel — 許可されている場合
エンドポイントガイド
| ステップ | パス | ドキュメント |
|---|---|---|
| Preview | POST /v1/orders/preview | Order preview |
| Create | POST /v1/orders/create | Create order |
| Pay | POST /v1/orders/pay | Pay order |
| Detail | POST /v1/orders/detail | Order detail |
| List | POST /v1/orders/list | Order detail |
| Cancel | POST /v1/orders/cancel | Cancel order |
| Domestic trace | POST /v1/orders/logistics/trace | Domestic logistics trace |
| Taobao purchases | POST /v1/orders/purchase/query | Order detail |
| レスポンススキーマ | — | Order response models |
チャネルショートカット: /v1/orders/1688/*, /v1/orders/taobao/* (本文では channel を省略できます)。
国内物流と国際物流 {#domestic-vs-international}
| 区間 | API |
|---|---|
| 販売者 → 中国倉庫 | Domestic trace |
| 倉庫 → 海外購入者 | International tracking |