东莞实名制考勤机对接标准补充说明V1.0.docxVIP

东莞实名制考勤机对接标准补充说明

“设备心跳接口”要求：需要有提供心跳间隔时间设置，以分为单位进行设置。系统默认为5分钟，建议设置为3-10分钟。

考勤机需要有设备有初始化数据接口功能。如：新机上线、更换设备、定时初始化等要求。初始化接口功能需要有调用触发机制，不能频繁调用，不然初始化过程中会影响正常打卡；初始化接口的分页调用中的pagesize支持最大100条记录，建议可以根据条件设置10-100，不能设置为1。

“考勤勤人员进场接口”、“考勤人员退场接口”、“考勤人员信息初始化（核对）接口”调用结束后必须调用“考勤机异步反馈接口”反馈考勤设备人员处理结果，退场接口反馈，当人员在考勤机中找不到也反馈成功，只要其他原因造成人员不能删除的反馈失败，以便系统能正确处理需要下发给考勤机的人员信息及记录下发情况，下次心跳不再重复下发人员信息。

“考勤记录上传接口”考勤机需要有处理机制：考勤机中有考勤记录时才发起调用；调用频率可设置为3-5分钟调用一次，考勤机需要有能根据调用成功后的数据不重复上传的机制。

考勤机要有重复打卡去重算法。如：30秒内同一人打卡记录去重。

考勤机获取考勤人员完整流程说明：

初始化所有考勤人员数据调用流程（新机上线、更换设备、定时初始化）

说明（在考勤设备管理中增加一个人员实始化功能，只能点击此功能的考勤设备才能进行实始化调用。并且初始化调用需要从第1页开始，如果中途调用出现异常，考勤机重试调用当页，完整的调用到最后一页后，反馈整个初始化结果。在考勤机接口文档中的心跳接口中增加init参数返回，当init为1时，设备调用初始化才能成功，否则初始化调用失效。）

其他说明：

初始化接口调用出错需要有重试机制，不能出错后就重新开始。以保证整个初始化工作完整性。（类似断点续传）

目前人员照片约30-40K一张，转成BASE64,约（40*1.3）50多K,获取人员分页每页数据量大小可根据实际情况考虑10以上。

日常考勤人员进退场完整流程