一. YonSuite产品初始化并维护业务单元

1.在“企业服务中心（网址：https://apcenter.yonyoucloud.com/）”，点击YonSuite订单的“产品初始化”，可进行YonSuite初始化操作。

详细操作请参考YonSuite初始化线上使用说明

2.维护业务单元

(1)使用管理员账号登录YonSuite系统，登录网址：https://yonsuite.yonyou.com/

登录后点击页面右上角用户头像，打开右侧菜单，点击【账号管理】，检查邮箱是否维护正确。同一用户在Yonsuite的账号与其登录U8操作员信息所维护的邮箱要保持一致。

注：与U8进行集成的YonSuite费控有且只能有一个初始管理员账号，不可手工增加指定新的管理员。当配置YonSuite费控时，部分维护操作只允许管理员进行，请使用此初始管理员账号。

（2）在【数字化建模】->【组织管理】->【组织机构】->【业务单元】中新建业务单元。

• 每一个U8账簿应当对应一个业务单元，该业务单元需要勾选上“会计主体”+“人力资源组织”；
• 汇率类型、会计主体币种、期间方案等必填项会先带入Yonsuite预置基本档案，后续基础数据同步后，会更新为U8一致，后续凭证集成时会要求数据一致性，建议复核一下。

注：Yonsuite与U8编码、名称等信息建议一致，方便后续维护

二.U8与YonSuite的ERP连接设置及档案同步

1.配置模式一：YHTU8集成配置工具

请在伙伴之家下载YHTU8集成配置工具，并在U8应用服务器上执行YHTU8.exe。

（1）U8端EAI设置

在U8端配置EAI客户端，在【外部系统注册】卡片中添加编码、名称以及指定相应U8账套数据源。

（2）登陆云窗口

此界面登录下载OpenAPI的小工具，用创建YS租户的管理员账户登录（邮箱地址要一致，密码默认和登录云的密码一致）

（3）配置主界面-选择租户、组织、U8EAI外部编码

• 选择租户，选定租户后会提示客户端登录的账户信息

• 选择组织，云上组织是指Yonsuite的业务单元。

注：单租户有默认组织，配置完成后默认组织会消失，不影响与云的配置，因此使用该工具需要一次性配置完，如果没有配置完，下次就不能用工具，只能进入web端去点后面的操作。

（4）配置主界面-下载、安装U8 OpenApi客户端

从工具的地址点开下载下载openapi客户端，请确保为最新版本客户端，安装后使用管理员账号登录。

（5）配置主界面-依次完成增加ERP设置，初始化同步和执行同步任务

（6）Yonsuite【数据同步任务】设置

• ERP设置连接成功后点击【初始化同步任务】，会在Yonsuite【数据集成】-【数据同步任务】按照网关自动建立数据同步任务，共计35个任务（除了27个基础档案还有8个单独任务）。(网关指为ERP连接中的组织编码，即Yonsuite业务单元)

• 初始化同步任务后在YHTU8工具中点击“执行同步任务”，会自动执行35个任务，可点击“同步任务执行日志”，查看执行进度，也可选择某个数据视图，点击“查看日志”，确认执行结果。

• 友企联云主键存储说明：U8大部分档案均采取全量拉取到友企联，友企联会根据唯一标识，通常是档案编码，个别档案有区别，来判断是新增还是修改数据；Yonsuite各档案保存成功后回传该条数据的id（云主键），友企联进行存储。
• 点击某数据视图行上“数据管理”→“查看详细数据”，当云主键（cloudpk）为空则表示在Yonsuite未存储成功，可通过日志排查问题，根据日志提示进行数据修正后，可再次执行同步任务。

• 当初始化同步结束，可根据不同档案的需要创建定时任务。

创建定时任务的详细操作请以YonSuite产品管理部编写的“YonSuite费控与U8集成操作指南202206”使用说明为准。

2.配置模式二：YonSuite ERP连接设置

（1）在【ERP连接配置】添加ERP连接配置，创建U8连接并初始化方案。

如果打开ERP连接配置添加U8连接时提示email不能为空，请登录租户管理员账号，在账号管理中设置邮箱；后期使用过程中该邮箱不可变更，请保存好。

（2）下载、安装U8OpenApi客户端

通过“点击下载”按钮，下载客户端并进行安装。安装位置和网络要求：Window环境或windows server环境，位置需要和U8客户端在一个网络内。此服务器必须能访问公网，端口80与8888开发。

