Order Preview API

POST /v1/orders/preview - Positionen, Preise und inländische Fracht vor Create validieren.

Verwandt: Bestellung erstellen · Antwortmodell

Request-Body

Feld	Erforderlich	Beschreibung
`channel`	Ja	`1688` \| `taobao`
`receiver`	Ja	Inländische Inbound-Adresse: `name`, `mobile`, `province`, `city`, `address`; 1688 ohne `address_id` benötigt zusätzlich `district`
`lines[]`	Ja	`id` + `spec_id` + `quantity` (`offer_id` / `mi_id` still work) pro Position
`response_format`	Nein	`standard` (Standard) oder `upstream`

Taobao: Gateway führt automatisch Batch-Checks für mi_id + Traffic-sku_id aus und ruft anschließend Upstream Render auf. Nutzen Sie eine aktuelle id / mi_id als lines[].id — sie ändert sich regelmäßig und darf nicht langfristig gecacht werden.

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.

Beispiel

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
    }
  ]
}

Antwort

StandardOrderPreviewResult - siehe Bestell-Antwortmodelle. JSON-Beispiel: Antwortformat.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support