财务与人力资源接口部署培训手册

财务与人力资源接口部署培训手册

1.部署前提条件

i.应用服务器组建需求

升级以下最新的三个M8服务端组件：

Freesky.M8.DAL.GL.dll,

Freesky.M8.BLL.BusinessProcess.GL.dll,

Freesky.M8.WebService.GL.dll。

分别部署至Ifreesky\webservice\bin目录下。

ii.例如：假如M8应用服务器程序安装在c:\programfiles'freesky目录的话,

直接将三个最新的组建存放到c:\programfiles\freesky\webservice\bin目

录下，假如存在旧版本的三个相应组件，直接替换掉就可以了。

iii.数据需求

1）凭证来源

2）在PL/SQL的commandwindow窗口执行hr.sql脚本.增长一种凭证

来源:HR

3）组织主数据

序号名称备注

01公司代码人力系统与财务系统进行数据同步。

02公司名称若编码有差异，需建立相应关系。

4）注：财务系统中若对公司代码及名称产生了变化，需发送数据变化

提醒信息给人力资源系统。人力资源系统的系统管理员根据提醒同

步人力资源系统内的公司代码数据表。

5）在人力资源系统向财务系统通过接口传递凭证时，凭证中的公司代

码信息如与财务系统不符，返回错误提醒给人力资源系统。

6）成本中心主数据

序号名称备注

01成本中心编号人力系统与财务系统进行数据同步。

02成本中心名称

7）注：财务系统中若对成本中心的编码及名称的数据表发生了变化,

需发送数据变化提醒信息给人力资源系统。人力资源系统系统管理

员根据提醒同步人力资源系统内的成本中心数据表。

8）在人力资源系统向财务系统通过接口传递凭证时，凭证中的成本中

心信息如与财务系统不符，返回错误提醒给人力资源系统。

9）人员信息主数据

序号名称备注

01身份证号财务系统与人力系统保持数据的一致

02姓名性

10）会计科目主数据

编号字段名称备注

01科目编号人力系统与财务系统进行会计科目数

据列表的同步。并在人力资源系统中

建立人工成本项目依据不同的影响与

02科目名称会计科目的相应关系，实现系统间数

据集成。

11）注：财务系统中若对会计科目的数据表发生了变化，需发送数据变

化提醒信息给人力资源系统。人力资源系统系统管理员根据提醒同

步人力资源系统内的会计科目数据表。

12）在人力资源系统向财务系统通过接口传递凭证时，凭证中的会计科

目信息如与财务系统不符，返回错误提醒给人力资源系统。

13）报账项目主数据

序号名称备注

01报账项目编号与人力系统的“人工成本项目分类”

02报账项目名称建立相应关系，实现系统间数据同

步。

2.注：财务辅助系统中报账项目类型按照集团规定的人工成本项目末级分类进

行相应。

3.接口交互信息

L资计提子接口交互信息

字段1字段中文名内容选择数据类型备注

userid用户姓名非必选此用户是指接受发放凭证的财务人

员的用户姓名。在接口传递时由人

力资源系统指定相应的人员姓名。

corpcode公司代玛必选

ztcode账套代玛非必选Hr系统初始化为空

makedate制证日期非必选

voucherkey凭证字必选

hrbillid凭证号必选Hr系统单据id

attachcount附件数必选

vouchersource凭证来源必选Hr系统填写为hr（小写）

cyear会计年度必选

cperiod会计月度必选

1inenumber行号必选

Abstractstr摘要必选

Flowitemcode钞票流量代码非必选假如科H规定钞票流量，则必输.

否则为空

Mnyflowitem钞票流流最金非必选假如科目规定钞票流量，则必输，

额否则为0

accountcode科目代玛必选

debit借方金额必选

credit贷方金额必选

costcode成本中心编码非必选

current币别__________CNY非必选默认为人民币

ii.工资发放子接口交互信息

字段字段中文名内容选择数据类型备注

userid用户姓名非必选此用户是指接受发放凭证的财务

人员的用户姓名。在接口传递时

由人力资源系统指定相应的人员

姓名。

corpcode公司代码必选

ztcode账套代码非必选Hr系统初始化为空

makedate制证日期必选

voucherkey凭证字必选

hrbillid凭证号必选

attachcount附件数必选

vouchersource凭证来源必选Hr系统填写为hi•（小写）

1inenumber行号必选

Flowitemcode钞票流量代码非必选假如科目规定钞票流量，则必愉

否则为空

