行程中修改目的地-预估费用

接口概述

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 响应码

ShoppingQueryProductDTO

参数 类型 必传 描述 示例 备注
price BigDecimal 价格 50 单位:元,注:此价格不含附加服务
estimation EstimationStandardDTO 预估信息
feeItems FeeItemV2DTO 报价费用列表

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": "成功"
}

results matching ""

    No results matching ""