【关键提示】

1、该文档针对s-HR Cloud V8.6及以上版本客户应用

2、请认真看完整个文档。云之家签到数据同步是建立在已经做了云之家用户同步的基础上的，如果没有做过用户同步，同步过来的数据会对应不到s-HR中的人员。

一 、云之家资源授权

云之家对外开放的接口都需要通过云之家授权协议进行授权后才能访问，只有通过了云之家的资源授权才可以进行云之家打卡数据的同步。

2. 

3. 

1.1给菜单授权

以administrator登录金蝶s-HR客户端，选择一个用户（一般为考勤专员），例如UserXXX，执行菜单权限分配（如果已经有权限，请忽略此步骤）。

客户端授权路径：企业建模->安全管理->权限管理->用户管理

选择分配权限的菜单为：人力资源（s-HR）->系统设置->考勤数据设置->云之家签到接口配置

1.2启用云之家签到同步接口

已授权用户登录到s-HR web系统，检查“云之家签到同步201906版”接口是否为“启用”状态，如果不是启用状态，点击工具栏的“启用”按钮进行接口启用。

路径：系统设置->考勤数据设置->云之家签到接口配置

二、云之家签到同步参数设置

         确保云之家签到数据能够正常同步s-HR考勤管理系统，需要进行相应的参数配置，包括企业ID，密钥等信息。

2.1 签到同步权限秘钥获取

管理员账号登陆云之家-->管理中心-->系统设置-->系统集成-->资源授权-->复制签到数据的秘钥

2.2秘钥配置

打开客户端，找到参数设置-->人力资源(s-HR) -->考勤管理，然后设置好云之家打卡同步团队id和云之家打卡同步资源授权秘钥,如果是私有云，请同时设置私有云的同步地址

三、数据同步

提示: 将云之家打卡数据同步到s-HR系统有两种方式：后台事务同步和前台手动同步，同步之前请确保前面的授权操作顺利完成。

3.1 后台同步

路径：登录s-HR客户端->系统平台->后台事务->事务定义->后台事务定义->人力资源（s-HR）->假勤管理->云之家签到数据同步

【说明】：首次同步会从2015-01-01开始同步，时间会比较长，建议修改同步时间，改为云之家有签到记录的时间。后续同步会同步前一天和当天两天的签到数据。如果不需要从这个时间点开始执行，可以修改表时间(修改下面语句标红的时间点即可)：

Update t_hr_ats_bizdatasynchassistset flastsynchtime={ts'2017-08-01 00:00:00'} where fid='bSvNRciAEU6cJb24RAS0lKlojLM='

3.2 手动同步

路径：s-HR系统->考勤管理->打卡记录->云之家签到同步

四、私有云签到同步

4.1私有云同步数据的配置

s-HR Cloud V8.6及以上版本，只能使用oAuth V2.0方式鉴权的接口同步，配置跟公有云的一样，按本文档配置。如果私有云是使用oAuth V1.0版本的鉴权同步，需要先对私有云进行升级。

五、FAQ

4.1、关于外勤打卡数据的审核操作？

审核操作支持云之家和s-HR审核，所有接口同步到的未审核的外勤数据都可以在s-HR进行审核，一旦经过审核操作，将不能再次审核。

4.2、什么是外勤打卡？

在云之家设置的打卡地点之内的数据属于内勤打卡，也就正常打卡，否则称为外勤打卡。内勤打卡会直接同步到打卡记录表，外勤打卡都会在移动签到审核表中有一份记录，而审核通过的外勤同时也会存在打卡记录表中。

4.3、所有或某段时间云之家签到数据都没有同步到s-HR中？

检查s-HR中同步事务是否正常执行（可在WEB端后台事务监控处检查）。如果执行成功，请检查事务监控看板内的日志信息；如果执行失败，可按事务监控看板内的提示信息检查，可能的原因有：

原因1：网络问题，本地服务器访问云之家接口延时，超时等，需检查本地网关是否允许对云之家的访问或网络稳定性（可查看apusic日志，是否有超时、500等错误）

原因2：云之家签到接口不通或鉴权信息未完善，先完善鉴权信息。

原因3：apusic服务器拦截了云之家对OSF接口的访问，需要将云之家服务器地址加入apusic服务器的安全访问白名单（默认已配置白名单）

4.4、后台同步事务成功完成，部分员工签到数据没有同步到s-HR系统

原因：可按事务监控看板内的异常提示信息检查，s-HR中用户与云之家用户映射关系有异常，同一个员工存在多个映射或找不到映射关系（找不到映射关系有一种特殊情况是员工已离职。离职员工无法进行签到数据同步，可以进行打卡记录导入。BOS已出补丁修复，离职员工不删映射关系，补丁号：PT117697）

修复：根据事务监控看板内的异常提示信息，利用s-HR中云之家用户同步功能，修复对应员工与云之家的用户映射关系，然后针对性选择异常员工单独进行同步，或修改开始同步时间重新执行任务全部同步。

4.5、云之家部分员工的数据未同步成功，如何重新同步？

见FAQ4.4，针对性选择异常员工单独进行同步，或修改开始同步时间重新执行任务全部同步。

4.6、拍照签到与外勤确认待办的关系

拍照签到与外勤确认待办是不一样的，拍照签到是正常内外勤签到的补充。特别是在无法签到的异常情况下可使用。拍照签到记录需要负责人（包括兼职负责人；若无部门负责人，将由管理员审核）审核后才可作为有效的签到记录。，若未审核或审核不通过，都不会同步到至s-HR系统。

内勤的拍照签到，云之家审核后，会同步到s-HR的打卡记录表；

外勤的拍照签到，云之家审核后，会变为有效的外勤记录，旧接口（云之家签到）会同步到s-HR的“移动签到审核”；新接口（云之家签到（外勤确认））会同步到“移动签到审核”并标记为“同意”，且同步到“打卡记录”表。

4.7、移动端外勤确认相关问题

4.7.1、云之家外勤由谁确认？

外勤确认分为自动确认和部门负责人确认。

4.7.2、负责人如何确认部门的外勤记录？

方法1：进入“云之家-签到-签到统计”，查看团队外勤记录并确认

方法2：通过每天推送的待办消息中进入查看并确认

4.7.3、为什么负责人没有收到待办消息呢？

请先确认部门中是否有员工进行了外勤签到。其次，外勤待办消息隔天推送，负责人会在第二天收到外勤确认消息

4.7.4、外勤未确认的记录会同步么？

会同步至s-HR系统的“移动签到审核”表，也可以由专员在WEB端进行同意确认。（详细可参考FAQ4.2：启用不同接口，哪些数据会同步至s-HR“打卡记录”，哪些数据会同步至“移动签到审核”）

4.7.5、非当天确认的记录如何同步？

非当天确认的记录，将在确认后，同步任务执行后，重新同步至s-HR系统。