Mnyflowitem钞票流流量金非必选假如科目规定钞票流量，则必输

额否则为0

cyear会计年度必选

eperiod会计月度必选

Abstractstr摘要必选

accountcode科目代码必选

debit借方金额必选

credit贷方金额必选

costcode成本中心编码非必选

current币别CNY必选

iii.人工成本数据回写子接口交互信息

字段字段中文名内容选择数据类型备注

compcode公司代码必选

makedate记账日期必选

billid报账单号必选

hrbillid凭证号必选

labourcostcode人工成本分类编码必选

costcode成本中心编码必选

cyear会计年度必选4位

cperiod会计月份必选2位

money金额必选

type类型必选“实发”

psnidcardcode人员身份证号必选假如是集体

的人工成本，

此字段值则

为“0000”

personname人员姓名必选假如是集体

的人工成本，

此字段值则

为“0000”

4.联调前期准备

i.测试用例准备

1）工资计提子接口

xml数据准备

<?xmlversion="l.0〃encoding="GB2312”?>

<createvoucherrequest>

<hrbillid><hrbillid>

<userid>userid</userid>

<corpcode>corpcods</corpcode>

<ztcode></ztcode>

<makedate></makedale>

<attachcountX/attachcount>

<voucherkey></voucherkey>

<vouchersource></vouchersource>

<cyear></cyear>

<cperiod></cperiod>

<lines>

<linenumber></linenumber>

<abstractstr></abstractstr>

<acountcode></aountcode>

<costcode></costcode>

<debitx/debit>

<flowitemcode></flowitcmcode>

<mnynowitem></mnyflowitem>

<crcditx/credit>

<currentX/current>

</lines>

</createvoucherrequest>

2）按照以上格式准备测试用例，然后保存该xml数据为文献

例如:c:\l.xml

3）工资发放子接口

xml数据准备

<?xmlversion="l.0"encoding=，，GB2312，z?>

<createvoucherrequest>

<hrbillid><hrbillid>

<userid>userid</userid>

<corpcode>corpcode</corpcode>

<ztcode></ztcode>

<makedate></makedate>

<attachcount></attachcount>

<voucherkey></voucherkey>

<vouchersource></vouchersource>

<cyear></cyear>

<cperiod></cperiod>

<lines>

<linenumber></linenumber>

<abstractslr></abstractstr>

<acountcode></aountcode>

<costcode></costcode>

<debitx/debit>

<flowitemcode></tlowiiemcode>

<innyflowitem></mnyflowitem>

<creditx/credit>

<currentX/current>

</lines>

</createvoucherrequest>

4）按照以上格式准备测试用例，然后保存该xml数据为文献

例如：c:\2.xml

5）人工成本数据回写子接口

xml数据准备

<?xmlversion=*'1.0"encoding="GB2312"?>

<createvoucherrequest>

<lines>

<compcodex/compcode>

<makedate></makedate

<billidx/billid>

<labourcostcode></labourcostcod㊀〉

<costcodex/costcode>

<cyear></cyear>

<cperiodx/cperiod>

<money></money>

<psnidcardcode></psnidcardcode>

</lines>

</lines>

<compcodex/compcode>

<makedate></makedate

<billid></billid>

<labourcostcode></labourcostcode>

<costcodex/costcode>

<cyear></cyear>

<cperiodx/cperiod>

<money></money>

<psnidcardcode></psnidcardcode>

</lines>

</lines>

</lines>

</lines>

</createvoucherrequest>

ii.按照以上格式准备测试用例，然后保存该xml数据为文献例如:

c:\3.xml

iii.测试环境

1）前端用用友客户端模拟小工具interfacetest.exe结合验证码生

成器prjGetUserAuth.exe测试应用程序服务器部署的对的性,

以及主数据准备的完整性。测试环节如下：

2）第一步、获取用户验证码

运营prjGetUserAuth.exe,打开如下界面：

获取用户蒙证码回

应用服务器地址：|http：//132.148.3.154/XineM8WS

登陆名：画

密码：|

帐套：|glserver

获取■一码|

验证码：

在应用服务器相应的输入框中输入M8测试服务器应用程序的

完整途径，例如：登陆名，例如：chy,再输入密码和帐套，再

点“获取验证码”，

3）再将该用户验证码拷贝出来，并保存起来，例如：保存到文

献(authcode.txt)o

第二步：用友客户端模拟小工具interfacetest.exe

II1LfmVoucherTransChedc

