当用户对订单信息进行修改操作时，第三方接入商调用安能开放平台的修改订单接口， 订单在”已开单”前，才可以修改成功。
当用户对订单信息进行修改操作时，第三方接入商调用安能开放平台的修改订单接口， 订单在”已开单”前，才可以修改成功。
(1)、安能开放平台会校验修改订单的请求来源是否为订单所在的第三方接入商，不支持一个接入商修改另一个接入商的订单。
(2)、修改订单只能在开单之前才能进行，建议第三方接入商在调用此接口前先判断订单状态。未受理、已受理、已撤销、已拒绝状态均能修改成功，可允许对同一个订单进行多次修改。
(3)、订单信息中订单号作为两个系统之间订单的映射条件，不能修改；订单状态为订单在安能物流的状态，不能修改，当状态发生变化后，由安能开放平台推送至第三方接入商。
入参
|
序号 |
参数名 |
参数说明 |
数据类型 |
必填 |
备注 |
|---|---|---|---|---|---|
|
1 |
params |
Json字符串 |
String |
是 |
Json字符串，具体见下面params参数说明 |
|
2 |
timestamp |
时间戳 |
String |
是 |
当前时间对应的时间戳 |
|
3 |
digest |
签名摘要 |
String |
是 |
base64(MD5(params +code + AppSecret)) |
|
4 |
code |
客户ID |
String |
是 |
客户唯一ID简码大写字母（订单头） |
Params 入参数据
|
参数名 |
参数说明 |
最大长度 |
类型 |
必填 |
备注 |
|
orderNo |
订单号 |
64 |
String |
是 |
|
|
sendSiteId |
寄件网点ID |
8 |
String |
否 |
默认-1 |
|
dispatchSiteId |
派件网点ID |
8 |
String |
否 |
|
|
totalPiece |
总件数 |
6 |
Int |
否 |
默认为0 |
|
totalWeight |
重量 |
10 |
double |
否 |
|
|
totalVol |
体积 |
8 |
double |
否 |
|
|
paySideId |
付款方ID |
8 |
Int |
否 |
默认为0 |
|
payModeId |
支付模式ID |
8 |
int |
否 |
103到付现金104月结102现金109返款到付110回单付 |
|
freightCharge1 |
网上运费单价 |
6 |
double |
否 |
默认为0 |
|
freightCharge |
网上运费价格 |
6 |
double |
否 |
默认为0 |
|
insuredAmount |
保价金额 |
6 |
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 |
包装说明 |
100 |
String |
否 |
|
|
ewbFlag |
开单标识 |
1 |
int |
否 |
（0-未开 1-已开） |
|
receiveEmployeeId |
收件业务员 |
8 |
int |
否 |
|
|
sendCompanyName |
寄件公司名称 |
100 |
String |
否 |
没有公司名则填人名 |
|
sendLinkMan |
寄件联系人 |
100 |
String |
否 |
|
|
sendPhoneSms |
寄件手机 |
20 |
String |
否 |
|
|
sendPhone |
寄件联系电话 |
32 |
String |
否 |
|
|
sendAddress |
寄件地址 |
256 |
String |
否 |
|
|
sendPostcode |
寄件邮编 |
6 |
String |
否 |
|
|
sendProvince |
寄件省份 |
32 |
String |
否 |
|
|
sendCity |
寄件城市 |
32 |
String |
否 |
|
|
sendCounty |
寄件区县 |
32 |
String |
否 |
|
|
sendStartTime |
客户约定取货开始时间 |
20 |
String |
否 |
yyyy-MM-dd HH:mm:ss |
|
sendEndTime |
客户约定取货结束时间 |
20 |
String |
否 |
yyyy-MM-dd HH:mm:ss |
|
dispatchCompanyName |
收件公司名称 |
100 |
String |
否 |
没有公司名则填人名 |
|
dispatchLinkMan |
收件联系人 |
100 |
String |
否 |
|
|
dispatchPhoneSms |
收件手机 |
20 |
String |
否 |
|
|
dispatchPhone |
收件联系电话 |
32 |
String |
否 |
|
|
dispatchAddress |
收件地址 |
256 |
String |
否 |
|
|
dispatchPostcode |
收件邮编 |
6 |
String |
否 |
|
|
dispatchProvince |
收件省份 |
32 |
String |
否 |
|
|
dispatchCity |
收件城市 |
32 |
String |
否 |
|
|
dispatchCounty |
收件区县 |
32 |
String |
否 |
|
|
dispatchStartTime |
客户约定送达开始时间（13:20） |
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值示例：
{
"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,
"bankName": "丞风银行",
"subBankName": "丞风银行亚洲分行",
"accountCode": "6532658987",
"accountName": "xp"
}
|
序号 |
参数名 |
参数说明 |
数据类型 |
是否必填 |
备注 |
|
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":"摘要验证错误"}
