Functionality
You can use this method to change business partner relationships withshareholding data.
Business partner relationships with shareholding data contain thefollowing attributes defined in the structure BUT053 (BPrelationship: business shareholding), which can be analyzed forregulatory reporting purposes:

• Capital investment as a percentage


• Amount of capital investment


• Currency key


• Indicator: Shareholder controls the firm/company

There are several relationship categories that contain only the listedshareholding data. Possible business partner relationships withshareholding data are, for example, business partner relationshipsbelonging to the relationship category BURC01 (shareholderrelationship), FS0030 (borrower entity member), or user-definedrelationship categories.
For user-defined relationships that contain this shareholding data inparticular, the method offers the advantage that you do not need todefine a separate method for each individual relationship category. Theyenable you to use the global method for several relationship categoriesinstead.

Notes
A preprocessing run takes place before the data is added:


• A check is performed to determine whether the business partners are
available for processing

• A check is performed to determine whether the business partner
relationship is available for processing.

• A check is performed to determine whether a relationship category with
shareholding data is available.
For further information about the relationship category check, see thedocumentation in the parameter Business Partner RelationshipCategory.

• A simple exclusive lock is activated.

This prevents other users from changing the business partner that iscurrently being processed until either the method TransactionCommit
or TransactionRollback for the Business ObjectBapiService is executed. The authorized user can access the samebusiness partner repeatedly.
The business partner relationship with shareholding data is not writtento the database until the method TransactionCommit for theBusiness Object BapiService has been called.

Buffering
This method works with buffering. Change and read methods for thisbusiness object category can be repeatedly used for this instance. Aftercalling the save method, read and write methods can access the bufferedinstances and supply current attributes in the same Logical Unit of Work(LUW).

Return messages
Messages are returned in the Return parameter. You can find thereturn values and their meaning in the parameter documentation.

Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.

Value range
The value range for the parameter corresponds to the value range for thedomain of the data element.

Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Generate Change Documents.

Value range
'X' Generate change documents
' ' Do not generate change documents

Description
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in parameterDATA.

Value range
'X' Change shareholding data
' ' Do not change shareholding data

Description
This parameter contains the validity date (valid from).
The validity date (valid from) indicates the start of thebusiness partner relationship with shareholding data as an identifyingcharacteristic.
You have to enter a value in this field if you want to change thebusiness partner relationship with shareholding data.

Default


• SY-DATLO (technical date)

Description
This parameter contains the new validity date (valid from).
The new validity date (valid from) indicates the new start of thebusiness partner relationship with shareholding data.

Description
This parameter contains the validity date (valid to).
The validity date (valid to) indicates the end of the businesspartner relationship with shareholding data as an identifyingcharacteristic.
You have to enter a value in this field if you want to change thebusiness partner relationship with shareholding data.

Default


• 31.12.9999

Description
This parameter contains the new validity date (valid to).
The new validity date (valid to) indicates the end of the newbusiness partner relationship with shareholding data.

Description
In this parameter you can state that the customer enhancements are to beexecuted for these Business Application Programming Interfaces (BAPIs).
If this indicator is not set, then the system ignores the customerenhancements.

Value range
'X' Execute customer enhancements
' ' Do not execute customer enhancements

Default
' ' Do not execute customer enhancements

Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Relationship Category.

Value range
You can find the value range for this parameter in the Business DataToolset for the SAP Business Partner for Financial Servicesunder Business Partner Relationships-> Control-> RelationshipCategories.
The relationship category to be entered has to be a relationshipcategory that contains exactly those attributes that have been definedas shareholding data for the structure BUT053 (BP relationship:business shareholding). These are relationship categories that havethe relevant application BURC (BP relationship: businessshareholding) and both of the following views BURC01(Shareholding: percent, amount of capital investment) and BURC02(Shareholding: control indicator) assigned to them.

Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.
This business partner number is the number for the business partner thathas the shareholding that is, for example, the number of the shareholderor the head of the borrower entity.

Value range
The value range for the parameter corresponds to the value range for thedomain of the data element.

Description
You can find information about the meaning of the parameter in thedocumentation for the data element: Switch to SimulationMode for Write BAPIs.

Value range
'X' Method is called in simulation mode, that is to say, the data is notupdated
' ' Method is not called in simulation mode, that is to say, the data isupdated.

Default
' ' Method is not called in simulation mode.

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the Structure forBAPI-Parameter ExtensionIn / ExtensionOut.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
This parameter serves as a data container. In the parameter you cantransfer additional data to the method that was not considered at theinterface.
The data is transferred in a table. The format for the individual datarecords for this table is determined by the structure BAPIPAREX. Thiscontains several data record fields (VALUEPART1, VALUEPART2, ..) as wellas a field for the name of an internal structure created by the customer(STRUCTURE). As the data for each data record is written piecewise, oneafter the other, in the available data record fields, an internalstructure is required in order to interpret the data.
In the event that a customer wants to add additional fields to an SAPdatabase table, BAPI table extensions are particularly well suited asinternal structures.
You will find more detailed information on the various customerenhancement options, and the internal structures to be used in eachcase, in the document "Customer Enhancement and Modification ofBAPIs" in the SAP Library under Enhancements, Modifications...(CA-BFA).
The data for the parameter is transferred to the methods Validate andTransferextensionin for the Business Add-Ins (BAdIs).

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the Structure forBAPI-Parameter ExtensionIn / ExtensionOut.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
This parameter serves as a data container. In the parameter you cantransfer additional data to the method that was not considered at theinterface.
The data is transferred in a table. The format for the individual datarecords for this table is determined by the structure BAPIPAREX. Thiscontains several data record fields (VALUEPART1, VALUEPART2, ..) as wellas a field for the name of an internal structure created by the customer(STRUCTURE). As the data for each data record is written piecewise, oneafter the other, in the available data record fields, an internalstructure is required in order to interpret the data.
In the event that a customer wants to add additional fields to an SAPdatabase table, BAPI table extensions are particularly well suited asinternal structures.
You will find more detailed information on the various customerenhancement options, and the internal structures to be used in eachcase, in the document "Customer Enhancement and Modification ofBAPIs" in the SAP Library under Enhancements,Modifications...(CA-BFA).
The data for the parameter is transferred to the methodTransferExtensionOut of the Business Add-Ins (BAdIs) for this method.

Description
This table contains the return messages from the method call.