# **特别说明**
根据车牌查询固定车(月租车和储值车)是向所有车场发查询请求固定主题格式为:**tcp/querymonthcard**
注:终端服务版本需【server:2.5.2.1218】以上支持查储值车
请求结构说明:
**数据传输结构说明:**
| 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- |
| code | 状态码 | int | 1 | 是 |
| uuid | mq消息唯一标识 | String | 31f15ab5-1ad9-4f38-b794-fb1f1fe019ee | 是 |
| serviceId | 业务类型 | String | **pay.querymonthcardlist**| 是 |
| parkCode | 停车场编码 | String | 此接口选填 | 否 |
| action | 操作类型,| String | 为空默认只查月租<br/>action:"store" 只查储值车<br/>action:"month" 只查月租车<br/>action:"store&month" 查储值车和月租车 | 否 |
| dataItems | 业务数据 | List | 业务字段说明如下表 | 是 |
> **dataItem 业务对象说明**
| 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- |
| plateNumber | 车牌号 | String | 粤B12345 | 是 |
* * * * *
> 示例:
~~~
{
"code": 1,
"action": "store&month",
"dataItems": [
{
"plateNumber": "粤B12345"
},
{
"plateNumber": "粤B34567
}
],
"serviceId": "pay.querymonthcardlist",
"parkCode": "querymonthcard",
"uuid": "e20b10b0-8633-4e7a-affa-dd7a55d02f56"
}
~~~
#### **请求查询车牌,车场收到请求后,找到对应固定车信息后,车场才发出请求的响应消息。没找到则不响应。**
> 例:有两个车场 SLZX/1P11 和 SLZX/1P22
> SLZX/1P11 有月租车:粤B12345
> SLZX/1P22 无月租车:粤B12345
> 发MQTT请求查车牌:粤B12345
> 收到消息只有 SLZX/1P11 车场的返回
返回结构说明:
> **dataItem 业务对象说明**
| 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- |
| id | 固定车数据库自增标志,不再推荐使用此字段 | int | 1 | 是 |
| uuid | 固定车分布式唯一标志,推荐使用此字段 | string | 5C7C3D5B6401465DB2B62CD83BE1936F | 是 |
| plateNumber | 车牌号 | String | 粤B12345 | 是 |
| price | 价格| double | 100.00| carType =8,必传 |
| deadlineDate |截止日期 | String | 2017-05-05 17:02:27 |carType =8,必传 |
| status | 状态 | int | 1-正常, 2-过期 | 是 |
| carType | 车辆类型 | int | 车辆类型:<br/> 8-月租车<br/>7-储值车<br/> | 是 |
| balance| 储值卡余额| double | 100.00| carType =7,必传 |
### **注:考虑到免布线的场景,唯一标识推荐使用 uuid**
### **注:终端(server:2.5.2.1218)之前无车辆类型字段,此接口获取的都是月租车,只有月租车充值。**
* * * * *
> 示例:
~~~
{
"code": 1,
"dataItems": [
{
"id":1,
"uuid":"5C7C3D5B6401465DB2B62CD83BE1936F",
"plateNumber": "粤B12345",
"carType":8,
"price": 300.0,
"status":1,
"deadlineDate": "2017-10-17 12:24:55"
},
{
"id":1,
"uuid":"5B7C3D5B6401465DB2B62CD83BE1936F",
"plateNumber": "粤B34567",
"carType":7,
"balance": 200.0,
"status":1
}
],
"serviceId": "pay.querymonthcardlist",
"parkCode": "SLZX/1P11",
"uuid": "e20b10b0-8633-4e7a-affa-dd7a55d02f56"
}
~~~
- 一、接入必读
- 1.1 MQ订阅说明
- 主题及数据结构说明(topic)
- 业务类型说明(serviceId)
- 操作类型说明(action)
- 1.2 修订记录
- 二、pts-车场端-服务端
- 2.2 入场记录上报
- 2.3 出场记录上报
- 2.1 在线状态
- 2.4 同步停车订单(废弃)
- 2.5 预出场账单推送
- 2.6 车场信息上报
- 2.7 预入场信息推送
- 2.8 防调头抬闸后超时预警
- 2.9 车场抬闸失败预警
- 2.10 ETC消费记录上报(废弃)
- 2.11手动抬闸记录上报
- 2.12 运行状态信息上报
- 2.13 对讲设备联动-上报
- 2.14 打印机/缴费机设备异常预警
- 2.15 出场取消记录上报
- 2.16 黑名单告警
- 2.17 车场综合告警
- 三、stp-服务端-车场端
- 3.1 查询车辆缴费金额
- 3.2 停车订单支付通知
- 3.3 优惠券领取下发
- 3.4 车辆类型管理
- 3.5 车位组管理
- a. 查询所有车位组-all
- b. 分页查询车位组-query
- c. 添加车位组-add
- d. 修改车位组-edit
- e. 删除车位组-delete
- 附:车位组结构说明
- 3.6 车辆管理
- a. 分页查询所有车辆-query
- b. 添加车辆-add
- c.修改车辆-edit
- d. 删除车辆-delete
- e.车牌变更-change
- f. 充值延期-charge
- g. 冻结-freeze
- h. 解冻-unfreeze
- I. 清空所有车辆-clear
- j.退款
- 附: 车辆结构体说明
- 3.7 根据车牌获取固定车列表
- 3.8 固定车订单支付成功通知
- 3.9 无牌车入场请求
- 3.10 通道管理
- a. 获取通道列表
- b. 指定通道抬闸/落闸
- c. 下发通道二维码
- 3.11 车牌锁定管理
- a.分页查询所有锁定车牌-query
- b.添加车牌锁定-add
- c.修改车牌锁定-edit
- d.删除车牌锁定-delete
- 3.12 车辆场内状态查询
- 3.13 平台控制进出场
- 3.14 访客预约
- 3.15 黑名单管理
- a.查询所有黑名单
- b.添加黑名单
- c.删除黑名单
- 3.16 场内车清理
- 3.17 场内车管理
- a.查询场内车
- b.场内车修改
- c.获取预入场
- 3.18 出场管理
- a.预出场修改
- b.获取预出场
- 3.19 对讲设备联动-下发
- 3.20 车辆管理日志
- a.查询
- 附:车辆管理日志结构体说明
- 3.21 车辆充值套餐
- a 分页查询所有套餐
- 附:充值套餐结构体说明
- 3.22 更新剩余车位
- 3.23 手动入场通知-下发
- 3.24 手动出场通知-下发
- 四、附录
- 车辆类型字典
- 机动车号牌种类字典
- 支付类型字典
- 缴费渠道说明
- 车牌结果来源(设备类型)
- 五、HTTP接口
- 5.1、协议规则与安全规范
- 5.1.1、协议规则
- 5.1.2、安全规范
- 5.2、接入方需实现接口
- 5.2.1、固定车管理
- 5.2.1.1、增加固定车
- 5.2.1.2、删除固定车
- 5.2.1.3、编辑固定车
- 5.2.2、场内车管理
- 5.2.2.1、编辑场内车
- 5.2.2.2、删除场内车
- 5.2.3、查询车辆是否有欠费订单
- 5.2.4、同步场内车到车场
- 5.2.4.1、车场下拉未同步的场内车
- 5.2.1.2、上传场内车同步完成通知
- 5.2.5 物业固定车校验
- 六、附录二
- 6.1 MQ订阅状态检测
- 七、其他
- 7.1 获取车场二维码
