操作教程 · 停车系统对接

SFM 停车系统对接访客云操作指南

配置 SFM 与访客云的 HTTP 或 MQTT 接入,核对设备、关联单位与回调,并验证预约车牌下发和车辆进出记录。

适用端
管理后台 / SFM
适用角色
管理员 / 停车系统实施人员
更新日期

什么时候可以用这份指南?

园区已使用 SFM 停车系统,希望把访客预约车牌下发到停车系统,并在访客云查看车辆进出记录时,可由访客系统管理员与停车实施人员按本指南完成配置和核对。

  1. 01确认前提
  2. 02配置双侧
  3. 03保存设备
  4. 04注册回调
  5. 05验证通行

确认版本、权限与网络

准备能管理目标园区设备、关联单位和查看车辆记录的后台账号,以及 SFM 停车软件的配置权限。SFM 需使用支持“第三方服务”的旗舰版。

本指南的状态检查适用于已提供 SFM 在线检测功能的访客云版本。看不到相关列或按钮时,请先联系管理员确认版本和权限。

项目填写与核对方法
私有化 HTTP 接入访客云服务器须能访问 SFM 的服务地址,SFM 须能访问本单位访客云回调地址。
公有云 MQTT 接入提前向访客云运维获取 MQTT 服务地址、端口及专用账号。SFM 须能连接 MQTT 服务,并通过 HTTP(S) 访问访客云回调地址。
通行验证准备一条带车牌的预约,配置完成后用对应车辆检查进出场和记录回传。

私有化服务器位于云端时,也需确保服务器能够访问所填写的 SFM 地址。

开启 SFM 第三方服务

  1. 在 SFM 打开第三方服务,启用服务,开放接口版本选择 V2。
  2. 记录停车场编号(ParkKey),按页面生成并记录 AppID、AppSecret。
  3. 确认 SFM 服务地址及端口。

打开设备表单,确定接入方式

  1. 进入设备管理 → 设备管理 → 新增设备,设备类型选择SFM停车系统。
  2. 填写设备名称以及 ParkKey、AppId、AppSecret。表单会自动生成设备序列号。
  3. 私有化 HTTP 接入选择 MQTT 接入不启用;公有云选择启用,记录表单生成的 MQTT 订阅主题、MQTT 发布主题。
  4. 公有云先保持当前表单打开,完成下一步 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 步。

图片预览
图 1 · 设备配置中的平台地址、接口凭据及连接测试、类型拉取入口。点击图片查看大图

公有云配置 SFM MQTT 客户端

私有化 HTTP 接入跳过本步骤。在 SFM 打开MQTT客户端配置,填写下列内容。

项目填写与核对方法
启用MQTT客户端启用。
服务器地址 / 端口使用运维提供的 MQTT 地址和端口;本文公有云配置为 lot.booen.co、18004。地址栏填写主机名,不加 https://。
用户名 / 密码使用运维分配的专用账号。
客户端ID每台设备唯一,避免与其他停车场重复。
订阅主题 / 发布主题分别复制上一步访客云表单中的 MQTT 订阅主题、MQTT 发布主题,与同名字段对应。
协议版本V500(MQTT 5.0)。

保存 SFM 配置并确认 MQTT 客户端已连接,再返回刚才的访客云设备表单。若重新打开表单导致序列号或主题重新生成,请重新核对两端主题。

图片预览
图 2 · 公有云启用 MQTT,分别复制订阅主题和发布主题到停车系统。点击图片查看大图

测试连接、选择类型并保存

  1. 再次核对接入方式、凭据及主题,点击表单中的连接测试。成功提示为“连接成功,签名与凭据有效”。
  2. 点击拉取类型。
  3. 在车辆类型编号中选择对应车辆类型,在车牌/卡类型编号中选择适用类型。预约访客车通常选择“访客车”;需要免费出场时,与停车管理员确认“免费车”及本停车场收费规则。
  4. 核对回调地址,确认设备已启用,再保存。重新打开设备信息,确认设置已保留。
从当前停车系统选择类型

