Fonction SAP BAPI_BUPR_GEN_SHAREHOLD_DELETE - Delete Business Partner Relationship with Shareholding Data

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
BUSINESSPARTNER BAPIBUS1006_HEAD-BPARTNER C 10 Business Partner Number 2
CHANGEDOCU BAPI_STR_BUPA_FS_CHANGE_DOCU-CHANGE_DOCU C 1 X Activate Generation of Change Documents
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
TESTRUN BAPI_FSBP_CENTRAL-TESTRUN C 1 X Activate Simulation Mode

Paramètre Reférence Long. Facultatif Description
EXTENSIONOUT BAPIPAREX 990 X ExtensionOut
RETURN BAPIRET2 548 X Return Messages

Functionality
You can use this method to delete 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 deleted:

    • 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 removedfrom 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 document
            ' ' Do not generate change document

            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 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.This contains several data record fields (VALUEPART1, VALUEPART2, ..) aswell as a field for the name of an internal structure created by thecustomer (STRUCTURE). As the data for each data record is writtenpiecewise, one after the other, in the available data record fields, aninternal structure 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.