Professional Documents
Culture Documents
For Payments
This manual contains proprietary and confidential information of Bank of America Merrill Lynch and
was prepared by the staff of Bank of America Merrill Lynch. This user guide may not be reproduced
or disclosed to others in whole or in part without the written permission of Bank of America Merrill
Lynch. Permitted reproductions shall bear this notice and the Bank of America Merrill Lynch copyright
notice. The user of this user guide acknowledges the rights of Bank of America Merrill Lynch in the
contents and agrees to maintain this user guide and its contents in confidence.
2011 Bank of America Corporation
All rights reserved. None of the enclosed material may be reproduced or published without
permission of Bank of America Merrill Lynch.
PAGE 2
Table of Contents
1
Introduction ................................................................................................... 4
2.2
2.3
2.4
2.5
2.6
2.7
3.3
PAGE 3
Introduction
The objective in implementing SAP or any ERP system is to automate processes and facilitate data
transport. In SAP, the Intermediate Document (IDoc) is the primary mechanism for moving data from
one module or system to another. It is a standard data structure for electronic data interchange (EDI)
between application programs written for the SAP system or between a SAP application and an external
program or system. Although SAP IDoc is the SAPs preferred format, clients are required to configure
their ERP systems to export an outward transaction in the SAP IDoc format.
The purpose of this document to provide the banks SAP clients with an overview of the major
configuration steps required to generate the SAP IDoc output. It is not intended to contain full details of
the setup of all the entities of the SAP system such as Company Code, House Bank and Vendors from
the beginning. Therefore, only specific fields and entities that are related to the configuration of the SAP
IDoc will be covered in this document.
The target audience of the document is either the business owner or the ERP system owner who will be
familiar with the information that is already set up within the existing or target SAP configuration. This
document assumes that the client has a functioning SAP system in that the:
Configuration of the Company Code is completed in the SAP system
Vendor information has already been defined
PAGE 4
Setup steps
There are seven major steps in configuring an existing SAP system to export the outward transactions
in the SAP IDoc format. The following diagram summaries the major steps required:
Defining House Bank
and Accounts
Defining Access Port &
Partner Profile
Payment Program
Configuration
Updating the
Vendor Details
EDI Partner Configuration
for House Bank
Assign EDI Payment Method
to External Payment Method
2.1
2.1.1
PAGE 5
button to continue.
Press the New Entries button on the action bar of the House Bank Overview screen to create
a new House Bank
On the New Entries: Details of Added Entries screen, enter the value of the fields as follow:
Field
Values
House Bank
Bank Country
Bank Key
PAGE 6
The following is the sample New Entries: Details of Added Entries screen:
If the bank has not been set up in the Bank Master, yet, the client can create it from this screen
by pressing the Create button, the Bank Data screen will be displayed for the clients to enter
detailed information of the Bank. The client should provide as much information as possible.
The following is the sample Bank Data screen:
PAGE 7
Description
Bank Country
The bank country field is maintained in the ERP system to identify the
domicile country of the bank account
Bank Name
This field is maintained to identify the bank name of the debit account
Bank Branch
SWIFT code
The SWIFT code field is maintained in the ERP to identify the SWIFT
address of the payer bank
Bank Number
This field identify the bank and Branch code of the bank, for example,
6 digits sort code for the UK branches
When the detailed bank data, the clients can press the
will be closed
PAGE 8
2.1.2
Click on the New Entries to create a new bank account or select an account on the Bank
Accounts list and click the
Most of the information on the Details of Added Entries will be populated from the House Bank
information that has been setup in section 2.1.1. The key information on the bank account
screen that the client needs to provide is as follow:
Field
Description
Account ID
Description
IBAN
Control Key
PAGE 9
G/L
Currency
After all the information about the bank account has been entered, the client can press the
button to save the account.
PAGE 10
2.2
2.2.1
The steps to setup the file port access for IDoc are as follow:
Select the option File on the list and use the Create option to create a new entry. The
following is the SAP screen for creating a file port:
PAGE 11
Enter a port name, description and select the IDoc record types SAP Release 4.x option under
Version Tab
Use the default values in the System Setting Tab
In the Outbound file tab, enter the following parameters
Field
Values
Logical directory
Off
Physical directory
On
Directory
/tmp/
Function Module
EDI_PATH_CREATE_CLIENT_DOCNUM
Outbound file
Leave blank
Values
Off
RFC destination
Rfcexe
Logical directory
Off
Physical directory
On
Directory
/tmp/
Command file
Leave blank
PAGE 12
The following screen is the sample of the Outboard Trigger tab on the Creating a file port screen:
No configurable is required for the Inbound file and Status file tabs
At this point, the file port can be saved and the file port access setup is completed
PAGE 13
2.2.2
The steps to set up the Partner Profile for the IDoc generation are as follow:
Enter transaction code WE20 to access the Partner profiles maintenance screen
Highlight the Partner Type B Bank option on the selection list on the left hand side of the
screen and press the
button
Values
Partner No.
PAGE 14
Partn. Type
B Bank
Ty.
US - User
Agent
Lang.
EN English
Provide additional information for message types EUPEXR and PAYEXT using the action
buttons under the Outbound parmtrs. box. The following screen shot highlighted the action
buttons:
Values
Partner No.
Partn. Type
Partner Role
Leave blank
Message Type
EUPEXR
Message Code
Leave blank
Message function
Leave blank
Outbound options
Receiver port
SUBSYSTEM
Output Mode
Transfer IDoc Immed.
Off
Collect IDocs
On
Start Subsystem
Off
On
IDoc Type
Basic Type
IDCREF01
Extension
Leave blank
View
Leave blank
On
Leave blank
Leave blank
PAGE 15
The following screen shows the sample screen shot of the EUPEXR message parameters using the
example of BAML_US as Partner No:
Values
Partner No.
Partn. Type
Partner Role
Leave blank
Message Type
PAYEXT
Message Code
Leave blank
Message function
Leave blank
Outbound options
Receiver port
SUBSYSTEM
Output Mode
Transfer IDoc Immed.
Off
Collect IDocs
On
Start Subsystem
Off
On
IDoc Type
SAP IDoc Configuration Guide For Payments
PAGE 16
Basic Type
PEXR2002
Extension
Leave blank
View
Leave blank
On
45A
Leave blank
The following screen shows the sample PAYEXT message parameters using the example of
BAML_US as the Partner No:
PAGE 17
2.3
2.3.1
The Change View Company Codes: Overview screen will be displayed when the All company
codes button is pressed
Click the New Entries button to access the New Entries: Details of Add Entries screen for
creating create a new company code or select an existing company code and press the
button to amend an existing company code. The following screen shows the Change View
Company Codes : Overview screen with the add new company code option highlighted in red
and change options highlighted in blue:
PAGE 18
On the Change View Company Codes: Details, the fields that should be filled in for the BAML
IDoc generation are as follows:
Field
Description
If applicable
Must be provided
If applicable
Press the
PAGE 19
2.3.2
PAGE 20
Press the New Entries button on the action button bar to define new Payment Methods. The
following is the sample,
Notes
The configuration of the payment method is depended on the client needs and the ERP
environment. However, the client needs to setup several parameters correctly for IDoc
generation. The essential parameters are as follow:
Select the Bank transf button for outbound payment transactions,
Select the Check for the outward check transactions,
Set the Allowed for personnel payments on,
Set the Bank details button on,
Select the Use class payment medium programs (RFFO*),
Assign currencies allowed for this payment method.
PAGE 21
The following is a sample screen for the currency setup of the payment method:
PAGE 22
2.3.3
The Maintenance of Company Code Data for a Payment Method will be displayed. Click the
New Entries button to create a new payment method. The following is the sample of the
Maintenance of Company Code Data for a Payment Method screen:
Enter the Company Code that will be used for creating transaction debiting the BAML accounts
and the payment methods that have been defined in section 2.3.2. Set other parameters of the
payment method.
PAGE 23
Press the Form Data button to expand the parameters settings and enter the following values for
the parameters:
Field
Description
F110_D_AVIS
F110_EDI_01
The following is a sample of the Details of Added Entries screen with the Form Data parameters
expanded:
2.4
2.4.1
On the Payment Company Codes: Overview screen, select the Company Code to be edited and
press the
PAGE 25
The following is the sample of the Payment Company Codes: Overview screen:
On the Paying Company Code: Details screen, press the Forms button at the bottom of screen
to expand the parameters of the output form settings. The following shows the Paying Company
Code: Details screen with the parameters of the form settings expanded:
Enter the following parameters in the Forms section and press the
Field
Description
F110_D_AVIS
F110_EDI_01
PAGE 26
2.4.2
On the ABAP: Variants Initial screen, enter the Company Code in the Variants field and press
Create or the Change button depending whether the variants for your company code has been
defined in the RFFOEDI1 program.
The following is the sample ABAP: Variants Initial screen using the Company Code USCC as
example:
PAGE 27
On the Maintain Variant screen, ensure that the Generate SAP IDoc option is selected,
Press the
To Use IBAN Account number for Vendor payment, tick Transfer IBAN.
If you would like the program to print payment advice notes choose the corresponding option and
specify the Number of invoice details.
PAGE 28
2.5
On the Change Vendor : Payment transaction Accounting screen, click on the button next the
payment methods to display the payment methods available. The following is a sample of the
Change Vendor: Payment transaction Accounting screen:
PAGE 29
On the payment method selection screen, select the payment method defined in section 2.3.3
for the IDoc output and press the
Payment Method selection screen:
The payment methods field on the Change Vendor screen has now updated with all the
payment methods selected, press the
button to save the information of the new payment
method. The following is a sample Change Vendor showing payment method I has been added:
Note: If a particular payment method is specified in the item to be paid, this specification has priority
over the specifications in the master record.
PAGE 30
2.6
On the View Cluster Maintenance: Initial screen, enter the Company Code and press the
button as shown in the following sample screen:
PAGE 31
On the Change View House Banks: Overview screen, select the House Bank to be configured
and press the
The following is a sample of the overview screen with House Bank BAML as an example:
On the Change View House Banks: Details screen, press the EDI partner profiles button to
expand the associated parameters,
Key in the EDI partner number defined as described in section 2.2.2 .e.g. BAML_US,
Press the EDI comp. pyt mthds button for the setup of the payment methods to the EDI partner.
PAGE 32
On the Change View EDI-compatible payment methods screen, press the New Entries button to
add new payment methods for IDoc. The following is the sample of the Change EDI-compatible
payment methods screen:
PAGE 33
Enter the payment methods for IDoc as defined in section 2.3.2 (e.g. I) on the New Entries:
Overview of Added Entries screen,
Press the
The following is a sample screen shot of the Entries: Overview of Added Entries screen:
Press the
button to close the New Entries: Overview of Added Entries screen and go back
up to the Change View EDI-compatible payment methods screen,
Press the
button on the Change View EDI-compatible payment methods screen to save
the EDI partner and payment methods added to the House Bank.
PAGE 34
2.7
button to proceed.
The following screen shows the sample of the Determine Work Area: Entry screen using the
example of BAML_US as the Partner No:
On the Change View FI-EDI: Assignment Pymt Method External Pymt Method screen, press the New
Entries to add the new mapping definition of the payment methods.
PAGE 35
The following screen shows the sample of the Change View FI-EDI: Assignment Pymt Method
External Pymt Method screen:
Press the
PAGE 36
3.1
PAGE 37
The major steps for the automatic payment run process are as follow:
Provide the Run Date and an identification ID for the payment run
Click the parameter tab to provide the parameters for the payment run. The following screen
shows the parameters on the Parameter tab:
On the parameter tab, the user should provide the following information which is most
commonly used in a payment run:
Screen field
Description
Posting Date
The date that the invoices have been posted in the SAP
system
Docs entered up to
This field specifies the date up to which the opened items are
to be included in the payment run. The date is the entry date
which may be different from the posting date
Company codes
A list of the company codes for which the opened items should
be extracted
Pmt methods
Next p/date
This is the posting date of the next payment run. The current
payment run will extract the items that will be overdue before
the date provided.
PAGE 38
These fields contain the keys that allows SAP to identify the
items of the debtors and/or creditors that should be included in
the current payment run
Click on the Printout/data medium tab. The following screen shows the layout of the
Printout/data medium tab:
The user should provide the variant that has been defined for SAP IDoc generation, as
described in section 2.4.2 -Defining Variants for IDoc Generation, in the REFFOEDI1 row as
shown above. This is a critical step because the transactions will not be formatted in the
SAP IDoc unless the variant is provided in the REFOEFI1 program.
Press the
button on the button bar to save the parameters and click the status tab. The
screen will be refreshed and updates the status to show that parameters have been entered.
The following is the sample screen showing the parameters entry status:
After the parameters have been entered and saved, the user can generate the payment
proposal by pressing the Proposal button on the top of the button bar of the screen as illustrated
in the screen print below:
PAGE 39
A schedule proposal screen will be displayed for the client to either enter the date and time of
the proposal to be generated in future or turn on the Start immediately check box to generate
the payment proposal immediately once the
proposal screen is shown as follow:
A message will be added to the Status tab showing the payment proposal generation status
If the proposal can be generated successfully, the button bar will be updated with additional
buttons for the client to work with the proposal or the proposal logs. The proposal status and
new action buttons added after the proposal has been created successfully are highlighted in
the sample screen print below:
Press the Payment Run button to print the payments. The Schedule Payment screen will be
displayed. As with the Schedule Proposal screen shown above, the user has the option of
PAGE 40
providing the date and time of the payment generation in the future or selecting the Start
immediately option to generate the payment once the
button is pressed.
There is another check box on the screen named Create payment medium. If the user has
selected this option, the SAP IDocs will be generated automatically after the payment run has
been executed successfully. A sample Schedule Payment screen is shown below:
If the payment run has been executed successfully, a message will be added on the Status tab
under the payment proposal execution status as shown in the sample below:
If the client has not specified to create the payment medium during the payment run process,
the client is required to print the SAP IDocs after the payment run. The client should press the
Printout option on the button bar as shown below:
PAGE 41
By pressing the Printout option, the Schedule Print screen will be displayed as shown below:
As with other schedule screens in the payment run process, the user can provide a date and
time for the process to be executed automatically or choose to execute the Payment Print
immediately by turning on the Start immediately check box. Additionally, the user is required to
provide a background job name with the convention of the job name as designed by the general
setting of the SAP system.
Press the
button on the Schedule Print screen to confirm the parameters. The SAP IDocs
will be printed
3.2
Monitoring
SAP offers 2 ways for the clients to monitor the SAP IDocs that are created from the Payment Run
process. The clients can:
Check the status of the SAP Idoc using the Status Monitor for the ALE messages function
Check the content of the SAP IDoc using the SAP IDoc list
3.2.1
Status Monitoring
The user can use transaction code BD87 to enquire the status of SAP IDocs. The following are the
steps:
Enter transaction code BD87
A Select IDocs screen will be displayed as shown in the screen print below:
PAGE 42
Enter the parameters that are related to the SAP IDocs that the user is searching for. For
example, the creation date and time and message type.
Press F8 to execute the query
The Status Monitor for ALE messages screen will be displayed. The user can click the items to
check the IDoc status. A sample Status Monitor for ALE message screen is provided below:
More information on the IDocs can be found by highlighting an entry on the Status Monitor for
ALE messages screen and double click on the highlighted entry or press the Display IDocs
button on the button bar. The high level information of the selected IDocs will be displayed as
per the sample screen shown below:
SAP IDoc Configuration Guide For Payments
PAGE 43
If the user wants to look at the contents of an IDoc message, the user can select an entry on the
IDoc number cell and double click on it, the Display of the IDoc screen will be displayed. The
structure of the selected IDoc will be shown on the left hand side of the screen under the IDoc
Display selection list. The content of the currently selected item will be shown on the right hand
side of the screen. The following is a sample Display of the IDoc screen:
PAGE 44
3.2.2
Provide the parameters in relation to the SAP IDocs to be reviewed on the IDoc List screen and
press F8 to execute the query. The result of the query will be displayed in the IDoc List screen.
Select the IDoc to be reviewed on the IDoc list box and press the IDoc button to display the
content of the selected IDoc. A sample IDoc List screen has been provided below:
The Display of the IDoc screen will be shown with the content of the selected IDoc as described
in section 3.2.1 - .Status Monitoring that the user interface will not be repeated in this section.
PAGE 45
3.3
Export
The SAP IDocs generated after the Payment Run process will be stored as individual messages in SAP.
This is driven by the setup of the Partner Profile as described in section 2.2.2 - Define Partner Profile
where the Collect IDocs option is used. This setup allows the client to create all the SAP IDoc messages
through different payment runs and export all the SAP IDoc messages in a single file. Otherwise, each
SAP IDoc message created after the payment run will become a file of its own. Depending on the
connectivity setup, the client may export the SAP IDoc file into other systems and the export process
can be configured to be executed automatically. This section describes the steps to export all SAP IDoc
messages into a physical file on a PC manually for easy illustration of each major step required.
Provide the selection criteria in the parameters on the Process All Selected IDocs (EDI) screen
and press F8 to execute the query
After the query has been executed, SAP will display the information of how many SAP IDoc
messages have been extracted. The following is a sample screen showing 2 IDocs have been
selected:
PAGE 46
Use transaction code AL11 to locate the SAP IDoc file generated. The output file will be
exported into the directory that has been specified in the Partner profile as described in section
2.2.2. The example used in the partner profile is /tmp. The following screen is a sample SAPDirectories screen with the tmp directory highlighted:
Note the file name to be exported from the Directory screen. In this example, the file name is
O_600_0000000000000064
Use transaction code CG3Y to initate the file download. The Download File: Parameters screen
will be displayed. The following is a sample Download File: Parameter screen:
PAGE 47
Provide the source file and target file name and path. In this example, the source file should be
/tmp/ O_600_0000000000000064
Ensure the transfer format is BIN. Otherwise, the IDoc lines will be truncated after 255
characters
Press the
button to continue
The result of the transfer will be shown on the status bar of the SAP main screen as shown in
the sample screen below:
The following sample screen shows the content of the exported SAP IDoc file in a text editor in
Windows:
Bank of America Merrill Lynch is the marketing name for the global banking and global markets businesses of Bank of America Corporation. Lending, derivatives, and other commercial banking activities are performed
globally by banking affiliates of Bank of America Corporation, including Bank of America, N.A., member FDIC. Securities, strategic advisory, and other invest ment banking activities are performed globally by investment
banking affiliates of Bank of America Corporation (Investment Banking Affiliates), including, in the United States, Merrill Lynch, Pierce, Fenner & Smith Incorporated and Merrill Lynch Professio nal Clearing Corp., all of
which are registered broker dealers and members of FINRA and SIPC, and, in other jurisdictions, by locally registered entities. Investment products offered by Investment Banking Affiliates: Are Not FDIC Insured May
Lose Value Are Not Bank Guaranteed. 2011 Bank of America Corporation.
PAGE 48