API preview đơn hàng
POST /v1/orders/preview — validate dòng hàng, giá và freight nội địa trước khi create.
Liên quan: Create order · Response model
Request body
| Field | Required | Description |
|---|---|---|
channel | Yes | 1688 | taobao |
receiver | Yes | Địa chỉ nhập kho nội địa: name, mobile, province, city, address; 1688 khi không có address_id cũng cần district |
lines[] | Yes | offer_id, spec_id, quantity cho mỗi dòng |
response_format | No | standard (mặc định) hoặc upstream |
Taobao: Gateway tự động batch-check mi_id + traffic sku_id, rồi gọi upstream render.
Ví dụ
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 — xem order response models. Ví dụ JSON: Response format.