Fonction SAP BAPI_BUPA_FS_CREATE_FROM_DATA2 - Create Business Partner

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ACCEPT_ERROR BAPI4001_1-ACCEPT_ERR C 1 SPACE X Accept Regional Structure Check Errors with Warnings
ADDRESSDATA BAPIBUS1006_ADDRESS u 830 X Address Data
BUSINESSPARTNEREXTERN BAPIBUS1006_HEAD-BPARTNER C 10 X Business Partner Number
CENTRALDATA BAPIBUS1006_CENTRAL u 137 General Data
CENTRALDATAGROUP BAPIBUS1006_CENTRAL_GROUP u 84 X General Group Data
CENTRALDATAORGANIZATION BAPIBUS1006_CENTRAL_ORGAN u 203 X General Organization Data
CENTRALDATAPERSON BAPIBUS1006_CENTRAL_PERSON u 465 X General Data for Person
CHANGEDOCU BAPI_STR_BUPA_FS_CHANGE_DOCU-CHANGE_DOCU C 1 X Generate Change Documents; obsolete
DUPLICATE_MESSAGE_TYPE BAPIBUS1006_HEAD-CONTROLDUPLICATEMESSAGE C 1 X Accept Duplicate Check Errors with Warnings
PARTNERCATEGORY BAPIBUS1006_HEAD-PARTN_CAT C 1 Business Partner Category
PARTNERGROUP BAPIBUS1006_HEAD-PARTN_GRP C 4 X Business Partner Grouping
TESTRUN BAPI_FSBP_CENTRAL-TESTRUN C 1 X Activate Simulation Mode

Paramètre Reférence Type Long. Description
BUSINESSPARTNER BAPIBUS1006_HEAD-BPARTNER C 10 Business Partner Number

Paramètre Reférence Long. Facultatif Description
ADDRESSDUPLICATES BAPIBUS1006_ADDRESS_DUPLICATES 67 X Address Duplicates
ADDRESSNOTES BAPIAD_REM 55 X Notes on Address
COMMUNICATIONNOTES BAPICOMREM 60 X Notes on Communication
COMMUNICATIONNOTESNONADDRESS BAPINOADCOMREM 60 X Notes on Address-Independent Communication Types
E_MAILDATA BAPIADSMTP 300 X E-Mail Addresses
E_MAILDATANONADDRESS BAPINOADSMTP 300 X Address-Independent E-Mail Addresses
FAXDATA BAPIADFAX 143 X Fax Numbers
FAXDATANONADDRESS BAPINOADFAX 143 X Address-Independent Fax Numbers
PAGADDRESSDATA BAPIADPAG 136 X Pager Numbers
PAGADDRESSDATANONADDRESS BAPINOADPAG 136 X Address-Independent Pager Numbers
PRTADDRESSDATA BAPIADPRT 40 X PRT Addresses
PRTADDRESSDATANONADDRESS BAPINOADPRT 40 X Address-Independent PRT Addresses
RETURN BAPIRET2 548 X Return Messages
RFCADDRESSDATA BAPIADRFC 69 X RFC Addresses
RFCADDRESSDATANONADDRESS BAPINOADRFC 69 X Address-Independent RFC Addresses
RMLADDRESSDATA BAPIADRML 63 X RML Addresses
RMLADDRESSDATANONADDRESS BAPINOADRML 63 X Address-Independent RML Addresses
ROLES BAPIBUSISB990_BPROLES 49 X Business Partner Role
SSFADDRESSDATA BAPIADSSF 2391 X SSF Addresses
SSFADDRESSDATANONADDRESS BAPINOADSSF 2391 X Address-Independent SSF Addresses
TELEFONDATA BAPIADTEL 142 X Telephone Numbers
TELEFONDATANONADDRESS BAPINOADTEL 142 X Address-Independent Telephone Numbers
TELETEXDATA BAPIADTTX 72 X Teletex Numbers
TELETEXDATANONADDRESS BAPINOADTTX 72 X Address-Independent Teletex Numbers
TELEXDATA BAPIADTLX 72 X Telex Numbers
TELEXDATANONADDRESS BAPINOADTLX 72 X Address-Independent Telex Numbers
URIADDRESSDATA BAPIADURI 2219 X URI Addresses
URIADDRESSDATANONADDRESS BAPINOADURI 2219 X Address Independent URI Addresses
X400ADDRESSDATA BAPIADX400 948 X X400 Addresses
X400ADDRESSDATANONADDRESS BAPINOADX400 948 X Address-Independent X.400 Addresses

