目录【关键提示】.......................................................................................................................................3一、云之家签到接口菜单授权..........................................................................................................31.1给菜单授权........................................................................................................................3二、配置接口与参数...........................................................................................................................3三、数据同步逻辑...............................................................................................................................4云之家签到数据同步逻辑...............................................................................................4同步考勤数据：有后台同步和前台同步两种方式.......................................................51、后台同步（s-HR客户端执行）.....................................................................................52、手动同步（s-HRWEB端执行）...................................................................................5四、FAQ...............................................................................................................................................64.1、哪些数据会同步至s-HR“打卡记录”，哪些数据会同步至“移动签到审核”？64.2、所有或某段时间云之家签到数据都没有同步到s-HR中...........................................64.3、后台同步事务成功完成，部分员工签到数据没有同步到s-HR系统.......................74.4、云之家部分员工的数据未同步成功，如何重新同步？.............................................84.5、拍照签到与外勤确认待办的关系.................................................................................84.5.1、拍照签到与外勤确认待办的关系......................................................................84.6、移动端外勤确认相关问题.............................................................................................94.6.1、云之家外勤由谁确认？......................................................................................94.6.2、负责人如何确认部门的外勤记录？..................................................................94.6.3、为什么负责人没有收到待办消息呢？............................................................104.6.4、外勤未确认的记录会同步么？........................................................................104.6.5、非当天确认的记录如何同步？........................................................................10【关键提示】1、该文档针对V8.6.1.2版本客户应用2、请认真看完整个文档。云之家签到数据同步是建立在已经做了云之家用户同步的基础上的，如果没有做过用户同步，同步过来的数据会对应不到s-HR中的人员。一、云之家签到接口配置1.1给菜单授权以administrator登录金蝶s-HR客户端，选择一个用户（一般为考勤专员），例如UserXXX，执行菜单权限分配（如果已经有权限，请忽略此步骤）。客户端授权路径：企业建模->安全管理->权限管理->用户管理选择分配权限的菜单为：人力资源（s-HR）->系统设置->考勤数据设置->云之家签到接口配置。1.2配置接口授权用户登入web端->系统设置->考勤数据设置->云之家签到接口配置。检查云之家签到接口是否启用（编码：004），接口默认启用。1.3团队ID设置授权用户登入客户端->系统平台->系统工具->系统配置->参数设置->人力资源（s-HR）->假勤管理。找到“云之家打卡同步团队id”参数，维护需要同步签到记录的云之家团队id。三、数据同步逻辑云之家签到数据同步逻辑1、内勤签到记录同步至s-HR打卡记录表；2、没有审批通过的外勤签到记录则同步至s-HR移动签到审核表-未审核状态，需审核同意后才进入打卡记录表（审核同意不需要走工作流）。3、云之家审批通过的外勤签到记录，会同时同步到s-HR打卡记录表和移动签到审核表–已审核状态。4、拍照签到由负责人确认之后才会同步至s-HR系统，若未审核或审核不通过，都不会同步。内勤的拍照签到，云之家审核后，会同步到s-HR的打卡记录表；外勤的拍照签到，云之家审核后，会变为有效的外勤记录，会同步到“移动签到审核”并标记为“同意”，且同步到“打卡记录”表。同步考勤数据：有后台同步和前台同步两种方式1、后台同步（s-HR客户端执行）路径：登录s-HR客户端->系统平台->后台事务->事务定义->后台事务定义->人力资源（s-HR）->假勤管理->云之家签到数据同步【说明】：首次同步会从2022-01-01开始同步，时间会比较长，建议修改同步时间，改为云之家有签到记录的时间。后续同步会同步前一天和当天两天的签到数据。待执行结束之后查看后台事物是否执行成功。如果不需要从这个时间点开始执行，可以修改表时间(修改下面语句标红的时间点即可)。Updatet_hr_ats_bizdatasynchassistsetflastsynchtime={ts'2017-08-0100:00:00'}wherefid='bSvNRciAEU6cJb24RAS0lKlojLM='正常打卡的数据（在云之家设置的打卡地点之内的数据）会直接同步到打卡记录表，在打卡地点之外的打卡数据会算成外勤。同步完成后，云之家签到数据会同步到s-HR系统的打卡记录表，或者移动签到审核内。2、手动同步（s-HRWEB端执行）路径：s-HR系统->考勤管理->打卡记录->云之家签到同步四、FAQ4.1、哪些数据会同步至s-HR“打卡记录”，哪些数据会同步至“移动签到审核”？云之家中有效的内勤签到会同步至s-HR“打卡记录”表中。对于外勤签到：已在移动端进行了外勤确认的外勤数据，会同步到“移动签到审核”表并标记为“同意”，且同步到“打卡记录”表；未确认过的外勤数据同步到“移动签到审核”表，也可以在WEB端进行移动签到审核。4.2、所有或某段时间云之家签到数据都没有同步到s-HR中检查s-HR中同步事务是否正常执行（可在WEB端后台事务监控处检查）。如果执行成功，请检查事务监控看板内的日志信息；如果执行失败，可按事务监控看板内的提示信息检查，可能的原因有：原因1：网络问题，本地服务器访问云之家接口延时，超时等，需检查本地网关是否允许对云之家的访问或网络稳定性（可查看apusic日志，是否有超时、500等错误）原因2：云之家签到接口不通或未正确绑定云之家管理员，可前往[系统设置-考勤数据设置-考勤基础数据-云之家签到接口配置]进行检查原因3：apusic服务器拦截了云之家对OSF接口的访问，需要将云之家服务器地址加入apusic服务器的安全访问白名单（默认已配置白名单）4.3、后台同步事务成功完成，部分员工签到数据没有同步到s-HR系统原因：可按事务监控看板内的异常提示信息检查，s-HR中用户与云之家用户映射关系有异常，同一个员工存在多个映射或找不到映射关系（找不到映射关系有一种特殊情况是员工已离职。离职员工无法进行签到数据同步，可以进行打卡记录导入。）修复：根据事务监控看板内的异常提示信息，利用s-HR中云之家用户同步功能，修复对应员工与云之家的用户映射关系，然后针对性选择异常员工单独进行同步，或修改开始同步时间重新执行任务全部同步。4.4、云之家部分员工的数据未同步成功，如何重新同步？见FAQ4.3，针对性选择异常员工单独进行同步，或修改开始同步时间重新执行任务全部同步。4.5、拍照签到与外勤确认待办的关系4.5.1、拍照签到与外勤确认待办的关系拍照签到与外勤确认待办是不一样的。拍照签到是正常内外勤签到的补充。特别是在无法签到的异常情况下可使用。拍照签到记录需要负责人（包括兼职负责人；若无部门负责人，将由管理员审核）审核后才可作为有效的签到记录。拍照签到由负责人确认之后才会同步至s-HR系统，若未审核或审核不通过，都不会同步。内勤的拍照签到，云之家审核后，会同步到s-HR的打卡记录表；外勤的拍照签到，云之家审核后，会变为有效的外勤记录，会同步到“移动签到审核”并标记为“同意”，且同步到“打卡记录”表。4.6、移动端外勤确认相关问题4.6.1、云之家外勤由谁确认？云之家外勤是由部门负责人确认。外勤记录是由部门负责人（包括兼职负责人）确认，负责人的外勤记录由上级部门的负责人（包括兼职负责人）确认。如下图：4.6.2、负责人如何确认部门的外勤记录？方法1：进入“云之家-签到-签到统计”，查看团队外勤记录并确认方法2：通过每天推送的待办消息中进入查看并确认4.6.3、为什么负责人没有收到待办消息呢？请先确认部门中是否有员工进行了外勤签到。其次，外勤待办消息隔天推送，负责人会在第二天收到外勤确认消息4.6.4、外勤未确认的记录会同步么？会同步至s-HR系统的“移动签到审核”表，也可以由专员在WEB端进行同意确认。4.6.5、非当天确认的记录如何同步？非当天确认的记录，将在确认后，同步任务执行后，重新同步至s-HR系统。
