文档中心 电商接口 企业下单并支付

企业下单并支付

1.功能说明

企业下单并支付。

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/commerce/order/createEnterpriseOrderWithPay

正式环境和测试环境的域名请见通用协议

HTTPS请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
outer_trade_no String [10,30] 外部交易号,用于做幂等
product_category Integer [1,3] 产品线 ID,允许的产品线:2 员工午餐、3 员工用车、4 员工通讯、10 关爱积分、12 关爱额度
sku_list List<OpSku>对象 sku列表,包含sku编码和购买数量,不允许为空
remark string [0-500] 买家备注
op_deliver_address OpDeliverAddress对象 收货地址(同步)
OpSku对象说明
sku_code String [1,16] sku编码
number Integer [1,10] 购买数量,最小为1,(10位数以下的大于0的整数)
OpDeliverAddress对象说明
receiver_province Integer [1,10] 收货地址省份id
receiver_city Integer [1,10] 收货地址城市id
receiver_area Integer [1,10] 收货地址区域id
receiver_address String [1,500] 收货地址详情
receiver_zip String [1,10] 收货地址邮编
receiver_name String [1,100] 收货人名字(不支持纯数字或者纯字母+数字的或者特殊符号)
receiver_tel String [1,30] 收货人电话
receiver_phone String [1,20] 收货人手机号,(目前只支持11位手机号)
请求示例
POST /commerce/order/createEnterpriseOrderWithPay?access_token=c8802155f04217869aaa8262acad81a1
&sign=dd1c3fe3070a08553dad018aa90f4c08ac62dcac&timestamp=1575543761  HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/json
cache-control: no-cache

{"op_deliver_address":{"receiver_address":"山东省济南市市中区401路","receiver_area":370103,
"receiver_city":370100,"receiver_name":"hyytest","receiver_phone":"18084054666","receiver_province":370000},
"outer_trade_no":"hyytest8450516","product_category":10,"remark":"hyy购买的商品",
"sku_list":[{"number":2,"sku_code":"KC19102900000001"},{"number":1,"sku_code":"KC19092900005336"}]}

					
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data 购物单号,shopOrderCode。查询订单详情或者物流时需要用到
正确返回示例
{"code":0,"data":"13201912051902000005","msg":"OK"}
错误返回示例
{"code":1000210002,"data":null,"msg":"sign check failed!"}