Functionality
With this method you can create business partners in selected business partner roles (BP roles).
You can create business partners of the category person,organization, or group, enter relevant general data, and control thenumber assignment using business partner grouping.
You can also enter an address including data for address-dependent andaddress-independent communication methods.

Notes
Before you create a business partner a simple exclusive lock isactivated. This prevents other users from changing the business partnerthat is currently being processed until either the methodTransactionCommit or TransactionRollback for the BusinessObject BapiService is executed. The authorized user can accessthe same business partner repeatedly.
The business partner is not written to the database until the methodTransactionCommit for the Business Object BapiService hasbeen called.

Authorizations
The system carries out an authorization check if an authorization object isentered in the authorization group for the business partner. The systemchecks the authorization object B_BUPA_GRP withthe activity 02 (change).
You can make settings for business partner authorization objects to bechecked in Customizing for the SAP Business Partner underBusiness Partner-> Basic Settings-> Authorization Management.

Dependencies
When you create a business partner you have to enter the business partner category.
If you create a business partner with external number assignment thenyou have to specify an external business partner number in the parameterBUSINESSPARTNEREXTERN ( business partner number).If you use internal number assignment then the system automaticallyselects a business partner number and returns this in the parameterBUSINESSPARTNER ( business partner number).
You generally create the business partner role for the business partnerin the parameter ROLES directly using the businesspartner role. If you enter the BP rolecategory in the parameter ROLES then the business partner is createdin the BP role that is marked as the standard assignment for this BProle type in the IMG activity Define BP Roles.
By setting the indicator Create all BP rolesbelonging to a BP role category you can create the business partnerin all business partner roles that are assigned to a BP role category.
The system checks data entered for a business partner with regards toits consistency and in accordance with certain Customizing settings.
In the parameter ACCEPT_ERROR you can define how the system is to dealwith errors arising from the regional structure check for addresses.
If you have set the system accordingly, it carries out a duplicate checkwhen addresses are created. If a record that you have created alreadyexists in the system, the system returns any addresses that are similarto this record in the table ADDRESSDUPLICATES. If the tool used for theduplicate check supports the option, then the system also states thelikelihood that the address record in question is a duplicate as apercentage. If no error occurs when adding addresses, then the data issaved and the system returns a unique address GUID in the parameterADDRESSGUID.

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 the returnvalues and their meaning in the parameter documentation.

Further information
Do not use the similar method FSCreateFromData (createbusiness partner) as the business partner roles specified in thismethod cannot be processed correctly (obsolete role concept).
You will find more information on creating business partners in dialogprocessing in the SAP Library by choosing SAP Business Partner forFinancial Services.

Description
This parameter contains business partner numbers issued by the system.
You can find information on the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.

