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

ChampObligatoireDescription
channelOui1688 | taobao
receiverOuiAdresse domestique d’entrée : name, mobile, province, city, address ; 1688 sans address_id nécessite aussi district
lines[]Ouiid + spec_id + quantity (offer_id / mi_id still work) par ligne
response_formatNonstandard (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[]1688Taobao
id (preferred)search/detail id (offerId)search/detail id (mi_id)
offer_idCompatible alias of idCompatible alias of id
mi_idCompatible Taobao alias of id
spec_idvariants[].sku_idvariants[].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

Email support