Show TOC

Create Business Partner Relationship as BulkLocate this document in the navigation structure

Definition

An operation that creates one or many specified business partner relationships.

Technical Data

Entity Type

Service Operation

Release State

Released

Technical Name

BusinessPartnerDataManagementBusinessPartnerRelationshipIn.CreateBusinessPartnerRelationshipAsBulk

Mode

Asynchronous

Idempotency

Not applicable

Change/Update Behavior

Not applicable

Business Context

For more information about the business context, see the Business Partner Relationship business object.

Related Operations

Business-Related Operations

Not applicable

Features

For each business partner relationship to be created in the bulk request, the following information is mandatory:

  • The coded representation of the category (CategoryCode element). CategoryCode is used for identification only; it cannot be changed.

  • One of the following three identifiers for the first business partner:

    • Unique identifier (UUID element)

    • Internal identifier (InternalID element)

    • The data required for the identification node (PartyIdentifierTypeCode and BusinessPartnerID elements)

  • One of the following three identifiers for the second business partner:

    • Unique identifier (UUID element)

    • Internal identifier (InternalID element)

    • The data required for the identification node (PartyIdentifierTypeCode and BusinessPartnerID elements)

  • The business process chain assignment (BusinessProcessChainAssignment element)

    For more information, see Business Process Chain Assignment .

  • One of the following three types of relationship with the associated data:

    • ContactPerson

    • Shareholder

    • OtherRelationshipCategory

  • The validity period for the relationship (ValidityPeriod element).

  • In addition, the specification of the confirmation view (ConfirmationViewSpecification node) can also be provided. This determines the nodes that are included in the confirmation message.

If the requested indicator (RequestedIndicator element) is set to true for one or more of the following nodes, the data from the corresponding node(s) is included:

  • FirstBusinessPartnerCommon

  • FirstBusinessPartnerIdentification

  • SecondBusinessPartnerCommon

  • SecondBusinessPartnerIdentification

  • BusinessProcessChainAssignment

  • ContactPerson

  • Shareholder

  • OtherRelationshipCategory

If the requested indicator (RequestedIndicator element) is set to false (default value), no data is returned for the corresponding node.

This operation triggers a confirmation message from its counterpart operation. The confirmation message contains information about whether the request was successful.

For more information about the bulk operation pattern, see Bulk, Bundle, Collection.

Error Handling

For information about the main error messages recorded in the log of the response message, see Confirm Business Partner Relationship Bulk Creation.

For more information, see Error Handling in Financial Services .

Forward Error Handling

This operation supports Forward Error Handling (FEH). The Error and Conflict Handling (ECH) component name is FS-BP and the ECH process name is MIF_RLC001. For more information about ECH, see Error and Conflict Handler (CA-FS-ECH).

Message Types
  • BusinessPartnerRelationshipFSBulkCreateRequest

Notes on SAP Implementation

Authorization

The user must be authorized to create business partner relationships. The following authorization objects are checked in the SAP back-end system:

  • B_BUPA_RLT

  • B_BUPR_BZT

Enhancements

You can find the Business Add-In (BAdI) BAdI for CreateBusinessPartnerRelationshipAsBulk(FSBPR_FND_SE_CREATE_AS_BULK) for this operation through Transaction SIMGH. Choose Start of the navigation path BAdIs for XI Interfaces Next navigation step Mapping and Processing of Service Enhancements Next navigation step Business Partner Relationship End of the navigation path. Depending on the application, the BAdIs for XI Interfaces structure could also be available in the IMG of your system such as SAP Policy Management.