調達注文作成 API

POST /v1/orders/create は preview と同じ receiver + lines 本文を使います。本ページでは create 専用フィールドとリクエスト例を示します。

行項目（preview と同じ）

Product API と同じフィールド名を使ってください。

ステップ	Product API	Order `lines[]`
1	`POST /v1/products/detail` または search	—
2	レスポンス `id`	`lines[].id`（推奨）
3	選択 SKU の `variants[].sku_id`	`lines[].spec_id`
4	数量	`lines[].quantity`

詳細: preview line mapping. offer_id / mi_id は後方互換の別名です。Taobao では source_product_id を使わないでください。

追加フィールド

external_order_id — 自社の冪等キー
buyer_message — 販売者へのメモ
Taobao: outer_purchase_id / purchase_amount は省略可（自動生成・preview から算出）

1688 create 例

POST /v1/orders/create
{
  "channel": "1688",
  "flow": "general",
  "receiver": {
    "name": "张三",
    "mobile": "15251667788",
    "province": "浙江省",
    "city": "杭州市",
    "district": "滨江区",
    "address": "网商路699号"
  },
  "lines": [
    {
      "id": "554456348334",
      "spec_id": "b266e0726506185beaf205cbae88530d",
      "quantity": 5
    }
  ],
  "external_order_id": "MY-ORDER-20260101",
  "buyer_message": "请尽快发货",
  "trade_type": "assureTrade"
}

Taobao create 例

preview と 同じ id / spec_id を使ってください:

POST /v1/orders/create
{
  "channel": "taobao",
  "receiver": {
    "name": "张三",
    "mobile": "15251667788",
    "province": "浙江省",
    "city": "杭州市",
    "district": "滨江区",
    "address": "网商路699号"
  },
  "lines": [
    {
      "id": "0000iIpSgysC-ca00kbG-Y-LXZu7WojtOJ5cnKTyzoID9UM",
      "spec_id": "6079564221554",
      "quantity": 1
    }
  ],
  "external_order_id": "MY-TB-ORDER-001",
  "buyer_message": "请尽快发货"
}

レスポンス

StandardOrderCreateResult — order response models. 成功時は order_id を保存し、pay / detail に進んでください。

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support