Create procurement order API

POST /v1/orders/create uses the same receiver + lines body as preview. This page adds create-only fields and full request examples.

Related: Order preview · Response model

Line mapping (same as preview)

Use the same field names as the Product API.

Step	Product API	Order `lines[]`
1	`POST /v1/products/detail` or search	—
2	Response `id`	`lines[].id` (preferred)
3	Selected `variants[].sku_id`	`lines[].spec_id`
4	Quantity	`lines[].quantity`

Full rules: preview line mapping. Do not use Taobao source_product_id.

Additional fields

external_order_id — your idempotency key
buyer_message — note to seller
Taobao: outer_purchase_id auto-generated if omitted

1688 create example

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 example

Use the same id and spec_id as preview:

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": "请尽快发货"
}

Response

StandardOrderCreateResult. On success, persist order_id for pay, detail, and trace.

See order response models.

Get Support

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

Email support