修改订单其他信息
接口说明:
1、用于订单取件后修改收件人信息、收件地址文本、期望送达时间、备注等非经纬度信息。
2、本接口不修改收件经纬度,不重新计价;如需修改经纬度,请使用 /openapi/merchants/v5/modifyAddress。
3、仅支持已取件且未进入终态的订单。
请求 url
/openapi/merchants/v5/modifyOrderAttr
接口协议以及签名计算
测试联调
入参说明
| 参数 |
示例 |
说明 |
| clientId |
sssHhHPkzCNWG1sFs |
App-key |
| shopId |
20000000000001715 |
商户 ID |
| timestamp |
1634095503814 |
毫秒级时间戳 |
| data |
参考入参示例 |
业务入参,JSON 字符串 |
| sign |
04C53CAF9FE2D8D535BA39D44B4F63DB |
签名 |
| 参数 |
字段描述 |
类型/是否必传 |
说明 |
| issOrderNo |
闪送订单号 |
String/YES |
下单或计费返回的平台订单号 |
| thirdOrderNo |
第三方平台流水号 |
String/YES |
下单时传入的第三方订单号 |
| toAddress |
新收件地址 |
String(100)/NO |
仅修改地址文本,不修改经纬度 |
| toAddressDetail |
新收件详细地址 |
String(100)/NO |
门牌号、楼层等详细地址 |
| toReceiverName |
新收件人姓名 |
String(20)/NO |
收件人姓名 |
| toMobile |
新收件手机号 |
String(11)/NO |
支持 11 位手机号 |
| expectStartTime |
期望送达起始时间 |
Long(13)/NO |
毫秒级时间戳 |
| expectEndTime |
期望送达终止时间 |
Long(13)/NO |
毫秒级时间戳 |
| remark |
备注 |
String(300)/NO |
订单备注 |
| 参数 |
类型/是否必传 |
说明 |
示例 |
| data |
Void/NO |
成功时无业务返回数据 |
null |
clientId:sssHhHPkzCNWG1sFs
shopId:20000000000001715
timestamp:1634095503814
data:{"issOrderNo":"TDH2022082318101307","thirdOrderNo":"C1119A000013053981","toAddress":"北京市海淀区永泰庄地铁站","toAddressDetail":"A口1楼","toReceiverName":"小送","toMobile":"13800000001","expectStartTime":1728577900000,"expectEndTime":1728581500000,"remark":"请电话联系收件人"}
sign:0B80707C9DD5D94ECA063682085D36AA
{
"status": 200,
"msg": null,
"data": null
}
1、本接口不支持修改经纬度,不会重新计价;
2、如需要修改收件位置坐标,请先调用预询价接口,再调用取件后修改地址确认接口;
3、仅支持已取件且未取消、未关闭、未完单的订单;
4、订单号必须同时匹配闪送订单号 issOrderNo 和第三方订单号 thirdOrderNo,且订单需归属当前 clientId;
5、建议至少传入一个需要修改的字段,未传的字段不会修改;
6、期望送达时间入参为毫秒级时间戳,系统保存时会转换为秒级时间戳。