**2026-01-05**
> 本次变更新配置生效需终端服务【server: 2026.*】以上版本支持。
1. 2.7预入场信息推送 参数增加channelScene字段
2. 3.14 访客预约 参数增加定义 bussinessType=3登记入场， 增加channelid字段登记入场时必填
3. 3.2停车订单支付通知 参数增加定义 payChannel=34 预付入场
4. 3.1 查询车辆缴费金额 参数增加定义payScene=4入口查金额
**2025-10-25**
> 本次变更新配置生效需终端服务【server: 2025.1025.5.*】以上版本支持。
1. 增加 2.17 车场综合告警
**2025-9-9**
> 本次变更新配置生效需终端服务【server: 2025.0910.0.*】以上版本支持。
1. 5.2.5物业固定车校验
2. 3.15.a 黑名单查询兼容支持分页
3. 3.15 黑名单结构体增加限制场景和入场通知
4. 3.17 增加 获取预入场接口
5. 3.18 增加 获取预出场接口
**2025-7-31**
> 本次变更新配置生效需终端服务【server: 2025.0731.0.*】以上版本支持。
1. 3.14 访客预约，可以指定预约次数限制
**2025.07.04**
> 本次变更新配置生效需终端服务【server: 2025.0704.0.*】以上版本支持。
1. 3.6.a 查询车辆时，可以指定需要返回续费相关信息
2. 车辆结构体说明中增加续费相关内容
**2025.06.24**
> 本次变更新配置生效需终端服务【server: 2025.624.0.*】以上版本支持。
1. 3.14 访客预约可以指定预约的车辆类型。
**2025.04.23**
> 本次变更配合纯云。
1. 黑名单入场告警。
**2023.07.28**
> 本次变更新配置生效需终端服务【server: 2023.728.0.*】以上版本支持。
1. 黑名单管理接口增加黑名单类型 。
2. 增加接口 2.15 出场取消记录上报。
**2022.04.20**
> 本次变更新配置生效需终端服务【server: *-22110.0420】以上版本支持。
1. 增加接口3.22.更新剩余车位 。
**2022.02.15**
> 本次变更新配置生效需终端服务【server: *-22046.0215】以上版本支持。
1. 增加接口3.21.a :充值套餐查询,action为:query 。
**2022.01.07**
> 本次变更新配置生效需终端服务【server: *-22006.0107】以上版本支持。
1. 增加接口3.10.c :下发通道二维码,action为 qrcode 。
**2021.12.27**
> 对7.1接口增加了说明和注意事项。
**2021.06.11**
> 本次变更新配置生效需终端服务【server: *-2652-210611】以上支持。
1、2.2 接口增加 groupUuid 车位组唯一标识上报。.
2、2.3 接口增加 groupUuid 车位组唯一标识上报。
3、2.5 接口增加 groupUuid 车位组唯一标识上报。
4、2.7 接口增加 groupUuid 车位组唯一标识上报。
5、3.6 车辆管理中，涉及到车位组的，都**增加了 CarGroupUuid，并优先以此字段作为筛选条件,CarGroupID 次之.**
> **2021.03.19**
> 本次变更新配置生效需终端服务【server: 2.7.0852.0319】以上支持。
1、3.5接口中，车位组管理增加UUID说明.
2、3.6-车辆管理充值延期接口,增加强制指定固定车开始时间参数;
3、3.8-固定车订单支付成功通知接口,增加强制指定固定车开始时间参数;
4、2.2入场记录上报和2.3-出场记录上报增加了本地记录自增编号(recordId)
> **2021.01.26**
> 本次变更新配置生效需终端服务【server: 2.7.0557.0128】以上支持。
1、增加3.20接口，车辆管理日志模块 (serviceId: manage.cars.logs).
2、3.6-车辆管理增加退款接口,注意action参数
3、2.3-出场记录上报增加了本次停车的订单列表
> **2021.01.24**
> 本次变更新配置生效需终端服务【server: 2.7】以上支持。
>
| 变更接口 | 变更字段及说明 |
| --- | --- |
|3.3 优惠券领取下发 | 新增请求字段: superStatus（超级商家） |
> **2020.12.28**
> 本次变更新配置生效需终端服务【server: 2.6.265.1228】以上支持。
增加MQ业务:
对讲系统相关MQTT业务 (serviceId: manage.talk),注意需要action参数
> **2020.12.18**
> 本次变更新配置生效需终端服务【server: 2.6.265.1220】以上支持。
>
| 变更接口 | 变更字段及说明 |
| --- | --- |
|3.3 优惠券领取下发 | 新增请求字段: allowTime（领券后默认停留时间） |
> **2020.12.09**
增加2.12接口，系统运行信息上报 (serviceId: sync.notify.upload)，需要1209之后的版本支持
> **2019.12.18**
修改3.18-预出场修改接口：
| 变更接口 | 变更字段及说明 |
| --- | --- |
| 预出场修改 | 新增请求字段： plateId（流水唯一标识：对应预出场的 plateID）。在修改车牌是，将优先使用此字段 |
> **2019.11.19**
本次变更新需终端服务【版本待发布】以上支持。
增加MQ业务：
2.10 ETC消费记录上报（serviceId：sync.etc.consume.upload）
2.11 手动抬闸记录上报（serviceId：sync.manualopengate.record）
| 变更接口 | 变更字段及说明 |
| --- | --- |
| 2.2 入场记录上报 | 新增请求字段：visitorTime ( 访客预约入场时间) |
| 2.5 预出场账单推送 | 新增请求字段：blacklistType(黑名单类型) <br/>新增请求字段：cardNo(ETC卡片编号) <br/>新增请求字段：obuId(标签号) <br/>新增请求字段：plateColor (车牌颜色) <br/>新增返回字段：vehicleStatus(车辆黑名单校验结果) |
> **2019.10.24**
本次变更新需终端服务【server: 2.6.326.1024】以上支持。
增加MQ业务：
2.9 车场抬闸失败预警 （serviceId：sync.alarm.opengate）
> **2019.09.20**
本次变更新需终端服务【server: 2.6.265.0915】以上支持。
**增加MQ业务：
6.1 MQ订阅状态检测 （serviceId：cloud/internet/time），设备版本升级后，使用自定义服务器的，需要自定义服务器实现此接口，以保证本地订阅状态正常。**
> **2019.09.10**
本次变更新需终端服务【server: 2.6.238.0910】以上支持。
增加MQ业务：
2.8 防调头抬闸后超时预警 （serviceId：sync.alarm.turnaround）
> **2019.08.26**
本次变更新需终端服务【server: 2.6.165.0826】以上支持。
修改MQ业务：
3.6 车辆管理，增加固定车信息唯一标识（uuid）并优先以此标识来处理记录，防止免布线方案下平台管理时主键不一致所导致的管理失败。
3.7根据车牌获取固定车列表，增加固定车信息唯一标识。
> **2019.08.1**
本次变更新需终端服务【server: 2.6.66.0801】以上支持。
修改MQ业务：2.6 车场信息上报，增加岗亭相关节点信息，包括管理的通道和通道对应的设备信息。
> **2019.07.30**
本次变更新需终端服务【server: 2.6.66.0729】以上支持。
新增MQ业务：3.17 场内车管理 （serviceId：manage.parkin ）
新增 MQ 业务：3.18 出场管理 (serviceId: manage.parkout)
| 变更接口 | 变更字段及说明 |
| --- | --- |
| 2.3 出场记录上报 | 新增返回字段：groupChargeDetails(车组收费详情) |
| 2.5 预出场账单推送 | 新增返回字段：groupChargeDetails(车组收费详情) <br/>新增返回字段：hasParkIn(是否匹配入场记录) |
> **2019.07.08**
本次变更新需终端服务【server:2.6.0】以上支持。
新增MQ业务：3.15 黑名单管理 （serviceId：manage.blacklist ）
新增MQ业务：3.16 场内车清理 （serviceId：record.clear ）
<br/>
> **2019.07.05**
本次变更新需终端服务【server:2.6.0】以上支持。
| 变更接口 | 变更字段及说明 |
| --- | --- |
|2.6 车场信息同步 | 新增上报字段：isWreless(是否免布线) |
|2.1 在线状态 | 新增上报字段：mac (设备mac) |
|2.2 入场记录上报<br/> 2.3 出场记录上报<br/>2.5 预出场账单推送<br/> 2.7 预入场信息推送 | 新增上报字段：groupId(车组标识) <br/> 新增上报字段： groupName(车组名称) <br/>新增上报字段: inMac(入场时所在设备 mac) <br/>新增上报字段: outMac(出场时所在设备 mac. 2.2和 2.7不包含此字段) |
<br/>
> **2019.06.22**
修改MQ业务：3.10 通道管理 （serviceId：manage.channels ）
--: 章节3.10/b.指定通道抬闸 更改为 3.10/b 指定通道抬闸/落闸
<br/>
> **2019.05.15**
新增MQ业务：3.14 访客预约 （serviceId：visitor.reservation ）
<br/>
> **2019.04.30**
| 变更接口 | 变更字段及说明 |
| --- | --- |
| 3.9 无牌车入场请求 | 新增返回字段：enterPic(场景图) |
<br/>
> **2019.04.16**
| 变更接口 | 变更字段及说明 |
| --- | --- |
| 3.13平台控制进出场 | 新增返回字段：operator (抬闸管理员) |
<br/>
> **2019.03.29**
| 变更接口 | 变更字段及说明 |
| --- | --- |
| 3.9 无牌车入场请求 | 新增返回字段：phone(管理员手机号) <br/>新增返回字段：recordNo(入场流水号) <br/>新增返回字段：channelid(通道号) <br/>新增返回字段：channelName( 通道名称) <br/>新增返回字段：sendSMS(是否发送短信) <br/>|
<br/>
> **2019.03.29**
> 新增附录
> 接口新增请求参数
| 变更接口 | 变更字段及说明 |
| --- | --- |
| 附录 | 新增：支付类型字典 <br/>新增：缴费渠道说明|
| 3.2 停车订单支付通知 | 新增：payPath(缴费渠道) <br/>新增：payAuth(缴费平台唯一标识) <br/>新增：payAuthName(缴费平台名称) <br/>新增：payPathDes(缴费渠道说明) <br/>新增：payPathExp(缴费渠道备注) |
| 3.8 固定车订单支付成功通知| 新增：payPath(缴费渠道) <br/>新增：payAuth(缴费平台唯一标识) <br/>新增：payAuthName(缴费平台名称) <br/>新增：payPathDes(缴费渠道说明) <br/>新增：payPathExp(缴费渠道备注)
<br/>
> **2019.03.05**
> 接口新增请求参数：
| 变更接口 |变更字段及说明 |
| --- | --- |
| 2.3 出场记录上报| 新增： ticketMark(商家券标记) <br/>新增： ticketNo(优惠券流水号) |
| 2.5 预出场账单推送| 新增： sweepCode (是否扫码枪支付 ) <br/>新增： sweepAuthCode (支付授权码) |
| 3.3 优惠券领取下发| 新增： ticketMark(商家券标记) <br/>新增： freeTicketType(免券有效进出次数) <br/>新增： freeTicketStart (免券多次进开始时间)<br/>新增： freeTicketEnd (免券多次进结束时间) <br/>新增： ticketNo(优惠券流水号) |
<br/>
> **2019.02.18**
> 增加接口 3.13：
平台控制进出场（serviceId: parking.remote）;
本次变更新需终端服务【server:2.5.20.0219】以上支持。
> **2019.01.29**
> 增加接口 2.7:
预入场信息推送（serviceId：sync.pre.in.record ）;
> 出场纪录上报增加三个字段，stopTime、balance、tel；
> 本次变更新需终端服务【server:2.5.12.0129】以上支持。
>
<br/>
> **2018.12.17**
> 增加储值卡充值：需终端服务【server:2.5.2.1218】以上支持。
>
| 变更接口 |变更字段及说明 |
| --- | --- |
| 3.7 根据车牌获取月租车和储值车列表 | **1.请求传输结构体action新增值说明**：<br/> 为空默认只查月租<br/> action:"store" 只查储值车<br/>action:"month" 只查月租车<br/>action:"store&month" 查储值车和月租车<br/> **2.新增返回字段**： carType (车辆类型 ) <br/>**3.新增返回字段**： balance(储值卡余额) |
<br/>
> **2018.08.13**
> 新增MQ业务：
3.12 车辆场内状态查询（serviceId：record.carstatus ）
<br/>
> **2018.09.05**
> 新增MQ业务：3.11 车牌锁定管理 （serviceId：manage.lockcars ）
> a.分页查询所有锁定车牌（action：query）
> b.添加车牌锁定 （action：add）
> c.修改车牌锁定（action：edit）
> d.删除车牌锁定（action：delete）
>
> 接口新增请求参数：
| 变更接口 |变更字段及说明 |
| --- | --- |
| 2.5 预出场账单推送 | 新增： leavePic (预出场车辆全景图 ) <br/>新增： leavePicSmall(预出场车牌图) |
<br/>
> **2018.09.01**
> 接口新增请求参数：
| 变更接口 |变更字段及说明 |
| --- | --- |
| 3.3 优惠券领取下发| 新增： shopId (商家id ) <br/>新增： shopName(商家名称) |
| 2.3 出场记录上报 | 新增： shopId (商家id ) <br/>新增： shopName(商家名称) |
<br/>
> **2018.08.13**
>
> 新增MQ业务：3.10 通道管理 （serviceId：manage.channels ）
> a . 获取通道列表 （action : all ）
> b . 指定通道抬闸 （action : opengate ）
<br/>
> **2018.07.25**
> 接口新增请求参数：
>
| 变更接口 |变更字段及说明 |
| --- | --- |
| 2.2 入场记录上报 |新增： enterPic (入场全景图访问路径 )<br/>新增： enterPicSmall (入场车牌图访问路径 ) |
| 2.3 出场记录上报 | 新增： leavePic (出场全景图访问路径 )<br/>新增： leavePicSmall (出场车牌图访问路径 ) |
| 2.6 车场信息上报 |新增： version (终端服务版本 ) <br/>终端服务从（2.3.133.0725）开始上报版本号|
| 5.1 车场图片上报 | 终端服务版本从（2.3.133.0725）开始，此接口停止上报图片，<br/>上报图片变更为出入场时上报图片访问路径 。|
<br/>
> **2018.07.14**
> 接口新增请求参数：
| 变更接口 |变更字段及说明 |
| --- | --- |
| 2.4 同步停车订单| 新增： recordNo (入场记录流水号 ) |
| 3.2停车订单通知| 新增： recordNo (入场记录流水号 ) |
<br/>
> **2018.06.28**
> 接口新增请求参数：
| 变更接口 |变更字段及说明 |
| --- | --- |
| 2.2 入场记录上报 |新增： inChannelid (入场通道标识 )<br/>新增： recordNo (入场记录流水号 ) |
| 2.3 出场记录上报 | 新增： outChannelid (出场通道标识 )<br/>新增： recordNo (入场记录流水号 ) |
| 2.5 预出场账单推送 | 新增： recordNo (入场记录流水号 ) |
| 3.1 查询车辆缴费金额 | 新增：payScene (支付场景 )<br/>新增：outChannelid (出口通道标志 )<br/>新增：recordNo (入场记录流水号 ) |
<br/>
> **2018.06.26**
> 增加http接口：5.2 获取车场二维码
> 新增MQ业务：3.9 无牌车入场请求 （serviceId：record.in.nocarnum ）
- 一、接入必读
- 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 获取车场二维码