创建运单
查看API域名
接口地址:
/order/create-order
请求方式:POST
请求头:
| 参数名 | 参数值 |
| Content-Type | application/x-www-form-urlencoded |
| Authorization | Bearer |
请求参数:
| 参数名 | 参数值 | 必填 | 描述 |
| async | int | 否 | 异步获取面单设置,9:不启用(默认),10:启用(可在用户后台->设置->异步设置中填入URL并启用) |
| product_code | string | 是 | 渠道地址名(在获取发货渠道地址API中获取) |
| type | int | 否 | 类型,仓库地址=>9(传空或不传值则默认9),GOFO和UNI上门取件(一票一件)=>10(在获取发货渠道地址API中获取) |
| currency_code | string | 否 | 货币代码,如美元:USD。不填默认为USD |
| customer_order_num | string | 是 | 客户订单号 |
| rate_order_num | string | 是 | 报价单号,由价格试算接口获取 |
| shipper_name | string | 是 | 发件人姓名 |
| shipper_phone | int | 是 | 发件人电话 |
| shipper_postal_code | string | 否 | 发件邮编,有申报需求的如(gofo、uniuni需传) |
| shipper_country | string | 否 | 发件人国家,有申报需求的如(gofo、uniuni需传) |
| shipper_state | string | 否 | 发件州,有申报需求的如(gofo、uniuni需传) |
| shipper_city | string | 否 | 发件城市,有申报需求的如(gofo、uniuni需传) |
| shipper_add_1 | string | 否 | 发件地址1,有申报需求的如(gofo、uniuni需传) |
| shipper_add_2 | string | 否 | 发件地址2 |
| shipper_company | string | 否 | 发件人公司 |
| unit | int | 是 | 尺寸-重量单位: Lbs-Inch/Kgs-Cm (9=>Lbs-Inch,10=>Kgs-Cm)默认Kgs-Cm |
| target_name | string | 是 | 收货人姓名 |
| target_phone | string | 是 | 收货人电话 |
| target_postal_code | int | 是 | 收货地邮编 |
| target_country | string | 是 | 收货地国家(如:US) |
| target_state | string | 是 | 收货地洲 |
| target_city | string | 是 | 收货地城市 |
| target_add_1 | string | 是 | 街道地址1 |
| target_add_2 | string | 否 | 街道地址2 |
| target_company | string | 否 | 收货地公司 |
| signature_service | string | 否 | 签名服务: None/Normal signature/Adult signature (传值填写:-/SSF/ASS) |
| package_qty | int | 是 | 包裹数量 |
| packages | JSON[] | 是 | 包裹信息 |
packages参数:
| 参数名 | 参数值 | 必填 | 描述 |
| x | double | 是 | 长 |
| y | v | 是 | 宽 |
| z | double | 是 | 高 |
| net_weight | double | 是 | 净重 |
| qty | int | 是 | 数量 |
| seq | int | 否 | 箱号 |
| name_cn | string | 否 | 申报中文名,有申报需求的如(一票一件,gofo、uniuni需传) |
| name_en | string | 否 | 申报英文名,有申报需求的如(一票一件,gofo、uniuni需传) |
| declared_value | string | 否 | 申报价格,有申报需求的如(一票一件,gofo、uniuni需传) |
| sku | string | 否 | SKU,有申报需求的如(一票一件,gofo、uniuni需传) |
| remark | string | 否 | 备注 |
响应结果:
| 参数名 | 参数值 | 是否一定回传 | 描述 |
| err_code | int | 是 | 状态码,详见状态码表 |
| msg | string | 是 | 描述信息 |
| result | string(JSON) | 否,code为200回传 | 结果(结果集) |
result结果集(code=200回传):
| 参数名 | 参数值 | 是否一定回传 | 描述 |
| async | int | 是 | 是否异步查询下单结果,(是:10,否:9) |
| total | int | 是 | 预付总金额 |
| fee_list_cost | JSON[] | 否 | 费用清单 |
| customer_order_num | int | 是 | 客户订单号 |
| master_tracking_number | string | 是 | 主跟踪号 |
| merge_label | string | 是 | 面单下载链接 |
| order_num | string | 是 | 订单号 |
| packages_list | JSON[] | 是 | 包裹单号、面单、箱号等 |
响应示例:
成功:
{
"err_code": 0,
"msg": "执行成功",
"result": {
"customer_order_num": "test1234567890001",
"total": "14.43",
"fee_list_cost": [
{
"code": "431580860",
"name": "快递费",
"currency": "USD",
"zone_code": "2",
"amount": "5.94"
},
{
"code": "431580861",
"name": "燃油附加费",
"currency": "USD",
"zone_code": "2",
"amount": "1.13"
},
{
"code": "431580862",
"name": "快递费",
"currency": "USD",
"zone_code": "2",
"amount": "5.94"
},
{
"code": "431580864",
"name": "燃油附加费",
"currency": "USD",
"zone_code": "2",
"amount": "1.13"
}
],
"master_tracking_number": "1ZK6B4420330175884",
"merge_label": "xxxxxxxxx",
"order_num": "LSM370918409065598976",
"packages_list": [
{
"tracking_number": "96320019602069871xxxxxxxxx",
"is_main": 10,
"seq": "test1234567890001-1",
"box_num": "1",
"package_label": "http://xxxxxxx.pdf"
},
{
"tracking_number": "9632001960206987xxxxxxxxx",
"is_main": 9,
"seq": "test1234567890001-2",
"box_num": "2",
"package_label": "http://xxxxxxx.pdf"
}
],
"async": 9
}
}
失败:
{
"err_code": 404,
"msg": "错误描述"
}