1.创建订单
1.1应用场景
创建订单
1.2注意事项
- 由于参数比较多因此出现问题请先检查入参字段名拼写是否正确。
- 看清2选1的参数或互斥参数,传参时仅可传一个。
- 当地址出现中文或参数值中有标点符号的时候需要url encode -utf8转码,否则可能出现授权认证失败等错误。
- 创建订单成功会返回1条或多条订单信息
- 当返回多条订单信息时是由于:贸易类型不同、商品供应商不同、跨境贸易单笔订单金额超5000 等原因拆单造成。
- 本系统保税商品不支持拆单,请务必一单一单发送,除保税商品外,其他商品如果发自不同的仓库就会进行自动拆单
1.3API内容
基本信息(API接口)
API名称 | /api/v2/order/createOrders |
---|---|
功能描述 | 创建订单 |
请求方式POST |
基本信息(SDK接口)
名称 | HDServiceProvider.class# createOrders() |
---|---|
功能描述 | 创建订单 |
请求方式POST |
输入参数
变量名 | 含义 | 类型 | 备注 |
---|---|---|---|
area | 区域编码 | string | 必填 ;从地区表中获取的reginId(第三级区级) @mock=310011 |
goodsSns | 商品货号SNs | string | 必填,与goodsIds二选一,以逗号隔开 |
nums | 数量 | string | 必填; 逗号分隔 |
name | 收货人姓名 | string | 必填 ; |
productNums | 规格数量 | string | 必填;以逗号隔开 @mock=1 逗号分隔 |
mobile | 手机 | string | 必填 |
appkey | 应用平台appkey | string | 必填 @mock=63568028 |
address | 地址 | string | 必填 详细地址; |
memberId | 会员ID | string | 必填; |
goodsIds | 商品ID | string | 必填 与goodsSns二选一,以逗号隔开; @mock=8309 |
identification | 身份证号码 | string | 必填 @mock=362502199106073246 |
thirdBuyAmount | 代购价格 | number | 保税商品必填,非保税商品不需要填写 @mock=89.9。 保税商品只能单个下单 报税商品不支持合并下单 |
thirdOrderNo | 保税商品订单号 | string | 对接保税收款的第三方必填,其他的不需要填写(2020.1.8);必须是发起支付的订单号,同样也是海带的订单号 |
lifes | 生产日期 | string | 选填;保税商品只能传递一个 保税、直邮代表:有效期 一般贸易:生产日期 |
paymentId | 支付Id | number | 选填 ; |
customOrder | 第三方订单号 | string | 选填 |
remarks | 买家备注 | string | 选填; #;#隔开 |
返回结果
变量名 | 含义 | 类型 | 备注 |
---|---|---|---|
result | number | @mock=1 | |
data|2 | object | ||
sn | ——订单编号 | string | @mock=20170707000019 |
memberId | ——客户ID | string | @mock=985 |
orderId | ——订单ID | string | @mock=533913 |
goodsNum | ——商品数量 | number | @mock=1 |
orderSource | ——订单来源 | number | @mock=0 |
paymentId | ——支付方式ID | string | @mock=0 |
code | string | @mock= | |
success | boolean | @mock=true | |
message | string | @mock= |
1.4返回json串示例
{
"code": "",
"data": {
"orderList": [
{
"goodsNum": 1,
"memberId": "985",
"needPayMoney": 135,
"orderAmount": 135,
"orderId": "533914",
"orderSource": 6,
"paymentId": "0",
"preferential": 0,
"shippingAmount": 0,
"sn": "201707070000190",
"taxAmount": 11
},
{
"goodsNum": 1,
"memberId": "985",
"needPayMoney": 135,
"orderAmount": 135,
"orderId": "533914",
"orderSource": 6,
"paymentId": "0",
"preferential": 0,
"shippingAmount": 0,
"sn": "201707070000190",
"taxAmount": 11
}
]
},
"message": "",
"result": 1,
"success": true
}