Functionality
Use this method to retrieve the following details for a forward order:

• Account attributes such as the International Bank Account Number and the
internal account number

• Forward order number and status


• Ordering party and recipient details such as the forward order amount
and currency, the value date, and the posting date

• Notes for the payment order that is to be created from the forward order

The method logs details of errors in the return parameter (RETURN).
Note: This method does not update the database.
To transfer the forward order details, it is mandatory to specify theForward Order Number (FORWARDNUMBER).

Notes
This method works with buffering. This means that other change methodsof instances created or changed by this method can be executed in thesame Logical Unit of Work (LUW), without a prior posting beingnecessary.
Customer Enhancements
INCLUDE BAPI_CUST1
INCLUDE BAPI_CUST_INOUT
INCLUDE BAPI_CUST2
INCLUDE BAPI_CUST_ENH_FURTHER_INFO
Return Messages
INCLUDE BAPI_RET

Further information
You can also display forward orders in the dialog. For more information,see Processing Forward Orders in the SAP Library under BankCustomer Accounts (BCA) -> Account Management -> Forward Order.

Description
This parameter returns identification details of the account for theforward order.
For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

Description
This parameter returns the forward order number and status.

Description
This parameter returns the ordering party details for the forward ordersuch as the forward order amount, the value date, and the paymentmethod.
For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

Description
This parameter allows you to specify thebank area.

Value range
The value range for this parameter corresponds to the bank areas thatyou have created in the IMG activity DefineBank Area.

Description
This parameter contains the key that identifies the forward order.

Description
This parameter specifies whether the details entered by the customers ina Business Add-In (BAdi) of this method must be retrieved.
You will find information on the meaning of the parameter in thedocumentation for the data element Execute Extension(s)(BAdI).

Value range
' ' (no value)
This value means that the customer enhancements are not executed.
'X'
This value means that the customer enhancements are executed.
INCLUDE BAPI_EXTIN
INCLUDE BAPI_EXTOUT

Description
This table contains the details of the notes for the payment order thatis to be created from the forward order.

Description
This table contains details of the recipient parties for a forwardorder.
For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

Description
INCLUDE BAPI_TABLE

Value range
Messages for Value Checks
Type ID,, Message Number,, Messages
1E,, 221,, Please maintain transaction type
Additional Messages
Type ID,, Message Number,, Messages
1BKKBAPI,, 101,, BAPI call failed
1BKKBAPI,, 218,, Message protocol could not be opened
1BKKBAPI,, 213,, Internal Error &1 occurred during generating directinput data
1BKKBAPI,, 012,, Instance of BADI definition &1 could not be created
1BKKBAPI,, 013,, Error on opening instance of object type &1. Externalreference &2 &3