Создание заказа закупки API

POST /v1/orders/create использует тот же receiver + lines, что и preview. На этой странице — поля только для create и примеры запросов.

См. также: Order preview · Response model

Строки заказа (как в preview)

Используйте те же имена полей, что и в Product API.

Шаг	Product API	Order `lines[]`
1	`POST /v1/products/detail` или search	—
2	`id` из ответа	`lines[].id` (рекомендуется)
3	`variants[].sku_id` выбранного SKU	`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 можно опустить

Пример 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

Используйте те же id / spec_id, что и в 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": "请尽快发货"
}

Ответ

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