조달 주문 생성 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