通用接口平台应用

通用接口平台应用目录2一、通用接口平台概述二、通用接口平台实施方法三、通用接口平台功能介绍Q&A通用接口平台概述Ι3

通用接口平台的通用，就是多个外围系统、多种业务数据都可以通过通用接口平台，导入到EBS中。通用接口平台通常适用于以下的情况：1.前端业务系统较为专业、完善，EBS无法替代前端系统的功能；2.公司业务按照业态进行划分，每一种业态模式都会使用特有的业务系统，业务系统之间相互独立；3.纯财务项目，需要统一管理财务信息，将基础数据收集在EBS中，进行汇总。通用接口平台核心系统租赁系统财管系统明源系统共享系统EBS客户品牌凭证房产资料发票通用接口平台概述Ⅱ4在通用接口平台中，前端系统传送的数据信息均汇集在一张平台表中。通过不同的系统代码，可以对接口数据进行区分，并制定不同的导入规则、校验传送至EBS基表中。从而在通用接口平台中实现了，所有前端系统的数据流信息，均通过一张接口表，导入到EBS中。

前端系统在万达项目中使用最多的是WEBSERVICE的方式，但是也有DBLINK和ETL以及MDM（万达自有数据传送系统）的方式进行传送，后面3种连接方式，会在平台表的前端新建一张表来进行接收，并通过请求调用至统一的平台表，接入到通用接口平台中。运行程序继续校验调用标准API导入前端系统BEBS平台表EBS应用表EBS基表总控请求导入WEBSERVICE传送OracleEBS前端系统A前端系统…前端业务系统成功消息或者错误消息返回通用接口平台概述Ⅲ51.灵活可配置将所有的映射和转换显示在前台界面，前端传送的数据内容和映射转换的内容能够清楚明晰的进行展示，一旦出现问题，能够快速找到错误数据，定位问题。业务同事完全能够对接口传送的逻辑进行控制和设计，且测试较为方便。减少了技术同事的工作量，提高了程序上线效率。2.多接口项目，可形成接口规范数据、多接口、多前端系统的项目，可以根据已有同类型的接口，形成接口规范。能够对前端系统进行字段要求，形成项目的原则性的共识。一旦出现了错误，可以有步骤的进行检查。3.可扩展性强通用接口平台非常灵活，对于业务上新的需求，能够较快的添加新的字段，进行应对多变的业务类型。通用接口平台特点通用接口平台实施方法Ⅰ6流程梳理系统定位接口清单数据字典SOA7共享服务资金管理成本费用营收系统报告分析系统EBS财务核算系统应付管理模块总账管理模块资产模块通用接口平台资产租赁系统物业管理系统财务管理系统（在建）报账平台成本系统物业收费系统（在建）通用接口平台通用接口平台久其报表银行余额调节表NC资金经营指标系统全面预算系统营销企划系统财务管理系统（在建）鼎新POS系统未付申请暂估…通用接口平台发票付款报表供应商新增转移报废折旧凭证查询报表公司间2345678Ｅ-ＨＲB收款发票客户支付结果预付发票暂估供应商同步供应商新增支付下拨对账单核算部门余额发生额凭证9图示（接口说明见下页清单）：集成接口（双向）集成接口（单向）人工接口资产实物管理X增加转移报废等资产租赁系统待定XXXX融资管理人工录入凭证员工CXA资金计划管控X现金日记账明源系统1成本系统停车场系统营销费用系统全面预算系统营销企划系统10通用接口总览通用接口平台实施方法Ⅱ8院线收入接口方案通用接口平台实施方法Ⅲ院线业务系统系统ERP财务核算系统（ORACLE）基础数据客户信息账户组合：公司段（平衡段）、部门段、分店段、科目段、子目段、产品段、项目段数据接口A基础数据流1通用导入接口MDMMDM基础数据数据总账模块总账凭证界面查询报表查询数据接口2业务单据凭证数据业务信息流通用导入接口数据传输方式WEBSERVICEB写入标识通用接口平台实施方法Ⅳ9院线业态具体收入类别院线业务大类院线业务小类1、主营收入

电影分账收入电影放映收入卖品收入逾期收入餐饮收入2、其他收入广告收入自有媒体收入喷绘收入权益卡收入储值卡收入IMAX/RealD赞助费收入租赁收入冠名费收入影片返点奖励收入供应商返佣收入3、收款业务（预收）购买券/码/团购10通用接口平台实施方法Ⅴ业务大类院线业态对应分录示例辅助核算项目摘要院线影城门店客商发卡月到期月1、电影分账收入√√借：应收账款√√

计提XX月分账收入贷：主营业务收入-电影分账收入√

计提XX月分账收入2、电影放映收入

√借：其他货币资金-POS机刷卡资金/库存现金/银行存款-结算户-XXX账户

x月x日xx店营业款存行/x月x日xx店中行POS机收款借：预收账款-电影放映/票券-消费/团购-消费/储值卡-消费/应收账款-电影放映√√

