Order Preview
Preview product subtotal, payable total, and domestic shipping for a third-purchase marketplace order (Taobao / 1688) before checkout. This is separate from ().
POST https://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-UuidYes string Merchant UUID assigned to your account
Request body
Name Required Type Description platformYes string Marketplace code: `taobao` (Taobao), `1688` (1688.com) skusYes array Line items to preview addressYes object Shipping address
Name Required Type Description goods_idYes string Product SPU ID (`num_iid` from Product Details) sku_idYes string SKU ID sumYes string Quantity (API field name `sum`) spec_idNo string 1688 specification ID. Required for 1688; use `0` when the product has no variants
Name Required Type Description receiver_nameYes string Recipient name postcodeYes string Postal code provinceYes string Province / state cityYes string City districtYes string District streetNo string Street addressYes string Detailed address phoneYes string Phone number
Example request
Copy {
"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
Copy {
"ret" : 1 ,
"msg" : "success" ,
"data" : {
"goodsFee" : 1349.5 ,
"paymentFee" : 1349.5 ,
"freightFee" : 0 ,
"isFree" : false
}
} Response fields
Top level Name Type Description retnumber Status code. `1` indicates success msgstring Status message dataobject Preview result
Name Type Description goodsFeenumber Product subtotal paymentFeenumber Order total payable freightFeenumber Domestic shipping fee isFreeboolean Whether shipping is free
Related endpoints