API de prévisualisation de commande
POST /v1/orders/preview — valide les lignes, les prix et le fret domestique avant création.
Lié : Créer une commande · Modèle de réponse
Corps de requête
| Champ | Obligatoire | Description |
|---|---|---|
channel | Oui | 1688 | taobao |
receiver | Oui | Adresse domestique d’entrée : name, mobile, province, city, address ; 1688 sans address_id nécessite aussi district |
lines[] | Oui | id + spec_id + quantity (offer_id / mi_id still work) par ligne |
response_format | Non | standard (par défaut) ou upstream |
Taobao : la passerelle effectue automatiquement un batch-check de mi_id + sku_id traffic, puis appelle le render upstream. Utilisez un id / mi_id frais comme lines[].id — il change périodiquement et ne doit pas être mis en cache longtemps.
Line mapping
Prefer lines[].id = search/detail id. offer_id and mi_id remain compatible.
lines[] | 1688 | Taobao |
|---|---|---|
id (preferred) | search/detail id (offerId) | search/detail id (mi_id) |
offer_id | Compatible alias of id | Compatible alias of id |
mi_id | — | Compatible Taobao alias of id |
spec_id | variants[].sku_id | variants[].sku_id (or mpSkuId) |
If both id and offer_id are sent, offer_id wins. Otherwise id (then mi_id) is copied to offer_id. Do not pass Taobao source_product_id. Taobao id / mi_id rotates periodically.
Exemple
POST /v1/orders/preview
{
"channel": "1688",
"receiver": {
"name": "张三",
"mobile": "15251667788",
"province": "浙江省",
"city": "杭州市",
"district": "滨江区",
"address": "网商路699号"
},
"lines": [
{
"id": "554456348334",
"spec_id": "b266e0726506185beaf205cbae88530d",
"quantity": 5
}
]
}Taobao example
POST /v1/orders/preview
{
"channel": "taobao",
"receiver": {
"name": "张三",
"mobile": "15251667788",
"province": "浙江省",
"city": "杭州市",
"district": "滨江区",
"address": "网商路699号"
},
"lines": [
{
"id": "0000iIpSgysC-ca00kbG-Y-LXZu7WojtOJ5cnKTyzoID9UM",
"spec_id": "6079564221554",
"quantity": 5
}
]
}Réponse
StandardOrderPreviewResult — voir modèles de réponse commande. Exemple JSON : Format de réponse.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days