通用接口平臺應(yīng)用

通用接口平臺應(yīng)用目錄2一、通用接口平臺概述二、通用接口平臺實施方法三、通用接口平臺功能介紹Q&A通用接口平臺概述Ι3

通用接口平臺的通用，就是多個外圍系統(tǒng)、多種業(yè)務(wù)數(shù)據(jù)都可以通過通用接口平臺，導(dǎo)入到EBS中。通用接口平臺通常適用于以下的情況：1.前端業(yè)務(wù)系統(tǒng)較為專業(yè)、完善，EBS無法替代前端系統(tǒng)的功能；2.公司業(yè)務(wù)按照業(yè)態(tài)進行劃分，每一種業(yè)態(tài)模式都會使用特有的業(yè)務(wù)系統(tǒng)，業(yè)務(wù)系統(tǒng)之間相互獨立；3.純財務(wù)項目，需要統(tǒng)一管理財務(wù)信息，將基礎(chǔ)數(shù)據(jù)收集在EBS中，進行匯總。通用接口平臺核心系統(tǒng)租賃系統(tǒng)財管系統(tǒng)明源系統(tǒng)共享系統(tǒng)EBS客戶品牌憑證房產(chǎn)資料發(fā)票通用接口平臺概述Ⅱ4在通用接口平臺中，前端系統(tǒng)傳送的數(shù)據(jù)信息均匯集在一張平臺表中。通過不同的系統(tǒng)代碼，可以對接口數(shù)據(jù)進行區(qū)分，并制定不同的導(dǎo)入規(guī)則、校驗傳送至EBS基表中。從而在通用接口平臺中實現(xiàn)了，所有前端系統(tǒng)的數(shù)據(jù)流信息，均通過一張接口表，導(dǎo)入到EBS中。

前端系統(tǒng)在萬達項目中使用最多的是WEBSERVICE的方式，但是也有DBLINK和ETL以及MDM（萬達自有數(shù)據(jù)傳送系統(tǒng)）的方式進行傳送，后面3種連接方式，會在平臺表的前端新建一張表來進行接收，并通過請求調(diào)用至統(tǒng)一的平臺表，接入到通用接口平臺中。運行程序繼續(xù)校驗調(diào)用標(biāo)準(zhǔn)API導(dǎo)入前端系統(tǒng)BEBS平臺表EBS應(yīng)用表EBS基表總控請求導(dǎo)入WEBSERVICE傳送OracleEBS前端系統(tǒng)A前端系統(tǒng)…前端業(yè)務(wù)系統(tǒng)成功消息或者錯誤消息返回通用接口平臺概述Ⅲ51.靈活可配置將所有的映射和轉(zhuǎn)換顯示在前臺界面，前端傳送的數(shù)據(jù)內(nèi)容和映射轉(zhuǎn)換的內(nèi)容能夠清楚明晰的進行展示，一旦出現(xiàn)問題，能夠快速找到錯誤數(shù)據(jù)，定位問題。業(yè)務(wù)同事完全能夠?qū)涌趥魉偷倪壿嬤M行控制和設(shè)計，且測試較為方便。減少了技術(shù)同事的工作量，提高了程序上線效率。2.多接口項目，可形成接口規(guī)范數(shù)據(jù)、多接口、多前端系統(tǒng)的項目，可以根據(jù)已有同類型的接口，形成接口規(guī)范。能夠?qū)η岸讼到y(tǒng)進行字段要求，形成項目的原則性的共識。一旦出現(xiàn)了錯誤，可以有步驟的進行檢查。3.可擴展性強通用接口平臺非常靈活，對于業(yè)務(wù)上新的需求，能夠較快的添加新的字段，進行應(yīng)對多變的業(yè)務(wù)類型。通用接口平臺特點通用接口平臺實施方法Ⅰ6流程梳理系統(tǒng)定位接口清單數(shù)據(jù)字典SOA7共享服務(wù)資金管理成本費用營收系統(tǒng)報告分析系統(tǒng)EBS財務(wù)核算系統(tǒng)應(yīng)付管理模塊總賬管理模塊資產(chǎn)模塊通用接口平臺資產(chǎn)租賃系統(tǒng)物業(yè)管理系統(tǒng)財務(wù)管理系統(tǒng)（在建）報賬平臺成本系統(tǒng)物業(yè)收費系統(tǒng)（在建）通用接口平臺通用接口平臺久其報表銀行余額調(diào)節(jié)表NC資金經(jīng)營指標(biāo)系統(tǒng)全面預(yù)算系統(tǒng)營銷企劃系統(tǒng)財務(wù)管理系統(tǒng)（在建）鼎新POS系統(tǒng)未付申請暫估…通用接口平臺發(fā)票付款報表供應(yīng)商新增轉(zhuǎn)移報廢折舊憑證查詢報表公司間2345678Ｅ-ＨＲB收款發(fā)票客戶支付結(jié)果預(yù)付發(fā)票暫估供應(yīng)商同步供應(yīng)商新增支付下?lián)軐~單核算部門余額發(fā)生額憑證9圖示（接口說明見下頁清單）：集成接口（雙向）集成接口（單向）人工接口資產(chǎn)實物管理X增加轉(zhuǎn)移報廢等資產(chǎn)租賃系統(tǒng)待定XXXX融資管理人工錄入憑證員工CXA資金計劃管控X現(xiàn)金日記賬明源系統(tǒng)1成本系統(tǒng)停車場系統(tǒng)營銷費用系統(tǒng)全面預(yù)算系統(tǒng)營銷企劃系統(tǒng)10通用接口總覽通用接口平臺實施方法Ⅱ8院線收入接口方案通用接口平臺實施方法Ⅲ院線業(yè)務(wù)系統(tǒng)系統(tǒng)ERP財務(wù)核算系統(tǒng)（ORACLE）基礎(chǔ)數(shù)據(jù)客戶信息賬戶組合：公司段（平衡段）、部門段、分店段、科目段、子目段、產(chǎn)品段、項目段數(shù)據(jù)接口A基礎(chǔ)數(shù)據(jù)流1通用導(dǎo)入接口MDMMDM基礎(chǔ)數(shù)據(jù)數(shù)據(jù)總賬模塊總賬憑證界面查詢報表查詢數(shù)據(jù)接口2業(yè)務(wù)單據(jù)憑證數(shù)據(jù)業(yè)務(wù)信息流通用導(dǎo)入接口數(shù)據(jù)傳輸方式WEBSERVICEB寫入標(biāo)識通用接口平臺實施方法Ⅳ9院線業(yè)態(tài)具體收入類別院線業(yè)務(wù)大類院線業(yè)務(wù)小類1、主營收入