不同停车场的类型编号可能不同,请从本台 SFM 拉取后选择。保存后,按第 8 步检查预约下发与车辆进出记录。

确认关联单位并注册回调

  1. 在设备列表打开该设备的操作 → 关联单位,核对预约所属的被访单位,按实际接待范围保存。
  2. 确认设备已启用,且回调地址为本次接入的访客云站点。
  3. 打开操作 → 注册回调并确认。注册成功后,SFM 会按配置向访客云推送车辆入场、出场记录。

系统先按预约的被访单位查找已启用设备;未找到匹配设备时,再按预约所属园区查找。请核对设备所属园区及关联单位与接待范围一致。

进出场回传使用 HTTP(S),不通过 MQTT。修改回调地址后,应重新注册并检查结果。

图片预览
图 3 · 在设备列表打开操作菜单,选择关联单位或注册回调。点击图片查看大图
图片预览
图 4 · 选择接待单位,移到已关联列表后保存。点击图片查看大图

检查在线与激活状态

在设备列表查看在线和激活列,悬停查看检测原因;也可通过操作 → 测试连接手动检查。

项目填写与核对方法
在线最近一次检测时,访客云与 SFM 连接正常。
离线检查 HTTP 地址与网络,或 SFM 的 MQTT 连接状态、账号与两端主题。
异常SFM 有响应但校验异常;核对 ParkKey、AppId、AppSecret 与第三方服务设置。
未检测尚无检测结果,刷新列表或执行测试连接。
已激活设备已成功连接过一次。当前连接情况请查看“在线”列。

刷新设备列表可更新检测结果。

用一条预约核对下发、通行与回传

  1. 创建一条带车牌、未过期的预约,被访单位与设备接待范围一致。按单位流程完成审核;若开启签到才能进入,需签到后再检查下发。
  2. 在 SFM 的预约车列表确认车牌、预约时段与本次预约一致。
  3. 在预约有效时段,让对应车辆进场、出场,检查车牌识别和道闸放行是否正常。
  4. 进入通行管理 → 车辆通行记录,核对车牌、进出时间与本次实际通行一致。
  5. 打开对应车辆记录,检查关联的预约是否正确。SFM 回传有效预约订单号时,系统会根据该订单号关联预约。
需要签离后再放行车辆?

“签离才能外出”目前不控制 SFM 车闸,车辆出场遵循 SFM 的配置。如需签离后再放行车辆,可请停车管理员确认是否支持岗亭确认规则;支持时,由保安核对签离状态后放行。同车人员按现场规定办理到访核验。

图片预览
图 5 · 使用时间范围和车牌号查找车辆通行记录。点击图片查看大图

常见问题

连接测试超时怎么办?

HTTP 接入先检查访客云服务器能否到达所填 SFM 地址和端口;MQTT 接入检查是否已启用、SFM 是否已连接、账号及两端主题是否一致。

能下发预约,但看不到车辆记录怎么办?

检查回调地址是否属于本单位访客云、注册回调是否成功,以及 SFM 能否通过 HTTP(S) 访问该地址。回调使用独立的 HTTP(S) 连接。

提示车牌类型不存在怎么办?

重新从本台 SFM 拉取类型,核对车辆类型编号及车牌/卡类型编号,保存后重新检查下发结果。类型编号以当前停车场返回的选项为准。

预约为什么没有下发?

依次检查设备启用状态、接待范围、预约车牌、审核状态和结束时间;启用“签到才能进入”时还需检查签到状态。先核对原预约,避免重复提交。

车辆记录出现了,但关联预约不对怎么办?

核对车辆记录的车牌、进出时间和对应预约。仍有异常时,提供记录时间与预约信息,联系技术支持检查。

已激活为什么还显示离线?

已激活表示曾经成功连通;在线状态反映最近一次检测。根据离线原因检查网络和连接配置,然后重新测试连接。

找不到在线列或相关按钮怎么办?

请管理员核对账号权限和当前部署版本。本指南的在线检测步骤适用于已更新相应功能的版本。