Functionality
Use this method to create a standing order for a specific account in theBank Customer Accounts system. This method returns the followingvalues:

• Identification of the account for which the standing order has been
created

• Standing order number and status


• A table containing error messages

To create a standing order, you must transfer values for the followingimport parameters:

• External Account Number (EXTERNALACCOUNTNR)


• Standing Order Data (STANDORDDATA)


• Customer Extension Indicator (PROCESS_EXTENSION)

In addition, to execute this BAPI 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)

Note: The system automatically generates a standing 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, 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 of the standing order that is created.
INCLUDE BAPI_DATAELEMENT

Description
This parameter returns a unique identification for the standing order ifthe method is implemented successfully . However, this parameter willnot return any values in the event of an error.

Description
This parameter allows you to specify thebank area for the standing order.
The method Create a Standing Order (BAPI_BKK_STAND_ORDER_CREATE)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 new standing order.
The method Create a Standing Order (BAPI_BKK_STAND_ORDER_CREATE)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 Create a Standing Order (BAPI_BKK_STAND_ORDER_CREATE)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 which the standing order willbe created and is a mandatory value for creating a standing order. Thisaccount must have the 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.

Description
INCLUDE BAPI_EXTIN

Description
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
1BKKBAPI,, 153,, An internal or external account number must be passed
1E,, 071,, Account number &1 does not exist in bank area &2
1E,, 072,, Internal account number &1 does not exist in bank area &2
1E,, 073,, Account & does not exist
1E,, 037,, Internal account number & does not exist: Check your entry
1E,, 069,, No corresponding data record was found for the parameters
1P,, 807,, Standing order number &1 was created &2
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.