s-HR Cloud 与金蝶云·星空(旗舰版)集成配置操作手册

栏目:s-hr cloud知识作者:金蝶来源:金蝶云社区发布:2024-09-22浏览:1

s-HR Cloud 与金蝶云·星空(旗舰版)集成配置操作手册

前  言

本文档是针对金蝶s-HR Cloud与金蝶云星空(旗舰版)使用接口集成应用的说明,包括应用环境、数据中心的支持,同步配置及同步机制说明等;还针对组织人事数据(组织、员工等)、薪酬业务数据(财务凭证、银行代发单)同步金蝶云星空(旗舰版)的方法与步骤以及星空旗舰版的出差单同步到s-HR的出差单的功能进行介绍。

【免责声明】:本文档仅用于学习使用,未经授权,禁止转载。本文档中所涉及的数据均为虚构的模拟数据,不代表任何一家企业的真实情况, 如有权利人认为其中的任何内容存在侵权情况,请反馈给金蝶官方邮箱(DataSubjectRequest@kingdee.com ),我们将在7个工作日内处理。

文档:金蝶s-HR Cloud 与金蝶云星空(旗舰版)集成配置操作手册.docx


一、功能目标

金蝶s-HR和金蝶云星空(旗舰版)集成主要为支持在包含人力资源的整体ERP解决方案当中,需要同时部署金蝶云星空(旗舰版)系统,以及相应的金蝶s-HR人力资源管理系统,可以保持行政组织(部门)、员工基础资料的统一,以及s-HR薪资数据同步至金蝶云星空财务系统,进行财务凭证和银行代发单业务处理。最终保障整个业务系统的信息流连贯通畅,及全程的自动化处理。

s-HR和金蝶云星空(旗舰版)集成,改用API接口的同步方式,对接苍穹OpenAPI平台,提供同步效率和稳定性。同步过程中记录同步日志和映射关系,以便在出现同步异常时,可以通过同步日志和映射关系快速查找原因,并结合业务应用,根据需要进行修复。

二、版本支持

金蝶s-HR Cloud(以下简称s-HR)支持s-HR Cloud V8.8 SP1、s-HR Cloud V9.0版本,金蝶云星空(旗舰版)取最新迭代版本即可。

• s-HR补丁要求:

s-HR Cloud V8.8 SP1必须安装:PTM171251、平台补丁PT177822、集成补丁PT175946、薪酬补丁PT176500、考勤补丁PT177379;(若对应领域有最新补丁,则安装最新补丁即可)

s-HR Cloud V9.0 必须安装:PTM176002 + 考勤补丁PT177421和平台PT177823、集成、薪酬的最新补丁

【备注】:s-HR各版本最新补丁清单可以从以下链接获取:

https://vip.kingdee.com/article/61509631671398912


金蝶s-HR与金蝶云星空(旗舰版)集成支持版本对照表如下:

序号

s-HR Cloud版本

金蝶云星空(旗舰版)版本

支持情况

1

s-HR Cloud V8.8 SP1

云星空(旗舰版)最新迭代版本

更新最新补丁后支持组织员工主数据集成,支持凭证集成、银行代发单集成

2

s-HR Cloud V9.0

云星空(旗舰版)最新迭代版本

支持组织员工主数据集成,支持凭证集成、银行代发单集成

三、集成同步要求

仅支持从s-HR一个数据中心到金蝶云星空一个数据中心进行集成同步,不支持一对多或多对一的数据中心集成同步,也不支持同一应用服务器下挂多个数据中心分别同步。

四、集成同步配置及初始化

第一步:【星空(旗舰版)OpenAPI相关配置】

1、 登录星空旗舰版数据中心,进入【开放服务云】→【OpenAPI】,如果没有进行过OpenAPI(开放平台)的初始化请先进行初始化处理。

若已经进行过初始化操作,但是很久没有进行过云更新,请先进API开发管理列表进行云更新,更新标准预置的API接口信息到本地。

2、进入【开放服务云】→【OpenAPI】→【安全策略】→【第三方应用】,进入第三方应用列表;

3、列表上找到点击系统编码(即appId)为s_HR_Cloud的第三方应用,若列表上不存在,点击【同步应用】按钮选择对应应用从云端同步到本地;

4、进入应用详情,选择应用联系人,打开启用代理用户控制,并设置代理用户,如图所示:

5、同步认证方式设置,s-HR支持四种认证方式,分别是:增强型token认证、JWT认证、摘要认证和签名认证(星空旗舰集成暂未支持);需要在星空环境根据客户需要配置其中一种认证方式,其中增强型token认证是默认存在的。


1)添加增强型token认证(默认)和JWT认证

【注意】:增强型token的AccessToken认证密钥,是要手动填写的,保存后就变成密文了,请记录下密码,以备后面配置使用。

2)添加摘要认证

3)添加签名认证(注意:添加了签名认证的,同时需要添加一种加密策略,可添加AES数据加密策略,或者SM4数据加密策略,星空旗舰基础还暂时不支持签名认证)

新增加密策略(AES和SM4只能选择一种加密策略):




第二步:【s-HR端集成方案配置】

1)administrator登录s-HR,进入菜单“开发平台 -> 集成配置 -> 苍穹平台集成配置”,如下图:

2)系统出厂预置了和星空旗舰的集成配置方案,点击预置的集成配置方案进行配置,填充请求地址和账套ID:

请求地址、账套ID、代理用户等信息获取方式如图所示(需在星空旗舰第三方应用配置处获取):

x_acgw_identity获取方式如图所示(需在星空旗舰第三方应用配置处获取):

3)认证方式配置

• 选择增强型token认证方式:

【注意】:创建时,星空环境上的AccessToken认证密钥是无法明文显示的,可以手动再修改密码,重新录入一个密码。

• 选择JWT认证方式,如下图:

• 选择摘要认证方式,如下图:

• 选择签名认证方式,如下图:

4)测试连接,验证当前配置是否正确。

5)第一次配置和切换s-HR数据中心时,请执行【更新数据中心】。

第三步:【s-HR单点登录配置】

本标准集成方案中,星空旗舰版系统也需要调用s-HR接口,因此需要进行s-HR单点登录配置及白名单配置。

管理员登录s-HR的网页版->系统设置->单点登录配置,参考下图设置,修改后保存,重启服务器后配置才生效


第四步:【星空(旗舰版)集成s-HR连接配置】

登录星空旗舰版数据中心,进入【内容和生态】→【云内容和应用】→【通用集成】→【s-HR集成配置】,配置对应集成s-HR系统的地址和密钥信息,测试连接通过后保存并启用即可。

第五步:【初始化同步】

请完成以上配置后,再进行行政组织、员工的初始化同步。

1. 请在“开发平台->集成配置->苍穹平台系统集成配置”对应集成配置详情界面,点击【集成系统初始化】按钮调整到初始化同步界面,如下图:

2. 根据说明进行操作,先设置和确保确保s-HR启用的行政组织类型编码都有星空旗舰的组织形态编码进行映射转换,如下图:



3. 需要调整两边系统中已有数据的行政组织编码(包括根组织)和员工工号对应一致,初始化时将按照组织编码和员工工号进行匹配更新;确认好后点击【初始化同步】按钮进行初始化同步处理。

4. 查看初始化同步结果,有失败的数据可以挑战到日志列表进行查看,处理后可以重新进行初始化同步。

【备注】:

初始化同步数据范围包括系统内所有启用的行政组织和在职员工(在职员工判定标准:员工用工关系状态对应的ERP人员状态为在职、不在职或返聘)。

初始化同步不对已经封存的组织、及已离职的员工(员工用工关系状态上的ERP人员状态为离职、离退休)进行同步。

初始化同步逻辑: s-HR的行政组织对应编码或员工工号在星空系统中不存在时,新增对应行政组织和人员数据并建立数据映射;s-HR的行政组织对应编码或员工工号在星空系统中存在时,二者对应匹配更新并建立数据映射关系。

员工薪酬部分不需要初始化。具体请参考第六章节。

五、组织人事集成同步功能说明

1.基本功能

集成同步配置完成并执行初始化同步后,后续系统将会自动同步更新行政组织和员工数据。在s-HR系统中组织数据的更新,以及员工管理中对员工信息的更新及员工变动等都会触发数据同步至去星空(旗舰版)系统中。

s-HR系统内进行行政组织的新增、修改、变更、封存、删除、批量组织架构调整,这些业务操作生效后,系统都会向星空旗舰系统内自动同步。