電影分賬收入電影放映收入賣品收入逾期收入餐飲收入2、其他收入廣告收入自有媒體收入噴繪收入權(quán)益卡收入儲值卡收入IMAX/RealD贊助費收入租賃收入冠名費收入影片返點獎勵收入供應(yīng)商返傭收入3、收款業(yè)務(wù)（預(yù)收）購買券/碼/團購10通用接口平臺實施方法Ⅴ業(yè)務(wù)大類院線業(yè)態(tài)對應(yīng)分錄示例輔助核算項目摘要院線影城門店客商發(fā)卡月到期月1、電影分賬收入√√借：應(yīng)收賬款√√

計提XX月分賬收入貸：主營業(yè)務(wù)收入-電影分賬收入√

計提XX月分賬收入2、電影放映收入

√借：其他貨幣資金-POS機刷卡資金/庫存現(xiàn)金/銀行存款-結(jié)算戶-XXX賬戶

x月x日xx店營業(yè)款存行/x月x日xx店中行POS機收款借：預(yù)收賬款-電影放映/票券-消費/團購-消費/儲值卡-消費/應(yīng)收賬款-電影放映√√

√

貸：主營業(yè)務(wù)收入-電影放映收入√

x月x日xx店票房收入\數(shù)字影片/x月x日xx店票房收入—IMAX影片貸：應(yīng)交稅費-應(yīng)交增值稅-銷項稅額√

x月x日xx店票房收入\數(shù)字影片/x月x日xx店票房收入—IMAX影片3、賣品

收入

√借：其他貨幣資金-POS機刷卡資金/庫存現(xiàn)金/銀行存款-結(jié)算戶-XXX賬戶

x月x日xx店營業(yè)款存行/x月x日xx店中行POS機收款貸：主營業(yè)務(wù)收入-賣品部收入√

x月x日xx店賣品收入貸：應(yīng)交稅費-應(yīng)交增值稅-銷項稅額√

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

收入√√借：預(yù)收賬款-票券-轉(zhuǎn)銷/團購-轉(zhuǎn)銷√

√確認XX店XX月逾期收入貸：主營業(yè)務(wù)收入-逾期收入√

