Functionality
Use this method to change the values of an existing forward order. Thismethod returns the following values:

• Identification details of the account for the changed forward order
(such as the International Bank Account Number and the external accountnumber)

• Forward order status

The changed forward order is transferred with the status Control(Dual Cont.) 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.
The method logs details of errors in the return parameter (RETURN).
To use this method, it is mandatory to specify values for the followingimport parameters:

• External Account Number (EXTERNALACCOUNTNR)


• Forward Order Number (FORWARDNUMBER) in the Forward Order Data (SENDER)
parameter

• Forward Order Recipient Data (RECEIVER)

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

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

• Bank Area (BANKAREA)

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 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 Change a Forward Order (BAPI_BKK_FORWD_ORDER_CHANGE)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 forward order.
The method Change a Forward Order (BAPI_BKK_FORWD_ORDER_CHANGE)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 Change a Forward Order (BAPI_BKK_FORWD_ORDER_CHANGE)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 the forward order and is amandatory value for changing a forward order. This account must have theinternal 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.

Description
This parameter contains the status (such as Parked, Posted, or Deleted)of 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.

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 thatis 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
1P,, 440,, Payment order &1 &2 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