出江西接口«HR接口

圻，•$***]

应用程序服务*1321483XML5C件名0寸■嬴US庚报目录名:际丽苑-

程口标识，|h_H_cokUste

验证码：|p”MyWH!WmL：ryUmWk♦〃汹404n，IUYa*J刈nth>ooMbnWcmyUxRm/mw1kHLMUt，U、/MtltUk\v3Lw/UJ、t!UWJ»：lHvcblR3LJVMTJAItn88UH8t

工资计提子接口、工资发放接口与人工成本数据回写子接口的

用户编码和用户密码都同样，分别是：

用户编码:hr

用户密码：#hr$$datasync$

接口标记：

工资计提子接口：hr_sal_calculate

工资发放接口：hr_sal_issue

人工成本数据回:PCMTOHRCOSTo

输入以上用户名，密码，验证码接口标记以后，再输入相应的XML文献全途径。

再点击最上面一排的按钮“HR接口”，然后就可以测试接口了。

假如部署环境有问题或者应用程序服务器IP地址不对，系统会提醒以下错误:

interfacetest

WSDLReader:XMLParserfailedatlinenumber0,Sneposition0,reasonis:Aconnectionwiththeservercocldnotbeestablished

HRESULTRxh函数不正确。

-WSDLReader:LoadingoftheWSDLfiefailedHRESULT=Ox80070057:参数不正确。

-Client:Oneoftheparameterssuppliedisinvalid.HRESULT=0x80070057:欧数不正确.

WSDLReader:XMLParserfailedatlinenumber0,Bneposition0,reasonis:Aconnectionwiththeservercoddnotbeestablished

假如应用服务器搭建成功的话，会出现以下提醒：

调用成功。

4）验证凭证生成

5）进入凭证查询界面，根据凭证来源（当前的三个接口产生的

凭证来源是HR）进行筛选，查看刚才做的凭证是否已经生

成。

6）查看日记

假如未生成，进入应月服务器的c:\program

files\freesky\webservice\log目录查看日记文献，里边会记录

具体错误信息。日记文献的命名规范是：

前缀:M8Log

后缀：年（四位）一月（两位）一日（两位）。

例如：2023-8-9做测试,则产生的日记文献全名是：

M8Log2023-08-09.log

用记事本打开该文献查看犯错具体信息：

内容大体如下：

时间:2023-8-820:58:00

用户错误描述：

系统错误描述：开始解析明细表XML

严重性：Unspecifed

M8用户ID:

M8模块名:GL

M8服务文献名:GL_VoucherWS

M8服务方法名:CreateHRVou

机器名:5C2ULHTC9ZV9s3P

应用程序名：

/LMAV3SVC/l/Root/FREESKY.M8.WEBSERVICE,GL-2-

1283102

)}

时间：2023・8・820:58:03

用户错误描述：

系统错误描述：完毕解析明细表XML

严重性:Unspecified

M8用户ID:

M8模块名:GL

M8服务文献名:GL_VoucherWS

M8服务方法名:CreateHRVou

机器名:5C2ULHTC9ZV9s3P

应用程序名：

/LM/W3SVC/l/Root/FREESKY.M8.WEBSERVICE.GL-2-

1283102

)}

时间：2023-8-820:58:03

用户错误描述:开始检查凭证！

系统错误描述：开始检查凭证！

严重性：Unspecified

M8用户ID:

M8模块名:GL

M8服务文献名:GL_VoucherWS.asmx

M8服务方法名:CreateHRVou

机器名:5C2ULHTC9ZV9s3P

应用程序

名:/LM/W3SVC/l/Root/FREESKY.M8.WEBSERVICE.GL-2-l

283102

)}

时间:2023-8-820:58:03

用户错误描述:ErrorXml=凭证来源不存在！

系统错误描述：集团人力资源接口调用生成凭证检查

WriteErrorlog

严重性：Unspecified

M8用户ID:

M8模块名:GL

M8服务文献名:Ifservice

M8服务方法名:CreateHRVou

机器名:5C2ULHTC9ZV9s3P

应用程序

名:/LMAV3SVC/l/Root/FREESKY.M8.WEBSERVICE.GL-2-l

283102

)}

假如要查看用友传过来的XM文献，可以按CYRL+F.然

后输入：IfserviceXML=<,再按回车，即可看到用友传过来

的XML信息，格式如下：

时间:2023-8-820:57:47

用户错误描述:Service

系统错误描述：IfserviceXML=<?xmlv