確認XX店XX月逾期收入5、餐飲

收入

√借：其他貨幣資金-POS機刷卡資金/庫存現(xiàn)金/銀行存款-結(jié)算戶-XXX賬戶

x月x日xx店營業(yè)款存行/x月x日xx店中行POS機收款貸：主營業(yè)務(wù)收入-電影放映收入√

x月x日xx店餐飲收入11通用接口平臺實施方法Ⅵ和前端系統(tǒng)溝通時，最重要的就是字段文檔。和EBS的很多結(jié)構(gòu)相同，接口也是采用了頭和行的結(jié)構(gòu)，需要提送頭信息和行信息兩個信息；在和前端系統(tǒng)提供文檔之后，也需要及時進行溝通，和對方說明字段，避免日后更多的調(diào)整。接口頭信息核心字段如下：序號字段編碼名稱說明是否必須類型長度小數(shù)位數(shù)默認值1HEADER_ID頭ID一批數(shù)據(jù)生成一個頭ID，頭ID需要帶在行信息上，用于校驗；所有接口統(tǒng)一編碼；

通過獲取通用接口平臺的序列信息生成頭ID；是數(shù)字200

2LINE_COUNT行記錄數(shù)量本次傳送數(shù)據(jù)具體行數(shù)是數(shù)字100

3SYSTEM_CODE數(shù)據(jù)來源代碼數(shù)據(jù)來源系統(tǒng)標(biāo)志是字符30

4CTL_DATE數(shù)據(jù)導(dǎo)入日期來源系統(tǒng)將數(shù)據(jù)傳入接口的系統(tǒng)時間是日期20

5STATUS狀態(tài)默認為NEW（未處理）是字符10

NEW12通用接口平臺實施方法Ⅶ序號字段編碼字段名稱字段說明是否必須類型長度小數(shù)位數(shù)默認值1HEADER_ID頭ID一批數(shù)據(jù)生成一個頭ID，頭ID需要帶在行信息上，用于校驗；所有接口統(tǒng)一編碼；

通過獲取通用接口平臺的序列信息生成頭ID；是數(shù)字200

2SYSTEM_CODE數(shù)據(jù)來源代碼數(shù)據(jù)來源系統(tǒng)標(biāo)志是字符30

XMMY3VALUE1批號VALUE值可輸入，外圍系統(tǒng)批次號是數(shù)字200

4SEGMENT1憑證類別代碼SEGMENT值只能值集選擇是字符20

GENERAL5VALUE2行標(biāo)識通過獲取通用接口平臺的統(tǒng)一序列信息生成行ID是數(shù)字1000

6SEGMENT3單據(jù)類型SEGMENT值只能值集選擇，單據(jù)類型需界定好，每個單據(jù)類型在明源系統(tǒng)中維護是字符150

7VALUE3單據(jù)編號VALUE值可輸入，外圍系統(tǒng)單據(jù)編號是數(shù)字800

8VALUE4單據(jù)行號VALUE值可輸入，外圍系統(tǒng)單據(jù)行號是數(shù)字800

9VALUE5業(yè)務(wù)日期VALUE值可輸入，報銷單的業(yè)務(wù)日期是日期20

10VALUE6傳送日期VALUE值可輸入，報銷單的記賬日期是日期20

11SEGMENT7幣種SEGMENT值只能值集選擇是字符10

CNY12VALUE7匯率VALUE值可輸入，外幣時必輸是數(shù)字206113SEGMENT8公司編碼SEGMENT值只能值集選擇是數(shù)字100

14VALUE8公司說明VALUE值可輸入，對應(yīng)公司名稱是字符60

15SEGMENT9科目編碼SEGMENT值只能值集選擇是數(shù)字150

16VALUE9科目說明VALUE值可輸入，對應(yīng)科目名稱是字符100

接口行信息核心字段（下表表黑字段）如下：EBS財務(wù)核算系統(tǒng)通用接口數(shù)據(jù)轉(zhuǎn)換通用接口平臺功能介紹Ⅰ13百貨招商營運系統(tǒng)兒童油菜花系統(tǒng)百貨富基融通POS……院線財管系統(tǒng)Oracle財務(wù)模塊統(tǒng)一數(shù)據(jù)傳送平臺通用映射轉(zhuǎn)換機構(gòu)映射通用導(dǎo)入接口通用導(dǎo)出接口基礎(chǔ)數(shù)據(jù)管理模塊…客戶&供應(yīng)商員工權(quán)限應(yīng)付模塊總帳模塊標(biāo)準(zhǔn)API調(diào)用應(yīng)收模塊資產(chǎn)模塊現(xiàn)金模塊科目映射業(yè)務(wù)映射產(chǎn)品映射銀行映射……

