Procurement orders overview

/v1/orders/* covers domestic procurement — orders with 1688/Taobao sellers for delivery into a China inbound address. Not international shipping; use Fulfillment after inbound.

Amounts are CNY fen (分). Set response_format per Response format.

Map product ids from Products: search/detail id → lines[].id (compatible: offer_id, Taobao mi_id); variants[].sku_id → lines[].spec_id.

Taobao id / mi_id rotates periodically. Do not cache it long-term. Re-fetch from search or detail before preview/create.

Lifecycle {#lifecycle}

  1. Preview — validate lines, prices, freight
  2. Create — place procurement order
  3. Pay — settle with marketplace wallet
  4. Detail / list — track status
  5. Domestic trace — seller → warehouse
  6. Cancel — when allowed

Endpoint guide

StepPathDoc
PreviewPOST /v1/orders/previewOrder preview
CreatePOST /v1/orders/createCreate order
PayPOST /v1/orders/payPay order
DetailPOST /v1/orders/detailOrder detail
ListPOST /v1/orders/listOrder detail
CancelPOST /v1/orders/cancelCancel order
Domestic tracePOST /v1/orders/logistics/traceDomestic logistics trace
Taobao purchasesPOST /v1/orders/purchase/queryOrder detail
Response schemas—Order response models

Channel shortcuts: /v1/orders/1688/*, /v1/orders/taobao/* (body may omit channel).

Domestic vs international logistics {#domestic-vs-international}

LegAPI
Seller → China warehouseDomestic trace
Warehouse → overseas buyerInternational tracking

Get Support

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

Email support