EAS凭证联查异构系统单据配置应用指南

一、业务背景介绍

用户使用异构系统的业务模块和EAS核算模块组合，或者将异构系统的凭证同步到EAS总账模块，如星瀚总账凭证→EAS总账凭证。

针对异构系统集成过来的凭证，财务人员往往需要对照查看异构系统单据，核对数据。为满足财务人员可直接在EAS联查到异构系统直接来源单据，提高数据核对效率和便利性，增加联查异构单据功能。

二、适用版本

三、产品相关说明

1. 联查配置表

   联查配置表，用来存异构系统服务器网址、应用代码和关键参数名；针对每一组单据集成关系需要维护一条记录，如异构系统星瀚凭证→EAS凭证，异构系统星瀚付款单→EAS凭证，这2组集成关系都需要分别维护一条对应的记录T_GL_LinkQueryConfig；

   联查配置表相关说明：需要根据异构系统的寻址访问说明进行配置，如来源系统为星瀚，则参考星瀚产品URL访问的相关说明https://vip.kingdee.com/link/s/laa2T ；

应用代码	异构系统服务器网址（案例数据）	参数名
cosmic@gl_voucher	https://ip:port/ierp/index.html?formId=gl_voucher	pkId
cosmic@fi_cas	https://ip:port /ierp/index.html?formId=fi_cas	pkId
eas@gl_voucher	https://ip:port /ierp/uipk=com.kingdee.eas.fi.gl.VoucherEditPage	billId

1) 应用代码-appCode：该属性有唯一索引约束，命名风格推荐 应用名@领域名_单据名

2) 异构系统服务器网址-externalUrl：URL寻址至特定单据页面的网址，排查掉唯一区分单据的入参名

3) 参数名paramKey：寻址可以唯一区分单据的入参名

示例：星瀚系统总账-凭证的列表详情单据url为

https://ip:port/ierp/index.html?formId=gl_voucher&pkId=xxxxxx1，

则externalUrl为https://ip:port/ierp/index.html?formId=gl_voucher，paramKey为pkId。

注意：需要在异构凭证同步前维护好联查配置表，否则凭证同步时会提示找不到配置信息；



2. 异构单据对照明细表

   1.异构单据对照明细表，用来存EAS单据ID和异构系统单据ID。目前EAS凭证接口支持自动写入相关信息。

   2.历史已存在的异构系统导入EAS的单据，如需使用异构单据联查功能，可手工在对照明细表中维护对应的记录。

   3.接口增加异构系统单据ID和异构系统应用代码参数，外部单据导入时需携带相关信息； {"externalId":"异构系统单据Id"}；公共参数 { "appCode": "异构系统应用代码"}；

   新添加的externalId和appCode为非必录字段：

• 当externalId为空时，不校验appCode； 

• 当externalId有值时，需要校验appCode， appCode为空或者不合法，在联查配置表中找不到对应记录，则提示“appCode值在联查配置表中找不到记录，请维护正确值”，凭证不允许导入。——因此需确保在导入业务数据前维护好联查配置表。

四、应用配置步骤

（一）配置步骤（星瀚凭证->EAS凭证）

1. 维护联查配置表

1. EAS已内置了一条总账凭证联查星瀚凭证的配置记录（APPCODE = 'cosmic@gl_voucher'），首先需要更新星瀚系统凭证单据列表指定记录详情页面的URL，更新语句如下：

1. update T_GL_LinkQueryConfig set FEXTERNALURL = 'https://test.com:1024/myCosmic/?formId=gl_voucher' where FAPPCODE = 'cosmic@gl_voucher'

2. 请参考https://vip.kingdee.com/li