Functionality
Using this method, in the contract object you can:

• Change general data in the contract object


• Block, delete or insert


• Delete or insert different correspondence receivers


• Delete or insert exception time period for correspondence dunning

The parameter 'Return' can collect several report numbers at once.

Example

Notes
The BAPI uses the customer enhancement concept with 'BAPI TableExtensions' for which the following structures can be used:


• BAPI_TE_DPSOB_BAPI_TE_DPSOB_BP_ACC


• BAPI_TE_DPSOB_BAPI_TE_DPSOB_BP_ACC_COR


• BAPI_TE_DPSOB_BP_ACC_COR

The customer enhancement P520 is called up so you can check datatransferred to BAPI and if necessary determine additional data.
The customer enhancement P525 is called up at the end of themethod in order to fill the output extension.
For an overview of all customer enhancements, see Financialaccounting-> Contract accounts receivable and payable -> Programenhancements -> Define customer-specific function modules inCustomizing.

Description
This export parameter contains the changed control parameter for acontract object's accounting data.

Description
This import parameter contains the changed basic data of a contractaccount.

Value range
The data of the person who last made changes, and the change date arenot displayed. This data is however saved in the database and can bedisplayed using the method readcontract object.

Description
In this import parameter, enter the contract accountcategory assigned to the contract object whose basic or accountingdata you want to change.

Description
In this import parameter, enter the business partner
of a contract object whose basic or accounting data you would liketo change.
INCLUDE BAPI_PARAM_PSOBJECTACCOUNT OBJECT DOKU ID TX

Description
In this import parameter, you determine which control data fromaccounting data (payment data, correspondence and inboundcorrespondence) in the contract object that is going to be changed.Select all the fields whose data you want to change.
INCLUDE BAPI_DATAELEMENT

Value range
The value 'X' means that the field is relevant for changes. The valueBLANK means that the field is not relevant for changes.
INCLUDE BAPI_PARAM_PSOBJECTDETAIL OBJECT DOKU ID TX

Description
In this import parameter, you determine which contract object basic andadministrative data should be changed. Select all the fields whose datayou want to change.
INCLUDE BAPI_DATAELEMENT

Value range
The value 'X' means that the field is relevant for changes. The valueThe value BLANK means means that the field is not relevant for changes.

Description
In this import parameter, you enter the GUID of a contract object forwhich you want to change the basic/accounting data.

Description
In this import parameter, enter the key of a contract object whosebasic or accouting data you want to change.

Description
Is used to check the instance specifications in the writing BAPIs beforeyou actually create the object instance in the database. Creating theobject instance is only simulated with this and the data is not updated(posted).
The following values are possible:


• ' ' (no value)

No value means that the update takes place. This is the default settingand corresponds with the normal expectation of the person calling.

• 'X'

This value means that the BAPI is only called in the simulation mode andthat no update takes place when it is called.

Description
You can change the contract account's master data that applies to thevalidity date using this import parameter.
Note that a validity date in the past cannot be used in this method.Master data cannot be changed retroactively.

Value range
Changes to current date
The current date is the standard proposal (system date). The changesmade on the current data are changed directly in the master data.
Changes in the future
If you enter a future validity date as a value, the changes to themaster data are stored the database as change documents. The contractobject master data is updated to the existing current date according tothe change document using the program BUSPCDACT.
Note:
Ensure that the program BUSPCDACT regularly (forexample daily) updates the contract object master data.
When contract objects are read or displayed, planned changed documentsand actual changed documents from the past are automatically included,as long as a current date different from the validity date was selectedbeforehand.

Description
You can use this import parameter to define whether contract accountdata flagged as obsolete should also be changed. To be able to do this,you require special authorization for authorization object F_KK_SONDwith activity 24.
If the import parameter is not set or the user does not have thecorresponding authorization, master data is excluded from the selectionof data to be changed from the start.

Default
By default, the parameter is not set; as such, obsolete contractaccount data is not included.

Description
With this import parameter, you can define whether the new/changed datais written with an update module or directly into the database.
In both cases, database changes can be reversed in the Logical Unitof Work (LUW) still open using a ROLLBACK WORK. The differenceis that with the update task, the data to be written with system checks(for example when creating a document that should refer to a contractobject just created) will not be regarded until the COMMIT WORKhas occurred.

Default
The parameter is set to 'X' by default which means an update module isused for the database update.

Description
In this import parameter, more data can be transferred to the methodfor example, when you change customer-specific data in contractaccounts using customer enhancement P520.

Description
In this export parameter, additional data processed by the method canbe transferred, for example, when you change customer-specific datausing customer enhancement P525.
Customer enhancement P525 is called up at the end of the method to fillthe output extension.

Description
You can make changes to the additional or different contract object'scorrespondence recipient in this table.
The system only includes control data for correspondence in thecontract contract object if the indicator correspondence parameterin contract
account active is set. Otherwise the control data of the assignedcontract account is included.
INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

Description
You can change the exception period for a contract account's inboundcorrespondence in this table.
INCLUDE BAPI_DATAELEMENT OBJECT DOCU ID TX

Description
In this table you can set locks for the processing of assignedaccounting data in a contract object . The contract object has the locktype 51.
Lock entries in the contract object are only included by the system ifthe indicator Payment Data Active for Contract Object orCorrespondence Parameter Active for Contract Object is set.Otherwise, the control data of the assigned contract account isincluded.
INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

Value range
The following processes can be locked in a contract object:
Type,,Process
01,,Dunning
02,,Incoming Payment
03,,Outgoing Payment
05,,Invoice Creation
07,,Correspondence Dunning
INCLUDE BAPI_TABLE OBJECT DOKU ID TX