123復(fù)制源數(shù)據(jù)列1、接口系統(tǒng)定義3、接口模板定義2、接口映射定義&維護1、來源系統(tǒng)生成指定格式的接口數(shù)據(jù)，通過統(tǒng)一的數(shù)據(jù)傳送平臺導(dǎo)入到通用接口導(dǎo)入接口表中；2、根據(jù)接口需求確定的來源系統(tǒng)數(shù)據(jù)與EBS數(shù)據(jù)的映射關(guān)系，在通用接口平臺完成映射關(guān)系維護后，通用接口程序?qū)⒔涌跀?shù)據(jù)進行映射轉(zhuǎn)換，得到映射結(jié)果數(shù)據(jù)(即滿足EBS系統(tǒng)核算要求的財務(wù)數(shù)據(jù))；3、通用接口程序調(diào)用EBS標(biāo)準(zhǔn)API或者數(shù)據(jù)表插入，對映射結(jié)果數(shù)據(jù)以及其它方式(比如復(fù)制源接口數(shù)據(jù)、默認值)得到的EBS財務(wù)數(shù)據(jù)進行校驗，將符合財務(wù)規(guī)則的數(shù)據(jù)導(dǎo)入到EBS系統(tǒng)各對應(yīng)模塊中生成相應(yīng)的財務(wù)數(shù)據(jù)。通用接口數(shù)據(jù)轉(zhuǎn)換模塊通用接口平臺功能介紹Ⅱ14系統(tǒng)定義1.系統(tǒng)代碼：一個新的系統(tǒng)代碼，可以簡單認為是一個新的接口，直接決定平臺表一直到基表的生成邏輯；2.類型：分為源數(shù)據(jù)列和映射數(shù)據(jù)列兩個來源類型，源數(shù)據(jù)列直接接受從前端直接傳送的數(shù)據(jù)，映射數(shù)據(jù)列根據(jù)前端傳送的內(nèi)容進行映射相應(yīng)的數(shù)據(jù)；3.存儲列：分為SEGMENT和VALUE兩種字段，SEGMENT傳送的值必須經(jīng)過值集校驗，而VALUE傳送的值不進行校驗直接接收；4.必輸：前端傳送的字段是否限制必輸；5.長度：對前端系統(tǒng)傳送的字段長度進行限制；6.啟用：前端傳送的字段是否正常接收并進行校驗；7.可修改：如果勾選之后，可以在前臺界面對傳送的字段進行修改（該功能需謹(jǐn)慎使用）。必輸可修改15分錄：DR：應(yīng)收賬款_電影發(fā)行

