Order Preview

Preview product subtotal, payable total, and domestic shipping for a third-purchase marketplace order (Taobao / 1688) before checkout. This is separate from Create Daigou Order (daigou-open).

POSThttps://open.hiobuy.com/api/client/third-purchase/preview-order

If your deployment uses a different base URL, replace `https://open.hiobuy.com` accordingly.

Request headers

Name	Required	Type	Description
`X-Uuid`	Yes	string	Merchant UUID assigned to your account

Request body

Name	Required	Type	Description
`platform`	Yes	string	Marketplace code: `taobao` (Taobao), `1688` (1688.com)
`skus`	Yes	array	Line items to preview
`address`	Yes	object	Shipping address

`skus[]`

Name	Required	Type	Description
`goods_id`	Yes	string	Product SPU ID (`num_iid` from Product Details)
`sku_id`	Yes	string	SKU ID
`sum`	Yes	string	Quantity (API field name `sum`)
`spec_id`	No	string	1688 specification ID. Required for 1688; use `0` when the product has no variants

`address`

Name	Required	Type	Description
`receiver_name`	Yes	string	Recipient name
`postcode`	Yes	string	Postal code
`province`	Yes	string	Province / state
`city`	Yes	string	City
`district`	Yes	string	District
`street`	No	string	Street
`address`	Yes	string	Detailed address
`phone`	Yes	string	Phone number

Example request

{
  "platform": "1688",
  "skus": [
    {
      "goods_id": "930485860295",
      "sku_id": "5815062253431",
      "sum": "2",
      "spec_id": "94d1d179497744028aa76873afdeba62"
    }
  ],
  "address": {
    "receiver_name": "Zhang San",
    "postcode": "518000",
    "province": "Guangdong",
    "city": "Shenzhen",
    "district": "Nanshan",
    "street": "Tech Park",
    "address": "Building A, Room 101",
    "phone": "13800138000"
  }
}

Sample response

{
  "ret": 1,
  "msg": "success",
  "data": {
    "goodsFee": 1349.5,
    "paymentFee": 1349.5,
    "freightFee": 0,
    "isFree": false
  }
}

Response fields

Top level

Name	Type	Description
`ret`	number	Status code. `1` indicates success
`msg`	string	Status message
`data`	object	Preview result

`data`

Name	Type	Description
`goodsFee`	number	Product subtotal
`paymentFee`	number	Order total payable
`freightFee`	number	Domestic shipping fee
`isFree`	boolean	Whether shipping is free