√

贷：主营业务收入-电影放映收入√

x月x日xx店票房收入\数字影片/x月x日xx店票房收入—IMAX影片贷：应交税费-应交增值税-销项税额√

x月x日xx店票房收入\数字影片/x月x日xx店票房收入—IMAX影片3、卖品

收入

√借：其他货币资金-POS机刷卡资金/库存现金/银行存款-结算户-XXX账户

x月x日xx店营业款存行/x月x日xx店中行POS机收款贷：主营业务收入-卖品部收入√

x月x日xx店卖品收入贷：应交税费-应交增值税-销项税额√

x月x日xx店卖品收入4、逾期

收入√√借：预收账款-票券-转销/团购-转销√

√确认XX店XX月逾期收入贷：主营业务收入-逾期收入√

确认XX店XX月逾期收入5、餐饮

收入

√借：其他货币资金-POS机刷卡资金/库存现金/银行存款-结算户-XXX账户

x月x日xx店营业款存行/x月x日xx店中行POS机收款贷：主营业务收入-电影放映收入√

x月x日xx店餐饮收入11通用接口平台实施方法Ⅵ和前端系统沟通时，最重要的就是字段文档。和EBS的很多结构相同，接口也是采用了头和行的结构，需要提送头信息和行信息两个信息；在和前端系统提供文档之后，也需要及时进行沟通，和对方说明字段，避免日后更多的调整。接口头信息核心字段如下：序号字段编码名称说明是否必须类型长度小数位数默认值1HEADER_ID头ID一批数据生成一个头ID，头ID需要带在行信息上，用于校验；所有接口统一编码；

通过获取通用接口平台的序列信息生成头ID；是数字200

2LINE_COUNT行记录数量本次传送数据具体行数是数字100

3SYSTEM_CODE数据来源代码数据来源系统标志是字符30

4CTL_DATE数据导入日期来源系统将数据传入接口的系统时间是日期20

5STATUS状态默认为NEW（未处理）是字符10

NEW12通用接口平台实施方法Ⅶ序号字段编码字段名称字段说明是否必须类型长度小数位数默认值1HEADER_ID头ID一批数据生成一个头ID，头ID需要带在行信息上，用于校验；所有接口统一编码；

通过获取通用接口平台的序列信息生成头ID；是数字200

2SYSTEM_CODE数据来源代码数据来源系统标志是字符30

XMMY3VALUE1批号VALUE值可输入，外围系统批次号是数字200

4SEGMENT1凭证类别代码SEGMENT值只能值集选择是字符20

GENERAL5VALUE2行标识通过获取通用接口平台的统一序列信息生成行ID是数字1000

6SEGMENT3单据类型SEGMENT值只能值集选择，单据类型需界定好，每个单据类型在明源系统中维护是字符150

7VALUE3单据编号VALUE值可输入，外围系统单据编号是数字800

8VALUE4单据行号VALUE值可输入，外围系统单据行号是数字800

9VALUE5业务日期VALUE值可输入，报销单的业务日期是日期20

10VALUE6传送日期VALUE值可输入，报销单的记账日期是日期20

11SEGMENT7币种SEGMENT值只能值集选择是字符10

CNY12VALUE7汇率VALUE值可输入，外币时必输是数字206113SEGMENT8公司编码SEGMENT值只能值集选择是数字100

14VALUE8公司说明VALUE值可输入，对应公司名称是字符60

15SEGMENT9科目编码SEGMENT值只能值集选择是数字150

16VALUE9科目说明VALUE值可输入，对应科目名称是字符100

接口行信息核心字段（下表表黑字段）如下：EBS财务核算系统通用接口数据转换通用接口平台功能介绍Ⅰ13百货招商营运系统儿童油菜花系统百货富基融通POS……院线财管系统Oracle财务模块统一数据传送平台通用映射转换机构映射通用导入接口通用导出接口基础数据管理模块…客户&供应商员工权限应付模块总帐模块标准API调用应收模块资产模块现金模块科目映射业务映射产品映射银行映射……

123复制源数据列1、接口系统定义3、接口模板定义2、接口映射定义&维护1、来源系统生成指定格式的接口数据，通过统一的数据传送平台导入到通用接口导入接口表中；2、根据接口需求确定的来源系统数据与EBS数据的映射关系，在通用接口平台完成映射关系维护后，通用接口程序将接口数据进行映射转换，得到映射结果数据(即满足EBS系统核算要求的财务数据)；3、通用接口程序调用EBS标准API或者数据表插入，对映射结果数据以及其它方式(比如复制源接口数据、默认值)得到的EBS财务数据进行校验，将符合财务规则的数据导入到EBS系统各对应模块中生成相应的财务数据。通用接口数据转换模块通用接口平台功能介绍Ⅱ14系统定义1.系统代码：一个新的系统代码，可以简单认为是一个新的接口，直接决定平台表一直到基表的生成逻辑；2.类型：分为源数据列和映射数据列两个来源类型，源数据列直接接受从前端直接传送的数据，映射数据列根据前端传送的内容进行映射相应的数据；3.存储列：分为SEGMENT和VALUE两种字段，SEGMENT传送的值必须经过值集校验，而VALUE传送的值不进行校验直接接收；4.必输：前端传送的字段是否限制必输；5.长度：对前端系统传送的字段长度进行限制；6.启用：前端传送的字段是否正常接收并进行校验；7.可修改：如果勾选之后，可以在前台界面对传送的字段进行修改（该功能需谨慎使用）。必输可修改15分录：DR：应收账款_电影发行