Description
This parameter is only relevant if you also create address data whencreating the business partner.
With this parameter you control whether a message from the regionalstructure check is of the type:

  • E (error) or

  • W (warning)

    • In this parameter enter the value X if messages issued are to be warningmessages.

    Value range
    X for the regional structure check will issue a message of type W(warning)
    ' ' for the regional structure check will issue a message of type E(error)

    Default
    ' ' for the regional structure check will issue a message of type E(error)

    Description
    This parameter contains the address data for the SAP Business Partner.
    For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
    You have to transfer values for the following fields:

    • COUNTRY (country key)

      • Value range
      The value range for this parameter corresponds with the value range forthe structure component.

      Description
      This parameter contains the external business partner numbers that youassign to business partners when assigning external numbers.
      If you work with external number assignment then this parameter is arequired (mandatory) parameter.
      You can find information on the meaning of the parameter in thecorresponding documentation for the data element: Business Partner Number.

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

      Description
      This parameter is a required (mandatory) parameter.
      It contains the general business partner data that is independent fromthe business partner category
      .
      For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

      Value range
      The value range for this parameter corresponds with the value range forthe structure component.

      Description
      This parameter contains general data for business partners belonging tothe category Group.
      For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

      Value range
      The value range for this parameter corresponds with the value range forthe structure component.

      Description
      This parameter contains general data for business partners belonging tothe categoryOrganization.
      For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

      Value range
      The value range for this parameter corresponds with the value range forthe structure component.

      Description
      This parameter contains general data for business partners belonging tothe category Person
      .
      For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

      Value range
      The value range for this parameter corresponds with the value range forthe structure component.

      Description
      This parameter is obsolete and no longer has a function.
      The system generates change documents automatically.

      Value range

      Description
      You can find information on the meaning of the parameter in thecorresponding documentation for the data element: Output: Severity of error (N/SPACE-normal, E/F/A-error).
      With this parameter you can control which kind of message is to beissued during a duplicate check:

      • E (error) or

      • W (warning)

        • If the system issues message type E then it terminates processing.

        Default
        If no value is entered then message type E is used as default in thestandard system.

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

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

        Description
        You can find information on the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Grouping.

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

        Description
        You can find information on the meaning of the parameter in thecorresponding documentation for the data element: Switchto Simulation Mode 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
        In this parameter the system returns duplicate addresses that itidentified as being the same or similar when the current record wasentered.
        The field ADDRNUMBER contains the address numbers of the addresses thatwere identified as being the same or similar.
        If these addresses are personal addresses then the relevant personnumber is entered in the field PERSNUMBER.
        If the duplicate check tool supports the option, then the fieldPERCENTAGE contains the percentage showing how likely it is that theaddress record in question is a duplicate.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This table contains notes on addresses for a business partner.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains notes on communication methods for a businesspartner.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains notes on the address-independent communicationdata of the business partner in Business Address Services.
        For more information on the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the e-mail addresses for abusiness partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent e-mailaddresses for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the fax numbers for a businesspartner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent faxnumbers for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains notes on addresses for a business partner.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent pagernumbers for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the RFC addresses for abusiness partner in Business Address Services.
        For more information on the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent PRT(printer) addresses for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This table contains return messages from the method call.

        Description
        This parameter contains information about the RFC addresses for abusiness partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent RFCaddresses for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the RML addresses for abusiness partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent RMLaddresses for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter transfers the business partnerrole (BP roles) for the business partner to be created.
        You can create the business partner role yourself using the BP role or using the BP role category. If you enter the BP role category then the systemcreates a BP role that is assigned to this BP role category as standard.
        You assign business partner roles to a business partner role category inCustomizing for the SAP Business Partner under BusinessPartner -> Basic Settings -> Business Partner Roles -> Define BusinessPartner Roles.
        In addition you can determine that certain business partner data can bedifferentiated for the business partner role.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the SSF addresses for abusiness partner in Business Address Services.
        For more information about individual parameter fields, see the relevantdata element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent SSFaddresses for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the telephone numbers for abusiness partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independenttelephone numbers for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the teletex numbers for abusiness partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independentteletex numbers for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the telex numbers for abusiness partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent telexnumbers for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about URI addresses for a businesspartner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent URIaddresses for a business partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the X.400 addresses for abusiness partner in Business Address Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

        Description
        This parameter contains information about the address-independent X.-400addresses for a business partner in Business Adress Services.
        For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.