行程中修改目的地-修改目的地
接口概述
1、该接口用来在行程中更新目的地信息。
2、如果携程未收到确认信息,携程会持续重试3次,每次间隔5秒。如果3次尝试都无信息,携程会通过邮件通知供应商修改用车人信息,由对方客服手动修改。
3、信息修改可能会发生在下单后、行程结束前任何时刻,已经取消的订单不会发生修改。
请求地址
地址格式:{Domain}/{Channel}/modifyconfirm/2.0/{timeStamp}/{sign}
请求内容
ModifyDestinationRequest
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
ctripPurchaseOrderId |
Long |
是 |
携程采购单号 |
881823967638342968 |
18位 |
vendorOrderId |
String |
是 |
供应商订单id |
|
|
priceMark |
String |
是 |
价格标签 |
B00AABFF7DEA0ABD |
|
currentAddress |
GeoDTO |
是 |
当前位置信息 |
|
|
arrAddress |
GeoDTO |
是 |
目的地位置信息 |
|
GeoDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
address |
String |
是 |
地址 |
携程旅行网(新总部) |
POI名称 |
detailAddress |
String |
否 |
详细地址 |
上海市-长宁区-金钟路968号凌空SOHO16号楼 |
POI详细地址 |
longitude |
BigDecimal |
是 |
经度 |
121.351145 |
精确到小数点后6位,不足6位补0 |
latitude |
BigDecimal |
是 |
纬度 |
31.221373 |
精确到小数点后6位,不足6位补0 |
geoType |
String |
是 |
坐标系类型 |
GCJ02 |
GCJ02;WGS84 |
poiCode |
String |
否 |
携程地址ID信息 |
|
|
cityId |
long |
是 |
城市Id |
258 |
城市ID列表 |
cityName |
String |
是 |
城市名称 |
福州 |
城市ID列表 |
返回内容
ModifyDestinationResponse
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
msgCode |
string |
是 |
响应码 |
OK |
响应码 |
message |
string |
是 |
响应详情 |
OK |
响应码 |
响应码
msgCode |
message |
OK |
成功 |
ERROR_MODIFY_NOT_ALLOW |
当前订单不可修改兜底错误,如订单状态未拦截、供应商不支持修改但上游调了接口等 |
ERROR_MODIFY_MAX_LIMIT |
当前无剩余修改次数 |
ERROR_MODIFY_OUT_RANGE |
目的地超出可修改范围 |
ERROR_MODIFY_PRICE_INVALID |
预估价失效 |
ERROR_MODIFY_JOURNEY_CONFLICT |
行程时间冲突例如修改后行程时间变长,但司机接下来有预约单等待服务 |
请求示例
{
"ctripPurchaseOrderId": 4295005950734823,
"vendorOrderId": "2022022022",
"priceMark":"B00AABFF7DEA0ABD",
"currentAddress": {
"address": "清华大学",
"detailAddress": "海淀区 双清路30号",
"longitude": 116.32676694616,
"latitude": 40.003909840453,
"geoType": "GCJ02"
},
"arrAddress": {
"address": "清华大学",
"detailAddress": "海淀区 双清路30号",
"longitude": 116.32676694616,
"latitude": 40.003909840453,
"geoType": "GCJ02"
}
}
响应示例
{
"msgcode": "OK",
"message": "成功",
}