什么时候可以用这份指南?
园区已使用 SFM 停车系统,希望把访客预约车牌下发到停车系统,并在访客云查看车辆进出记录时,可由访客系统管理员与停车实施人员按本指南完成配置和核对。
- 01确认前提
- 02配置双侧
- 03保存设备
- 04注册回调
- 05验证通行
确认版本、权限与网络
准备能管理目标园区设备、关联单位和查看车辆记录的后台账号,以及 SFM 停车软件的配置权限。SFM 需使用支持“第三方服务”的旗舰版。
本指南的状态检查适用于已提供 SFM 在线检测功能的访客云版本。看不到相关列或按钮时,请先联系管理员确认版本和权限。
| 项目 | 填写与核对方法 |
|---|---|
| 私有化 HTTP 接入 | 访客云服务器须能访问 SFM 的服务地址,SFM 须能访问本单位访客云回调地址。 |
| 公有云 MQTT 接入 | 提前向访客云运维获取 MQTT 服务地址、端口及专用账号。SFM 须能连接 MQTT 服务,并通过 HTTP(S) 访问访客云回调地址。 |
| 通行验证 | 准备一条带车牌的预约,配置完成后用对应车辆检查进出场和记录回传。 |
私有化服务器位于云端时,也需确保服务器能够访问所填写的 SFM 地址。
开启 SFM 第三方服务
- 在 SFM 打开第三方服务,启用服务,开放接口版本选择 V2。
- 记录停车场编号(ParkKey),按页面生成并记录 AppID、AppSecret。
- 确认 SFM 服务地址及端口。
打开设备表单,确定接入方式
- 进入设备管理 → 设备管理 → 新增设备,设备类型选择SFM停车系统。
- 填写设备名称以及 ParkKey、AppId、AppSecret。表单会自动生成设备序列号。
- 私有化 HTTP 接入选择 MQTT 接入不启用;公有云选择启用,记录表单生成的 MQTT 订阅主题、MQTT 发布主题。
- 公有云先保持当前表单打开,完成下一步 SFM 配置,再返回测试连接和拉取类型。
| 项目 | 填写与核对方法 |
|---|---|
| 设备名称 | 填写容易辨认的名称,例如“园区停车场”。 |
| 平台地址 | HTTP 接入填访客云服务器可访问的 SFM 地址及端口,例如 http://<SFM地址>:<端口>。MQTT 接入也需填写此项,命令通过 MQTT 传输;MQTT 服务器地址在 SFM 的客户端配置页填写。 |
| 停车场编号(ParkKey) / AppId / AppSecret | 填写本台 SFM 的值,核对大小写和前后空格。 |
| 回调地址 | 填写 SFM 能访问到的访客云站点地址。公有云为 https://lot.booen.co;私有化填写本单位地址,例如 https://visitor.example.com。私有化部署请将预填地址改为本单位的访客云地址。 |
| 回调间隔(毫秒) | 通常保留默认 1000。 |
| MQTT 接入及订阅、发布主题 | 按选定接入方式配置。主题使用表单生成值,与 SFM 两个同名字段一一对应;每台设备使用独立主题。 |
公有云先完成下一步 MQTT 配置,再测试连接和拉取类型。HTTP 接入可直接进入第 5 步。
公有云配置 SFM MQTT 客户端
私有化 HTTP 接入跳过本步骤。在 SFM 打开MQTT客户端配置,填写下列内容。
| 项目 | 填写与核对方法 |
|---|---|
| 启用MQTT客户端 | 启用。 |
| 服务器地址 / 端口 | 使用运维提供的 MQTT 地址和端口;本文公有云配置为 lot.booen.co、18004。地址栏填写主机名,不加 https://。 |
| 用户名 / 密码 | 使用运维分配的专用账号。 |
| 客户端ID | 每台设备唯一,避免与其他停车场重复。 |
| 订阅主题 / 发布主题 | 分别复制上一步访客云表单中的 MQTT 订阅主题、MQTT 发布主题,与同名字段对应。 |
| 协议版本 | V500(MQTT 5.0)。 |
保存 SFM 配置并确认 MQTT 客户端已连接,再返回刚才的访客云设备表单。若重新打开表单导致序列号或主题重新生成,请重新核对两端主题。
测试连接、选择类型并保存
- 再次核对接入方式、凭据及主题,点击表单中的连接测试。成功提示为“连接成功,签名与凭据有效”。
- 点击拉取类型。
- 在车辆类型编号中选择对应车辆类型,在车牌/卡类型编号中选择适用类型。预约访客车通常选择“访客车”;需要免费出场时,与停车管理员确认“免费车”及本停车场收费规则。
- 核对回调地址,确认设备已启用,再保存。重新打开设备信息,确认设置已保留。
不同停车场的类型编号可能不同,请从本台 SFM 拉取后选择。保存后,按第 8 步检查预约下发与车辆进出记录。
确认关联单位并注册回调
- 在设备列表打开该设备的操作 → 关联单位,核对预约所属的被访单位,按实际接待范围保存。
- 确认设备已启用,且回调地址为本次接入的访客云站点。
- 打开操作 → 注册回调并确认。注册成功后,SFM 会按配置向访客云推送车辆入场、出场记录。
系统先按预约的被访单位查找已启用设备;未找到匹配设备时,再按预约所属园区查找。请核对设备所属园区及关联单位与接待范围一致。
进出场回传使用 HTTP(S),不通过 MQTT。修改回调地址后,应重新注册并检查结果。
检查在线与激活状态
在设备列表查看在线和激活列,悬停查看检测原因;也可通过操作 → 测试连接手动检查。
| 项目 | 填写与核对方法 |
|---|---|
| 在线 | 最近一次检测时,访客云与 SFM 连接正常。 |
| 离线 | 检查 HTTP 地址与网络,或 SFM 的 MQTT 连接状态、账号与两端主题。 |
| 异常 | SFM 有响应但校验异常;核对 ParkKey、AppId、AppSecret 与第三方服务设置。 |
| 未检测 | 尚无检测结果,刷新列表或执行测试连接。 |
| 已激活 | 设备已成功连接过一次。当前连接情况请查看“在线”列。 |
刷新设备列表可更新检测结果。
用一条预约核对下发、通行与回传
- 创建一条带车牌、未过期的预约,被访单位与设备接待范围一致。按单位流程完成审核;若开启签到才能进入,需签到后再检查下发。
- 在 SFM 的预约车列表确认车牌、预约时段与本次预约一致。
- 在预约有效时段,让对应车辆进场、出场,检查车牌识别和道闸放行是否正常。
- 进入通行管理 → 车辆通行记录,核对车牌、进出时间与本次实际通行一致。
- 打开对应车辆记录,检查关联的预约是否正确。SFM 回传有效预约订单号时,系统会根据该订单号关联预约。
“签离才能外出”目前不控制 SFM 车闸,车辆出场遵循 SFM 的配置。如需签离后再放行车辆,可请停车管理员确认是否支持岗亭确认规则;支持时,由保安核对签离状态后放行。同车人员按现场规定办理到访核验。
常见问题
连接测试超时怎么办?
HTTP 接入先检查访客云服务器能否到达所填 SFM 地址和端口;MQTT 接入检查是否已启用、SFM 是否已连接、账号及两端主题是否一致。
能下发预约,但看不到车辆记录怎么办?
检查回调地址是否属于本单位访客云、注册回调是否成功,以及 SFM 能否通过 HTTP(S) 访问该地址。回调使用独立的 HTTP(S) 连接。
提示车牌类型不存在怎么办?
重新从本台 SFM 拉取类型,核对车辆类型编号及车牌/卡类型编号,保存后重新检查下发结果。类型编号以当前停车场返回的选项为准。
预约为什么没有下发?
依次检查设备启用状态、接待范围、预约车牌、审核状态和结束时间;启用“签到才能进入”时还需检查签到状态。先核对原预约,避免重复提交。
车辆记录出现了,但关联预约不对怎么办?
核对车辆记录的车牌、进出时间和对应预约。仍有异常时,提供记录时间与预约信息,联系技术支持检查。
已激活为什么还显示离线?
已激活表示曾经成功连通;在线状态反映最近一次检测。根据离线原因检查网络和连接配置,然后重新测试连接。
找不到在线列或相关按钮怎么办?
请管理员核对账号权限和当前部署版本。本指南的在线检测步骤适用于已更新相应功能的版本。
