Order preview API

POST /v1/orders/preview — validate lines, prices, and domestic freight before create.

Related: Create order · Response model

Request body

FieldRequiredDescription
channelYes1688 | taobao
receiverYesDomestic inbound address: name, mobile, province, city, address; 1688 without address_id also needs district
lines[]Yesoffer_id, spec_id, quantity per line
response_formatNostandard (default) or upstream

Taobao: Gateway auto batch-checks mi_id + traffic sku_id, then calls upstream render.

Example

POST /v1/orders/preview
{
  "channel": "1688",
  "receiver": {
    "name": "张三",
    "mobile": "15251667788",
    "province": "浙江省",
    "city": "杭州市",
    "district": "滨江区",
    "address": "网商路699号"
  },
  "lines": [
    {
      "offer_id": "554456348334",
      "spec_id": "b266e0726506185beaf205cbae88530d",
      "quantity": 5
    }
  ]
}

Response

StandardOrderPreviewResult — see order response models. JSON example: Response format.