创建代购订单

携带商品与 SKU 信息向 HioBuy 提交代购订单，通常在使用 商品详情 之后调用。若在第三方平台结账前需试算费用，请使用 订单预览。

PUThttps://open.hiobuy.com/api/client/daigou-open/create-order

若实际 API 基地址不同，请替换 `https://open.hiobuy.com`。

请求头

名称必填类型说明
X-Uuid是string商户 UUID（账户唯一标识）
Currency否string结算币种，如 `CNY`（人民币）、`USD`。需在商户后台配置对应汇率。

请求体

名称必填类型说明
warehouse_id是string仓库 ID
user_id是string您系统中对接 HioBuy 的终端用户 ID
shop_id是string卖家店铺 ID
shop_name是string卖家店铺名称
platform是string平台：`taobao`（淘宝）、`1688`、`weidian`（微店）
platform_url是string商品链接
name是string商品标题
title_cn否string中文商品标题
goods_amount否string商品总金额
freight_fee是string国内运费，默认 `0`
remark否string订单备注
skus是arraySKU 行项目（见下表）
address是object收货地址（见下表）
express_line_id否string国际物流线路 ID

skus[]

名称必填类型说明
price是number | string该 SKU 单价
platform_sku是string平台 SKU ID
quantity是string购买数量
freight_fee否string行级运费（如有）
sku_info是objectSKU 元数据（见下表）

skus[].sku_info

名称必填类型说明
shop_id是string店铺 ID
shop_name是string店铺名称
sku_img是stringSKU 主图 URL
imgs是arraySKU 图片 URL 列表
spec_id否string1688 规格 ID（1688 必填）
min_order_quantity否string1688 起订量
batch_number否string1688 批次数量
specs否array规格项（`label`、`value`）
priceRangeList否array1688 阶梯价（`startQuantity`、`price`）

skus[].sku_info.specs[]

名称必填类型说明
label是string规格名（如颜色、尺码）
value是string规格值

address

名称必填类型说明
receiver_name是string收件人姓名
address是string详细地址
province是string省
city是string市
district是string区/县
street否string街道
company是string集运仓或货代公司名称
postcode是string邮政编码
timezone是string时区
phone是string手机号
email否string邮箱
country_name是string国家名称
country是object国家信息（见下表）

address.country

名称必填类型说明
country_code是string国家代码（如 `CN`）
name是string国家名称

请求示例

{
  "warehouse_id": "3",
  "user_id": "161037",
  "shop_id": "BBBZSESFJBTCxhL370nJnRUjQ",
  "shop_name": "示例店铺",
  "platform": "1688",
  "platform_url": "https://detail.1688.com/offer/682292125022.html",
  "name": "商品英文标题",
  "title_cn": "商品中文标题",
  "goods_amount": "480",
  "freight_fee": "8",
  "remark": "订单备注",
  "skus": [
    {
      "price": "120",
      "platform_sku": "4881544500911",
      "quantity": "2",
      "sku_info": {
        "shop_id": "BBBZSESFJBTCxhL370nJnRUjQ",
        "shop_name": "示例店铺",
        "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": "张三",
    "address": "A 栋 101",
    "province": "广东省",
    "city": "深圳市",
    "district": "龙华区",
    "street": "科技园",
    "company": "转运公司",
    "postcode": "518054",
    "timezone": "0086",
    "phone": "18512345678",
    "email": "user@example.com",
    "country_name": "中国",
    "country": {
      "country_code": "CN",
      "name": "中国"
    }
  }
}

响应示例

{
  "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"
  }
}
实际响应还包含仓库、服务费、优惠券等字段，下表仅列出常用字段。

响应字段

顶层字段

名称类型说明
retnumber状态码，`1` 表示成功
msgstring状态说明
dataobject已创建的订单

data（主要字段）

名称类型说明
idinteger订单内部 ID
order_snstring代购订单号
user_idstring终端用户 ID
goods_amountnumber商品小计
freight_feenumber运费
amountnumber订单总额
statusinteger订单状态码
status_namestring订单状态说明
currencystring结算币种
ratestring使用的汇率
addressobject收货地址（与请求一致回显）
skusarray已创建的 SKU 行
created_atstring创建时间

data.skus[]（行项目）

名称类型说明
idinteger行 ID
platform_skustring平台 SKU ID
quantityinteger数量
pricenumber单价
amountnumber行小计
codestring行项目编号

相关接口