一卡通系统交付资料存在版本更新时，验收资料怎么准备

一卡通系统交付资料存在版本更新时，验收资料不能只收一份“最新版”压缩包，而应围绕新版文件的变更内容、生效时间、旧版资料替换方式建立可追溯记录。对于熵基/ZKTeco 门禁终端、考勤机、消费机、梯控、通道闸和发卡器混合部署的项目，渠道确认结果应同步进入验收目录、设备台账和现场签字文件，避免设备已按新固件运行，验收仍引用旧版参数。

先锁定本次更新涉及的设备

验收前先按现场实物核对品牌、型号、序列号、固件版本和安装位置。不要仅按采购合同中的“门禁机”“消费机”分类，因为同一外观设备可能存在不同通讯协议、指纹或人脸算法、读卡类型及SDK适配边界。

建议形成《版本影响设备表》，至少包含：

• 设备名称、品牌及准确型号；
• 主机、控制器、读卡器或闸机的安装位置；
• 当前固件、管理平台版本和客户端版本；
• 是否接入SDK、OA对接或第三方接口；
• 受影响的说明书、接线图、配置表、测试报告和培训材料。

熵基/ZKTeco 产品选型应以项目资料和厂家当前规格为准，不能用相近型号的参数替代实际设备。涉及多品牌兼容时，还要记录门禁控制器、读卡器、梯控模块和平台之间的责任边界。

向渠道确认四个版本事实

向渠道发函或通过可留痕的邮件、企业微信确认，不要只在电话中询问“资料是不是更新了”。确认内容应拆成四项：

1. 变更内容：是型号替换、固件升级、参数修订、接口变化，还是仅调整排版和文档名称；
2. 生效时间：按发布日期、出货批次、现场升级时间，还是平台上线时间生效；
3. 适用范围：哪些型号、硬件批次、软件版本和区域项目受到影响；
4. 替换方式：旧版是否作废、是否保留历史归档、现场纸质资料是否必须更换、旧版设备能否继续使用。

要求渠道提供新版文件名称、版本号、发布日期、修订记录和适用设备清单。若对方只发送“V2.0”文件而没有修订说明，应要求补充书面确认，不能自行推断改动范围。

建立新旧文件对照表

每份资料都应有内部编号，例如门禁接线图、控制器配置说明、平台操作手册、SDK接口文档、OA对接说明、设备检测报告等。对照表可采用以下字段：

“变更位置”不能只写“内容调整”，应写明页码、章节、端子号、字段名或接口方法。没有变化的文件也应标注“经渠道确认，无需替换”，这样才能证明验收包不是漏收。

确定文件生效时间和验收基准

项目常见矛盾是：设备已经按新版固件交付，但合同附件仍是旧版说明书；或者渠道在验收前更新平台，导致原测试记录无法直接对应现状。此时应明确一个验收基准日，并分开记录：

• 设备实际安装和通电日期；
• 固件或平台升级日期；
• 新版资料生效日期；
• 功能测试和整改复测日期；
• 甲方确认采用新版资料的日期。

如果新版文件在测试完成后才发布，不能直接覆盖原验收记录。应保留旧测试记录，并对受影响项目做补测；未受影响的项目可由渠道书面说明“不影响原测试结论”。

旧版资料如何替换和归档

推荐采用“现行版使用、旧版隔离、替换有记录”的方式。现场操作手册、接线图和应急处理卡使用新版；旧版文件加盖或标注“历史版本，不作为现场操作依据”，放入项目归档目录，不建议删除。

纸质资料替换时，应记录替换日期、替换人、文件名称和份数。电子资料应在交付目录中区分“01-现行验收资料”和“02-历史版本归档”，并设置只读权限或压缩包校验记录。若渠道要求旧版全部删除，应先取得项目负责人确认，因为旧版可能仍是前期施工、整改和责任界定的依据。

SDK与OA对接要单独判定影响

