系统对接
PMS 对接：从入住到房态，一条链路走完
佐妙 ZOMYO 自带 PMS 套件与开放 API：房态、入住状态、能耗与员工权限，与前台已经在用的物业管理系统保持同步。
- 自研 PMS 套件：房态、能耗报表、门禁与权限管理在同一套平台内
- 面向第三方 PMS、BMS 与后勤系统的开放 API
- 本地私有化部署，客房数据不出酒店
我们回复对接数据映射方案，以及需要向 PMS 厂商确认的问题清单。
对接要解决的问题
客控系统和前台系统，常常是两个互不相通的世界
PMS 与客房自动化不通，员工就只能用手工去补；而缺口暴露的时机，恰好是酒店最忙的时候。
"已清洁"的房间其实没就绪
客房部在一个系统里标了已清洁，客控系统却还停在离房状态，客人进门就是这一套。
请勿打扰靠敲门确认
服务与隐私状态只存在于门牌和一张卡片上，前台系统看不到，员工只能敲门问客人。
能耗数据没有归属
能耗只在一个独立的分析后台里，运营部门周一早上不会打开它。
两套权限模型
门禁、房间权限与员工角色分散在不同系统里管理，对"谁能进哪间房"的理解还不一致。
同步范围
哪些数据保持同步
平台对项目保持一份统一的运营记录，并通过有文档的接口对外发布或消费数据。
入住与退房
前台确认入住，房间标记为使用中，自动化模板从空房切换到有人状态：灯光、空调设定、窗帘与请勿打扰行为同步变化。
客房部房态
已清洁、待清洁、已查房、维修停用等状态在同一套平台更新，客房部在手持终端上就能看到。
请勿打扰与请即清理
门牌与面板状态回流到系统，前台实时看到隐私与服务请求，不必再去巡走廊。
门禁与权限
房间、楼层与角色权限集中管理，员工权限可设时效并从同一处回收。
能耗与告警
按房间、按楼层的能耗、节能报表与设备告警导出到同一套系统，而不是另一个分析产品。
多项目管理
一套部署可承载多个项目，数据相互隔离，权限模型按项目独立配置。
接口说明
对接的实际形态
我们按"有文档的接口"对接，而不是靠一份封闭认证厂商名单；决定因素是你的 PMS 是否开放你拥有的数据。
双向：佐妙消费入住与房态记录，同时发布房态、能耗与告警数据
开放 REST API 与有文档的数据模型；BMS 侧可用 RS485 / Modbus / KNX 桥接
房态、入住退房、请勿打扰与请即清理、有人/无人状态、能耗、告警
部署在项目本地服务器；外网中断不影响对接与本地运行
只涉及员工角色与房间级权限，自动化不需要客人个人身份数据
PMS 厂商接口文档、一个测试租户、你们运营口径的房间与楼层命名
不需要按房间的云订阅，也不强制引入第三方中间件
实施步骤
对接怎么做
从文档到试点楼层跑通，四步。
- 01
需求确认
先确定每条记录归谁管——入住、房态、能耗——并把你们的房间与楼层命名映射到平台。
- 02
沙箱验证
用测试租户和样例房间跑通每一次接口调用与状态变化，再让客人参与进来。
- 03
试点楼层
一个楼层双系统并行运行，把前台和客房部的真实工作流验证出来，而不是假设成立。
- 04
上线与复制
逐层上线，配套售前工程支持，并把交付文档移交给你们的 IT 团队。
在联系 PMS 厂商之前
对接常见问题
你们支持我们用的 PMS 吗？
我们通过开放 REST API 与有文档的接口对接，而不是靠一份封闭的认证厂商名单。只要你的 PMS 提供 API、数据库视图或有文档的接口，对接就是映射与配置的工作。我们从厂商文档和测试租户开始；如果某个接口确实做不通，我们会尽早说明。
数据存在哪里？
存在项目本地服务器。自动化不需要客人个人身份数据，只处理房间、入住与权限记录，因此部署范围始终在你们自己的数据合规边界内。
PMS 或网络断了会怎样？
客房自动化在本地运行，灯光、空调、窗帘与场景照常工作。平台会缓存状态变化，链路恢复后与 PMS 对账；前台按最后一次收到的房态继续运营。
能保留现有 BMS 吗？
可以。KNX 与 Modbus 桥接让楼宇系统继续挂在这台主机上：BMS 保持自己的空调与照明视图，佐妙负责房间级行为。
对接要多久？
接口映射通常几天内可在沙箱验证完成，试点楼层跑通后再扩大上线。整体排期主要取决于 PMS 厂商文档到位与测试租户开通的速度。
员工端能不能用我们自己的界面？
可以——API 就是接口。已有员工端 APP 或集团看板的项目，可以直接消费佐妙的房态与能耗记录，不必使用内置界面。