XML (ISO 20022) Payment File for XML (ISO ... - baixardoc

© 2012 SAP AG© 2012 SAP AGNeurottstr. 16Neurottstr. 16D-69190 WalldorfD-69190 Walldorf

Title:Title: Implementation Guide CGI_XML_CT Implementation Guide CGI_XML_CT

Version:Version: 1.1 1.1

Date:Date: 30.12.2011 30.12.2011

Page 1 of 59Page 1 of 59

XML (ISO 20022) Payment File for XML (ISO 20022) Payment File for Credit Transfer InitiationCredit Transfer Initiation

(pain.001.001.03)(pain.001.001.03)

ImplementatiImplementation Guideline on Guideline for CGI_XML_CTfor CGI_XML_CT

I.I. Overview of the new CGI_XML_CT FormatOverview of the new CGI_XML_CT Format ................................................................................... 2................................................................................... 2

II.II. Implementation stepsImplementation steps ......................................................................................................................... 2 ......................................................................................................................... 2

III.III. Format Parameter Structure FPM_CGI:Format Parameter Structure FPM_CGI: ......................................................................................... 5 ......................................................................................... 5

IV.IV. Enhance Structures FPAYP, FPAYH and FPAYHXEnhance Structures FPAYP, FPAYH and FPAYHX ................................................................... 17 ................................................................... 17

V.V. Apply Ad Apply Additional Nditional Notesotes .................................................................................................................... 18 .................................................................................................................... 18

VI.VI. Create Function Group DMEE_CGICreate Function Group DMEE_CGI .............................................................................................. 19 .............................................................................................. 19

VII.VII. Create Function Modules and Exit Modules under Function Group DMEE_CGICreate Function Modules and Exit Modules under Function Group DMEE_CGI .................. 20 .................. 20

VIII.VIII. Create XSLT Transformation CGI_XML_CT_XSLT to Eliminate Empty TagsCreate XSLT Transformation CGI_XML_CT_XSLT to Eliminate Empty Tags ....................... 27 ....................... 27

IX.IX. Upload and activate the XML FileUpload and activate the XML File .................................................................................................. 29 .................................................................................................. 29

X.X. Maintain Customizing settingsMaintain Customizing settings........................................................................................................ 32........................................................................................................ 32

a)a) Adjust cu Adjust customizing sstomizing settings in ettings in Payment MPayment Medium edium Workbench (PMWorkbench (PMW)W) ............................. 32 ............................. 32

b)b) Adjust cus Adjust customizing setomizing settings ottings of instruction f instruction keyskeys ................................................................... 37 ................................................................... 37

c)c) Adjust cus Adjust customizing setomizing settings of Fttings of Format Supormat Supplement plement for textfor text .................................. .................................. ............. 41............. 41

d)d) Adjust cus Adjust customizing setomizing settings fottings for Maintainir Maintaining the Titlng the Titlee .......................................................... 42 .......................................................... 42

e)e) Adjust cus Adjust customizing setomizing settings for Lttings for Language anguage DependDependent Addreent Addressss ....................................... 44 ....................................... 44

f)f) Adjust cus Adjust customizing setomizing settings fottings for Languar Language Depenge Dependent Addent Address for Cdress for Company Company Codeode ..... 45 ..... 45

g)g) Adjust cus Adjust customizing setomizing settings fottings for Languar Language Depenge Dependent Addent Address for Vdress for Vendor endor ................................ .... 48.... 48

XI.XI. Use of BICOrBEI element in the formatUse of BICOrBEI element in the format ........................................................................................ 51 ........................................................................................ 51

XII.XII. Assign the Assign the format naformat name in the Bme in the BADI ImpleADI Implementation mentation to get thto get the correct e correct XML file in XML file in UTF-8UTF-8

formatformat ................................................................................................................................................. 52 ................................................................................................................................................. 52

XIII.XIII. Steps to create a new node in the DMEE format (Optional)Steps to create a new node in the DMEE format (Optional) ..................................................... 56 ..................................................... 56




Date:Date: 30.12.2011 30.12.2011


I.I. Overview of the new CGI_XML_CT FormatOverview of the new CGI_XML_CT Format

TheThe CGI_ XML_CTCGI_ XML_CT format is used by SAP ERP Financials to generate XML payment files for format is used by SAP ERP Financials to generate XML payment files for

outgoing international and domestic credit transfers. The format structure is based on the ISOoutgoing international and domestic credit transfers. The format structure is based on the ISO

