Payment Formats - User Guide 1.1
Payment Formats - User Guide 1.1
Payment Formats - User Guide 1.1
1.6 Step 6: Execute Payment Run and Generate Payment Medium File ............................................................... 20
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
1 Introduction
According to new regulations regarding the use of payment formats, the 2253571 SAP Note provides you with a
solution on implementing CGI (Common Global Implementation) payment formats for those countries that
support payments in XML file format according to the ISO 20022 standard, and also how these standard payment
formats can be enhanced with country-specific requirements. These payment formats support SEPA, non-SEPA
and check payments as well.
The following payment formats are used:
• CGI_XML_CT payment format for CGI credit transfer (for example, pain.001.001.03 and higher versions),
and its enhancement using a BAdI concept.
• CGI_XML_DD payment format for CGI direct debits (for example, pain.008.001.02 and higher versions),
and its enhancement using a BAdI concept.
We introduce a BAdI concept that you can use to enhance these payment formats according to country-
specific requirements. The payment formats use DMEE trees (called CGI_XML_CT and CGI_XML_DD).
Prerequisites
As a prerequisite to implement SAP Note 2253571 and all its related SAP Notes, ensure that you already have the
SEPA function installed in your system, that is, the SAP Note 1845689 is implemented.
Process
1. You either download the relevant support package listed in PF_Notes_and_SPs_2253571.xlsx
attachment of the 2253571 SAP Note, or you manually implement all the related SAP Notes.
2. If you manually implement the SAP Notes, you then need to create a new XSLT transformation
(IDFI_XML_XSLT), or update an existing one.
3. You upload or create a new DMEE tree.
4. You make Customizing settings in the system for the use of the CGI_XML_CT and CGI_XML_DD payment
formats in your country.
5. You post vendor or customer invoices.
6. You execute the payment run and from here you generate the payment format.
Let’s have a look at the steps of the process in detail one by one.
Please note that certain steps contain specific settings and other steps contain general descriptions, not specific
data. In such steps, you need to enter data according to your requirements. The steps highlight the basic
requirements so that you can use the payment formats but does not give you full description on the general
settings for payments.
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
3
1.1 Step 1: Implement SAP Notes
So that you can use the function, do the following:
• You can either download the highest possible support package that is available for your release that
contain the changes as listed in PF_Notes_and_SPs_2253571.xlsx attachment of the 2253571 SAP Note.
• You manually implement all the related SAP Notes as it is explained in the following video:
https://www.youtube.com/watch?v=JUCDqtfNk0s
Please note that the system setup of your system can differ from those ones that you can see in the
video.
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
1.2 Step 2: Create New or Update Existing XSLT Transformation
If you have downloaded the highest available support package in your release, you can skip this step.
If you have manually implemented the SAP Notes, you additionally need to create a new XSLT or update an
existing one. To do so, proceed as follows:
Create new XSLT transformation IDFI_XML_XSLT
1. Download the IDFI_XML_XSLT.TXT file attached to SAP Note 2253571 to your local PC
2. Run transaction XSLT_TOOL
3. Enter transformation IDFI_XML_XSLT 4. Choose the Create button or press [F5] 5. Enter the
following parameters: o Transformation: IDFI_XML_XSLT o Short Text: XSLT Transformation to
Remove All Empty Nodes o Transformation Type: XLST Program
6. Save your entry or press [Enter]
7. Enter package: ID-FI-REU-PAYM and choose Save or press [Enter]
8. Copy the content of the IDFI_XML_XSLT.TXT file to the Source Code tab page
9. Activate the IDFI_XML_XSLT XSLT transformation or press [Ctrl+F3]
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
5
1.3 Step 3: Create a New or Update Existing DMEE Tree
If you have downloaded the highest available support package in your release, you can skip this step.
If you have manually implemented the SAP Notes, you additionally need to create a DMEE tree or update your
existing one as follows:
1. Upload/Create new DMEE tree
• To update the version of the DMEE tree, please download the CGI_XML_CT_YYMMDD.XML
(YYMMDD refers to the version attached to the SAP Note) and CGI_XML_DD_YYMMDD.XML files
attached to SAP Note 2253571 to your local PC.
• If you have customer-specific modifications of the original DMEE tree, make a backup copy of the
modified tree by downloading the tree in transaction DMEE before uploading its new version. The
tree is overwritten during upload. If you do not want the standard SAP tree to be overwritten, change
the format name in the DME definition XML file in a text editor before you perform the upload
(change a content of the XML element <Name>... </Name>).
• Log on in the language in which you want to use the DMEE tree (payment format)
• When you perform the upload, the original language of the tree changes to the current logon
language. Later on, the tree can only be changed in the original language
• Press Enter to confirm the warnings that appear during the upload
• If the system display error message DMEE_ABA 130, you need to check your SAP_ABA release and
change the release information in the XML element <BasisRelease> ... </BasisRelease> accordingly
before uploading.
If you have any problems with uploading the DMEE tree, check and implement SAP Note 2309792.
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
7
• fields are ready for usage in the DMEE tree:
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
Step 3.2 How to Use Instruction Keys in the CGI Solution for Credit Transfer
Payments
This document contains recommended settings for the Instruction Keys. When new codes are needed, please
enhance the customizing. For any additional logic, create your own Enhancement Implementation for BAdI
FI_CGI_DMEE_COUNTRIES_CUST.
Where to enter Instructions?
The instructions in the payment transactions are used to give the bank details on how to carry out the payment
orders. Instructions can be defined
1. in the document
2. in the customer/vendor master record using an instruction key
3. in the house bank DME data using the default instruction key
The instructions from the document are used with higher priority, if one of the four fields has been filled out.
Note that we do not recommend that you change the Instruction key during editing the payment proposal.
Instruction 1 (DTWS1)
This key is used to define the code value for the Service Level Code <PmtTpInf><SvcLvl><Cd> or the Check Type
<PmtInf><CdtTrfTxInf><ChqInstr><ChqTp> Recommended way:
In Customizing for Financial Accounting (New) under Accounts Receivable and Accounts Payable → Business
Transactions → Outgoing Payments →Automa c Outgoing Payments → Payment Media → Data Medium
Exchange → Define Instruc ons for Payment Transac ons, enter instructions that control the way in which a
payment is made for a credit institute at two different points in the system as follows:
1. Create application area CGI with short name ISO20022.
2. Define permitted instructions: field 1.
3. Save your entries.
4. Create instructions for field 1 on the Instructions screen:
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
9
5. Save your entries.
Instruction 2 (DTWS2)
This key is used to define the code value for the Service Level Code <PmtTpInf><SvcLvl><Cd> or the Check Type
<PmtInf><CdtTrfTxInf><ChqInstr><ChqTp> Recommended way:
In Customizing for Financial Accounting (New) under Accounts Receivable and Accounts Payable → Business
Transactions → Outgoing Payments →Automa c Outgoing Payments → Payment Media → Data Medium
Exchange → Define Instruc ons for Payment Transac ons, enter instructions that control the way in which a
payment is made for a credit institute at two different points in the system as follows:
1. Create application area CGI with short name ISO20022.
2. Define permitted instructions: field 2.
3. Save your entries.
4. Create instructions for field 2 on the Instructions screen:
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
11
1.4 Step 4: Customizing Settings for Payment Media
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
Type Field Length No. of Fields
Line type 1 Main note to payee line 1 No. 746 999 from 01.01.2000
Line type 1 Main note to payee line 2 No. 333 934 from 02.15.2000
Line type 1 Main note to payee line 3 No. 4 734 from 02.20.2000
Line type 1 Main note to payee line 4 Visit our homepage: www.sap.com
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
13
Line type 3 External short reference Our account with you: 345 876
Selection variant maintenance is a requirement for automatically scheduling the payment media of the Payment
Medium Workbench in the payment program (only).
Prerequisites
You have determined the level of detail in Customizing for Adjust Payment Medium Format. The level of detail
governs how payment media are output in payment groups. In selection variant maintenance, the system
displays all defined payment groups that each require assignment of one selection variant.
Procedure
You can enter, assign, and transport selection variants for the generic payment medium program.
Assigning selection variants
At least 1 variant is defined in each payment group for each payment medium format. It is important to assign a
selection variant to each group to ensure that no payment is forgotten.
1. To assign a selection variant, in Customizing for Financial Accounting (New), choose Accounts Receivable
and Accounts Payable → Business Transac ons → Outgoing Payments → Automa c Outgoing Payments →
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
Payment Media → Make Se ngs for Payment Medium Formats from Payment Medium Workbench →
Create/Assign Selection Variants (or transaction OBPM4).
2. On the left side of the screen, select the payment medium format to which you want to assign a variant.
The system displays the format on the right side of the screen. In order to make the list easier to work
with, you can use Drag&Drop to copy formats to the favorites list.
3. When you place the cursor over a selection variant field and press F4 (input help) the system displays
possible variants.
4. Choose the variant you require.
5. Carry out assignment for each individual group level. You can speed up this process by using filter, copy,
selection, and paste functions.
6. Save assignment of the selection variants.
1. To create a selection variant, in Customizing for Financial Accounting (New), choose Accounts Receivable
and Accounts Payable → Business Transac ons → Outgoing Payments → Automatic Outgoing Payments
→ Payment Media → Make Settings for Payment Medium Formats from Payment Medium Workbench →
Create/Assign Selection Variants.
2. On the left side of the screen, select the payment medium format for which you want to create a variant.
The system displays the format on the right side of the screen.
3. Place the cursor over a selection variant field, enter a name for a new variant, and press continue.
4. The system displays a dialog box where you confirm variant creation.
5. The system displays the selection screen of the generic payment medium program SAPFPAYM.
6. Here, you enter the required selection criteria, then you maintain the attributes before saving the
variant.
7. Choose Back to return to selection variant maintenance for the payment medium formats.
8. Save assignment of the selection variants.
Note:
If you want to work with Dynamic selection you can enter several variants per group using the procedure
described above (Variant → Enter further variants). You should only use Dynamic selections to define
selection variants where no alternative exists. After this, you need to ensure that no payment order has been
carried out in duplicate and that only 1 payment medium has been created for each order.
You can increase the level of detail in Customizing (Adjust Payment Medium Format) as an alternative to
Dynamic selections.
In selection variant maintenance for payment medium creation, it is possible to branch to transport of the
settings made and the selection variants for payment medium creation themselves.
1. To carry out the transport, in Customizing for Financial Accounting (New), choose Accounts Receivable and
Accounts Payable → Business Transactions → Outgoing Payments → Automatic Outgoing Payments →
Payment Media → Make Settings for Payment Medium Formats from Payment Medium Workbench →
Create/Assign Selection Variants.
2. To transport the selection variants, choose (Tansport variants to all formats).
3. To transport selection variant assignment, choose (Transport settings to all formats). You can decide
whether you transport the currently selected format or whether you transport all formats.
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
15
Result
The payment program starts payment medium creation using each selection variant entered.
This BAdI contains country-specific implementations that you can use to enhance the standard CGI
payment formats (CGI_XML_CT and CGI_XML_DD) with country-specific fields. Note:
You can only activate these BAdI implementations. You cannot make any change in them. If you want a
different behavior, you need to create your own implementation as explained below (BAdI for Customer).
You can use this BAdI definition to create your own implementations. You can use these implementations
to modify some parts of the country-specific BAdI implementation that we deliver in the
FI_CGI_DMEE_COUNTRIES BAdI.
If there is no country-specific BAdI implementation that we provide, and you have not created any customer-
specific BAdI implementation, the system uses the CL_IDFI_CGI_DMEE_FALLBACK fallback class to generate the
XML file with the CGI_XML_CT or CGI_XML_DD DMEE trees.
You can access the BAdI implementations in Customizing for Financial Accounting (New), choose Accounts
Receivable and Accounts Payable → Business Transactions → Outgoing Payments → Automatic Outgoing
Payments → Payment Media → SEPA/CGI Payment Formats → Country-Specific Fields for CGI Payment Formats.
9. As the first filter value, enter the country of your house bank in the Value 1 field and save it.
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
17
10. As the second filter value, enter either CREDIT or DEBIT depending on the functionality in the Value 1 field
and save it.
11. Activate the implementation.
Note:
After you have implemented SAP Note 2253924- CGI: CGI_XML_CT, CGI_XML_DD Format Updates #4, you might
face the issue that also o_value must be entered. You might have the following statement in your code:
CASE i_node_path.
WHEN '<PmtInf><-PmtTpInf>'.
c_value = abap_false.
ENDCASE.
that must be replaced with the following code (please note, that o_value is also changed):
CASE i_node_path.
WHEN '<PmtInf><-PmtTpInf>'.
o_value = abap_false.
ENDCASE.
Also, please note that at the beginning of your customer implementation we recommend that you clear
the C_VALUE, P_VALUE, and N_VALUE values. You can use the following coding for this purpose:
CLEAR: C_VALUE, P_VALUE, N_VALUE.
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
2. Fill in values with name of customer BAdI, description and implementing class:
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
19
Please note that you need to clear the value that is coming from the delivered Implementation or Fallback Class,
otherwise it can happen that your logic decides not to fill this value, so the wrong value will be displayed.
1.6 Step 6: Execute Payment Run and Generate Payment Medium File
You run transaction F110 (Automatic Payment Transactions) to process payment run as follows:
1. Run payment proposal (no posting is done)
2. Execute payment run (with posting)
3. Generate payment file using transaction FBPM (Payment Medium: Creation) – or with the selection
variant defined in OBPM4?
For more information about the payment format generation, read the report documentation in the system.
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
2 Additional Information
1. Bank Communication Management
For information about the bank communication management and payment batch approval, see SAP Note
1577912. This SAP Note contains a list of frequently asked questions and their answers about the communication
process with banks using the SAP Bank Communication Management.
Legend:
Example Description
<Example>
Angle brackets indicate that you replace these words or characters with appropriate entries to make
entries in the system, for example, “Enter your <User Name>”.
Arrows separating the parts of a navigation path, for example, menu options
Example Example
Example
Words or characters that you enter in the system exactly as they appear in the documentation
/example Quicklinks added to the internet address of a homepage to enable quick access to specific content on
the
Web
Example
● Words or characters quoted from the screen. These include field labels, screen titles, pushbutton
labels, menu names, and menu options.
Example
● Output on the screen following a user action, for example, messages
● Source code or syntax quoted directly from a program
● File and directory names and their paths, names of variables and parameters, and names of
installation, upgrade, and database tools
EXAMPLE
Technical names of system objects. These include report names, program names, transaction codes,
database table names, and key concepts of a programming language when they are surrounded by body
text, for example, SELECT and INCLUDE
Preliminary version
© Copyright 2017 SAP SE or an SAP affiliate company. All rights reserved.
23
www.sap.com