SAP 銀行接口實例

曹曉明

摘要：文章舉例說明了SAP銀行接口的3種方案：網(wǎng)上銀行上傳、EDI發(fā)送以及銀企直連，詳細(xì)描述了3種方案的具體實現(xiàn)方法以及操作步驟，指出了各方案之間的異同和各自的優(yōu)缺點。

關(guān)鍵詞：SAP; 銀行接口

中圖分類號：TP391? ? ? 文獻(xiàn)標(biāo)識碼：A

文章編號：1009-3044（2021）09-0239-04

開放科學(xué)（資源服務(wù)）標(biāo)識碼（OSID）：

Examples of SAP Bank Interfaces

CAO Xiao-ming

（Thermofisher （Shanghai） Management Co.， Ltd， Shanghai 201206，China）

Abstract：It explains 3 solutions to implement bank interfaces in SAP through examples – payment medium files， EDI connection and EPIC （Electronic Bank Interface for China）. Then， it describes implementation settings and configuration step by step， and it describe operation steps as well. And finally it compared the 3 solutions and their pros and cons.

Key words：SAP; bank interface

1 SAP 銀行接口實例 （一） ——以批量上傳方式將付款請求從SAP傳送至銀行

SAP是世界領(lǐng)先的ERP軟件，隨著企業(yè)規(guī)模的發(fā)展壯大，國內(nèi)越來越多的企業(yè)實施了SAP。在實施過程中，一個常見的需求就是與銀行的接口。SAP與銀行的接口包括兩個方面：從SAP發(fā)送到銀行的付款請求，和從銀行返回的交易明細(xì)（SAP中稱為對賬單bank statement）。

從SAP發(fā)送到銀行的付款請求，其實現(xiàn)方法主要有3種：

1）在SAP上生成付款請求文件，客戶將該付款文件上傳到銀行的專用軟件或網(wǎng)上銀行;

2）從SAP中將付款請求以EDI方式發(fā)送給銀行;

3）最新的SAP版本提供了一個新的功能模塊EPIC（Electronic Payment Integration for China 中國電子付款集成，在中國也稱之為銀企直連），該模塊提供了跟銀行接口的一個集成界面。

我們從最簡單的入手，本篇講述了從SAP發(fā)送付款請求到銀行的第一種情況，即在SAP上生成付款請求文件，再將該付款文件上傳到銀行的專用軟件或網(wǎng)上銀行。我們將在以后的篇幅里討論從SAP發(fā)送付款請求到銀行的其他情況。

1.1 實例

以中國銀行為例。中國銀行的網(wǎng)上銀行提供了上傳批量付款文件的界面：

但是卻沒有提供該文件的規(guī)范或詳細(xì)說明書。不過，中國銀行提供了批量工具小程序，可以在同一上傳頁面下載。該工具提供了對公匯款、對私匯款、跨境匯款和境內(nèi)外幣匯款四種格式。具體文件格式可以通過工具的幫助文件得到。需要注意的是，該工具導(dǎo)入文件的格式和此工具生成的可以上傳到網(wǎng)上銀行的文件格式是不同的。導(dǎo)入文件可以是txt、csv、xls等，其字段/列的次序跟屏幕顯示一致。

而它生成的文件雖然也是txt文件，但有特定的格式。具體來說，該文件分成三部分-文件頭、付款明細(xì)行、文件尾。 文件頭和文件尾都只有一行，付款明細(xì)行可以有多行，分別對應(yīng)每一條付款?？梢酝ㄟ^批量工具導(dǎo)出來得到具體的文件格式。需要注意的是付款明細(xì)部分的字段順序和批量工具中的順序也是不同的。這個文件才是我們需要在SAP中生成的、可以直接上傳到網(wǎng)上銀行的格式。

1.2 后臺配置

要在SAP中生成可以上傳到中國銀行網(wǎng)上銀行的文件，需要在SAP中做一系列的設(shè)置。

1.2.1定義付款文件格式

