Show TOC

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

Definition

An operation that cancels multiple business partner relationships in Business Partner Data Management.

Technical Data

Entity Type

Service Operation

Release State

Released

Technical Name

BusinessPartnerRelationshipBulkCancelRequest_In

Mode

Asynchronous

Idempotency

No

Change/Update Behavior

Not applicable
Business Context

This operation allows the service consumer to cancel one or more specified business partner relationships. Examples of business partner relationships are contact person, shareholder, and marriage relationship.

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

Related Operations

Business-Related Operations

Not applicable

Compensation Operation

  • Create Business Partner Relationship as Bulk

Counterpart Operation

  • Confirm Business Partner Relationship Bulk Cancellation

Features

To use this operation, the following information is needed:

  • The identifier of the change state (ChangeStateID element)

    This is needed to ensure that cancellations are not performed using old, and therefore obsolete, data (optimistic lock concept).

    For more information, see The ChangeStateID in Update Services .

  • 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)

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

    • Unique identifier (UUID element)

    • Internal identifier (InternalID element)

  • The business process chain assignment (BusinessProcessChainAssignment element)

    For more information, see Business Process Chain Assignment .

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 Cancellation .

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_RLC003. For more information about ECH, see Error and Conflict Handler (CA-FS-ECH).

Notes on SAP Implementation

Authorization

The user must be authorized to cancel 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 CancelBusinessPartnerRelationshipAsBulk(FSBPR_FND_SE_CANCEL_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.