取件后修改地址确认
接口说明：
1、用于订单取件后修改收件坐标并确认执行改址。
2、调用本接口前，需要先调用取件后修改地址预询价接口 /openapi/merchants/v5/preModifyAddress 获取 modifyToken。
3、仅支持已取件且未进入终态的订单。改址成功后会重新规划配送路径，并按实际增程费用扣款。
请求 url
/openapi/merchants/v5/modifyAddress
接口协议以及签名计算
测试联调
入参说明
| 参数 |
示例 |
说明 |
| clientId |
sssHhHPkzCNWG1sFs |
App-key |
| shopId |
20000000000001715 |
商户 ID |
| timestamp |
1634095503814 |
毫秒级时间戳 |
| data |
参考入参示例 |
业务入参，JSON 字符串 |
| sign |
04C53CAF9FE2D8D535BA39D44B4F63DB |
签名 |
| 参数 |
字段描述 |
类型/是否必传 |
说明 |
| issOrderNo |
闪送订单号 |
String/YES |
下单或计费返回的平台订单号 |
| thirdOrderNo |
第三方平台流水号 |
String/YES |
下单时传入的第三方订单号 |
| toAddress |
新收件地址 |
String/NO |
新收件地址名称；未传时按原收件地址参与改址 |
| toAddressDetail |
新收件详细地址 |
String/NO |
当前改址确认逻辑不使用该字段；如需修改详细地址文本，请调用 modifyOrderAttr |
| toLatitude |
新收件纬度 |
Double/YES |
改址时必须与 toLongitude 成对传入；纬度范围 -90 到 90 |
| toLongitude |
新收件经度 |
Double/YES |
改址时必须与 toLatitude 成对传入；经度范围 -180 到 180 |
| lbsType |
坐标类型 |
Integer/NO |
0：百度坐标系，1：高德坐标系；不传按百度坐标处理 |
| modifyToken |
预询价凭证 |
String/YES |
由 /openapi/merchants/v5/preModifyAddress 返回 |
| deductFlag |
是否同意扣除余额 |
Boolean/NO |
payModifyFee 大于 0 时需传 true；不传默认 false |
| 参数 |
类型/是否必传 |
说明 |
示例 |
| payModifyFee |
Long/YES |
本次改址实际补交金额，单位：分 |
500 |
| totalFeeAfterSave |
Long/YES |
改址后订单实付总额，单位：分 |
5121 |
| totalDistance |
Integer/YES |
改址后配送距离，单位：米 |
16800 |
clientId:sssHhHPkzCNWG1sFs
shopId:20000000000001715
timestamp:1634095503814
data:{"issOrderNo":"TDH2022082318101307","thirdOrderNo":"C1119A000013053981","toAddress":"北京市海淀区永泰庄地铁站","toLatitude":40.043612,"toLongitude":116.361199,"lbsType":1,"modifyToken":"TDH2022082318101307_500_0_1728577900000","deductFlag":true}
sign:0B80707C9DD5D94ECA063682085D36AA
{
"status": 200,
"msg": null,
"data": {
"payModifyFee": 500,
"totalFeeAfterSave": 5121,
"totalDistance": 16800
}
}
1、需先调用预询价接口获取 modifyToken；
2、经纬度必须成对传入，并且在合法范围内：纬度 -90 到 90，经度 -180 到 180；
3、lbsType 为 1 时按高德坐标传入，系统会转换为百度坐标；不传或传 0 时按百度坐标处理；
4、仅支持已取件且未取消、未关闭、未完单的订单；
5、改址后总配送距离不能超过 150 公里；
6、新收件坐标需要与原收件坐标不同，否则会返回没有需要修改的信息；
7、订单号必须同时匹配闪送订单号 issOrderNo 和第三方订单号 thirdOrderNo，且订单需归属当前 clientId；
8、预计补交金额 payModifyFee 大于 0 时，确认改址需传 deductFlag=true；余额不足会返回改址失败。
