IFC8 FIAS 接口

FIAS（Fidelio Interface Application Specification）是 OPERA 通过 IFC8 接口控制器与第三方系统通讯所用的协议。它把入住、退房、换房、挂账、叫醒、制卡等业务事件编码成一条条文本记录，在 OPERA 与你的系统之间实时传递。

FIAS 解决什么问题

酒店里大量设备系统需要"知道"客人的状态：门锁要在入住时制卡、退房时失效；房控要在入住时进入欢迎模式；网关要按房号和姓名放行上网；电话交换机要在入住时开通外线并把话费挂到房账。FIAS 把这些事件标准化，第三方系统只需实现一套协议，就能对接所有使用 OPERA 的酒店。

工作原理

1. 建立连接：IFC8 与第三方系统建立 TCP 连接。
2. 链路握手：双方交换 LS（Link Start）、LD（Link Description）、LR（Link Record）、LA（Link Alive）等链路记录，第三方在 LR 中声明需要的记录类型与字段。
3. 数据同步（可选）：第三方可发起 DR（Database Resync Request），OPERA 以 DS … DE 包裹，批量发送当前在住客人等数据，用于初始化或断线恢复。
4. 实时事件：入住 GI、退房 GO、信息变更/换房 GC 等由 OPERA 实时推送；第三方可回传挂账 PS、房态等记录。
5. 保活：链路空闲时定期发送 LA 维持连接；夜审期间 OPERA 会发送 NS / NE 标记。

一条记录的样子（示意，字段按 LR 声明返回）：

<STX>GI|RN1203|G#100234|GNZhang|GA261020|GD261023|<ETX>

完整的记录与字段说明见 FIAS 数据字典。

适用系统

• 门锁与发卡系统（含手机钥匙）——见 门锁对接方案
• 客房控制、节能与楼宇管理（BMS）——见 房控对接方案
• 酒店网络认证网关——见 网关对接方案
• 电话交换机与话费计费、叫醒、留言灯——见 电话计费方案
• 付费电视、迷你吧、洗衣等计费类设备

对接流程

1. 需求确认：确定需要的事件（入住/退房/换房/挂账/制卡…）与字段，确认酒店 OPERA 版本和 IFC8 版本。
2. 记录设计：确定 LR 声明、字段格式（日期 YYMMDD、时间 HHMMSS）、编码与房号映射。
3. 开发与自测：在模拟环境完成握手、实时事件、重连、DR 同步等场景。
4. 酒店联调：在酒店测试环境（或非高峰时段的生产环境）逐项验证。
5. 上线与监控：上线后关注断线重连、夜审期间行为和异常记录。

常见坑

• 只测了实时事件，没测断线恢复：网络中断后要能自动重连并通过 DR 补齐数据，否则会出现"已入住但门卡做不出来"。
• 换房处理：换房通常以 GC 记录携带新旧房号，第三方需要同时处理旧房间退出、新房间入住。
• 共享房（Share）：同一房间多位客人时，要按预订号区分，退房时不能把同住人一起清掉。
• 字符编码：客人姓名可能包含中文或特殊字符，需与酒店确认 IFC8 的编码设置。

最后核对：2026-10