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: source_product_id → lines[].offer_id, variants[].sku_id → lines[].spec_id.

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