EAS历史单据集成星瀚说明文档本文档对EAS费用历史单据集成星瀚流程进行说明，目前仅支持费用报销单、差旅报销单、对公费用报销单、出差借款单、借款单、出差申请单、费用申请单集成。集成方向：EAS单据——>星瀚单据1.EAS环境说明目前8.5以上版本才支持，需要更新引擎模块的补丁，各版本补丁如下：EAS8.5PT172446(2023-12-08)EAS8.6.1PT172447(2023-12-15)EAS8.8暂不支持EAS9.0发版包支持2.单据集成说明1.集成单据范围目前支持以下满足条件的单据集成如果用户有个性化需求，需要修改集成单据的范围，经过充分评估后，也可以调整集成方案的过滤范围。标准是在单据集成方案中，通过方案脚本约束集成单据范围的，如下图所示。1.所以如果是缩小范围，可以修改脚本；也可以在集成方案中设置字段过滤，比如要进一步只同步某申请人公司的单，可以设置该字段的过滤条件如下图所示2.如果是要扩大范围，需要修改脚本。但该情况要充分评估是否存在风险。因为扩大范围后，可能集成方案中有些字段配置已经不适用了，需要重新配置处理，比如可用、已用金额，冲销金额，已付、未付金额等字段的赋值。标准集成方案脚本加申请公司过滤条件。2.集成说明预置方案单据只支持新增同步，不支持更新同步。若单据已同步到星瀚，则下次再次同步时，星瀚已存在的单据不会再次同步。这是为了避免同步到星瀚的未关闭的单据，继续业务后有发生改变，若再次触发了EAS同步，会覆盖掉星瀚发生改变的这些单据问题。若需再次同步单据，可以采用这些方式：（1）将星瀚单据删除再同步；（2）若能确定已同步到星瀚的单据没有发生变化，可以覆盖同步。可以修改集成方案里的同步方式，覆盖同步，如下：3.集成支持与不支持功能说明（1）支持单头、分录、冲申请、冲借款、收款分录、发票分录集成、不支持付款明细分录（2）星瀚支持费用单据间上下查，单据同步后可提单到星瀚基础系统服务部。（3）支持发票分录同步，并在星瀚通过查看发票按钮查看发票（发票云系统要为AWS）。需要用支持查看发票的集成方案同步，具体可参考章节3的说明（4）不支持影像同步、查看影像。如果需要支持，需要找星瀚共享模块沟通，同步一些影像信息。（5）不支持与预算集成4.集成方案中的值转换规则说明人工映射的数据：币别、支付方式。引入方案后，需根据现场客户环境进行修改映射的数据，手工维护数据。sql编码映射：公司、部门、成本中心、人员、开户银行、费用类型、项目。引入方案后，需保证以上字段的星瀚和EAS编码一致，不需要修改值转换规则。枚举映射：发票查验状态、换算方式、收款人类型、单据状态、交通工具。不需要修改值转换规则。名称映射：出发地\目的地。引入方案后，需保证星瀚和EAS的名称一致。不需要修改值转换规则。如客户现场环境无法使用以上默认值转换规则，需要现场二开对应的值转换规则进行数据映射。Id字段：id字段都是取的EAS中间表中生成的星瀚系统的id，如单据id、各分录id、冲申请、冲借款分录源单id、源单分录id等3.集成预置方案（1）预置-出差借款单(单头收款人)_历史单据同步(EAS-苍穹)：出差借款单没有收款信息分录，只有单头收款信息时，使用该方案同步，同步的是单头的收款信息字段。（2）预置-出差借款单(多收款分录)_历史单据同步(EAS-苍穹)：出差借款单有收款信息分录时，使用该方案同步，同步的是收款信息分录的数据，单头的收款信息不会同步到星瀚。（3）预置_费用报销单(支持查看发票)_历史单据同步(EAS-苍穹)：支持在星瀚查看发票，若有该需求，用该方案同步。实际该方案增加了以下几个字段的配置，若星瀚没有这些字段需要联系星瀚费用模块添加。其他报销单要支持查看发票也可以参考该方案增加这些字段配置（4）预置_差旅费报销单(表格)_历史单据同步(EAS-苍穹)：如果星瀚差旅单使用的是表格模式，则使用此方案同步。（5）预置_差旅费报销单(卡片)_历史单据同步(EAS-苍穹)：如果星瀚差旅单使用的是卡片模式，则使用此方案同步。4.集成操作流程4.1集成流程图4.2GUI端添加单据迁移菜单如果是打过补丁了，那该菜单已存在，忽略该节。以管理员身份登录客户端，点击系统--->客户化菜单编辑在客户化菜单下，选择集成管理--->单据集成，点击新增创建单据迁移菜单填写信息，最后点击保存名称：单据迁移编码：EIP202520UI对象：com.kingdee.eas.base.botp.client.BillSyncResourceUI打开方式：模式对话框简码：EIPEASDJQY1、登录客户端，在集成管理--->EASCloud+EASCloud--->单据集成--->单据迁移4.3GUI端执行单据迁移1、选择需要同步的单据，以费用报销单为例3、同步完成后，同步的单据和分录都会保存到T_BOT_BILLSYNC表中（此表中存储EAS所有模块的中间单据，不是只有费用单据），字段分别为FBOSTYPE（单据bostype）、FSRCOBJECTID（单据id）、FBILLID（星瀚自增id）；表中的星瀚id（FBILLID）为EAS生成的默认自增id，不是从星瀚系统获取的。4、同步的单头关联关系会保存到T_BOT_RELATIONSYNC表中，字段分别为FRELATIONID（单据关联关系id）、FSRCOBJECTID（源单id）、FDESTOBJECTID（目标单id）、FSRCBILLID（源单星瀚自增id）、FDESTBILLID（目标单星瀚自增id）；5、单据表中也会新增一个CFSYNCBILLID的字段，即：星瀚id6、同步的分录关联关系会保存到T_BOT_RELATIONENTRYSYNC表中，字段分别为FRELATIONID（单据分录关联关系id）、FSRCOBJECTID（源单id）、FDESTOBJECTID（目标单id）、FSRCBILLID（源单星瀚id）、FDESTBILLID（目标单星瀚id）、FSRCENTRYID（源单分录id）、FDESTENTRYID（目标单分录id）、FSRCBILLENTRYID（星瀚源单分录id）、FDESTBILLENTRYID（星瀚目标单分录id）；字段FSRCBILLID、FDESTBILLID、FSRCBILLENTRYID、FDESTBILLENTRYID是关联表T_BOT_BILLSYNC获取的。7、同步完成之后会提示同步结束EAS端单据同步至中间表操作结束，完成将EAS所选择的费用单据id、单据关联关系存储到中间表。用于后续执行集成方案时，从中间表中获取或处理一些数据，如单据id，各分录id，冲申请分录里的源单id，源单分录id等。也用于后续同步单据的BOPT关系，便于在星瀚上下查单据。4.4导入（EAS-苍穹）集成方案登录苍穹集成平台，引入本文档开头提供的星瀚预置集成测试方案。以下以费用报销单的集成方案为例，打开苍穹集成平台的数据集成方案。导入预置的方案，然后解析方案启动方案立即执行，执行完成后可以查看执行结果或日志。批量同步时，若某张单据同步失败，是会忽略的，在日志中可以看到失败数量。若全部执行成功，没有失败数，则同步完成了