【特别说明】:s-HR系统内行政组织封存,星空旗舰系统对应行政组织会自动置为封存,这可能影响星空旗舰相关的行政组织架构部门的财务、供应链、制造等相关的业务,需谨慎处理。

s-HR系统内进行员工的入职、员工信息的修改、员工信息的变更、调动事务、兼职事务、员工离职、删除、批量组织架构调整造成的员工任职变化,这些业务操作生效后,系统都会向金蝶云星空系统内自动同步。

【特别说明】:s-HR系统内管理的企业员工更新、转正、调动、离职、删除等,根据s-HR对应员工状态和星空旗舰系统的参数设置,可能会将星空旗舰的对应人员禁用,这可能影响员工相关的财务、供应链、制造等相关的业务及供应链业务员的设置,以及工作流的应用,需谨慎处理。

行政组织、员工数据更新机制及字段对应关系,请参考下面Excel的描述:

组织、员工数据同步(标准预置)

s-HR业务操作更新金蝶云星空(旗舰版)数据说明如下:


s-HR与金蝶云星空(旗舰版)集成字段同步标准预置说明如下:

若有同步失败的数据,可以在s-HR的集成同步日志里边重新同步(参见本章第2节)。

薪资数据同步

薪酬数据同步详情请参考本文档第六 章节

出差单同步

星空期间出差单同步到s-HR出差单正在规划中,后续补丁发布,敬请期待。


1.1  不进行同步推送的数据说明

部分数据因关键数据不完整、关联的上级或前置基础资料未同步成功,将不会向金蝶云星空同步这些数据,这些数据的失败日志将写入s-HR和星空旗舰的错误日志:


同步组织:行政组织类型没有和星空旗舰组织形态建立映射关系的组织无法同步,失败原因为:“参数【patternNumber】必填。”;

同步组织:上级组织未新增同步成功的,失败原因为:“【上级部门】数据不存在:编码“XXXX””;

同步组织:金蝶云星空业务组织为空的,失败原因为:“金蝶云星空业务组织编码为空,不进行同步推送”;

同步员工:员工任职部门编码在星空旗舰不存在(即组织未新增同步成功的),失败原因为:“【部门】数据不存在:编码“XXXX””;

同步员工:员工编码和用户名不符合规范的,失败原因为:““用户名”只能包含中文、字母、数字、下划线,并且不能以下划线开头和结尾”;

同步员工:手机号码、邮箱号码不符合格式校验的,失败原因为:“手机号位数不对”或“区号不对”;

同步员工:直接上级不存在(即直接上级员工未同步成功)的,失败原因为:““直接上级”下“工号=XXXXXX”引入不成功。”。


1.2  同步禁用金蝶云星空基础数据说明

组织

s-HR组织封存时,同步到星空旗舰版会自动封存对应部门;

s-HR组织删除时,星空旗舰对应部门不会封存,只会删除数据映射关系。

员工

s-HR员工同步到星空旗舰系统是否禁用该员工,根据员工当前用工关系状态上的ERP人员状态设置和星空旗舰对应参数进行综合判断。

若ERP人员状态为离职、离退休,则同步至星空旗舰时调用处理员工映射关系接口。如:员工离职后用工关系状态变为辞职(用工关系状态为“辞职”的基础数据上的ERP人员状态为离职),同步至旗舰时会调用对应接口进行处理。请根据需要设置对应用工关系状态上的用户状态,如下图:

当星空旗舰接收到s-HR对应的接口调用后,会根据星空旗舰系统【基础服务云-公共设置-参数配置-系统参数】菜单里基础服务系统参数中s-HR集成参数进行判定是否进行用户禁用和人员禁用:  

参数名称

参数说明

员工离职/删除时同步禁用用户

参数为默认开启状态。开启该参数,则s-HR系统中员工离职禁用或删除时,会同步禁用当前星空系统中与之映射的用户账号;关闭该参数,则不同步禁用,需要管理员手工调整用户状态。

员工离职/删除时同步禁用人员

参数为默认开启状态。开启该参数,则s-HR系统中员工离职禁用或删除时,会同步禁用当前星空系统中与之映射的用户账号;关闭该参数,则不同步禁用,需要管理员手工调整用户状态。


