查询计价规则接口
更新时间： 2022-11-06 打车必须接入，接送机站建议接入（对接前请先沟通）。
接口概述
1、该接口用来查询供应商计价规则信息，并对外公示。
2、性能要求：供应商需要在1000ms内响应结果。
请求地址
地址格式: {Domain}/{Channel}/pricerule/2.0/{timeStamp}/{sign}
请求内容
PriceRuleRequest
| 参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| categoryCode | String | 是 | 服务类型 | airport-pickup | 服务类型 |
| cityId | long | 是 | 城市Id | 258 | 城市ID列表 |
| vehicleType | Long | 是 | 车型 | 117 | 车型ID列表 |
| priceMode | Integer | 是 | 计价模式 | 0-普通计费 1-一口价 | |
| fixedLocation | FixedLocationDTO | 否 | 机场/火车/高铁站信息 | 注1：仅接送机/站场景下有值 | |
| serviceProviderId | Long | 否 | 服务商ID | 1000000 | 用于多服务商接入场景，需要的供应商请联系我方技术添加 |
返回内容
PriceRuleResponse
| 参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| msgCode | String | 是 | 响应码 | OK | 响应码 |
| message | String | 否 | 响应详情 | 成功 | 响应码 |
| currency | String | 否 | 供应商币种 | CNY | 注1：默认是CNY，可选的为USD/CNY/EUR/JPY |
| commonRule | List<PriceRuleDTO> | 是 | 常规/工作日计价规则 | ||
| weekendRule | List<PriceRuleDTO> | 否 | 周末/休息日计价规则 | ||
| holidayRule | List<PriceRuleDTO> | 否 | 节假日计价规则 |
FixedLocationDTO
| 参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| fixedCode | String | 是 | 机场三字码/火车站code | FOC | 注2 |
| fixedLocationName | String | 是 | 机场名称/火车站名称 | 长乐国际机场 | 注3 |
| cityId | String | 是 | 城市Id | 258 | 城市ID列表 |
| cityName | String | 是 | 城市名称 | 福州 | 城市ID列表 |
PriceRuleDTO
查看下方页面示例，有助您理解前端渲染逻辑
| 参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| code | String | 是 | 计费规则编码 | ||
| mainPriceRule | PriceRuleItemDTO | 是 | 主规则/平峰规则 | ||
| subPriceRuleList | List<PriceRuleItemDTO> | 否 | 分段规则 | 注1：subPriceRuleList和desc不可同时为空 | |
| desc | List\ |
否 | 补充信息 | 注1：subPriceRuleList和desc不可同时为空 | |
| sortNum | Integer | 否 | 排序 | 注1：序号不能重复 |
PriceRuleItemDTO
| 参数 | 类型 | 必传 | 描述 | 示例 | 备注 | |
|---|---|---|---|---|---|---|
| name | String | 是 | 标题 | |||
| value | String | 是 | 金额 | 注1：value只能是大于等于0的数字字符串，最多保留两位小数 |
计费规则编码
计费规则编码是费用编码的子集
| 编码 | 含义 | 计费单位 |
|---|---|---|
| START_FEE | 起步价 | 元 |
| MIN_COAST_FEE | 最低消费补足费 | 元 |
| NORMAL_KM_FEE | 公里费 | 元/公里 |
| NORMAL_TIME_FEE | 时长费 | 元/分钟 |
| LONG_KM_FEE | 远途费 | 元/公里 |
| OTHER_FEE | 其他计费规则 | 元 |
请求示例
{
"categoryCode":"airport-dropoff",
"cityId":1,
"vehicleType":117,
"priceMode":1
}
响应示例
{
"commonPrice": [{
"code": "START_FEE",
"mainPriceRule": {
"name": "起步费（含2.00公里/5.00分钟）",
"value": ""
},
"subPriceRuleList": [ {
"name": "00:00:00-12:00:00",
"value": "1.1"
}, {
"name": "12:00:00-00:00:00",
"value": "2.0"
}],
"desc": [],
"sortNum": 1
}, {
"code": "NORMAL_KM_FEE",
"mainPriceRule": {
"name": "里程费",
"value": ""
},
"subPriceRuleList": [{
"name": "00:00:00-12:00:00",
"value": "1.0"
}, {
"name": "12:00:00-00:00:00",
"value": "2.0"
}],
"desc": [],
"sortNum": 2
}, {
"code": "NORMAL_TIME_FEE",
"mainPriceRule": {
"name": "时长费",
"value": ""
},
"subPriceRuleList": [{
"name": "00:00:00-12:00:00",
"value": "1.0"
}, {
"name": "12:00:00-00:00:00",
"value": "2.0"
}],
"desc": [],
"sortNum": 3
}, {
"code": "LONG_KM_FEE",
"mainPriceRule": {
"name": "远途费",
"value": ""
},
"subPriceRuleList": [{
"name": "0-10.0公里",
"value": "0.0"
}, {
"name": "10.0-10000.0公里",
"value": "1.0"
}],
"desc": [],
"sortNum": 4
}, {
"code": "OTHER_FEE",
"mainPriceRule": {
"name": "附加费",
"value": ""
},
"subPriceRuleList": [],
"desc": ["附加费用包括路桥费、停车费和清洁费（洗车费）。如果产生清洁费的，按以下标准执行：1）如乘客在使用车辆过程中因踩踏、将食物、饮料洒落、宠物排便等在座椅或车内，造成车内环境脏乱或有异味的，乘客需支付100元/次的清洁费。2）如乘客乘车时呕吐造成车辆脏乱、有异味，乘客需支付200元/次的清洁费。"],
"sortNum": 5
}, {
"code": "OTHER_FEE",
"mainPriceRule": {
"name": "节假日服务费",
"value": ""
},
"subPriceRuleList": [{
"name": "2022/06/28 15:35:00 - 2023/06/29 15:33:10",
"value": "3.00"
}],
"desc": [],
"sortNum": 6
}]
}
页面示例
异常示例
{
"msgCode": "Error",
"message": "",
}