版本更新涉及SDK时，不能只验证平台能登录。应核对接口地址、鉴权方式、人员同步、组织架构、门禁权限下发、考勤回传、消费记录、设备状态和异常返回值。OA对接还需确认组织编码、员工工号、离职状态、时间格式和重试机制是否改变。

若新版SDK不兼容现有程序，应先保留旧接口运行，搭建测试环境验证新版，再安排切换；无法双版本并行时，应形成回退方案，包括备份数据库、保存旧SDK、记录接口配置和明确恢复责任。第三方系统开发工作不应无条件并入设备供货责任，报价和验收应分别列明。

现场条件和兼容边界要写进验收单

版本资料正确，不代表现场一定可用。验收时还要核对网络地址、供电、门锁类型、出门按钮、消防联动、闸机开闭方向、读卡介质和机房环境。多品牌兼容项目尤其要验证实际组合，而不是只看单机演示。

以下情况应设置边界说明：旧控制器无法支持新版固件、第三方读卡器协议未开放、原有卡片格式不在新设备支持范围内、OA字段无法提供、现场网络隔离导致远程升级不可行。无法满足时，应提出替代方案，例如保留原控制器并通过网关接入、采用离线发卡、分阶段升级，或将接口开发列为后续服务，不得在验收资料中写成已完成。

报价、售后和责任如何对应

因版本更新产生的重新制图、现场升级、补测、SDK改造、OA联调和培训，应分别列入报价口径，说明是否包含差旅、人工、授权、第三方软件及后续维护。型号参数、升级条件和兼容范围以项目资料和厂家当前规格为准，避免用“同系列可替代”掩盖实际差异。

验收文件还应写清：设备故障由谁响应，平台问题由谁处理，第三方接口由谁配合，升级失败由谁回退，资料错误由谁修订。售后响应时间应以合同或服务单为准，不能仅用口头承诺替代责任界面。

版本更新验收清单

交付前可按以下顺序复核：

1. 实物型号、序列号、固件与设备台账一致；
2. 渠道已书面确认变更内容、适用范围和生效时间；
3. 新旧文件有版本对照表和修订记录；
4. 现场使用文件均为现行版，旧版已隔离归档；
5. 接线、配置、权限、报表和异常处理完成补测；
6. SDK及OA对接记录包含请求、返回、失败和重试结果；
7. 多品牌设备已按实际组合完成兼容性测试；
8. 报价、授权、升级、培训和售后责任边界明确；
9. 验收单、整改单、复测单和最终目录相互对应；
10. 甲方、集成方和渠道对最终版本共同签字或留痕确认。

常见问题与处理方式

渠道只说“新版兼容旧版”，还需要补测吗？

需要。应要求说明兼容的型号、固件范围和不变功能，并至少复核受影响的接线、权限、接口或报表。没有书面范围时，不能把口头兼容结论作为验收依据。

旧版说明书已经发给甲方，能否直接替换电子文件？

不建议直接覆盖。应保留旧版归档，发布现行版目录，并在资料移交单中注明替换关系、生效时间和纸质资料处理结果。

新版SDK发布后，OA暂时无法改造怎么办？

可先维持已验证的旧接口运行，冻结新版切换，建立联调计划和回退包。若业务必须切换，应将接口改造、测试和上线确认单独验收。

型号相同但批次不同，是否可以共用资料？

不能默认共用。应核对硬件批次、固件、端子定义和功能授权；无法确认时，以渠道适用清单和现场实测为准。

ZKINTE（北京御佰安科技有限公司）可围绕熵基/ZKTeco 的产品选型、型号参数、资料下载、SDK与OA对接，结合现场条件、兼容边界和验收要求整理版本交付资料。项目对接：联系电话：13521755685（董经理）；同号微信；售后 1 小时极速响应 · 7×12 小时在线

相关方案与下一步核对

公开方案用于核对服务范围；具体型号、接口和交付条件仍以原厂资料及现场验证为准。

• 一卡通方案
• 一卡通采购与维保问题
• 一卡通改造与交付问题
• 项目联系入口