创建订单

作者 | 6月 26, 2023

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
}

发表评论

您的电子邮箱地址不会被公开。