Functionality
Use this method to create a forward order for an account in BankCustomer Accounts (BCA). This method returns the following values:

• Identification number of the forward order


• Forward order status

The forward order is transferred with the status Control (DualCont.) if you set up the principle of dual control for paymentorders. You can define the principle of dual control in the IMG activity
Maintain Amount Limit/Principle of DualControl for Payment Order.
The forward order is transferred with the status Planned if youdo not set up the principle of dual control.

• Identification details of the account such as the external account
number and the International Bank Account Number
The method logs details of errors in the return parameter (RETURN).
To create a forward order, it is mandatory to specify values for thefollowing parameters:

• External Account Number (EXTERNALACCOUNTNR)


• Forward Order Data (SENDER)


• Forward Order Recipient Data (RECEIVER)

Further, to ensure that the account is correctly identified, you mustenter either of the following import parameters:

• Bank Key (BANKNUMBER) and Bank Country Key (BANK_COUNTRY_KEY)


• Bank Area (BANKAREA)

Note: The system automatically generates a forward order numberif you do not specify one.

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

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 identification number for the forward orderif the method is implemented successfully. However, this parameter doesnot return any value if an error occurs.

Description
This parameter returns the status (such as Parked, Posted, or Deleted)of the forward order.

Description
This parameter allows you to specify thebank area for the forward order.
The method Create a Forward Order (BAPI_BKK_FORWD_ORDER_CREATE)internally identifies the account for the forward order by using any ofthe following parameters:


• Bank Key (BANKNUMBER) and Bank Country Key
(BANK_COUNTRY_KEY)

• Bank Area (BANKAREA)

Note: The system returns an error message if you do not specify avalue for either of these parameters.

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

Description
The bank key parameter identifies thebank that is to process the new forward order.
The method Create a Forward Order (BAPI_BKK_FORWD_ORDER_CREATE)internally identifies the account for the forward order by using any ofthe following parameters:


• Bank Key (BANKNUMBER) and Bank Country Key
(BANK_COUNTRY_KEY)

• Bank Area (BANKAREA)

Note: The system returns an error message if you do not specify avalue for either of these parameters.

Description
The bank country key parametercontrols the validation of external account numbers.
The method Create a Forward Order (BAPI_BKK_FORWD_ORDER_CREATE)internally identifies the account for the forward order by using any ofthe following parameters:


• Bank Key (BANKNUMBER) and Bank Country Key
(BANK_COUNTRY_KEY)

• Bank Area (BANKAREA)

Note: The system returns an error message if you do not specify avalue for either of these parameters.

Description
This parameter contains the country for theBank Area parameter (BANKAREA).
The system returns an error message if you enter an invalid value.

Description
This parameter identifies the account for which the forward order is tobe created and is a mandatory value for creating a forward order. Thisaccount must have the internal status Active.
The system returns an error message if you enter an invalid value.

Description
This parameter contains the key that identifies the forward order. Ifyou do not specify a value for this parameter, the system automaticallygenerates one.

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.

Description
This parameter contains the ordering party details for a forward order.You must specify values for the following mandatory fields:


• Account holder name (ACCOUNT_HOLDER_NAME)


• Value date (DATE_VALUE)


• Posting date (DATE_POST)


• Transaction currency (CURRENCY)


• Payment medium (MEDIUM)


• Transaction type (TRNSTYPE)


• Payment method (PAYMENT_METHOD)


• Amount in transaction currency (AMOUNT)

The system also validates the data in the following fields:

• Payment method

The payment method must be a valid one.

• Transaction amount

This amount must be equal to the sum of the recipient transactionamounts that is transferred in the Forward Order Recipient tableparameter (RECEIVER).

• Posting date

This date must lie within the date range defined in the IMG activityTolerance Days for Forward Order.

• Transaction type

Payment order creation must be allowed for the transaction type. You candefine settings for transaction types in the IMG activityMaintain Transaction Types.
For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

Description
If this parameter is set, the method will only be executed in the testrun. All checks are then carried out, without an entry being made in thedatabase.
This is used for write BAPIs to check the entries for the objectinstance in the database before actually creating the instance. Theobject instance is not actually created; it is merely simulated.

Value range
' ' (no value)
This value means that the database is updated.
'X'
This value means that the BAPI is called in simulation mode and that nodata is written to the database.
INCLUDE BAPI_EXTIN
INCLUDE BAPI_EXTOUT

Description
This table contains the details of the notes for the payment order(s)that are to be created from the forward order.

Description
This table contains details of the recipient parties for a forwardorder. The system checks that the sum of the recipient transactionamounts is equal to the transaction amount specified in the Sender(SENDER) import parameter.
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
1B,, 001,, Bank area &1 does not exist
1E,, 071,, Account number &1 does not exist in bank area &2
1E,, 073,, Account & does not exist
1BKKBAPI,, 154,, Bank country &1 does not correspond with bank area &2
1BKKBAPI,, 155,, Bank key &1 does not correspond with bank area &2
1BKKBAPI,, 156,, IBAN &1 does not correspond with bank area &2 andaccount number &3
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