高低价屏蔽接口信息

更新时间：2022-10-17，可选接入，建议联系商务接入携程自动调价，可有效避免报价被屏蔽。

接口概述

该接口用来根据用户查询价格的记录，返给供应商相关屏蔽价格的信息，包括：高低价类型、屏蔽线金额、屏蔽价格、搜索起始地、航班信息等信息。每当携程收到屏蔽信息就会推送到供应商以便查询。

请求地址

地址格式: {Domain}/{Channel}/pricelimitinfo/2.0/{timeStamp}/{sign}

请求内容

PriceLimitRequest

参数	类型String	必传是	描述	示例	备注
priceLimitInfo	List<priceLimitInfoDTO>	是	屏蔽信息
queryProductRequest	queryproductRequestDTO	是	用户查询信息
serviceProviderId	Long	否	服务商ID	1000000	用于多服务商接入场景，需要的供应商请联系我方技术添加

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列表

FixedLocationDTO

参数	类型	必传	描述	示例	备注
fixedCode	String	是	机场三字码/火车站code	FOC	注2
fixedLocationName	String	是	机场名称/火车站名称	长乐国际机场	注3
cityId	String	是	城市Id	258	城市ID列表
cityName	String	是	城市名称	福州	城市ID列表

注

2.机场使用IATA代码，火车站为携程内部代码，如需要请线下联系携程商务。
3.携程在传机场地址时通常会将机场与具体的航站楼传给供应商，此时经纬度为具体航站楼的经纬度，方便供应商进行报价和接驳。有极小概率拿不到具体的航站楼数据，此时接口会传递机场经纬度，需要供应商自行兼容。如果不接受无航站楼报价，请联系技术同学，屏蔽无航站楼报价。

priceLimitInfoDTO

参数	类型	必传	描述	示例	备注
priceLimitType	string	是	屏蔽类型	upper Limit	upper Limit；lowerLimit
price	BigDecimal	是	屏蔽价格	500
priceLimit	BigDecimal	是	价格屏蔽线	400
toll	BigDecimal	是	高速费金额	200
vehicleType	Long	是	车型ID	117
skuID	long	是	商品ID	234
lowestKeep	bool	是	是否是最低兜底价格	false	false；true

queryProductRequestDTO

参数	类型	必传	描述	示例	备注
useTime	String	是	用车时间	2020-08-28 14:46	时间为当地时间，格式为yyyy-MM-dd HH:mm:ss
categoryCode	String	是	接送机类型	airport-pickup	二级品类
fixedLocation	FixedLocationDTO	是	机场/车站
duseLocation	GeoDTO	是	起点地址
auseLocation	GeoDTO	是	终点地址
estimation	EstimationStandardDTO	否	预估信息

返回内容

priceLimitInfoResponse

参数	类型	必传	描述	示例	备注
msgCode	String	是	响应码	OK	响应码
message	String	否	响应详情	成功	响应码

请求示例

{
  ``"queryProductRequest"``: {
    ``"categoryCode"``: ``""``,
    ``"duseLocation"``: {},
    ``"auseLocation"``: {},
    ``"useTime"``: ``""``,
    ``"fixedLocation"``: {},
    ``"estimation"``: {}
  ``},
  ``"priceLimitInfo"``: [{
      ``"skuID"``: 234,``//商品ID
      ``"vehicleType"``: 117, ``//车型ID
      ``"priceLimitType"``: ``"upperLimit"``,``//限价类型(upperLimit、lowerLimit)
      ``"price"``: 500.0,``//价格
      ``"priceLimit"``: 400.0,``//价格屏蔽线
      ``"toll"``: 200.0, ``//高速费
      ``"lowestKeep"``: ``false``//是否最低价兜底保留
    ``}]
}

响应示例

{
  "msgCode": "OK",
  "message": "null",
}

异常示例

{
  "msgCode": "Error",
  "message": "",
}

高低价屏蔽信息推送接口