首页 /接口文档 /正文/

19：取件后修改地址预询价

2026年07月21日

取件后修改地址预询价

接口说明：
1、用于订单取件后修改收件坐标前的费用预估。
2、预询价成功后会返回 modifyToken，调用 /openapi/merchants/v5/modifyAddress 确认改址时需要传入该凭证。
3、仅支持已取件且未进入终态的订单。预询价金额仅作为本次改址费用参考，实际补交金额以确认改址接口返回为准。
参数 示例 说明
clientId sssHhHPkzCNWG1sFs App-key
shopId 20000000000001715 商户 ID
timestamp 1634095503814 毫秒级时间戳
data 参考入参示例 业务入参，JSON 字符串
sign 04C53CAF9FE2D8D535BA39D44B4F63DB 签名
  • data 参数说明
参数 字段描述 类型/是否必传 说明
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：高德坐标系；不传按百度坐标处理
  • 出参说明
参数 类型/是否必传 说明 示例
payModifyFee Long/YES 本次改址预计需补交金额，单位：分 500
totalFeeAfterSave Long/YES 改址后订单预计实付总额，单位：分 5121
modifyToken String/YES 预询价凭证，确认改址时必传 TDH2022082318101307_500_0_1728577900000
totalDistance Integer/YES 改址后预计配送距离，单位：米 16800
  • 入参示例
clientId:sssHhHPkzCNWG1sFs
shopId:20000000000001715
timestamp:1634095503814
data:{"issOrderNo":"TDH2022082318101307","thirdOrderNo":"C1119A000013053981","toAddress":"北京市海淀区永泰庄地铁站","toLatitude":40.043612,"toLongitude":116.361199,"lbsType":1}
sign:0B80707C9DD5D94ECA063682085D36AA
  • 出参示例
{
  "status": 200,
  "msg": null,
  "data": {
    "payModifyFee": 500,
    "totalFeeAfterSave": 5121,
    "modifyToken": "TDH2022082318101307_500_0_1728577900000",
    "totalDistance": 16800
  }
}
  • 接口注意点
1、预询价接口只计算改址费用并返回 modifyToken，不会实际修改订单地址；
2、确认改址时需将本接口返回的 modifyToken 传入 /openapi/merchants/v5/modifyAddress；
3、经纬度必须成对传入，并且在合法范围内：纬度 -90 到 90，经度 -180 到 180；
4、lbsType 为 1 时按高德坐标传入，系统会转换为百度坐标；不传或传 0 时按百度坐标处理；
5、仅支持已取件且未取消、未关闭、未完单的订单；
6、改址后总配送距离不能超过 150 公里；
7、新收件坐标需要与原收件坐标不同，否则会返回没有需要修改的信息；
8、订单号必须同时匹配闪送订单号 issOrderNo 和第三方订单号 thirdOrderNo，且订单需归属当前 clientId。
关键词：