ZKteco uFace800 plus与Odoo 15 hr_zk_attendance模块兼容性及适配问询

兼容性判断 #

ZKteco同系列生物识别设备通常基于相似的ZK TCP/IP通讯协议，但hr_zk_attendance模块是专为uFace202/iFace990开发，大概率不完全兼容uFace800 Plus。核心原因是模块可能硬编码了指定设备的型号标识、数据字段格式或通讯指令。

你可以先做快速验证：

• 在Odoo设备配置中填入uFace800 Plus的IP、端口等信息，尝试建立连接，查看设备是否显示在线
• 尝试同步1-2名员工的生物识别模板到设备，再打卡测试是否能获取考勤记录
• 如果通讯失败或数据无法正常同步，说明需要定制修改

适配修改方向 #

如果验证后确实不兼容，可从以下几个维度调整模块代码：

1. 设备型号白名单适配 #

模块通常会有型号校验逻辑，限制仅支持指定设备。找到模块代码中型号判断的位置（比如hr_zk_attendance/models/zk_device.py），添加uFace800 Plus的型号标识（可从设备手册或ZKteco官方文档中获取设备的型号代码）。

示例调整（假设原代码有型号列表）：

SUPPORTED_DEVICES = ['uFace202', 'iFace990', 'uFace800 Plus']  # 添加新型号

2. 通讯数据解析适配 #

不同型号设备返回的考勤记录、员工信息字段可能存在格式差异（比如时间戳格式、员工ID字段长度、考勤状态编码）。需要：

• 抓包获取uFace800 Plus的通讯数据（比如考勤记录的原始返回内容）
• 对比模块现有数据解析函数（比如hr_zk_attendance/models/zk_attendance.py中的解析逻辑）
• 调整字段映射、数据格式转换代码，确保模块能正确解析新设备返回的数据

3. 生物模板同步逻辑适配 #

如果uFace800 Plus的生物识别模板格式与原设备不同，需要修改模块中模板同步的代码。参考ZKteco官方SDK的模板传输规范，调整模板数据的编码、传输指令，确保员工模板能正常同步到设备。

4. 全流程测试 #

修改完成后，需覆盖以下测试场景：

• 设备连接状态稳定性
• 员工模板同步成功率
• 考勤记录实时获取与Odoo考勤模块的对接
• 异常场景（比如设备离线后重新上线的数据补传）

内容的提问来源于stack exchange，提问作者RAK