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

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

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

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

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

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

計(jì)提XX月分賬收入2、電影放映收入

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

x月x日xx店?duì)I業(yè)款存行/x月x日xx店中行POS機(jī)收款借：預(yù)收賬款-電影放映/票券-消費(fèi)/團(tuán)購(gòu)-消費(fèi)/儲(chǔ)值卡-消費(fèi)/應(yīng)收賬款-電影放映√√

√

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

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

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

收入

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

x月x日xx店?duì)I業(yè)款存行/x月x日xx店中行POS機(jī)收款貸：主營(yíng)業(yè)務(wù)收入-賣品部收入√

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

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

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

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

確認(rèn)XX店XX月逾期收入5、餐飲

收入

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

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

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

通過獲取通用接口平臺(tái)的序列信息生成頭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)時(shí)間是日期20

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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