SAP沒有提供現(xiàn)成的中國銀行文件格式。我們需要在DMEE（Data Medium Exchange Engine數(shù)據(jù)介質(zhì)交換引擎）中自己定義。由于各付款方式的文件格式不同，我們需要定義3個格式樹（對公匯款和對私匯款格式相同，合并為一個格式樹）。

在DMEE中定義一個PAYM類型的格式樹（交易碼：DMEE）。

格式樹以樹形表示文件格式，下面將一一介紹各樹形節(jié)點的要點。

樹屬性是整個格式樹的屬性，在結(jié)構(gòu)中只能有一個節(jié)點，位于結(jié)構(gòu)頂部。其屬性包括：

·格式屬性：中國銀行的付款文件是以豎線“|”為分隔符的文本文件，所以指定字段類型為1（帶分隔符的文件），分隔符（定界符）為“|”;

·等級：給文件行定義不同的層級， 以區(qū)分文件頭、付款頭、付款明細(xì)等不同的層級。后面的償付因素其實是指該層級可重復(fù)次數(shù)。

·排序/代碼字段：指定付款明細(xì)的輸出順序。

段組是一整套記錄的集合。通常我們會在樹屬性下建一個段組將所有記錄包括進(jìn)去。

段通常用來表示一條記錄。需要給文件中的每個類型的記錄建一個段。比如，文件頭、付款明細(xì)、文件尾等等。

元素用來表示一條記錄中的一個字段。其屬性中各參數(shù)含義如下：

l名稱： 名稱可以重復(fù)。系統(tǒng)用節(jié)點標(biāo)識作為唯一標(biāo)識。

l參考標(biāo)識：如果要在其他地方引用該字段，需要輸入一個參考標(biāo)識。

lSAP腳本名稱：用來在附表中引用該元素。

l長度：字段長度。

l類型：字段類型。

l目標(biāo)偏移量：系統(tǒng)從偏移量后一位開始填寫元素內(nèi)容。

l轉(zhuǎn)換功能：字段格式。

l狀態(tài)：用來標(biāo)志字段是必填還是可選的。

l映射過程：用來指定數(shù)據(jù)來源。具體來源在“源”頁面指定（集合例外）。

常量：字段填入一個常量。

結(jié)構(gòu)字段：可以指定為付款運行中的內(nèi)容（包括FPAYH， FPAYHX， FPAYP以及DMEE_PAYD結(jié)構(gòu)字段），或系統(tǒng)字段的內(nèi)容。

參照樹節(jié)點：某個樹節(jié)點的內(nèi)容。

集合：某個節(jié)點的統(tǒng)計數(shù)字。比如總計多少個付款，總計付款金額等等。其來源在“集合”頁面指定。

退出模塊：可以在一個退出模塊（user exit）中，指定元素內(nèi)容?？梢钥截怱AP提供的函數(shù)模塊例子DMEE_EXIT_TEMPLATE和DMEE_EXIT_TEMPLATE_EXTENDED。

內(nèi)部映射：指定元素內(nèi)容由多個子鍵（最小單位）組成，需要在其下面建2個以上的最小單位：

技術(shù)節(jié)點和元素類似，但是不輸出到目標(biāo)付款文件中?？梢詫⑵淇闯膳R時存儲的一個元素。

最小單位也和元素類似，但是它只能是某個元素的組成部分?？梢詫⒍鄠€最小單位的內(nèi)容拼接成一個元素。

元素、技術(shù)節(jié)點和最小單位都有“條件”頁面。只有當(dāng)其中的條件成立時，它們才會輸出。

1.2.2配置付款運行

根據(jù)銀行付款文件格式定義好格式樹后，我們需要配置付款運行。付款運行的配置只需按照通常的方式配置。以下只對影響銀行接口的地方做詳細(xì)說明，通常的付款運行配置我們將只作簡要說明或略過不提，不再贅述。

1.2.2.1開戶銀行