【备注】:组织、员工在星空旗舰同步禁用,将可能影响到相关的星空旗舰业务,涉及:工作流/审批流、业务单据/基础资料/凭证等引用,若有特殊需要,请做好业务协调,在s-HR更新操作前,确保走完金蝶云星空(旗舰版)相关业务或者不会影响到星空对应业务。

2. 同步日志记录及映射表

在星空旗舰和s-HR系统均可以查看同步数据的同步日志和映射关系表。通过同步日志可以直观查看同步失败的原因,便于分析原因,通过映射关系的查看可以溯源。

在初始化同步时,系统根据s-HR中的基础数据(行政组织、员工)编码与旗舰版系统中的对应基础数据(行政部门、员工/人员)编码或工号进行匹配,生成对应数据内码的映射表,后续数据更新均通过映射表中的ID进行匹配更新;如新增的数据在映射表中不存在,会先根据编码进行匹配,若匹配成功则生成对应数据内码的映射表,若未找到匹配数据,则在星空期间中创建数据并返回内码记录到映射表中。

数据同步成功和失败均在s-HR和星空旗舰同时记录同步日志,s-HR可由管理员或有权限的用户通过【开发平台->集成配置->星空旗舰版集成日志】进行查看,每次同步均会新增日志记录。


2.1 s-HR系统记录同步日志

有权限的用户进入【开发平台-集成配置-星空旗舰版集成日志】查看,每次同步都会新增一条日志记录,主要记录数据的的编码、名称、同步状态以及失败原因等信息。同步失败的数据,可以批量选择重新同步,同步后会以最新的同步结果更新金蝶云星空的数据,并生成最新的日志,如下图:

2.2 金蝶云星空(旗舰版)记录集成同步日志

星空旗舰系统由用户针对具体的基础资料分别查看接口调用同步日志,功能路径:【行政组织(部门)/人员】的【其他】->【s-HR同步日志】菜单;星空旗舰系统这里的同步日志主要记录同步接口的调用日志,如下图:

在【行政组织(部门)/人员】的【其他】->【s-HR同步映射关系】可以查看相关基础数据的对应关系如下图:

3、业务配置方案

s-HR集成根据不同的业务场景有不同的操作步骤。

【场景一】:先实施金蝶云星空(旗舰版),后实施金蝶s-HR

【场景一】需区分下面两种情况:

金蝶云星空(旗舰版)的历史数据不再使用

 1、修改金蝶云星空历史数据的编码,避免与s-HR重复;

   【建议】:在编码增加前缀或者后缀标识(例如:_old)

 2、在金蝶云星空对历史数据进行【禁用】操作;

 3、s-HR按照实际情况维护数据;

 4、s-HR和星空旗舰各自完成集成配置;

 5、s-HR执行【同步】,完成初始化同步。

金蝶云星空(旗舰版)的历史数据需要继续使用,但是要与s-HR保持一致

 1、金蝶云星空修改编码与s-HR一致;(尽量不要遗漏数据);

(例如:金蝶云星空历史存在采购部编码为001,经过梳理对应s-HR行政组织编码为002,则需要修改星空旗舰版对应组织的编码和s-HR保持一致。)

 2、s-HR按照实际情况维护数据;

 3、s-HR和金蝶云星空各自完成集成配置;

 4、在s-HR执行【初始化同步】,完成已有数据的匹配同步。

操作步骤

1. 先梳理需同步的数据

主要分为两部分,一个是金蝶云星空尚不存在,需s-HR追加同步的数据;另一个是对s-HR和金蝶云星空双方都已存在的数据同步。

对于s-HR和金蝶云星空双方都已存在的数据:

1) 从业务层面决策是否需要与s-HR一致,如果保存一致是否会影响金蝶云星空的历史数据或者工作流之类的,最终确定需双方保持一致的数据范围;

2) 确定同步数据的顶层、自上而下的级次顺序;

3) 保证同步数据在两个系统的编码相同,且编码最好都是大写或者小写;特别是遇到编码不同名称相同的,重点检查确认是否要做同步,若需要,需要调整编码,保证两个系统编码完全一致。

2. 金蝶云星空进行s-HR集成配置,并启用,引出密钥文件,然后s-HR 在金蝶云星空集成配置中引入金蝶云星空密钥文件,填写消息地址;

3. 对于s-HR和金蝶云星空双方都已存在的,且需做同步的数据:

