SAP Function BAPI_BUPR_GEN_SHAREHOLD_EXISTS - Check Business Partner Relationship with Shareholding Data

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)
RELATIONSHIPCATEGORY BAPIBUS1006_RELHEAD-RELATIONSHIPCATEGORY C 6 Business Partner Relationship Category
SHAREHOLDER BAPIBUS1006_HEAD-BPARTNER C 10 Business Partner 1

Parameter Reference Length Optional Text
RETURN BAPIRET2 548 X Return Messages

Functionality
You can use this method to check whether a relationship withshareholding data exists between the business partners stated.
Business partner relationships with shareholding data contain only 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.

    Example

    Notes
    The system proceeds as follows when making the checks:

    • A check is performed to determine whether the business partners are
      • 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 check is performed to determine whether the business partner
          • relationship is available for processing.

          Return messages
          If errors occur during the check or if the relationship does not existbetween the business partners stated, then the system returns a messagein the parameter Return.
          If the system returns the message FSBP_BAPI 044 of the categoryS in the parameter Return, then the relationship isavailable.

          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 the actual validity date (valid from) in thisfield if you want to check the business partner relationship withshareholding 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 the actual validity date (valid to) in thisfield if you want to check the business partner relationship withshareholding data.

            Default

            • 31.12.9999

              • 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
              This table contains the return messages from the method call.
              If the system returns the message FSBP_BAPI 044 of the categoryS in this parameter, then the relationship is available.