Create Daigou Order

Submit a daigou (purchasing agent) order to HioBuy with product and SKU details—typically after Product Details. For marketplace fee preview before third-party checkout, use Order Preview instead.

PUThttps://open.hiobuy.com/api/client/daigou-open/create-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
`Currency`	No	string	Settlement currency code, e.g. `CNY` (RMB), `USD`. Exchange rates must be configured in the merchant backend.

Request body

Name	Required	Type	Description
`warehouse_id`	Yes	string	Warehouse ID
`user_id`	Yes	string	End-customer user ID in your HioBuy integration
`shop_id`	Yes	string	Seller shop ID
`shop_name`	Yes	string	Seller shop name
`platform`	Yes	string	Marketplace: `taobao`, `1688`, `weidian`
`platform_url`	Yes	string	Product listing URL
`name`	Yes	string	Product title
`title_cn`	No	string	Chinese product title
`goods_amount`	No	string	Total product amount
`freight_fee`	Yes	string	Domestic shipping fee. Default: `0`
`remark`	No	string	Order remark
`skus`	Yes	array	SKU line items (see below)
`address`	Yes	object	Shipping address (see below)
`express_line_id`	No	string	International shipping line ID

`skus[]`

Name	Required	Type	Description
`price`	Yes	number \| string	Unit price for this SKU
`platform_sku`	Yes	string	Marketplace SKU ID
`quantity`	Yes	string	Quantity
`freight_fee`	No	string	Per-line shipping fee (when applicable)
`sku_info`	Yes	object	SKU metadata (see below)

`skus[].sku_info`

Name	Required	Type	Description
`shop_id`	Yes	string	Shop ID
`shop_name`	Yes	string	Shop name
`sku_img`	Yes	string	SKU main image URL
`imgs`	Yes	array	SKU image URLs
`spec_id`	No	string	1688 specification ID (required for 1688)
`min_order_quantity`	No	string	1688 minimum order quantity
`batch_number`	No	string	1688 batch quantity
`specs`	No	array	Variant options (`label`, `value`)
`priceRangeList`	No	array	1688 tiered pricing (`startQuantity`, `price`)

`skus[].sku_info.specs[]`

Name	Required	Type	Description
`label`	Yes	string	Attribute name (e.g. Color, Size)
`value`	Yes	string	Attribute value

`address`

Name	Required	Type	Description
`receiver_name`	Yes	string	Recipient name
`address`	Yes	string	Detailed address
`province`	Yes	string	Province / state
`city`	Yes	string	City
`district`	Yes	string	District
`street`	No	string	Street
`company`	Yes	string	Forwarding warehouse or agent company name
`postcode`	Yes	string	Postal code
`timezone`	Yes	string	Time zone
`phone`	Yes	string	Phone number
`email`	No	string	Email address
`country_name`	Yes	string	Country display name
`country`	Yes	object	Country object (see below)

`address.country`

Name	Required	Type	Description
`country_code`	Yes	string	ISO country code (e.g. `CN`)
`name`	Yes	string	Country name

Example request

{
  "warehouse_id": "3",
  "user_id": "161037",
  "shop_id": "BBBZSESFJBTCxhL370nJnRUjQ",
  "shop_name": "Example Shop",
  "platform": "1688",
  "platform_url": "https://detail.1688.com/offer/682292125022.html",
  "name": "Product title",
  "title_cn": "商品中文标题",
  "goods_amount": "480",
  "freight_fee": "8",
  "remark": "Order note",
  "skus": [
    {
      "price": "120",
      "platform_sku": "4881544500911",
      "quantity": "2",
      "sku_info": {
        "shop_id": "BBBZSESFJBTCxhL370nJnRUjQ",
        "shop_name": "Example Shop",
        "sku_img": "https://cbu01.alicdn.com/img/ibank/example.jpg",
        "spec_id": "7f74e9dcb448177df9404cb65f6bad1e",
        "min_order_quantity": "2",
        "batch_number": "1",
        "imgs": [
          "https://cbu01.alicdn.com/img/ibank/example.jpg"
        ],
        "specs": [
          {
            "label": "颜色",
            "value": "白色"
          },
          {
            "label": "尺码",
            "value": "XL"
          }
        ]
      }
    }
  ],
  "address": {
    "receiver_name": "Zhang San",
    "address": "Building A, Room 101",
    "province": "广东省",
    "city": "深圳市",
    "district": "龙华区",
    "street": "Tech Park",
    "company": "Forwarding Co.",
    "postcode": "518054",
    "timezone": "0086",
    "phone": "18512345678",
    "email": "user@example.com",
    "country_name": "中国",
    "country": {
      "country_code": "CN",
      "name": "中国"
    }
  }
}

Sample response

{
  "ret": 1,
  "msg": "success",
  "data": {
    "id": 1572,
    "order_sn": "DG646",
    "goods_amount": 3516.52,
    "freight_fee": 58.61,
    "amount": 3575.13,
    "status": 1,
    "status_name": "已付款",
    "skus": [
      {
        "id": 1595,
        "platform_sku": "4881544500911",
        "code": "TG2503310010"
      }
    ],
    "created_at": "2025-03-31 18:23:52"
  }
}

The live response includes warehouse, services, coupons, and more. Only commonly used fields are listed below.

Response fields

Top level

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

`data` (key fields)

Name	Type	Description
`id`	integer	Internal order ID
`order_sn`	string	Daigou order number
`user_id`	string	End-user ID
`goods_amount`	number	Product subtotal
`freight_fee`	number	Shipping fee
`amount`	number	Order total
`status`	integer	Order status code
`status_name`	string	Order status label
`currency`	string	Settlement currency
`rate`	string	Exchange rate applied
`address`	object	Shipping address echoed from request
`skus`	array	Created SKU line items
`created_at`	string	Creation timestamp

`data.skus[]` (line item)

Name	Type	Description
`id`	integer	Line item ID
`platform_sku`	string	Marketplace SKU ID
`quantity`	integer	Quantity
`price`	number	Unit price
`amount`	number	Line subtotal
`code`	string	Line item reference code

Create Daigou Order

Request headers

Request body

skus[]

skus[].sku_info

skus[].sku_info.specs[]

address

address.country