[從菜單進(jìn)入 IMG > 財務(wù)會計 > 銀行會計核算 > 銀行賬戶 > 定義開戶行 交易碼 FI12 ]

開戶銀行中除一般的開戶行名稱、銀行國家和銀行代碼外，還可以在數(shù)據(jù)媒介交換中指定一些信息，比如本公司在銀行的客戶編號、費用賬戶等等，以便在格式樹中引用。

1.2.2.2 定義支付媒介

根據(jù)前面在DMEE中創(chuàng)建的付款文件格式創(chuàng)建支付媒介格式。在媒介格式中指定輸入為“01文件”，并指定“使用DME Engine映射”。

1.2.2.3調(diào)整支付方式格式

在支付格式中，指定代碼頁為“4110 – Unicode UTF-8”。在有中文輸出的付款格式，必須指定Unicode 代碼頁或兼容的中文代碼頁，否則輸出的付款文件有可能帶有亂碼。

1.2.2.4創(chuàng)建付款方式

需要為銀行不同的付款格式創(chuàng)建一個新的付款方式。對公匯款和對私匯款雖然格式相同，但為了生成不同的付款文件，我們也分別為它們建一個新的付款方式。在付款方式中，指定所用的支付媒介格式。

1.2.2.5定義付款文件生成的變式

[從菜單進(jìn)入 無 交易碼 FBPM ]

運行FBPM，為每一個付款格式指定相應(yīng)的參數(shù)，并將參數(shù)保存為一個變式。

1.2.2.6為付款文件的生成分配變式

[從菜單進(jìn)入 IMG > 財務(wù)會計 > 應(yīng)收賬款和應(yīng)付賬款 > 業(yè)務(wù)交易 > 付款 > 自動付款 > 支付媒介 > 進(jìn)行支付方式工作臺中支付方式格式化的設(shè)置 > 創(chuàng)建/分配選擇變式 交易碼 無 ]

按照自動付款銀行確定，給相應(yīng)的賬戶和付款方式組合分配變式。

在做完其他的付款運行配置后，我們就可以執(zhí)行付款運行，并生成付款文件了。

1.3 在付款運行時生成付款文件

執(zhí)行付款運行F110/F111的方法沒有變化，在最后一步過賬付款運行時，需要選擇“創(chuàng)建付款媒介”。

收付任務(wù)完成后，可以在菜單中選擇管理付款媒介。在此界面下，可以下載付款文件。

此文件可直接上傳到中國銀行網(wǎng)上銀行作為批量付款。你也可以將此文件導(dǎo)入中國銀行批量文件工具里，驗證矯正后生成批量付款文件，再上傳到網(wǎng)上銀行。

1.4 小結(jié)

使用上傳付款文件的方式來將付款請求發(fā)送到銀行，這種方式簡單方便。雖然執(zhí)行付款運行后，需要下載文件，再上傳到網(wǎng)銀，需要手工操作，中間存在一定的風(fēng)險。但是這種方式穩(wěn)定可靠，適用面廣，基本上所有銀行都可以使用。

2 SAP銀行接口實例（二） - 以EDI方式將付款請求發(fā)送給銀行

上篇講述了從SAP發(fā)送付款請求到銀行的第一種情況， 這里我們繼續(xù)講第二種情況——即以EDI方式將付款請求發(fā)送給銀行。使用該方法需要滿足一定的前提條件：

1）銀行方面提供對企業(yè)的直接接口服務(wù)（該服務(wù)可能收取額外的費用）;

2）銀行方面可以接收EDI 820標(biāo)準(zhǔn)格式的付款請求;或者通過某個中間件（比如Oracle OFM）將EDI 820 轉(zhuǎn)換成銀行方面可以接收的格式（比如XML）并將請求傳送到銀行。

2.1 實例

花旗銀行就提供了這樣的接口， 允許企業(yè)將付款請求以指定文件格式發(fā)送到指定地址。因此，企業(yè)可以將付款請求以EDI 方式發(fā)送到OFM上，再在OFM上將付款請求轉(zhuǎn)換成花旗銀行指定的格式，并傳送到花旗銀行指定地址。整個過程不需要人為干預(yù)。

