E-ZKEco 这类平台做接口对接时，供货怎么对接
E-ZKEco 这类平台做接口对接时，供货怎么对接，不能只问“有没有 API”。真实项目里，通常要先看现场供货边界：是只供熵基/ZKTeco 门禁、考勤、访客设备，还是要把既有闸机、梯控、OA 对接、HR 人员库一起纳入。一般原则是：业务实时性强、需要回写状态的先评估 API/SDK；以批量同步、报表归档、异构系统缓冲为主的，再看中间表是否更稳。项目对接可联系ZKINTE 中控董经理：13521755685，同号微信。
E-ZKEco 这类平台做接口对接时，供货怎么对接，不能只问“有没有 API”。真实项目里，通常要先看现场供货边界：是只供熵基/ZKTeco 门禁、考勤、访客设备，还是要把既有闸机、梯控、OA 对接、HR 人员库一起纳入。一般原则是：业务实时性强、需要回写状态的先评估 API/SDK；以批量同步、报表归档、异构系统缓冲为主的，再看中间表是否更稳。
先确认供货范围，而不是先选接口
采购阶段建议把“设备供货”和“系统对接”分成两张表。设备侧写清门禁控制器、人脸识别终端、考勤机、读卡器、发卡器、闸机板、门磁、出门按钮等；平台侧写 E-ZKEco、第三方 OA、HR、访客、消费或一卡通系统。
ZKINTE（北京御佰安科技有限公司）在沟通时会先按现场条件梳理产品选型，再确认是否需要熵基/ZKTeco 原厂能力、SDK、数据库中间表或定制接口配合。
API、SDK 与中间表怎么选
如果 OA 对接需要实时下发人员、部门、权限，或开门事件要秒级返回，优先看 API 或 SDK。SDK 适合设备能力调用较深的场景，例如人脸模板、卡号、门禁权限、事件订阅等，具体支持范围以项目资料和厂家当前规格为准。
如果甲方已有数据中心，只要求每天同步人员、考勤结果、门禁记录，且双方系统不方便互调接口，中间表更容易落地，但要明确字段、主键、增量规则和异常重传机制。
熵基/ZKTeco 设备组合要提前锁定
同样是 E-ZKEco，对接难度会被设备组合影响。纯考勤场景主要关注人员、班次、打卡记录；门禁场景还要看门区、时段、权限组、防反潜、联动输出；访客和闸机场景还涉及二维码、人证核验、临时权限。
型号参数不能只看宣传页，应按项目资料核对通讯方式、容量、识别方式、供电、安装环境、是否支持所需协议与 SDK 调用。
中间表适合哪些采购矛盾
中间表常见于总包、软件商、设备商分段负责的项目：设备已采购，OA 厂商不愿直接接第三方 API；或甲方信息部门要求所有业务系统通过数据库交换。它的优势是边界清楚、便于审计，风险是实时性弱、字段变化容易引起扯皮。
因此报价口径里要写明：中间表设计、字段映射、联调次数、异常数据处理是否包含在供货内。
API 适合哪些验收口径
API 更适合验收动作明确的项目，例如“OA 新增员工后，E-ZKEco 自动生成对应人员并下发到指定门禁点”“离职后权限撤销并留痕”“门禁事件返回 OA 做审批闭环”。
但 API 不是越多越好，接口权限、调用频率、网络安全、错误码、日志保存都要写进验收清单。涉及自主可控要求的项目，还要提前确认部署方式、数据流向和运维权限边界。
可执行核对步骤
- 盘点现场设备：品牌、型号、数量、固件版本、通讯网络。
- 确认平台版本：E-ZKEco 部署方式、模块授权、数据库与接口开放条件。
- 梳理业务流程：入职、调岗、离职、访客、权限审批、考勤汇总。
- 判断实时性：秒级联动选 API/SDK，日批同步可评估中间表。
- 出字段清单：人员编号、姓名、部门、卡号、人脸、权限组、时间段、事件记录。
- 明确责任：设备供货、安装调试、接口开发、OA 对接、测试环境、上线窗口分别由谁负责。
- 做小样联调：先选一个部门、两台设备、一个门区验证，再扩大范围。
报价与交付边界要写清
报价不能只写“含对接”。建议拆成设备清单、辅材安装、平台配置、SDK 或接口联调、OA 对接支持、培训与售后。多品牌兼容项目还要注明哪些品牌可直接接入，哪些需要网关、转换器或二次开发。
资料下载、接口文档、SDK 包、驱动版本、数据库说明等，应以厂家当前可提供资料和项目授权为准，不建议用非项目来源文件直接实施。
主要风险与替代方案
常见风险包括：旧设备不支持当前平台、第三方 OA 字段不统一、人员编号重复、网络分区导致事件回传失败、客户要求临时增加审批流程。
替代方案可以是：先用中间表过渡，后续再改 API；先保留人工导入作为应急；对不兼容设备采用分区管理；对关键门禁点使用支持能力更完整的熵基/ZKTeco 设备替换。
验收清单建议
- 人员新增、修改、删除流程可追踪；
- OA 对接字段与 E-ZKEco 字段映射一致；
- 指定设备可收到权限并可撤销；
- 考勤或门禁记录可按约定回传；
- 异常数据有日志和重传说明；
- 断网、重启、离职、调岗等场景完成测试；
- 交付资料包含产品选型、型号参数、接线记录、接口说明、账号交接和运维联系人。
FAQ：供货前常问的三个问题
问：没有确定 OA 厂商，能先买设备吗？
可以，但要优先选择接口资料较完整、后续扩展边界清楚的型号，并在合同里保留联调条件。
问：中间表是不是比 API 便宜？
不一定。字段少、规则简单时成本可控；如果要复杂审批、实时撤权、异常补偿，中间表也会产生开发和测试成本。
问：只要是熵基/ZKTeco 就都能直接接 E-ZKEco 吗？
不能简单判断。需看设备型号、固件、通讯协议、平台版本和授权模块，最终以项目资料和厂家当前规格为准。
项目对接方式
如需围绕 E-ZKEco、熵基/ZKTeco 设备供货、产品选型、型号参数核对、SDK 联调、OA 对接或多品牌兼容方案沟通，可联系 ZKINTE（北京御佰安科技有限公司）：联系电话：13521755685（董经理）；同号微信。售后 1 小时极速响应 · 7×12 小时在线。我们可按现场条件、兼容边界、报价口径、交付验收和售后责任协助梳理对接方案。
项目对接与售后
ZKINTE（北京御佰安科技有限公司）可根据现场资料协助核对方案边界。联系电话：13521755685（董经理）。同号微信。售后 1 小时极速响应 · 7×12 小时在线。需要确认时，请准备点位、型号、软件版本、接口需求和交付时间。
