Order preview API
POST /v1/orders/preview — validate lines, prices, and domestic freight before create.
Related: Create order · Response model
Request body
| Field | Required | Description |
|---|---|---|
channel | Yes | 1688 | taobao |
receiver | Yes | Domestic inbound address: name, mobile, province, city, address; 1688 without address_id also needs district |
lines[] | Yes | offer_id, spec_id, quantity per line |
response_format | No | standard (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.