保证两边对应数据编码相同后执行初始化同步;

4. 金蝶云星空尚不存在,需s-HR追加同步的数据:

s-HR点击【初始化同步】,系统进行初始化同步操作;

5. 若初始化同步存在同步失败的数据,需要根据同步日志检查并处理。


【场景二】:先实施s-HR,后实施金蝶云星空(旗舰版)

1、金蝶云星空进行s-HR集成配置,并启用,引出密钥文件;

2、 s-HR在集成配置中配置完毕,系统进行初始化同步操作;

3、后续s-HR 的数据有异动,则系统会自动同步到金蝶云星空。


【场景三】:金蝶云星空(旗舰版)调整同步的数据中心

操作步骤

1、 s-HR 手动执行脚本清除与金蝶云星空G的数据映射关系(向s-HR产品获取);

2、金蝶云星空 H进行s-HR集成配置,并启用;

3、 在s-HR系统中星空旗舰集成配置修改配置信息,连接成功后,进行初始化同步操作;

4、后续s-HR 的数据有异动,则系统会自动同步到金蝶云星空H。

【场景四】:s-HR调整同步的账套

操作步骤

1、梳理s-HR 与金蝶云星空F的同步数据,对于已同步到金蝶云星空的数据重点梳理(主要从s-HR 同步过去的数据);

  1)从业务层面决策是否需要与s-HR一致,如果保存一致是否会影响金蝶云星空的历史数据或者工作流之类的,最终确定需双方保持一致的数据范围;

  2)确定同步数据的顶层、自上而下的级次顺序;

  3)保证同步数据在两个系统的编码相同;特别是编码不同名称相同的,重点检查确认是否要同步,若是则需要调整编码,保证两个系统编码完全一致。

2、s-HR旧数据中心6#对应的集成方案禁用;【必须】

3、金蝶云星空F手动执行脚本清除与s-HR的数据映射关系(金蝶云星空提供脚本),同步数据依然在金蝶云星空F存在;

4、s-HR新数据中心7#进行对应集成配置;

5、点击【初始化同步】,进行初始化同步操作,确保s-HR后续追加数据的同步;

6、后续s-HR 的数据有异动,则系统会自动同步到金蝶云星空F。


六、薪酬业务集成配置及功能说明

支持与金蝶云星空(旗舰版)进行财务凭证集成以及银行代发集成。

1、代发单集成

【应用场景】

薪酬核算完成,并审批通过后,将s-HR系统的银行代发单同步到星空旗舰,对应生成薪资付款单,财务可直接在星空旗舰系统处理薪资发放的出纳付款业务。

【前置条件】

(1) 需要先同步组织、员工(请参考五、人事领域与星空对接内容说明);

(2) 初始化同步组织员工时,已离职员工不会同步,若存在离职员工仍需发放薪资,则需在星空旗舰版系统中新增该员工,其工号需与s-HR系统中的员工编码一致;若星空旗舰中已存在该员工,则需检查工号是否与s-HR系统中的员工编码一致;

(3) 同步组织与员工后,需在星空旗舰版系统的【基础服务云->公共设置->s-HR集成->s-HR集成映射关系】中维护行政组织和收付组织、结算组织的映射关系;

(4) 在星空旗舰版系统中,需要给代理用户(请参考第四章节集成同步配置及初始化 -【第二步】-【s-HR端配置】中的【苍穹平台集成配置】设置)分配生成薪资付款单的相关权限;

(5) s-HR系统中银行代发单上的发放币别的编码,需与星空旗舰中的币别编码保持一致。

【集成配置】

请按照以下链接的步骤说明,在星空旗舰系统中,从云端同步API资源:

【一键同步原厂标准API方式】: https://vip.kingdee.com/knowledge/specialDetail/272110040385964032?category=523054365351886592&id=548882576992034048&productLineId=1


需同步的API:

编码

名称

url

getList

币别列表查询

/v2/base/bd_currency/getList

shrOrgMapping/queryByAdminOrgNumber

s-HR集成映射关系查询(Number)

/v2/base/shrOrgMapping/queryByAdminOrgNumber

addSave

代发处理新增保存

/v2/cas/cas_agentpaybill/addSave

【s-HR业务配置】

(1) 权限分配

在客户端的【用户管理】中给业务用户分配以下权限项:

• 【人力资源(s-HR)】-【薪酬核算】-【薪酬核算】-【薪酬核算向导】-【薪酬发放】-【银行代发处理】&【银行代发(星空旗舰)】(必须分配)

• 【人力资源(s-HR)】-【薪酬核算】-【薪酬核算】-【银行代发单】-【银行代发单(星空旗舰)】

(2) 配置编码规则(业务用户登录)

操作路径:客户端的【规则定义】-【人力资源(s-HR)】-【薪酬核算】-【银行代发单】

(3) 设置发放项目

请确保计算规则中已设置发放项目,用户在【计算规则-薪酬项目-设置】中勾选【发放项目】字段。

【同步集成说明】

• 集成同步配置完成后,用户在【薪酬核算向导-第四步-银行代发处理】中点击【生成代发单(星空旗舰)】,此时会根据星空旗舰的【s-HR集成映射关系】找到对应的收付组织作为代发单上的付款公司,自动拆分生成s-HR银行代发单。

• s-HR银行代发单提交财务后,如果单据上的【代发单处理状态(星空旗舰)】字段为“提交中”,则说明同步生成星空旗舰薪资付款单正在进行中;

• 如果【代发单处理状态(星空旗舰)】字段为“提交失败”,则说明同步生成星空旗舰薪资付款单失败,请在代发单列表字段【星空旗舰同步日志】中查看失败原因;

• 如果同步生成成功,则【代发单编码(星空旗舰)】字段会被返写为星空旗舰薪资付款单单据编码,【代发单处理状态(星空旗舰)】为“付款中”;

• 如果星空旗舰退单/退回s-HR后,用户可在代发单列表字段【星空旗舰同步日志】中查看退单原因。


当【代发单处理状态(星空旗舰)】为[未提交/提交失败/已删除]时,s-HR银行代发单允许删除,否则不允许删除。

星空旗舰薪资付款单退单/退回shr后,如何重新生成并同步代发单?

当星空旗舰薪资付款单退单/退回shr后,s-HR银行代发单中分录状态会被返写为【已退单】,此时可以在核算向导-第四步-银行代发处理中,展开过滤,过滤条件【代发单员工】选择[支付失败代发单],过滤出已退单的记录,勾选并重新生成代发单。

2、凭证集成

【应用场景】

薪酬核算完成,生成费用分摊数据,并审批通过后,根据分摊数据生成费用分配单,将s-HR系统的费用分配单同步到星空旗舰,对应生成财务应付单,财务可根据应付单处理凭证记账业务。

【前置条件】

(1) 需要先同步组织(请参考第五章节人事领域与星空对接内容说明);

(2) 同步组织后,需在星空旗舰版系统中的【基础服务云->公共设置->s-HR集成->s-HR集成映射关系】维护行政组织和收付组织、结算组织的映射关系;

(3) 在星空旗舰版系统中,需要给代理用户(请参考第四章节集成同步配置及初始化 -【第二步】-【s-HR端配置】中的【苍穹平台集成配置】设置)分配新增费用项目、生成财务应付单的相关权限;

(4) s-HR系统中费用分配单上的币别的编码,需与星空旗舰版中的币别编码保持一致。

【集成配置】

请按照以下链接的步骤说明,在星空旗舰系统中,从云端同步API资源:

【一键同步原厂标准API方式】: https://vip.kingdee.com/knowledge/specialDetail/272110040385964032?category=523054365351886592&id=548882576992034048&productLineId=1

需同步的API:

编码

名称

url

er_expenseitemedit_save

费用-费用项目_保存(预置)

/v2/er/er_expenseitemedit/er_expenseitemedit_save

shrOrgMapping/queryByAdminOrgNumber

s-HR集成映射关系查询(Number)

/v2/base/shrOrgMapping/queryByAdminOrgNumber

batchAdd

财务应付单批量新增

/v2/ap/ap_finapbill/batchAdd

【s-HR业务配置】

(1) 权限分配

在客户端的【用户管理】中给业务用户分配以下权限项:

• 【人力资源(s-HR)】-【薪酬核算】-【薪酬核算】-【生成费用分配单(星空旗舰)】

• 【人力资源(s-HR)】-【薪酬核算】-【薪酬核算】-【费用分配单(星空旗舰)】

(2) 配置编码规则(业务用户登录)

