SAP Function BAPI_BUPR_GEN_SHAREHOLD_DETAIL - Read Shareholding Data for Business Partner Relationship

Parameter Reference Type Length Default Optional Text
BUSINESSPARTNER BAPIBUS1006_HEAD-BPARTNER C 10 Business Partner Number 2
DATE_FROM BAPIBUS1006002_HEADER-VALIDFROMDATE D 8 SY-DATLO X Validity Date (Valid from)
DATE_TO BAPIBUS1006002_HEADER-VALIDUNTILDATE D 8 '99991231' X Validity Date (Valid To)
PROCESSEXTENSION BAPI_FSBP_CENTRAL-PROCESSEXTENSION C 1 X Execute Customer Enhancements
RELATIONSHIPCATEGORY BAPIBUS1006_RELHEAD-RELATIONSHIPCATEGORY C 6 Business Partner Relationship Category
SHAREHOLDER BAPIBUS1006_HEAD-BPARTNER C 10 Business Partner Number 1

Parameter Reference Type Length Text
DATA BAPI_BPREL_SHAREHOLD_ATTR u 19 Shareholding Data for Business Partner Relationship

Parameter Reference Length Optional Text
EXTENSIONOUT BAPIPAREX 990 X ExtensionOut
RETURN BAPIRET2 548 X Return Messages

Functionality
You can use this method to display shareholding data for certainbusiness partner relationships.
Shareholding data for business partner relationships consists of 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 read:

    • 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.

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

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

          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
          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 delete thebusiness partner with shareholding data.

          Default

          • SY-DATLO (technical date)

            • 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 delete thebusiness partner with shareholding data.

            Default

            • 31.12.9999

              • Description
              In this parameter you can state that the customer enhancements are to beexecuted for the 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 BURC02Shareholding: 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 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.