（3）U8端EAI设置

配置方法同“配置模式一”的相同，请参考“配置模式一”中的U8端EAI设置说明。

（4）登陆U8 OpenApi客户端

账号使用Yonsuite租户管理员的邮箱，密码是登录Yonsuite的密码。

（5）U8连接器配置工具

• 系统编码：跟U8对接的账套号
• 服务地址：U8服务器IP地址
• 服务识别码：U8产品服务识别码

• EAI数据源：U8服务器IP地址
• 数据库地址：U8服务器IP地址
• 数据库账套：Yonsuite与U8对接的U8账套库

• 数据库账号：登陆U8数据库的用户，一般是sa
• 数据库密码：登陆U8数据库的密码

设置完信息配置后进行保存、测试服务器连接、测试数据库连接，并指定主账号。目前币种档案为租户级档案，仅从主账号同步。

（6）点击初始化同步任务，会自动在【数据同步任务】中创建35个同步任务有没有对应节点位置能查看到

执行同步任务、

注意：多账套租户，参照以上操作重复配置其余账套的ERP连接即可。

（7）配置方法同“配置模式一”相同，请参考“配置模式一”中的【数据同步任务】设置文档说明。

三.YonSuite 费控与U8集成特殊档案配置

1.U8科目指定对应项目大类的关系需要在YS中进行配置

U8中每个项目大类只能指定一个科目即每个科目只能有一个项目大类的辅助核算。该项目大类与科目关系需要在Yonsuite中设置，避免Yonsuite在报销过程中出现无法生成相应会计科目的凭证的问题；所以在U8项目大类指定会计科目后，需要Yonsuite在科目对照关系中进行相应设置。

U8中科目指定项目大类：

Yonsuite配置说明：

（1）在YS【自定义项设置】中增加自定义项名称命名为“项目类型”，类型为“档案”，引用档案选择“项目类别”

（2）将自定义项分配给使用项目的报销单子表。分配完成，该自定义项会在UI模板报销明细数据区中显示，到【UI模板】选择“配置”

（3）找到新建的自定义项字段设为显示，点击保存。

（4）进入【UI模板】，选择【设计】，找到项目字段，选择【参照配置】，参照带入信息为项目档案的所属项目类别，带入的字段为新建的项目类型自定义项。配置完成，报销单中即可根据项目自动生成项目类型。

（5）进入【影响因素设置】，输入影响因素名称，对应已创建的基础档案类型“项目类型”。

（6）进入到【影响因素关联】中选择源实体模板“通用报销-报销明细-标准”影响因素“项目类型”单据字段选择创建好自定义项。若为创建第一个自定义项就为表体自定义项1。

（7）进入【总账凭证模板】根据相应报销单凭证模板中的科目对照编码到科目对照表中配置科目对照关系。

（8）在【科目对照表】中找到使用的科目对照，选择编辑，影响因素维护“项目类型”，在表体维护实例中的项目类型与科目对应关系即可；

2.Yonsuite总账会计科目辅助核算将是否允许为空选项去掉

由于U8中科目只要启用客户、供应商、人员、部门、项目辅助核算就不能为空，所以在会计科目同步到Yonsuite后，需要将Yonsuite中会计科目客户、供应商、人员、部门、项目辅助核算项可以为空的选项手工勾掉。

U8端科目辅助核算如勾选了部门核算

进入Yonsuite【会计科目】，找到对应的会计科目将“是否允许为空”选项去掉。

3.Yonsuite总账凭证模板凭证类型修改

Yonsuite凭证模板中的凭证类型需要人为检查并编辑一下要保证与U8凭证类型一致。

U8端“凭证类别”档案

Yonsuite端配置：进入Yonsuite【总账凭证模板】选择“编辑”，找到凭证类型字段，设置为U8中的凭证类别即可。

四.YonSuite总账凭证同步至U8

1.开通【友企联_YonBIP服务】

订阅数字化建模会默认开通友企连的基础功能，没有【集成方案】【启动方案】等功能节点，数字化建模->我的应用->应用市场->搜索友企连->进行开通，0元购买即可。

开通成功后按照下图的蓝框和红框节点进行配置即可。

2.【集成系统配置】

按3.1.4.2章节描述选择两种ERP连接中的一种，创建集成系统

