API предварительного расчета заказа

POST /v1/orders/preview — проверяет lines, prices и внутренний freight перед create.

Request body

Поле	Обязательно	Описание
`channel`	Да	`1688` \| `taobao`
`receiver`	Да	Внутренний inbound address: `name`, `mobile`, `province`, `city`, `address`; для 1688 без `address_id` также нужен `district`
`lines[]`	Да	`id` + `spec_id` + `quantity` (`offer_id` / `mi_id` still work) для каждой строки
`response_format`	Нет	`standard` (по умолчанию) или `upstream`

Taobao: Gateway автоматически выполняет batch-check mi_id + traffic sku_id, затем вызывает upstream render. Use a fresh id / mi_id as lines[].id — it rotates periodically.

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.

Пример

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

Ответ

StandardOrderPreviewResult — см. модели ответов заказов. JSON example: формат ответа.

Get Support

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

Email support