用户在线下订单,调用开放平台新增订单接口,将订单信息流转至订单系统。
用户在线下订单,调用开放平台新增订单接口,将订单信息流转至订单系统。
(1)、新增订单成功后,系统默认订单状态为待受理。
(2)、对于返回的异常代码,如果属于系统异常,建议再次发送请求,属于业务异常, 不进行重发。
入参
参数名 |
参数说明 |
数据类型 |
必填 |
备注 |
---|---|---|---|---|
params |
Json字符串 |
String |
是 |
Json字符串,具体见下面params参数说明 |
timestamp |
时间戳 |
String |
是 |
当前时间对应的时间戳 |
digest |
签名摘要 |
String |
是 |
base64(MD5(params +code + AppSecret)) |
code |
客户ID |
String |
是 |
客户唯一ID简码大写字母(订单头) |
Params参数说明
参数名 |
参数说明 |
最大长度 |
类型 |
必填 |
备注 |
---|---|---|---|---|---|
orderNo |
订单号 |
64 | String | 是 |
Code+时间戳 |
sendSiteId |
寄件网点ID |
8 |
String |
否 |
默认-1 |
dispatchSiteId |
派件网点ID |
8 |
String |
否 |
|
goodsType |
商品类别 |
1 |
int |
否 |
默认0 |
0:文件类 1:电子产品类(包括家用电器) 2:办公用品类, 服装鞋帽,箱包类 3:化妆品 美容产品类 4:珠宝,手表,眼镜,贵重饰品类 5:食品,保健药品类 6:工艺品类(包括瓷器,茶具,烹饪用品) 7:玩具乐器类 8:其他类 |
|||||
goodsName |
商品名称 |
100 |
String |
否 |
|
piece |
商品数量 |
5 |
int |
否 |
|
remark |
商品描述 |
500 |
String |
否 |
|
totalPiece |
总件数 |
6 |
Int |
默认为0 |
|
totalWeight |
重量 |
double |
否 |
|
|
totalVol |
体积 |
double |
否 |
|
|
paySideId |
付款方ID |
8 |
Int |
否 |
默认为0 |
payModeId |
支付模式ID |
8 |
int |
否 |
103到付现金104月结102现金109返款到付110回单付 |
freightCharge1 |
网上运费单价 |
6 |
double |
否 |
默认为0 |
freightCharge |
网上运费价格 |
6 |
double |
否 |
默认为0 |
insuredAmount |
保价金额 |
double |
否 |
|
|
codCharge |
代收货款 |
6 |
double |
否 |
|
ecWarehouseId |
电商仓库ID |
8 |
long |
否 |
|
receiveFlag |
上门接货类型(1,需要上门接货0,客户自送) |
1 |
int |
否 |
|
smsFlag |
短信通知 |
1 |
int |
否 |
(0-否 1-是) |
serviceType |
服务类型(1-正常, 2-次日达 4-次晨达 8-当日达) |
2 |
int |
否 |
|
packageFlag |
是否打包 |
1 |
int |
否 |
(0-否 1-是) |
packageDesc |
包装说明 |
String |
否 |
|
|
ewbFlag |
开单标识 |
1 |
int |
否 |
(0-未开 1-已开) |
receiveEmployeeId |
收件业务员 |
8 |
int |
否 |
|
sendCompanyName |
寄件公司名称 |
100 |
String |
是 |
没有公司名则填人名 |
sendLinkMan |
寄件联系人 |
String |
是 |
|
|
sendPhoneSms |
寄件手机 |
20 |
String |
是 |
|
sendPhone |
寄件联系电话 |
String |
否 |
|
|
sendAddress |
寄件地址 |
String |
是 |
|
|
sendPostcode |
寄件邮编 |
String |
否 |
|
|
sendProvince |
寄件省份 |
String |
是 |
|
|
sendCity |
寄件城市 |
String |
是 |
|
|
sendCounty |
寄件区县 |
32 |
String |
是 |
|
sendStartTime |
客户约定取货开始时间 |
String |
否 |
yyyy-MM-dd HH:mm:ss |
|
sendEndTime |
客户约定取货结束时间 |
20 |
String |
否 |
|
dispatchCompanyName |
收件公司名称 |
100 |
String |
是 |
没有公司名则填人名 |
dispatchLinkMan |
收件联系人 |
100 |
String |
是 |
|
dispatchPhoneSms |
收件手机 |
String |
是 |
|
|
dispatchPhone |
收件联系电话 |
32 |
String |
否 |
|
dispatchAddress |
收件地址 |
String |
是 |
|
|
dispatchPostcode |
收件邮编 |
String |
否 |
|
|
dispatchProvince |
收件省份 |
String |
是 |
|
|
dispatchCity |
收件城市 |
String |
是 |
|
|
dispatchCounty |
收件区县 |
32 |
String |
是 |
|
dispatchStartTime |
客户约定送达开始时间(13:20) |
String |
否 |
yyyy-MM-dd HH:mm:ss |
|
dispatchEndTime |
客户约定送达结束时间(14:20) |
20 |
String |
否 |
yyyy-MM-dd HH:mm:ss |
coupon |
优惠券 |
20 |
String |
否 |
|
returnTime |
返款时效 |
20 |
String |
否 |
代收货款为必传字段 |
returnTarget |
返款对象 |
1 |
int |
否 |
1-返款客户;2-返款网点代(收货款为必传字段) |
subOrdeId |
采购单号 |
|
String |
否 |
|
memberType |
CXT: 诚信通;PT:普通会员;POW:实力商家 |
|
String |
否 |
|
serviceDipFlag |
天猫服务类型 |
|
int |
否 |
|
reservationFixDate |
预约时间 |
|
date |
否 |
|
reservationFixDate |
预约完成时间 |
|
date |
否 |
|
fixFinDate |
安装完成时间 |
|
date |
否 |
|
goodCharge |
商品費用 |
|
double |
否 |
|
参数params值示例:
{
"logisticNo": null,
"sendSiteId": null,
"dispatchSiteId": null,
"orderStatus": null,
"totalPiece": null,
"totalWeight": null,
"totalVol": null,
"paySideId": null,
"payModeId": null,
"freightCharge1": null,
"freightCharge": null,
"insuredAmount": null,
"codCharge": null,
"ecWarehouseId": null,
"receiveFlag": null,
"smsFlag": null,
"serviceType": null,
"packageFlag": null,
"packageDesc": null,
"ewbFlag": null,
"receiveEmployeeId": null,
"sendCompanyName": "xxx",
"sendLinkMan": "测试1",
"sendPhoneSms": "00000000",
"sendPhone": null,
"sendAddress": "上海市安能物流",
"sendPostcode": null,
"sendProvince": "上海",
"sendCity": "上海",
"sendCounty": "青浦",
"sendStartTime": null,
"sendEndTime": null,
"dispatchCompanyName": "安能物流",
"dispatchLinkMan": "测试2",
"dispatchPhoneSms": "11111111",
"dispatchPhone": null,
"dispatchAddress": "杭州萧山安能物流",
"dispatchPostcode": null,
"dispatchProvince": "浙江",
"dispatchCity": "杭州",
"dispatchCounty": "萧山",
"dispatchStartTime": null,
"dispatchEndTime": null,
"createdTime": null,
"modifiedBy": null,
"modifiedTime": null,
"rdStatus": null,
"coupon": null,
"ordStatusVO": null,
"goodsType": null,
"goodsName": null,
"piece": null,
"remark": null,
"goodsOrder": null,
"bankName": "丞风银行",
"subBankName": "丞风银行亚洲分行",
"accountCode": "6532658987",
"accountName": "xp",
"orderCanceId": null,
"ordStatusList": null
}
序号 |
参数名 |
参数说明 |
数据类型 |
是否必填 |
备注 |
1 |
result |
返回结果 |
boolean |
是 |
成功:true;失败:false |
2 |
resultCode |
返回码 |
String |
是 |
见码表说明 |
3 |
resultInfo |
返回信息 |
String |
否 |
|
4 |
reason |
原因 |
String |
否 |
|
成功返回数据的结构示例:
{"result":true,"resultCode":"1000","resultInfo":"成功获取","reason":"成功获取"}
失败返回数据的结构示例:
{"result":false,"resultCode":"2002","resultInfo":"摘要验证失败","reason":"摘要验证错误"}