CR：主营业务收入_电影发行收入结构：行标识记账日期制单人头标识COA10段借/贷方金额…行摘要行标识记账日期制单人COA10段借/贷方金额…行摘要来源代码…举例：院线业态通过财管系统中向OracleEBS推送收入凭证。通用接口平台功能介绍Ⅲ前台接口数据查看：通用接口平台功能介绍Ⅳ16映射定义1.字段类型：分为映射维和映射目标，映射维是由前端系统传送的字段，而映射目标是在EBS自动映射出的字段；2.映射表字段：前端传送的字段为SOURCE，而EBS自动生成的字段为TARGET；3.必需：限制前端系统传送的字段和映射字段是否可以为空。通用接口平台功能介绍Ⅴ17映射维护1.映射维护在系统定义冻结的情况下，仍然是可以进行编辑并保存的。不像修改其他内容，需要先进行系统定义的解冻，然后才能修改；2.映射维护必须维护完全，前端不能传送事先未讨论的值，一旦出现，系统就会报错；3.映射维护不能出现关系存在一对多的情况，即前端传送的同一个数值，只能有一种映射关系，不能维护多个关系。通用接口平台功能介绍Ⅵ18模板定义在模板定义中，可以为一个来源的系统代码，设置多种规则进行后续的导入到应用表中，可以导入到一个应用表中，也是可以导入到多个应用表中。例如：收入端日记账凭证一行生成多行凭证，应付端传送的发票分为发票行和计划付款行，基础数据传送的商户信息既生成客户信息，又生成供应商信息。XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX筛选组规则1规则1规则2规则3平台表应用表19分录：院线（总部）DR：预收账款_广告（外部客户）CR：其他应收款_内部公司往来_日常往来（影城A）CR：其他应收款_内部公司往来_日常往来（影城B）实现方法：影城ADR：其他应收款_内部公司往来_日常往来（院线总部）CR：应收账款_广告（外部客户）影城BDR：其他应收款_内部公司往来_日常往来（院线总部）CR：应收账款_广告（外部客户）行标识总部凭证借方行信息头标识行标识影城A借方COA10段…来源代码…总部凭证贷方行信息影城A贷方COA10段行标识影城B借方COA10段…总部凭证贷方行信息影城B贷方COA10段规则1：生成院线总部凭证规则2：生成影城借方凭证行规则3：生成影城贷方凭证行通用接口平台功能介绍Ⅶ举例：院线业态收入类凭证推送，院线总部代收客户广告费（预收总额），但是广告实际在各地影城放映，各地影城确认应收账款收入。院线收入之后，与各地影城进行往来结算。通用接口平台功能介绍Ⅷ20规则定义1.导出列名：应用表中的字段名称，一般根据基表的字段来进行定义；2.类型：包括源数据列、常数、映射列、配置文件；3.来源列名称/值：来源列、映射列的名称或者常数值；4.符号：一般是在平台表数据类型为数值类型的需要进行定义。通用接口平台功能介绍Ⅸ21值集附加值集附加的功能类似于映射转换，但是值集附加是直接存储在表验证值集中，并不在前台进行显示，适用于数据量较大的转换。例如：通过前端系统传送的供应商编码和供应商类型映射EBS的供应商编码；通过前端的客户名称映射关联方段值；通过公司段和子目段映射客户编码……值集附加这个功能，虽然一个源头对应多个映射的情况不会报错，但是在逻辑上也是有问题的，和映射功能一致，逻辑上不能出现一对多的关系。源头字段目标字段通用接口平台功能介绍Ⅹ22内部测试生成WEBADI模板模拟数据EXCEL导入后续测试1.生成WEBADI模板在通用接口平台中，设置完成之后，通常要使用“CUX_自动生成通用接口桌面集成”请求来生成WEBADI的模板，放在菜单中，进行下载。WEBADI的模板会根据模板定义的接口表进行生成。2.模拟数据EXCEL导入

在这个过程中，业务顾问会根据与前端系统的讨论模拟前端系统发送的数据，在EXCEL中进行数据初步的填写。3.后续测试

WEBADI会根据导入的数据自动生成HEADER_ID和LINE_ID，业务顾问可以进行总控导入和后续操作来进行检验表