车牌订单核销模拟接口说明.md 2.57 KB

Raw Blame History Permalink


车牌订单核销模拟接口说明

接口地址：
http://192.168.50.1:8080/parking/mock/mqttScan

请求方式：
GET 或 POST

请求参数：
deviceCode：必填，停车场设备编号，设备需已配置并绑定通道。
licensePlate：必填，明文车牌号，例如：晋B4HSW6。
colorValue：非必填，默认值为 0。
0：蓝牌。
1：绿牌。
2：黄牌。

请求示例：
http://192.168.50.1:8080/parking/mock/mqttScan?deviceCode=DEVICE001&licensePlate=晋B4HSW6&colorValue=0

成功返回示例：
{
  "success": true,
  "info": "模拟扫牌成功",
  "data": {
    "orderId": 12345,
    "orderCode": "M480733",
    "licencePlate": "5pWLQjRIU1c2",
    "createTime": "2026-09-28 08:36:00",
    "seq": 1,
    "vehicleType": 3,
    "licenseColor": "蓝",
    "pass": true,
    "secondEntry": false,
    "entryTimes": null
  }
}

返回字段说明：
success：是否处理成功。
info：处理结果说明或失败原因。
data.orderId：平台订单 ID。
data.orderCode：订单号。
data.licencePlate：Base64 编码后的车牌号。
data.createTime：首次入场时间。
data.seq：入场排队序号。
data.vehicleType：车辆类型，1 为本地车，2 为工作车，3 为预约车，4 为非预约车。
data.licenseColor：车牌颜色。
data.pass：是否允许通行。
data.secondEntry：是否重复入场。
data.entryTimes：当前入场次数。

失败返回示例：
{
  "success": false,
  "info": "未查询到设备信息！"
}

其他常见失败原因：
设备已禁用！
未查询到设备绑定信息！
未查询到停车场信息！
3秒内重复车牌识别消息已忽略。

接口处理流程：
模拟 MQTT 摄像头扫牌。
校验设备和通道。
查询车辆是否为本地车、工作车或预约车。
校验预约信息及通行规则。
下发开闸指令。
当车辆为有效预约车辆，且通道业务模式为“查询、放行并核销”时，执行订单核销。

注意：
该接口虽然名为 mock，但调用的是正式扫牌处理链路。
生产环境传入有效预约车牌时，可能触发开闸、写入入场流水和真实订单核销，请勿随意测试。

代码位置：
分支：tdos-dev
接口入口：
open-api/src/main/java/com/ectrip/b2b/openapi/parking/controller/ParkingController.java
方法：mockMqttScan

实际订单核销：
open-api/src/main/java/com/ectrip/b2b/openapi/order/parking/ParkingOrderHandler.java
方法：parkingVerify

核销代码截图： 20260928-111104.jpeg

核销原码的后端JAVA项目在： /Volumes/USERDATA/ideaProjects/wts_vehicle_reservation ，千万不修改，可以读取参考。