集成系统编码示例：voucher_scheme_u8_999

集成系统名称示例：U8总账系统999账簿

关联连接：选择“组织编码”+“系统编码”名称的ERP连接器；

ERP连接器的组织编码指YS中的组织编码，系统编码指U8企业应用集成EAI中设置的对接账套的编码

3.【启动方案配置】

用于初始化U8集成方案。初始化成功后，会在【启动方案】、【集成方案配置】、【集成对象】、【数据同步任务】下，自动创建相关内容。

点击“初始化”按钮，

来源集成系统：当前YonBIP集成系统

目标集成系统：对接集成的U8系统999账套

方案列表：U8凭证下的“总账同步至U8总账方案”

4.【集成方案配置】

U8集成方案初始化成功后，自动建立相应配置，原则上不需要修改。但是当U8为多账套，需要进入此节点新增集成方案，详见后面第6点介绍。

5.【集成对象配置】

在【集成对象配置】->【当前YonBIP集成系统】->[result]-> [query]中为当前集成方案指定相应的Yonsuite账簿，该账簿下的Yonsuite总账凭证会通过ERP连接器同步至相应U8账簿。

选择【当前YonBIP集成系统】下，对[result]对象进行编辑操作。

查看[query]操作，将请求参数中"accbookCode"修改为当前集成方案对应的Yonsuite账簿code，Yonsuite账簿code可在【会计服务 > 财务公共 > 核算账簿 > 账簿设置】节点查询。

6.U8多账套的配置方法

（1）多账套的凭证集成同步任务，也是先要增加新账套的集成系统配置。注意集成系统名称的设定有所标注区分并选择正确的ERP连接器，用以区分不同账簿的集成方案。

（2）入口与第一次创建集成同步一致：【集成对象配置】-【当前YonBIP集成系统】-[result]

选择“新增”，只是不同的Yonsuite账簿需要建立不同的query

新增query参数说明请以YonSuite产品管理部编写的“YonSuite费控与U8集成操作指南202206”使用说明为准。

创建好集成对象需要再创建相应账簿的集成方案时，可通过复制初始化的集成方案来创建

a.【集成方案配置】界面找到初始化的集成方案；选择“复制”。

b.维护相应参数保存、确认即可

c.选择新创建的集成方案，点击“下一步”进入到其他设置，选择来源数据处理设置，选择对应的“集成对象”，提交即可。

7.数据同步任务

在【数据同步任务】可查看总账同步方案，可通过搜索启动集成方案编码或名称快速找到相应方案。

（1）通过【立即执行】或者【定时任务】可以进行触发【总账同步至u8总账】数据同步任务。

（2）通过【查看日志】查看最近一次同步任务的执行情况。

（3）同步失败时回将失败原因展示页面中，可选择“只显示错误日志”，方便排查问题。

报文可以通过U8开放平台接口的”API测试工具”转换的报文查看是否正确。U8开放平台地址：http://open.yonyouup.com/

转换后的XML格式报文可以在U8OpenApi 客户端查看。

8.YonSuite凭证同步到U8端

（1）YonSuite端友费控生成的凭证

传输到U8端的凭证，通过U8凭证列表查询到，并联查到对应凭证

（2）从YonSuite传输到U8的凭证，在凭证列表的“系统名”栏目会显示“友费控”字样。

通过列表双击进入到凭证界面，鼠标点击凭证头的凭证类别字样，还会显示YonSuite传输过来的凭证来源信息。

（3）凭证的制单日期、凭证类别、辅助等信息因为YonSuite和U8两边都保持一致了，所以基本上YonSuite的凭证信息是什么，传到U8的凭证信息就是什么。但是凭证号是不同的，YonSuite依据的是YonSuite的凭证号排序规则，传到U8的凭证依据的是U8的凭证号系统自然排序规则。

（4）YonSuite凭证传输到U8后，在U8端是允许作废传输过来的凭证的，但是YonSuite端对应的凭证状态不做任何改变，该凭证也不会再次传输到U8。但是如果YonSuite对该张凭证做了任何修改，则再次传输时，会在U8端追加一张新的凭证。

（5）YonSuite端已审核和已记账的凭证传输到U8端，在U8端不会打上审核人和记账人的标记，只标记制单人信息。

（6）如果U8端某个月份已结账，YonSuite端会有相关控制不能传输该月份的凭证。