熵基/ZKTeco项目需要接口联调时应如何安排技术人员对接
熵基/ZKTeco 项目需要接口联调时，应在采购定型前安排 ZKINTE（北京御佰安科技有限公司）技术人员、OA 厂商开发人员和现场实施方共同对接，而不是等设备安装完成后再临时协调。对于“人脸门禁终端＋门禁控制器＋闸机＋OA 审批”组合，建议先确认数据流、接口版本和责任边界，再锁定型号、报价及联调日期。项目对接可联系ZKINTE 中控董经理：13521755685，同号微信。
熵基/ZKTeco 项目需要接口联调时，应在采购定型前安排 ZKINTE（北京御佰安科技有限公司）技术人员、OA 厂商开发人员和现场实施方共同对接，而不是等设备安装完成后再临时协调。对于“人脸门禁终端＋门禁控制器＋闸机＋OA 审批”组合，建议先确认数据流、接口版本和责任边界，再锁定型号、报价及联调日期。
哪些情况必须提前启动联调
出现以下任一情况，均不宜只按标准设备采购处理：
- OA 审批通过后需要自动下发门禁权限；
- 员工、访客或承包商档案需跨系统同步；
- 需要回传进出记录、抓拍结果或设备状态；
- 现场混用熵基/ZKTeco 与其他品牌控制器、读卡器或闸机；
- 项目要求私有化部署、自主可控或限定服务器环境；
- 旧系统数据需要迁移，且人员编号、卡号规则不能改变。
单机录入、U 盘导入或仅使用设备自带管理软件的项目，通常不需要完整接口开发，但仍应核对数据容量和导入格式。
技术人员应如何组成
联调会议至少安排四类人员：
| 角色 | 主要职责 |
|---|---|
| ZKINTE 技术人员 | 核对产品选型、型号参数、SDK 适配范围及设备配置 |
| OA 厂商开发人员 | 说明人员、组织、审批单和回调接口 |
| 项目实施人员 | 确认网络、供电、闸机信号及安装进度 |
| 甲方信息化负责人 | 决定数据主系统、账号规则、安全策略和验收口径 |
若涉及第三方平台，还应让平台开发方参加。仅由采购人员转述接口需求，容易遗漏字段和异常处理方式。
采购前先核对设备组合
SpeedFace、ProFace、人脸门禁终端、inBio 系列控制器及不同闸机的接入方式并不完全一致。采购前应逐项确认：
- 设备是否支持项目要求的联网协议或 SDK；
- OA 是直接连接设备，还是通过门禁管理平台中转；
- 控制器、读卡器与锁具的信号类型是否匹配；
- 人脸、卡片、二维码等凭证是否需要同时使用；
- 固件版本与接口包版本是否处于可配套范围。
具体型号参数、接口能力和授权方式，以项目资料和厂家当前规格为准，不能仅凭相近型号名称判断兼容。
联调资料应一次备齐
正式排期前，双方应交换并确认：
- 设备型号、数量、序列号及固件版本；
- 网络拓扑、IP 规划、端口和服务器访问策略；
- SDK、接口说明、示例代码及版本记录；
- OA 人员字段、部门编码、工号和离职状态规则；
- 权限组、门区、时段及审批有效期定义；
- 测试账号、测试设备和可重复使用的测试数据。
资料下载应通过双方确认的交付渠道完成，并保留版本号。SDK 能调用设备，不代表已包含完整 OA 对接功能，二次开发工作量需单独评估。
推荐的接口联调顺序
联调不宜一开始就覆盖全部设备，可按以下步骤执行：
- 先接通一台测试终端或一块控制器；
- 完成人员新增、修改、删除和查询；
- 验证人脸、卡号及权限时段下发；
- 测试通行记录回传、重复数据与断点补传；
- 模拟 OA 审批撤回、人员离职和权限过期；
- 再复制配置到闸机、门区及其余设备；
- 最后执行并发、离线恢复和异常重试测试。
这样可以把接口问题与现场线路问题分开，避免多人同时排查却无法定位责任。
OA 对接必须明确数据主从关系
OA 对接最常见的矛盾是双方都能修改人员资料。建议明确 OA、门禁平台和终端设备中谁是主数据源，并约定工号是否允许变化。审批通过后的权限下发、撤回后的权限删除、离职后的凭证注销，都应形成闭环。
若 OA 不具备稳定接口，可采用中间库、定时文件或人工审核后批量导入作为替代方案，但应说明同步延迟、重复执行和失败补偿机制。
多品牌兼容的边界
ZKINTE 可结合熵基/ZKTeco 项目开展多品牌兼容核对，但“通信接通”不等于“全部功能一致”。第三方闸机通常可通过开关量接受放行信号，而人员管理、照片下发、记录回传等深层功能仍取决于协议开放程度。
自主可控要求还应落实到操作系统、数据库、中间件、部署方式和升级权限，不能只看终端品牌。无法直接兼容时，可选择协议网关、平台级对接或保留原控制器，分别评估成本和维护责任。
报价口径与售后责任
报价应区分设备供货、软件授权、接口开发、现场调试、差旅、培训及后续版本适配。若 OA、服务器环境或需求范围改变，应先确认是否构成二次开发。
责任划分建议写入交付文件：设备通信由谁排查、OA 字段由谁维护、接口版本升级由谁验证、现场网络由谁保障。否则验收阶段容易把应用逻辑、设备故障和网络异常混为一项。
联调验收清单
- 型号、固件和 SDK 版本与确认记录一致
- 人员新增、变更、删除均可追踪
- OA 审批、撤回、到期场景执行正确
- 权限下发失败有日志、提示和重试机制
- 通行记录时间、设备编号和人员编号一致
- 断网期间可运行，恢复后按约定补传
- 多品牌设备的支持功能与限制已书面确认
- 源码、配置、接口文档及培训资料完成移交
- 售后受理范围和问题升级路径明确
常见问题
可以先采购设备，再决定如何接 OA 吗？
不建议。若所选型号没有项目需要的接口能力，后续可能需要更换设备或增加中间平台。
厂家提供 SDK 后，OA 厂商是否能直接完成开发？
不一定。还需确认开发语言、操作系统、授权机制、固件版本以及设备是否允许并发访问。
现场不能开放外网，是否还能联调？
可以考虑内网部署、离线安装包和现场测试环境，但相关依赖、授权及升级方式应提前确认。
项目对接方式
联系电话：13521755685（董经理）
同号微信
售后 1 小时极速响应 · 7×12 小时在线
相关方案与下一步核对
公开方案用于核对服务范围；具体型号、接口和交付条件仍以原厂资料及现场验证为准。