20022 payment initiation message (pain.001.001.03). The20022 payment initiation message (pain.001.001.03). The CGI_ XML_CTCGI_ XML_CT format corresponds to format corresponds to

the Implementation template defined by banks and corporate customers through the Commonthe Implementation template defined by banks and corporate customers through the Common

Global Implementation (CGI) initiative, includes country specific information, and is fully SingleGlobal Implementation (CGI) initiative, includes country specific information, and is fully Single

Euro Payment Area (SEPA) compliant.Euro Payment Area (SEPA) compliant.

II.II. Implementation stepsImplementation steps

You must execute the You must execute the following activities to utilizefollowing activities to utilize CGI_ XML_CTCGI_ XML_CT::

Create the format parameter structureCreate the format parameter structure FPM_CGIFPM_CGI for transmitting structured informationfor transmitting structured information

Enhance structuresEnhance structures FPAYH, FPAYHX and FPAYP FPAYH, FPAYHX and FPAYP

oo Enhance structureEnhance structure FPAYHFPAYH with fieldswith fields BSWIFT1BSWIFT1,, BSWIFT2 BSWIFT2, and, and BSWIFT3BSWIFT3 (Swift (Swift

International Payment)International Payment)

oo Enhance structureEnhance structure FPAYHXFPAYHX with the field with the field DTURG DTURG (Urgent Payment) (Urgent Payment)

oo Enhance structureEnhance structure FPAYP FPAYP with the field with the field BSTRASBSTRAS (Street and House Number) (Street and House Number)

Apply requisite additionalApply requisite additional NotesNotes

Create Function GroupCreate Function Group DMEE_CGIDMEE_CGI

Create Function ModuleCreate Function Module FI_PAYMEDIUM_DMEE_CGI_05FI_PAYMEDIUM_DMEE_CGI_05 to:to:

oo Use the address details of both Use the address details of both the creditor and debtorthe creditor and debtor

oo Determine if the payment is SEPADetermine if the payment is SEPA

oo Get the bank identification for the house Get the bank identification for the house bankbank

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_ XMLDMEE_EXIT_CGI_ XML to get the parameter values for the nodes to get the parameter values for the nodes

‘‘IdId’’,,''BICOrBEIBICOrBEI',', and and ‘‘IssrIssr’’ based on company code and party name based on company code and party name

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_DEBT_NAMEDMEE_EXIT_CGI_DEBT_NAME to getto get the language dependent debtorthe language dependent debtor

namename




Date:Date: 30.12.2011 30.12.2011


Create the exit moduleCreate the exit module DMEE_EXIT_CGI_CRED_NAMEDMEE_EXIT_CGI_CRED_NAME to getto get the language dependent creditorthe language dependent creditor

namename

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_CRED_CITYDMEE_EXIT_CGI_CRED_CITY to getto get the language dependent creditor citythe language dependent creditor city

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_CRED_PO_CITYDMEE_EXIT_CGI_CRED_PO_CITY to getto get the language dependent creditorthe language dependent creditor

PO cityPO city

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_CRED_REGIONDMEE_EXIT_CGI_CRED_REGION to getto get the language dependent creditorthe language dependent creditor

regionregion

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_CRED_STREETDMEE_EXIT_CGI_CRED_STREET to getto get the language dependent creditorthe language dependent creditor

streetstreet

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_EQVTAMTDMEE_EXIT_CGI_EQVTAMT to get the amount in payment currency to get the amount in payment currency

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_CCYOFTRFDMEE_EXIT_CGI_CCYOFTRF to get the currency for automatic payment to get the currency for automatic payment

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_CRED_TAXIDDMEE_EXIT_CGI_CRED_TAXID to get the creditor Tax ID to get the creditor Tax ID

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAXAMT_RATEDMEE_EXIT_CGI_TAXAMT_RATE to get the tax amount rateto get the tax amount rate

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAXAMT_TTLAMTDMEE_EXIT_CGI_TAXAMT_TTLAMT to get the total tax amountto get the total tax amount

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAXAMT_TXBASEAMTDMEE_EXIT_CGI_TAXAMT_TXBASEAMT to get the taxable base amountto get the taxable base amount

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAX_CATEGORYDMEE_EXIT_CGI_TAX_CATEGORY to get the tax categoryto get the tax category

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAX_CTGRY_DTLSDMEE_EXIT_CGI_TAX_CTGRY_DTLS to get the tax category detailsto get the tax category details

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAX_FORMS_CODEDMEE_EXIT_CGI_TAX_FORMS_CODE to get the tax forms codeto get the tax forms code

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAX_METHODDMEE_EXIT_CGI_TAX_METHOD to get the tax methodto get the tax method

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TAX_SQNBDMEE_EXIT_CGI_TAX_SQNB to get the tax sequence numberto get the tax sequence number