2.2. 后臺配置

這種連接方法在SAP中的配置比較簡單，除了一般的付款運行設(shè)置外，還需要做以下設(shè)置：

2.2.1 設(shè)置付款方式

首先要創(chuàng)建一個新的付款方式，并在付款方式的支付媒介中指定EDI付款程序REFOEDI1。

2.2.2 為開戶行定義 EDI 兼容支付方式

針對每個付款公司，按照開戶行和付款方式的組合開通EDI付款。

2.2.3 在開戶行定義中指定 EDI 合作伙伴

在開戶行中，需要指定相應(yīng)的合作伙伴編號。下面WE20中創(chuàng)建的合作伙伴編號需要與這里指定的編號一致。

2.2.4 設(shè)置IDOC接收端口（Port）

首先根據(jù)連接屬性選擇端口類型?？蛇x擇的類型包括RFC、文件、XML文件、XML HTTP等。OFM 要求提供XML文件，所以此處選擇了XML 文件。

XML文件端口需要指定文件存放的網(wǎng)絡(luò)地址和路徑。同時可以指定一個功能模塊，此功能模塊會在文件存放時觸發(fā)。例如，我們可以利用這個功能模塊指定文件的名稱等。

2.2.5 有了端口就可以配置合作伙伴參數(shù)文件（Partner Profile）

[從菜單進(jìn)入 IMG > 財務(wù)供應(yīng)鏈管理 > 開票合并 > 環(huán)境 > 定義合作伙伴參數(shù)文件 交易碼 WE20 ]

伙伴參數(shù)文件類型必須選擇B（Bank）。合作伙伴編號就使用上述步驟3開戶行定義中指定的編號。

在出站參數(shù)中添加下面2個消息類型：

·PAYEXT – 付款請求擴(kuò)展類型，它包括了付款請求的主要內(nèi)容;

·EUPEXR – 付款請求的參考消息，如果EDI子系統(tǒng)無法處理EUPEXR， 可以把他指向一個臨時路徑，然后通過TCODE SARA將其歸檔。

在消息類型中將接收方端口指定為步驟4中創(chuàng)建的端口。

將消息PAYEXT中的IDOC基本類型指定為PEXR2002， EUPEXR中的IDOC基本類型指定為IDCREF01。 如果銀行還需要基本類型以外的信息，可以創(chuàng)建一個擴(kuò)展類型將這些信息包括進(jìn)去。

在進(jìn)站消息中添加狀態(tài)消息STATUS。

2.2.6 為支付方式分配支付媒介程序

[從菜單進(jìn)入 IMG > 財務(wù)會計 > 應(yīng)收賬款和應(yīng)付賬款 > 業(yè)務(wù)交易 > 付款 > 自動付款 > 支付媒介 > 進(jìn)行標(biāo)準(zhǔn)支付方式程序的設(shè)置 > 對本國支付方式分配支付媒介程序 交易碼 無 ]

將EDI程序REFOEDI1分配給EDI 支付方式。

2.2.7 為支付方式分配表單

[從菜單進(jìn)入 IMG > 財務(wù)會計 > 應(yīng)收賬款和應(yīng)付賬款 > 業(yè)務(wù)交易 > 付款 > 自動付款 > 支付媒介 > 進(jìn)行標(biāo)準(zhǔn)支付方式程序的設(shè)置 > 向公司代碼支付方式分配支付格式 交易碼 無 ]

可以使用標(biāo)準(zhǔn)附表F110_EDI_01， 也可以使用自定義的附表。

2.2.8 為EDI支付程序創(chuàng)建變式

[從菜單進(jìn)入 無 交易碼 SE38 ]

使用ABAP編輯器為程序REFOEDI1創(chuàng)建一個變式。在變式中指定公司代碼和支付方式，并勾選“生成SAP IDoc”。這個變式將被用在付款程序中。