操作路径:客户端的【规则定义】-【人力资源(s-HR)】-【薪酬核算】-【费用分配单】

【同步集成说明】

• 计算规则核算完成,审核、生成费用分摊,并审批后,用户在【生成费用分配单(星空旗舰版)】中点击【生成费用分配单】,此时会根据费用分摊组织在星空旗舰【s-HR集成映射关系】找到对应的收付组织、结算组织,自动拆分生成s-HR费用分配单。

• 如果【生成财务单据状态】字段为“提交失败”,则说明同步生成星空旗舰财务应付单失败,请在费用分配单列表字段【提交操作日志】中查看失败原因;


• 如果同步生成成功,则【财务单据编码】字段会被返写为星空旗舰财务应付单单据编码,【生成财务单据状态】为“已提交”;

• 当【生成财务单据状态】为[未提交/提交失败/已删除]时,s-HR费用分配单允许删除,否则不允许删除。

七、考勤业务出差单集成配置及说明

支持与金蝶云星空(旗舰版)进行出差单集成。

【应用场景】

星空旗舰出差单审批通过和反审批后,将星空旗舰的出差单同步到s-HR系统,对应生成出差单和删除出差单,财务可直接在s-HR系统处理考勤计算的业务。

【前置条件】

(1) 需要先同步组织、员工(请参考五、人事领域与星空对接内容说明);

(2) 初始化同步组织员工时,已离职员工不会同步,若存在离职员工仍需对员工的出差单进行计算,则需在星空旗舰版系统中新增该员工,其工号需与s-HR系统中的员工编码一致;若星空旗舰中已存在该员工,则需检查工号是否与s-HR系统中的员工编码一致;

(3)  在星空旗舰版系统的【系统服务云->调度中心->调度作业】,启用【费用-出差申请单同步到其他系统】的调度作业;

(4) 在星空旗舰版系统的【系统服务云->调度中心->调度计划】,启用【出差申请单同步到第三方系统】的调度计划;

(5) 在s-HR系统的【EAS客户端->参数设置->人力资源(s-HR)->系统设置】将【是否开启外部接口调用日志记录】改为“是”;

【OSF配置信息】

s-HR系统调用OSF配置信息:

服务名称

OSF名称

saveTripBill

保存出差单

deleteOutTripBill

删除外部出差单

【s-HR业务配置】

(4) 权限分配

在客户端的【用户管理】中给业务用户分配以下权限项:

• 【人力资源(s-HR)】-【考勤管理】-【日常考勤】-【出差单】。

【同步集成说明】

• 星空旗舰出差单审批通过,调度计划执行后,将星空旗舰的出差单同步到s-HR系统,对应生成出差单。

• 星空旗舰出差单反审批,调度计划执行后,将星空旗舰的出差单同步到s-HR系统,对应删除出差单。

• 如果需要即刻查看同步的数据,可在【系统服务云->调度中心->调度计划】,进入【出差申请单同步到第三方系统】的调度计划手工执行;

• 查看出差单外部服务调用日志,进入【s-HR系统->开发平台->OSF配置->更多->查看服务日志】,过滤服务名称


八、应用服务器或数据库切换

当需要进行应用服务器或数据库切换时,请根据以下指引选择正确的方式处理:

s-HR服务器地址切换

需根据新的服务器地址调整s-HR和金蝶云星空端的配置。

s-HR或金蝶云星空数据库切换

需清空未变化的数据库中的映射表(如s-HR数据库不变,金蝶云星空切换为另一个未执行过同步的数据库,则需要清空s-HR数据库的映射表;反之,若s-HR切换为另一个未执行过同步的数据库,金蝶云星空数据库不变,则需要清空金蝶云星空数据库的映射表;数据库均切换成未执行过同步的数据库,则无需处理),重新配置后再进行初始化同步;

若s-HR和金蝶云星空数据库均做过同步,需要重新以未同步状态进行初始化同步,则需要同时清空两个数据库中的映射表。

九、注意事项

s-HR Cloud 与金蝶云·星空(旗舰版)集成配置操作手册

前 言本文档是针对金蝶s-HR Cloud与金蝶云星空(旗舰版)使用接口集成应用的说明,包括应用环境、数据中心的支持,同步配置及同步机制说...
点击下载文档
确认删除?