s-HR和星瀚集成配置1配置和星瀚平台的链接1.1注册星瀚账号s-HR与星瀚交互，是通过星瀚账号进行权限验证的，因此为了能登录星瀚系统，同时能够让s-HR可以提交财务信息到星瀚，需要在星瀚系统中申请对应的账号。需要注意的是，必须有个账号注册了星瀚的第三方应用，登录账号可以使用其他账号。1.2在星瀚系统的配置登录星瀚系统，配置和星瀚平台的链接，服务的完整流程如下图：详细操作信息参考：https://vip.kingdee.com/article/213309216688450304?productLineId=29由于上文链接所在社区文档描述较为清晰，本文档不作复述，其中有几点需要特别说明的地方：1)系统编号和系统名称：手动维护，但需要和s-HR中维护的“星瀚集成配置”中的系统编号保持一致，系统内置的编码为“SHR_COMPENSATION”，建议使用内置编码。2)accessToken加密认证密钥：用户手动维护，和s-HR中维护的“星瀚集成配置”中的APPToken认证密钥一致。系统编码及accessToken在星瀚位置如下，s-HR端请看1.3在s-HR端的配置：注意：请开启API授权，API授权需遵循：要么授权所有API接口，要么给定能够访问的API。1.3在s-HR端的配置在s-HR端我们需要配置和星瀚链接的相关信息，其操作如下。1、使用管理员登录2、进入操作路径：【开发平台】→【集成配置】→【星瀚集成配置】操作说明：在该页面中维护所需对接的星瀚系统的相关信息，具体情况如下：url地址：为星瀚系统地址。➢如果星瀚使用的是私有云，使用适用云地址，其地址格式如下：http(https)://ip:port/patchfi，截止到patchfi（patchfi是星瀚系统访问前缀，如果有设置为其他前缀，以设置的为准）。➢如果星瀚使用的是公有云，直接使用星瀚公有云地址，其地址格式如下：http(https)://xxx.com。数据中心ID获取方法：通过如下链接查询数据中心ID集合：➢如果星瀚使用的是私有云环境，地址为（注意：patchfi为星瀚系统前缀，如果有设置为其他前缀，以设置的为准）：http(https)://ip:port/patchfi/auth/getAllDatacenters.do➢如果星瀚使用的是公有云环境，地址为：http(https)://xxx.com/auth/getAllDatacenters.do2.配置会计事件会计事件：是智能核算中星瀚系统为了方便接收第三方系统的财务数据，而通过星瀚开放平台来接收数据的方式；通过调用星瀚开放平台中的“保存事件（操作）”接口，将数据传输给智能核算平台，一次完整的通讯则产生一个会计事件。s-HR和星瀚财务的凭证对接即是通过调用会计事件实现的，因此需要先配置相应的会计事件。2.1配置会计事件前准备创建第三方应用操作路径：【开放平台】→【第三方应用】第三方应用，即是需要与星瀚平台对接的三方系统，在此创建是为了获取与星瀚平台通讯的连接信息，即accessToken值；后面会给出完整获取示例。API服务列表操作路径：【开放平台】→【其他】→【API1.0】→【API服务管理1.0】上图是由相关星瀚财务开发人员已经内置好的几个API清单，即是说，会计事件不需要我们来手动添加，如果后面有需要，需要跟星瀚财务相关研发、产品等人沟通，由其内置成功后，由我们来调用；API服务接口信息查看操作路径：【开放平台】→【其他】→【API1.0】→【API清单】可以查看到各接口基础信息，请求报文示例、返回报文示例等。2.2会计事件模型配置为实现会计事件调用，需先配置会计事件模式。操作路径：【财务云】→【会计事件库】→【会计事件管理】→【事件模型】操作说明，具体操作说明可点击事件模型页面右上角的带圈问号查看，或点击如下链接：https://club.kdcloud.com/article/258294296963323904?productLineId=2&isKnowledge=2，本文不再赘述。系统中需配置事件模型，其编码为SHR-CMP-ItemAccountBill，名称为费用分配单，用户仅可调整事件模型中的字段设置，编码不可调整，不可新增其他编码的事件模型。调整字段时，只能在该事件模型的限制的字段范围内进行减少，不可新增限制范围外的字段，不可修改字段编码为限制范围外的其他编码。完成以上配置后，即可调用会计事件进行数据传输了。费用分配单会计事件可配置字段说明:1)会计事件模型配置效果图：效果图1-基本信息及事件数据结构信息效果图2-分录结构2)会计事件模型可配置字段范围:注意：配置效果如右侧图中展示：以下是可选配置字段，标志必录的，必须配置，非必录的，按自己需求选择配置。➢会计事件基本信息：编码名称分组SHR-CMP-ItemAccountBill费用分配单SHR➢事件数据结构配置字段：字段编码字段名称字段类型基础资料辅助资料是否必录必录条件cmpItemAccountBill费用分配单编号文本是company所属财务组织基础资料业务单元是voucherNum凭证字号文本currency核算币别基础资料币别是recordDate记账日期日期businessDate业务日期日期matureDate到期日期日期generVoucherSate凭证处理状态文本entries分录分录是➢分录可选字段：字段编码字段名称字段类型基础资料辅助资料是否必录必录条件cmpItem薪酬项目文本costBearOrgUnit费用承担组织基础资料业务单元persons员工文本isResidualPerson其余人员布尔calTableItemAmount薪酬项目金额（核算币）数值commitmentItemAmount薪酬项目金额（承担币）数值commitmentItemCurrency承担币别基础资料币别exchangeRate汇率（核算币-承担币）数值entryId分录主键文本optionalFieldOneName自定义字段1名称文本optionalFieldOneVal自定义字段1值文本optionalFieldTwoName自定义字段2名称文本optionalFieldTwoVal自定义字段2值文本optionalFieldThreeName自定义字段3名称文本optionalFieldThreeVal自定义字段3值文本optionalFieldFourName自定义字段4名称文本optionalFieldFourVal自定义字段4值文本optionalFieldFiveName自定义字段5名称文本optionalFieldFiveVal自定义字段5值文本➢前置事件：无，不用填写。➢基础资料:说明：由于基础资料可能同名的有多个内容，请按照以下来选。名称编码业务单元bos_org币别bd_currency2.3调用会计事件完成以上配置后，即可调用会计事件进行数据传输了，一次完整的通讯则产生一个会计事件；调用会计事件，需通过s-HR系统费用分配单模块的相关功能操作，具体操作可参看该文档中“3s-HR费用分配单调用会计事件生成凭证”部分的详细内容。生成会计事件后如何查看信息，生成凭证等，可参看链接的文档：https://club.kdcloud.com/article/256734661765069056?productLineId=2&isKnowledge=2链接中已有详细说明，此处不再赘述。3.s-HR费用分配单调用会计事件生成凭证3.1前期操作在调用会计事件生成凭证前，还需要对核算完的薪资进行如下操作：➢审批当期的薪资核算结果➢在生成费用分配单（星瀚）中生成费用分配单详细操作此处不赘述，请参看以下链接中的文档【苍穹凭证集成_用户手册10.31】：https://vip.kingdee.com/article/374994560696606976?fromAction=POST_ARTICLE&productLineId=103.2和星瀚财务集成的操作经过前面的一系列操作，接下来我们可以在【费用分配单（星瀚）】中进行操作了。操作路径：【薪酬核算】→【薪酬核算】→【费用分配单（星瀚）】操作说明：选择s-HR系统中生成的费用分配单且提交财务状态为“待提交”的记录，点击【提交财务】按钮，系统将会调用会计事件，将分配单数据按会计事件模型中配置的关系传递到星瀚智能财务的会计事件中。一次传递生成一个会计事件，用户可进入星瀚系统，查找对应的会计事件进行检查，示例图如下：操作路径：【财务云】→【会计事件库】→【会计事件管理】→【会计事件】操作说明：具体的操作说明可在会计事件页面点击右上角带圈的问号查看帮助文档，或点击如下链接：https://club.kdcloud.com/article/258294296963323904?productLineId=2&isKnowledge=2文档中已有详细说明，此处不再赘述。选择所生成的会计事件，点击【生成凭证】或根据财务配置的【智能执行方案】，系统会自动按凭证模板中配置的要求生成财务凭证，详细操作也可参考上一条链接。注：凭证模板和智能执行发放需由财务人员配置。费用分配单（星瀚）其他操作说明：在s-HR系统的费用分配单（星瀚）页面中还可执行其他操作，其操作和相互约束简单说明如下：查看费用分配单：点击【单据编号】，系统会进入查看明细的费用分配单界面，客户可在此查看费用分配单，点击【编辑】按钮后可添加备注信息。提交财务:选中【提交星瀚财务状态】为“待提交”或“已撤销”的记录，点击【提交财务】，系统会将费用分配单数据传递到财务的会计事件中。撤销提交财务：选中【提交星瀚财务状态】为“已提交”且【生成财务凭证状态】为“待生成”或“已废弃”的记录，系统会将已经提交财务的数据标记为废弃。删除费用分配单：选中【提交星瀚财务状态】为“待提交”或“已撤销”的记录，点击【删除费用分配单】，系统会删除选中的费用分配单及相关的费用分摊明细。查看费用分摊明细：选中一行记录，点击【查看费用分摊明细】，系统会展示该费用分配单中所使用到的所有的薪酬结果进行成本分摊后的明细数据。刷新凭证状态：选中（可多选）需要刷新【生成财务凭证状态】的记录，点击【刷新凭证状态】按钮，系统会查询并更新所提交的费用分配单在财务生成凭证的状态，值包括“待生成”、“已生成”。