Create the exit moduleCreate the exit module DMEE_EXIT_CGI_TP_WHTDMEE_EXIT_CGI_TP_WHT to get the constant type value WHTto get the constant type value WHT

Create XSLT TransformationCreate XSLT Transformation CGI_XML_CT_XSLTCGI_XML_CT_XSLT to eliminate empty tags to eliminate empty tags

Upload and activate the XML file for the Upload and activate the XML file for the payment format with the DMEE transactionpayment format with the DMEE transaction

Maintain Customizing settings:Maintain Customizing settings:




Date:Date: 30.12.2011 30.12.2011


oo Adjust the customizing settings inAdjust the customizing settings in Payment Medium WorkbenchPayment Medium Workbench (PMW) for the use of (PMW) for the use of

the new payment methodthe new payment method

oo Adjust the customizing settings for the instruction keysAdjust the customizing settings for the instruction keys

oo Adjust the customizing settings for the format Adjust the customizing settings for the format payment supplementpayment supplement

oo Adjust the customizing settings for maintaining the text titleAdjust the customizing settings for maintaining the text title

oo Adjust the customizing settings for maintaining the Language DeAdjust the customizing settings for maintaining the Language Dependent Addresspendent Address

oo Adjust the customizing settings for maintaining the Language Dependent Address inAdjust the customizing settings for maintaining the Language Dependent Address in

Company CodeCompany Code

oo Adjust the customizing settings for maintaining the Language DepeAdjust the customizing settings for maintaining the Language Dependent Address inndent Address in

Vendor master dataVendor master data

Select desired use ofSelect desired use of BICOrBEIBICOrBEI element in the format element in the format

Specify the format nameSpecify the format name CGI_ XML_CTCGI_ XML_CT as a filter value in as a filter value in the BADI implementationthe BADI implementation

DMEE_BADI_XML_01DMEE_BADI_XML_01

Create a new node Create a new node in the DMEE format (Optional)in the DMEE format (Optional)

Note:Note: Ensure every object is saved in the packageEnsure every object is saved in the package ID-DMEEID-DMEE..




Date:Date: 30.12.2011 30.12.2011


III.III. Format Parameter Structure FPM_CGI:Format Parameter Structure FPM_CGI:

The format parameter structureThe format parameter structure FPM_UIFPM_UI is used to specify additional information or choose additional is used to specify additional information or choose additional

file structure formatting options.file structure formatting options.

With a certain transaction the With a certain transaction the user can create variants for user can create variants for the formatting options per House Banks perthe formatting options per House Banks per

payment method. Go to transaction SPRO and choosepayment method. Go to transaction SPRO and choose SAP Reference IMG InSAP Reference IMG In the IMG tree, choose the IMG tree, choose

Financial AccountingFinancial Accounting > > Accounts Receivable and Accoun Accounts Receivable and Accounts Payablets Payable > > Business TransactionsBusiness Transactions > > OutgoingOutgoing

PaymentsPayments > > Automatic Outgoing Payments Automatic Outgoing Payments > > Payment MediaPayment Media > > Make settings for payment mediumMake settings for payment medium

formats for payment medium > Create/Ass formats for payment medium > Create/Assign Selection Variant ign Selection Variant

InIn CGI_XML_CTCGI_XML_CT, structured remittance information can be , structured remittance information can be transmitted within the file. The user selectstransmitted within the file. The user selects

this option by populating thethis option by populating the Structured Remittance InfoStructured Remittance Info checkbox as shown below.checkbox as shown below.

The user can also choose to The user can also choose to publish country specific information by specifying the appropriate two digitpublish country specific information by specifying the appropriate two digit

ISO 3166-1 code of the required country in theISO 3166-1 code of the required country in the ISO codeISO code parameter. parameter.

TheThe Address VersionAddress Version parameter is used to parameter is used to support local language requirements for values such assupport local language requirements for values such as

debtor name or creditor debtor name or creditor name. The user needs to specify the name. The user needs to specify the version of international address toversion of international address to