2.3 在付款運行時發(fā)送EDI付款請求

執(zhí)行付款運行F110/F111的方法基本沒有變化。只是要在“打印輸出/數(shù)據(jù)媒介”頁面要為EDI支付程序指定前面創(chuàng)建的變式。

然后，在最后一步過賬付款運行時，需要選擇“創(chuàng)建付款媒介”。付款運行結(jié)束后，EDI付款請求就會以IDoc的形式發(fā)送出去。

收付任務(wù)完成后，可以在菜單中選擇管理付款媒介。在此可以看到產(chǎn)生的付款概況。顯示（Ctrl + F1）相應(yīng)的付款可以跳轉(zhuǎn)到對應(yīng)的IDOC。

狀態(tài)記錄顯示了IDOC處理的結(jié)果，如有異?？梢詮倪@兒找到原因。其中的數(shù)據(jù)記錄包含了具體的付款明細(xì)。

2.4 小結(jié)

通過EDI發(fā)送付款請求到銀行，需要銀行方面提供EDI服務(wù)或提供某種直接連接方式。但這種方式對用戶來說是最方便的、最可靠的。用戶執(zhí)行付款運行后不需要進(jìn)行任何操作，也避免了付款請求在發(fā)送過程中可能被修改的風(fēng)險。從用戶角度看，這是最佳方案。

3 SAP銀行接口實例（三） - 電子支付集成/銀企直連

本篇我們繼續(xù)講第三種情況。從ECC6 SP05開始，SAP專門為中國開發(fā)了面向本地銀行的接口EPIC（電子支付集成/銀企直連）。將所有與銀行的交互都集成到了一個界面里。這比較符合中國用戶的操作習(xí)慣，因此在新實施的項目中比較流行。

目前，EPIC只提供了針對下列五大銀行的http/https接口例子：

·中國銀行

·中國工商銀行

·中國建設(shè)銀行

·中國招商銀行

·中國農(nóng)業(yè)銀行

如果其他銀行也提供類似的http/https接口，可以拷貝這些例子，再在此基礎(chǔ)上進(jìn)行定制。但即便是這五大銀行，SAP也只提供了樣例，實際使用時還需要進(jìn)行定制。

3.1業(yè)務(wù)流程

EPIC通過http/https連接將付款請求發(fā)送到銀行前置機(jī)，然后銀行前置機(jī)再將付款請求轉(zhuǎn)發(fā)到銀行主機(jī)。業(yè)務(wù)流程示意圖如下所示：

銀行前置機(jī)需要聯(lián)系銀行安裝和配置。本篇只講述SAP上的設(shè)置以及跟銀行前置機(jī)的連接，并假定前置機(jī)與銀行的連接已經(jīng)配置好并正常運行。

3.2后臺配置

如前所述，這種連接方法需要較多的定制，系統(tǒng)配置也相對復(fù)雜。除了一般的付款運行設(shè)置外，還需要做以下設(shè)置。

3.2.1 激活EPIC模塊

EPIC 并不默認(rèn)激活，你需要在SFW5里激活FIN_LOC_CI_16， 以及相應(yīng)的功能模塊（FIN_LOC_EPIC_*）。激活以后你才能在IMG看到相應(yīng)的配置，在菜單里才能找到相應(yīng)的功能。

3.2.2 定義銀行通信類型

[從菜單進(jìn)入

IMG > 財務(wù)會計 > 應(yīng)收賬款和應(yīng)付賬款 > 業(yè)務(wù)交易 > 國家特定設(shè)置 > 中國 > 電子支付集成 >定義銀行通信類型 交易碼 無 ]

下面是系統(tǒng)默認(rèn)的6種類型，如果需要，可以自定義新的通信類型。

3.2.3 創(chuàng)建到銀行前置機(jī)的連接

[從菜單進(jìn)入

無 交易碼 SM59 ]

