Functionality
Use this method to change the values for a standing order. This methodreturns the following values:

• Identification details of the account for the changed standing order
(such as the international bank account number and the external accountnumber)

• A table containing error messages

To use this method, you must transfer values for the following importparameters:

• External Account Number (EXTERNALACCOUNTNR)


• Standing Order Number (STANDING_ORDER_NUMBER) in the structure
Standing Order Data (STANDORDDATA)

• Customer Extension Indicator (PROCESS_EXTENSION)

In addition, to execute this method and ensure that the account iscorrectly identified, you must enter either of the following importparameters:

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

• Bank Area (BANKAREA)

The changed standing order will be transferred with the internal valueControl (Dual Cont.) if you have set up the principle of dualcontrol for standing orders. You can define the principle of dualcontrol in the IMG activity Maintain AmountLimit/Principle of Dual Control for Standing Order.
Note: The original standing order will continue to be executeduntil you release the changed standing order.

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, without a prior posting being necessary.
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 details about the standing order.
INCLUDE BAPI_DATAELEMENT

Description
This parameter allows you to specify thebank area for the standing order.
The method Change a Standing Order (BAPI_BKK_STAND_ORDER_CHANGE)internally identifies the account for the standing 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 keyparameter identifies the bankthat will process the standing order.
The method Change a Standing Order (BAPI_BKK_STAND_ORDER_CHANGE)internally identifies the account for the standing 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 keyparametercontrols the validation of external account numbers.
The method Change a Standing Order (BAPI_BKK_STAND_ORDER_CHANGE)internally identifies the account for the standing 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 transfers the country forthe Bank Area parameter (BANKAREA).
The system returns an error message if you enter an invalid value.

Description
This parameter identifies the account for the standing order and is amandatory value for changing a standing order. This account must havethe internal status Active.
The system returns an error message if you enter an invalid value.

Description
This parameter specifies whether the details entered by the customers ina Business Add-In 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. Thisis the default setting.
'X'
This value means that the customer enhancements are executed.

Description
This parameter transfers the basic input details for a standing orderand is a mandatory value for creating a standing order.
You must specify the following mandatory values:


• Transaction Type for Sender and Receiver (TRNSTYPE and TRNSTYPE_R)


• Payment method (PAYMETHOD)


• Period (PERIOD)


• Period unit (PER_UNIT)


• Bank area or the Bank country key (RCV_BANK_COUNTRY_KEY ) along with the
Country ISO code (RCV_BANK_COUNTRY_KEY_ISO)
In addition, to transfer the amount for the standing order, you mustspecify a value for either of the following parameters:

• Amount in Transaction Currency (TRANSACTION_AMOUNT)


• Base Amount (REM_AMOUNT), Execution Percentage of Standing Order
(PERCENTAGE), and Minimum Transfer Amount (MIN_AMOUNT)
The system also validates the data in the following fields:

• Payment method

The payment method must be a valid one.

• Transaction type

Creation of standing orders must be enabled in the IMG activityMaintain Transaction Types.

• Execution percentage of standing order

The percentage must be above 0 and below 100.

• Next date

The date must be after the current posting date.

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. This is the defaultsetting and corresponds to the expectations of the calling program.
'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
INCLUDE BAPI_TABLE

Value range
Messages for Value Checks
Type ID,, Message Number,, Messages
1B,, 001,, Bank area &1 does not exist
1BKKBAPI,, 155,, Bank key &1 does not correspond with bank area &2
1BKKBAPI,, 154,, Bank country &1 does not correspond with bank area &2
1BKKBAPI,, 156,, IBAN &1 does not correspond with bank area &2 andaccount number &3
1BKKBAPI,, 016,, ISO-Code &1 of field &2 could not be processed
1E,, 073,, Account & does not exist
1E,, 071,, Account number &1 does not exist in bank area &2
1E,, 069,, No corresponding data record was found for the parameters
Messages for Authorization
Type ID,, Message Number,, Messages
1P,, 131,, User &1 has no authorization for executing &2
Additional Messages
Type ID,, Message Number,, Messages
1E,, 089,, SYST: Error in import parameter check
1BKKBAPI,, 012,, Instance of BADI definition &1 could not be created
1BKKBAPI,, 013,, Error on opening instance of object type &1. Externalreference &2 &3
1BKKBAPI,, 014,, &1 must be called at least with one of the parameters2 3
1BKKBAPI,, 100,, BAPI call has been processed successfully
1BKKBAPI,, 101,, BAPI call failed
1BKKBAPI,, 218,, Message protocol could not be opened

Description
This table contains the details of the notes for the payment order(s)that will be created from the standing order.