|
Functionality
Use this method to modify the master data (such as limits, conditions,and direct debit orders) of an existing account. The Change Accountmethod returns the following values:
- Identification details for the account that is changed such as the
internal and the external account number, and the bank area details
- Details of the changes that you made
The method logs the errors that occur in the return parameter (RETURN).
To change account details by using this method, it is mandatory tospecify values for the import parameters Bank Area (BANKAREA) andExternal Account Number (EXTERNALACCOUNTNR).
To specify amount notice details, you must transfer values in both theAmount Notice Master Data import parameter (NOTICEONAMOUNT_RULEIN) andthe Amount Notice Details table parameter (NOTICEONAMOUNTIN).
Update Indicator Parameters
To enable the system to track the changes, you must also set the updateindicator for every changed parameter. Update indicator parameters havethe suffix "X". For example, the update indicator parameter forACCMASTERDATAIN is ACCMASTERDATAINX.
Each update indicator parameter contains the following fields:
- UPDATEFLAG
This field specifies the operation being carried out, and can havefollowing values:
Value,, Operation
I,, Insert
U,, Update
D,, Delete
- An update indicator corresponding to each field in the input parameter.
Thus, to change the value for a parameter by using this method, do thefollowing:
- Transfer the required values in the input parameters
- Make the following changes in the corresponding update indicator
parameter:
In the UPDATEFLAG field, specify the operation (whether insert, update,or delete)
In the update indicator corresponding to each field in the inputparameter, indicate if the value is changed by specifying the value "X"Example
- You may want to increase the amount of the direct debit order number 1
from EUR 100 to EUR 200. To make this change, specify the followingvalues:
Parameter,, Fields,, Value
DEBITORDERIN,, DIRECTDEBITORDER,, 1
(input parameter),, DIRECTDEBITODERITEM,, ' '
,, PAYMENTRECIPIENTNAME,, ' '
,, DIRECTDEBITAMOUNTLIMIT,, 200
,, DIRECTDEBITCURRENCY,, ' '
,, CURRENCYISO,, ' '
DEBITORDERINX,, UPDATEFLAG,, U
(update indicator parameter),, DIRECTDEBITORDER,, 'X'
,, DIRECTDEBITODERITEM,, ' '
,, PAYMENTRECIPIENTNAME,, ' '
,, DIRECTDEBITAMOUNTLIMIT,, 'X'
,, DIRECTDEBITCURRENCY,, ' '
,, CURRENCYISO,, ' '
- To delete the direct debit order, you can set the parameters as follows:
Parameter,, Fields,, Values
DEBITORDERIN,, DIRECTDEBITORDER,, 1
(input parameter),, DIRECTDEBITODERITEM,, ' '
,, PAYMENTRECIPIENTNAME,, ' '
,, DIRECTDEBITAMOUNTLIMIT,, ' '
,, DIRECTDEBITCURRENCY,, ' '
,, CURRENCYISO,, ' '
DEBITORDERINX,, UPDATEFLAG,, D
(update indicator parameter),, DIRECTDEBITORDER,, 'X'
,, DIRECTDEBITODERITEM,, ' '
,, PAYMENTRECIPIENTNAME,, ' '
,, DIRECTDEBITAMOUNTLIMIT,, ' '
,, DIRECTDEBITCURRENCY,, ' '
,, CURRENCYISO,, ' '
- To insert a new direct debit order, you can set the parameters as
follows:
Parameter,, Fields,, Values
DEBITORDERIN,, DIRECTDEBITORDER,, 1
(input parameter),, DIRECTDEBITODERITEM,, '1'
,, PAYMENTRECIPIENTNAME,, 'Marcus Adams'
,, DIRECTDEBITAMOUNTLIMIT,, '500'
,, DIRECTDEBITCURRENCY,, 'EUR'
,, CURRENCYISO,, 'EUR'
DEBITORDERINX,, UPDATEFLAG,, I
(update indicator parameter),, DIRECTDEBITORDER,, 'X'
,, DIRECTDEBITODERITEM,, 'X'
,, PAYMENTRECIPIENTNAME,, 'X'
,, DIRECTDEBITAMOUNTLIMIT,, 'X'
,, DIRECTDEBITCURRENCY,, 'X'
,, CURRENCYISO,, 'X'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).
Customer Enhancements
INCLUDE BAPI_CUST1
INCLUDE BAPI_CUST_INOUT
INCLUDE BAPI_CUST2
Return Messages
INCLUDE BAPI_RETDescription
This parameter returns details of the account identifiers (such as theinternal and external account numbers).
INCLUDE BAPI_DATAELEMENT Description
This parameter contains the basic data (such as the account status andcreation date) for an account.
It is mandatory to specify a value in the following fields:
- Account status enhancement (ADDITIONALACCOUNTSTATUS)
- Account opening date (ACCOUNTOPENDATE)
- All fields that are set up as required fields in the product.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that you changed in theAccount Master Data (ACCMASTERDATA) parameter. Specify if you haveinserted, updated, or deleted values in the Account Master Dataparameter and denote the fields that have changed by using the "X"indicator.
The system returns an error message if you specify an invalid value.
For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary. Description
This parameter contains the operational data (such as currency andcondition area) for an account.
You must specify a value in the Currency Key field (CURRENCY) andfor all other fields that are set up as required fields in the product.The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that you changed in theAccount Operative Data (ACCOPERATIVEDATAIN) parameter. Specify if youhave inserted, updated, or deleted values in the Account Operative Dataparameter and denote the fields that have changed by using the "X"indicator.
The system returns an error message if you specify an invalid value.
For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary. Description
This parameter contains details about the account identifiers (such asthe internal and external account numbers).
For more information on the individual parameter fields, see the dataelement documentation in the ABAP Dictionary. Description
This parameter contains the bank area for an accountand is a mandatory value. The system returns an error message if youspecify an invalid value.Value range
The value range for this parameter corresponds to the values that youdefine in the IMG activity Define BankArea.Description
The external account number parameter contains thekey that uniquely identifies an account and is a mandatory value.
If the account number is numeric, it can be transferred with leadingzeros (internal display) or without leading zeros (external display).The system returns an error message if you specify an invalid value.Description
This parameter contains details about the amount notices (such as thenotice lock period and the free amount) for an account.
Note: Transfer values for this parameter only in case of savingsaccounts.
You can change the field values based on the product settings. You canset up the product field modifications in the IMG activityCreate Product orChange Product.
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that you changed in theAmount Notices Master Data (NOTICEONAMOUNT_RULEIN) parameter. Specify ifyou have inserted, updated, or deleted values in the Amount NoticesMaster Data parameter and denote the fields that have changed by usingthe "X" indicator.
The system returns an error message if you specify an invalid value.
For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary. 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 details about the term agreements (such as thecontract amount and term duration) for an account.
Note: Transfer values for this parameter only for fixed-termdeposit accounts.
You can change the master data for a term agreement only if it is notyet fixed. You cannot, however, delete the master data. You must specifya value for all fields that are set up as required fields in theproduct. You can set up the product field modifications in the IMGactivity Create ProductorChange Product. The system returns an errormessage if you specify an invalid value.
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that are changed in theFixed Term Deposits: Master Data (TERMRULEIN) parameter. Specify if youhave inserted, updated, or deleted values in the Fixed Term Deposits:Master Data parameter and denote the fields that have changed by usingthe "X" indicator.
The system returns an error message if you specify an invalid value.
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. 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
This parameter contains details of the lockingreasons. The system returns an error message if you specify aninvalid value.Value range
The value range for this parameter is determined by the values that youdefine in the IMG activity Define AccountLocking Reasons.Description
This parameter contains details about the fields that you changed in theLocking Reasons (ACCOUNTLOCKSIN) parameter. Specify if you haveinserted, updated, or deleted values in the Locking Reasons parameterand denote the fields that have changed by using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details of the time periods that are used by thedifferent features in Bank Customer Accounts such as bankstatements and account balancing.
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that you changed in theAccount Periodicity (ACCOUNTTIMEPERIODSIN) parameter. Specify if youhave inserted, updated, or deleted values in the Account Periodicity par
ameter and denote the fields that have changed by using the "X"indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details of the business partners who areassigned to the account in different roles (such as account holder andauthorized drawer).
The system checks that the business partner is valid on the currentsystem date.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the fields that you changed in theBusiness Partners (BUSINESSPARTNERIN) parameter. Specify if you haveinserted, updated, or deleted values in the Business Partners parameterand denote the fields that have changed by using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
If the account is a bank account, this parameter contains details suchas the account category(whether vostoor nostro) and the time for theaccount category change.
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that you changed in theBank Account Data (CONTROLINDICATORBALANCEIN) parameter. Specify if youhave inserted, updated, or deleted values in the Bank Account Data pa
rameter and denote the fields that have changed by using the "X"indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the direct debit orders (such asthe payee and the amount limit).
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the fields that you changed in theDirect Debit Orders (DEBITORDERIN) parameter. Specify if you haveinserted, updated, or deleted values in the Direct Debit Ordersparameter and denote the fields that have changed by using the "X"indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT
INCLUDE BAPI_EXTIN
INCLUDE BAPI_EXTOUT Description
This parameter contains details of the holds (such as the hold amountand the hold validity) defined for an account.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the fields that you changed in theHolds (HOLDIN) parameter. Specify if you have inserted, updated, ordeleted values in the Holds parameter and denote the fields that havechanged by using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains the individual condition details (such as thecondition validity period and the differentiation types) for an account.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the fields that you changed in theIndividual Condition: Header (INDIVIDUALCONDITIONHEADERIN) parameter.Specify if you have inserted, updated, or deleted values in the Individ
ual Condition: Header parameter and denote the fields that have changedby using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains the position details of the individualconditions for an account.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the fields that you changed in theIndividual Conditions: Position (INDIVIDUALCONDITIONPOSITIONIN)parameter. Specify if you have inserted, updated, or deleted values inthe Individual Conditions: Position parameter and denote the fields thathave changed by using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details of the limits (such as the limitvalidity and amount) belonging to the different limit categories (suchas the account overdraft limit and the external limit).
You can insert new limits and delete existing limits; existing limitscannot, however, be changed. To delete a limit, you must specify thefull key, which includes the limit type, the valid from date, therelease indicator, and the currency.
INCLUDE BAPI_DATAELEMENT Value range
For reference limits, the value range for this parameter corresponds tothe values that you have defined in the IMG activityDefine Reference Limits.Description
This parameter contains details about the fields that you changed in theAccount Limits (LIMITSIN) parameter. Specify if you have inserted,updated, or deleted values in the Account Limits parameter and denotethe fields that have changed by using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains the notes for the account in the language thatyou have specified in the parameters Language Key (LANGU) orISO Language Key (LANGU_ISO).Description
This parameter allows you to create, change, or delete amount notices.
Note: Transfer values for this parameter only in the case ofsavings accounts.
Create Amount Notice
To create an amount notice, you must specify a value for all the fieldsin this parameter.
Change Amount Notice
You can change amount notices that meet the following criteria:
- The current system date is outside the withdrawal period of the notice
- The notice is no longer subject to release under the principle of dual
control
Delete Amount Notice
To delete an amount notice, you must specify the Notice Number(NOTICE_NUMBER). You can delete notices that meet all the followingcriteria:
- The notice has the Active status
- The notice is no longer subject to release under the principle of dual
control
- The notice allowance type is any of the following:
Partial amount notice
Full amount notice
Full amount notice with closure
- The notice amount equals the available amount
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that you changed in theAmount Notice Details (NOTICEONAMOUNTIN) parameter. Specify if you haveinserted, updated, or deleted values in the Amount Notice Details par
ameter and denote the fields that have changed by using the "X"indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details of whether the check (pf) number must beissued on check presentation or check issue.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the fields that you changed in theChecks (PF) (POSITIONTYPESCHECKSIN) parameter. Specify if you haveinserted, updated, or deleted values in the Checks (PF) parameter anddenote the fields that have changed by using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details of the different types of referenceaccounts (such as the reference account for account closure orbalancing) for an account.
INCLUDE BAPI_DATAELEMENT Description
This parameter contains details about the fields that you changed in theReference Accounts (REFERENCEACCOUNTSIN) parameter. Specify if you haveinserted, updated, or deleted values in the Reference Accounts parameterand denote the fields that have changed by using the "X" indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT
INCLUDE BAPI_TABLE Value range
Messages for Value Checks
Type ID,, Message Number,, Messages
1E,, 176,, Account is closed. Display only possible.
1E,, 872,, Control value &1 for capital yield tax not allowed
1E,, 255,, Account still in mass processing; changing not allowed
1E,, 030,, Account number & does not exist; check your entry
1E,, 263,, Account was used in balancing; Condition Area change notpossible
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 occured during generatingdirect input data
1BKKBAPI,, 008,, Activity &1 for object &2 is not maintained
1BKKBAPI,, 012,, Instance of BADI definition &1 could not becreated
1BKKBAPI,, 013,, Error on opening instance of object type &1.External reference &2 &3Description
This parameter allows you to create, change, or delete the rollover datafor a fixed-term deposit account. You can also change or delete thecurrent term agreement details if it is not yet fixed.
Note: Transfer values for this parameter only in the case offixed-term deposit accounts.
Create Rollover Data
The information that you specify when you create rollover data variesbased on whether you insert identical or different rollovers.
- For both rollover types, you must specify if the rollover is identical
or different, the number of rollovers, and the markup or markdownamount. You must also transfer a value for the Contract Amount field(DEPOSIT).
- For identical rollovers, the rest of the information is derived from the
current rollover details.
- For different rollovers, you must also specify the term, the term unit,
and the status of each new rollover.
You must specify values for all fields that are set up as requiredfields in the product. You can set up the product field modifications inthe IMG activity Create ProductorChange Product. The system returns an errormessage if you specify an invalid value.
INCLUDE BAPI_DATAELEMENTDescription
This parameter contains details about the fields that you changed in theFixed-Term Deposits: Term Data (TERMIN) parameter. Specify if you haveinserted, updated, or deleted values in the Fixed-Term Deposits: TermData parameter and denote the fields that have changed by using the "X"indicator.
The system returns an error message if you specify an invalid value.
INCLUDE BAPI_DATAELEMENT
|