An operation that creates one or many specified business partner relationships.
Entity Type |
Service Operation |
Released |
|
BusinessPartnerDataManagementBusinessPartnerRelationshipIn.CreateBusinessPartnerRelationshipAsBulk |
|
Asynchronous |
|
Not applicable |
|
Not applicable |
For more information about the business context, see the Business Partner Relationship business object.
Related Operations
Business-Related Operations
Not applicable
Compensation Operation
Counterpart Operation
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.
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).
BusinessPartnerRelationshipFSBulkCreateRequest
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 . 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.