CR：主營業(yè)務(wù)收入_電影發(fā)行收入結(jié)構(gòu)：行標(biāo)識記賬日期制單人頭標(biāo)識COA10段借/貸方金額…行摘要行標(biāo)識記賬日期制單人COA10段借/貸方金額…行摘要來源代碼…舉例：院線業(yè)態(tài)通過財管系統(tǒng)中向OracleEBS推送收入憑證。通用接口平臺功能介紹Ⅲ前臺接口數(shù)據(jù)查看：通用接口平臺功能介紹Ⅳ16映射定義1.字段類型：分為映射維和映射目標(biāo)，映射維是由前端系統(tǒng)傳送的字段，而映射目標(biāo)是在EBS自動映射出的字段；2.映射表字段：前端傳送的字段為SOURCE，而EBS自動生成的字段為TARGET；3.必需：限制前端系統(tǒng)傳送的字段和映射字段是否可以為空。通用接口平臺功能介紹Ⅴ17映射維護1.映射維護在系統(tǒng)定義凍結(jié)的情況下，仍然是可以進行編輯并保存的。不像修改其他內(nèi)容，需要先進行系統(tǒng)定義的解凍，然后才能修改；2.映射維護必須維護完全，前端不能傳送事先未討論的值，一旦出現(xiàn)，系統(tǒng)就會報錯；3.映射維護不能出現(xiàn)關(guān)系存在一對多的情況，即前端傳送的同一個數(shù)值，只能有一種映射關(guān)系，不能維護多個關(guān)系。通用接口平臺功能介紹Ⅵ18模板定義在模板定義中，可以為一個來源的系統(tǒng)代碼，設(shè)置多種規(guī)則進行后續(xù)的導(dǎo)入到應(yīng)用表中，可以導(dǎo)入到一個應(yīng)用表中，也是可以導(dǎo)入到多個應(yīng)用表中。例如：收入端日記賬憑證一行生成多行憑證，應(yīng)付端傳送的發(fā)票分為發(fā)票行和計劃付款行，基礎(chǔ)數(shù)據(jù)傳送的商戶信息既生成客戶信息，又生成供應(yīng)商信息。XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX篩選組規(guī)則1規(guī)則1規(guī)則2規(guī)則3平臺表應(yīng)用表19分錄：院線（總部）DR：預(yù)收賬款_廣告（外部客戶）CR：其他應(yīng)收款_內(nèi)部公司往來_日常往來（影城A）CR：其他應(yīng)收款_內(nèi)部公司往來_日常往來（影城B）實現(xiàn)方法：影城ADR：其他應(yīng)收款_內(nèi)部公司往來_日常往來（院線總部）CR：應(yīng)收賬款_廣告（外部客戶）影城BDR：其他應(yīng)收款_內(nèi)部公司往來_日常往來（院線總部）CR：應(yīng)收賬款_廣告（外部客戶）行標(biāo)識總部憑證借方行信息頭標(biāo)識行標(biāo)識影城A借方COA10段…來源代碼…總部憑證貸方行信息影城A貸方COA10段行標(biāo)識影城B借方COA10段…總部憑證貸方行信息影城B貸方COA10段規(guī)則1：生成院線總部憑證規(guī)則2：生成影城借方憑證行規(guī)則3：生成影城貸方憑證行通用接口平臺功能介紹Ⅶ舉例：院線業(yè)態(tài)收入類憑證推送，院線總部代收客戶廣告費（預(yù)收總額），但是廣告實際在各地影城放映，各地影城確認應(yīng)收賬款收入。院線收入之后，與各地影城進行往來結(jié)算。通用接口平臺功能介紹Ⅷ20規(guī)則定義1.導(dǎo)出列名：應(yīng)用表中的字段名稱，一般根據(jù)基表的字段來進行定義；2.類型：包括源數(shù)據(jù)列、常數(shù)、映射列、配置文件；3.來源列名稱/值：來源列、映射列的名稱或者常數(shù)值；4.符號：一般是在平臺表數(shù)據(jù)類型為數(shù)值類型的需要進行定義。通用接口平臺功能介紹Ⅸ21值集附加值集附加的功能類似于映射轉(zhuǎn)換，但是值集附加是直接存儲在表驗證值集中，并不在前臺進行顯示，適用于數(shù)據(jù)量較大的轉(zhuǎn)換。例如：通過前端系統(tǒng)傳送的供應(yīng)商編碼和供應(yīng)商類型映射EBS的供應(yīng)商編碼；通過前端的客戶名稱映射關(guān)聯(lián)方段值；通過公司段和子目段映射客戶編碼……值集附加這個功能，雖然一個源頭對應(yīng)多個映射的情況不會報錯，但是在邏輯上也是有問題的，和映射功能一致，邏輯上不能出現(xiàn)一對多的關(guān)系。源頭字段目標(biāo)字段通用接口平臺功能介紹Ⅹ22內(nèi)部測試生成WEBADI模板模擬數(shù)據(jù)EXCEL導(dǎo)入后續(xù)測試1.生成WEBADI模板在通用接口平臺中，設(shè)置完成之后，通常要使用“CUX_自動生成通用接口桌面集成”請求來生成WEBADI的模板，放在菜單中，進行下載。WEBADI的模板會根據(jù)模板定義的接口表進行生成。2.模擬數(shù)據(jù)EXCEL導(dǎo)入

在這個過程中，業(yè)務(wù)顧問會根據(jù)與前端系統(tǒng)的討論模擬前端系統(tǒng)發(fā)送的數(shù)據(jù)，在EXCEL中進行數(shù)據(jù)初步的填寫。3.后續(xù)測試

WEBADI會根據(jù)導(dǎo)入的數(shù)據(jù)自動生成HEADER_ID和LINE_ID，業(yè)務(wù)顧問可以進行總控導(dǎo)入和后續(xù)操作來進行檢驗表