新建一個G類（通過HTTP方式與外部服務(wù)器的連接）連接。在連接中指定主機(jī)地址和目標(biāo)路徑。

3.2.4 定制EPIC類

[從菜單進(jìn)入

無 交易碼 SE80/SE24 ]

將程序包ID-FI-EPIC-CN下的相關(guān)類拷貝一份，并根據(jù)銀行的實際要求進(jìn)行定制。比如中國銀行的付款類CL_EPIC_EXAMPLE_CN_BOC_PAY， 可以重命名為ZCL_EPIC_CN_BOC_PAY。

3.2.5 定義銀行通信明細(xì)

[從菜單進(jìn)入

IMG > 財務(wù)會計 > 應(yīng)收賬款和應(yīng)付賬款 > 業(yè)務(wù)交易 > 國家特定設(shè)置 > 中國 > 電子支付集成 >定義銀行通信明細(xì) 交易碼 無 ]

我們需要對每一個銀行賬號和通信類型建立通信明細(xì)，并指定：

對話參數(shù)結(jié)構(gòu) – 定義該通信類型的對話字段結(jié)構(gòu)。比如查詢交易明細(xì)時要指定的起止日期。

其他參數(shù)結(jié)構(gòu) – 發(fā)送給銀行的參數(shù)結(jié)構(gòu)。

輸出結(jié)構(gòu) – 定義銀行返回查詢信息的字段。

其他結(jié)果結(jié)構(gòu) – 定義銀行返回其他信息的字段。

目標(biāo) – 前面創(chuàng)建的、到銀行前置機(jī)的連接。

編碼 – 字符編碼。

實施類- 前面拷貝和定制化后的類。

3.2.6 定義付款文件格式

[從菜單進(jìn)入

無 交易碼 DMEE ]

具體付款文件格式請參考各銀行的銀企直連接口規(guī)范。創(chuàng)建時可以參考SAP提供的格式例子（EPIC_EXAMPLE_CN*）。

3.2.7 創(chuàng)建新的付款方式，把上述付款文件格式賦予付款方式

[從菜單進(jìn)入

IMG > 財務(wù)會計 > 應(yīng)收賬款和應(yīng)付賬款 > 業(yè)務(wù)交易 > 付款 > 自動付款 > 支付程序的付款方式/銀行選擇 > 設(shè)置支付事務(wù)每一國家的支付方法 交易碼 無 ]

在付款方式中指定付款格式。需要為每一個不同的付款格式創(chuàng)建一個新的付款方式。

其他的自動付款設(shè)置這里就不再贅述，請參考以前的文章。

3.3運行銀企直連付款

SAP銀企直連的事務(wù)碼 EPIC_PROC。運行此事務(wù)碼出現(xiàn)下列屏幕，包括了銀企直連的所有功能-查詢余額、查詢對賬單、付款等。其付款流程與F110類似。

先輸入付款參數(shù)，然后運行付款建議。付款建議生成后，可以提交給第二、第三人審批。批準(zhǔn)后的付款項目后點擊即可生成付款憑證。與F110不同的是，既可以選擇所有的建議項目，也可以選擇部分項目進(jìn)行審批和付款。

此時付款請求尚未發(fā)送給銀行，點擊報文處理頁面向銀行提交付款請求。選中已創(chuàng)建文件，點擊向銀行提交。

傳送完成后，可以點擊查看傳送狀態(tài)?？梢钥吹絺魉鸵殉晒?。

3.4 小結(jié)

EPIC（銀企直連）是SAP專門為中國開發(fā)的， 其界面比較符合中國人的使用習(xí)慣，因此越來越多的中國企業(yè)采用此種方式發(fā)送付款請求到銀行。但是這種方式暫時只適用于國內(nèi)大銀行，實施時需要一定的開發(fā)，實施的難度較大。另外，由于該工具專對中國開發(fā)，其穩(wěn)定性和可靠性也有待實踐的檢驗。

【通聯(lián)編輯：李雅琪】