行程中修改目的地-预估费用
接口概述
1、该接口用来查询新目的地的预估费用,供应商应返回对应的路线、时间和基础报价。
2、性能要求:建议在500ms以内返回信息,最长不超过1000ms。除去网络因素,建议自身系统的处理时间控制在150ms以内。以上衡量标准为10分钟压力测试,询价频率500ms/次。
请求地址
地址格式:{Domain}/{Channel}/modifyquery/2.0/{timeStamp}/{sign}
请求内容
QueryModifyPriceRequest
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
ctripPurchaseOrderId |
Long |
是 |
携程采购单号 |
881823967638342968 |
18位 |
vendorOrderId |
String |
是 |
供应商订单id |
|
|
priceMode |
int |
是 |
计价模式 |
|
0-普通计费 1-一口价 |
currentAddress |
GeoDTO |
是 |
当前经纬度 |
|
|
deptAddress |
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列表 |
返回内容
QueryModifyPriceResponse
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
priceMark |
String |
是 |
价格标签 |
B00AABFF7DEA0ABD |
注1 |
currency |
String |
是 |
币种 |
CNY |
可选的为USD/CNY/EUR/JPY |
queryResultList |
ShoppingQueryProductDTO |
是 |
价格信息 |
|
|
msgCode |
String |
是 |
响应码 |
OK |
响应码 |
message |
String |
否 |
响应详情 |
OK |
响应码 |
EstimationStandardDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
estimateDistance |
Integer |
是 |
预估里程 |
16000 |
单位:米 |
estimateTime |
Integer |
是 |
预估时间 |
1200 |
单位:秒 |
FeeItemV2DTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
code |
string |
是 |
费用代码 |
|
费用编码 |
name |
string |
是 |
费用名称 |
|
|
amount |
decimal |
是 |
费用金额 |
|
注:折扣项的费用金额应该是负数,如折扣金额8元,此处应返回 -8 |
discount |
boolean |
是 |
是否折扣条目 |
|
注:仅在费用金额为负数的场景下返回true |
响应码
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",
"currentAddress": {
"address": "清华大学",
"detailAddress": "海淀区 双清路30号",
"longitude": 116.32676694616,
"latitude": 40.003909840453,
"geoType": "GCJ02"
},
"deptAddress": {
"address": "首都国际机场",
"detailAddress": "首都国际机场",
"longitude": 116.588057,
"latitude": 40.080519,
"geoType": "GCJ02"
},
"arrAddress": {
"address": "清华大学",
"detailAddress": "海淀区 双清路30号",
"longitude": 116.32676694616,
"latitude": 40.003909840453,
"geoType": "GCJ02"
}
}
响应示例
{
"priceMark": "B3730C27FE83FC8B",
"currency":"CNY",
"queryResultList":{
"price": 195
}
"msgCode": "OK",
"message": "成功"
}