accomplish this. Detailed information for values are identified below under the customizing steps accomplish this. Detailed information for values are identified below under the customizing steps forfor

language dependent address.language dependent address.

TheThe Requested Execution DateRequested Execution Date parameter is the date the initiating party requests the clearing agent to parameter is the date the initiating party requests the clearing agent to

process the payment.process the payment.

© 2012 SAP AGNeurottstr. 16D-69190 Walldorf

Title: Implementation Guide CGI_XML_CT

Version: 1.1

Date: 30.12.2011

Page 6 of 59

Steps to create the format parameter structure FPM_CGI:

1. Initiate transaction SE11

2. Enter the database table name as FPM_SEPA and click on the Copy button

If you have the structure FPM_SEPA in your system, proceed to step 3 – Copy structure FPM_SEPA

to FPM_CGI. If you do not have the structure FPM_SEPA, then seen the Note – Creating structure

FPM_SEPA below.

Note: Creating Structure FPM_SEPA

Steps to create the format parameter structure FPM_SEPA:

A) Create the following three data elements with the domain TEXT70 in SAP package

BFIBL_PAYM

FPM_XML_XMLNS (XML Namespace of Data Medium)

FPM_XML_XSI (XML Namespace of Schema)



Version: 1.1

Date: 30.12.2011

Page 7 of 59

FPM_XML_SCHEMALOCATION (XML Location of Schema)

Save and activate the element in the package BFIBL_PAYM

B) Create Data Element FPM_STRD with the domain XFELD in SAP package BFIBL_PAYM as

shown below

In the ABAP Dictionary: Initial Screen, select Data type, enter the value FPM_STRD, and click on the

Create button:

The Create Type STRD box appears. Select Data element and click on the green checkmark as

shown below:



Version: 1.1

Date: 30.12.2011

Page 8 of 59

The Dictionary: Display Data Element screen appears. Populate Short Description with the value

Structured Remittance Info. Select the Data Type tab and populate as shown below:

Select the Field Label tab and populate as shown below:



Version: 1.1

Date: 30.12.2011

Page 23 of 59

4. Save and activate the function module in package ID-DMEE.

d) Create Function module DMEE_EXIT_CGI_CRED_NAME

Follow the steps for Create Function Module DMEE_EXIT_CGI_XML substituting the value

DMEE_EXIT_CGI_CRED_NAME for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500

and above) or DMEE_EXIT_TEMPLATE_EXTENDED (for 470 release) in the Function Module

field in step 2.

e) Create Function module DMEE_EXIT_CGI_CRED_CITY


DMEE_EXIT_CGI_CRED_CITY for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500


field in step 2.

f) Create Function module DMEE_EXIT_CGI_CRED_PO_CITY


DMEE_EXIT_CGI_CRED_PO_CITY for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases

500 and above) or DMEE_EXIT_TEMPLATE_EXTENDED (for 470 release) in the Function

Module field in step 2.

g) Create Function module DMEE_EXIT_CGI_CRED_REGION


DMEE_EXIT_CGI_CRED_REGION for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases



h) Create Function module DMEE_EXIT_CGI_CRED_STREET


DMEE_EXIT_CGI_CRED_STREET for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases





Version: 1.1

Date: 30.12.2011

Page 24 of 59

i) Create Function module DMEE_EXIT_CGI_EQVTAMT


DMEE_EXIT_CGI_EQVTAMT for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500


field in step 2.

j) Create Function module DMEE_EXIT_CGI_CCYOFTRF


DMEE_EXIT_CGI_CCYOFTRF for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500


field in step 2.

k) Create Function module DMEE_EXIT_CGI_CRED_TAXID


DMEE_EXIT_CGI_CRED_TAXID for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500


field in step 2.

l) Create Function module DMEE_EXIT_CGI_TP_WHT


DMEE_EXIT_CGI_TP_WHT for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500 and

above) or DMEE_EXIT_TEMPLATE_EXTENDED (for 470 release) in the Function Module field

in step 2.

m) Create Function module DMEE_EXIT_CGI_TAX_METHOD


DMEE_EXIT_CGI_TAX_METHOD for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500


field in step 2.

n) Create Function module DMEE_EXIT_CGI_TAX_SQNB


DMEE_EXIT_CGI_TAX_SQNB for DMEE_EXIT_TEMPLATE_EXTEND_ABA (for releases 500

XML (ISO 20022) Payment File for XML (ISO ... - baixardoc

Documents