Show TOC

Update Business Partner as BulkLocate this document in the navigation structure

Definition

An operation that updates one or more business partners.

Technical Data

Entity Type

Service Operation

Release State

Released

Technical Name

BusinessPartnerDataManagementBusinessPartnerIn.UpdateBusinessPartnerAsBulk

Mode

Asynchronous

Idempotency

Not applicable

Change/Update Behavior

field-based updates and explicit list item updates/deletions

Business Context

The data for each business partner to be updated can be as comprehensive as required. For example, it can include name, address, bank details, employment, rating, financial statement, and credit standing. The operation can be used for business partners of any type, that is, persons, organizations, or groups.

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

Related Operations

Business-Related Operations

Not relevant

Compensation Operation

Not relevant

Features

For each request to update a business partner in the mass bulk request the following information is required:

  • The business process chain assignment (BusinessProcessChainAssignment element)

    For more information, see Business Process Chain Assignment.

  • An identifier (UUID or InternalID element)

  • A list complete transmission indicator for a specific node (e.g.:addressInformationListCompleteTransmissionIndicator)

    When set to true this indicates that all records sent for the specific node are to replace those in the database.

Note that if data is sent to the Common node, the following are mandatory:

  • An indicator of whether correspondence in braille is required or not (CorrespondenceBrailleRequiredIndicator element)

  • An indicator of whether correspondence in large print is required or not (CorrespondenceLargePrintRequiredIndicator element)

  • An indicator of whether the business partner is a natural person or not (NaturalPersonIndicator element)

  • An indicator of whether the business partner is a VIP or not (VIPIndicator element)

  • An indicator of whether the business partner is undesirable as a customer or not (CustomerUndesirableIndicator element)

  • The action code for nodes that are to be updated (ActionCode attribute)

  • The change state ID (ChangeStateID element)

    For more information, see The ChangeStateID in Update Services.

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, then the data from the  corresponding node(s) is included:

  • BusinessProcessChainAssignment

  • Common

  • AddressInformation

  • CommunicationData

  • Role

  • BankDetails

  • PaymentCardDetails

  • IndustrySector

  • Identification

  • TaxNumber

  • GeneralProductTaxExemption

  • TextCollection

  • CreditRating

  • CreditStanding

  • Occupation

  • FinancialStatement

  • Alias

  • TaxCompliance

  • BankRegulations

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 Bulk Update.

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

Message Types
  • BusinessPartnerFSBulkUpdateRequest_V1

Notes on SAP Implementation

Authorization

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

  • B_BUPA_GRP

  • B_BUPA_PGM

  • B_BUPA_RLT

  • B_CARD_SEC

  • B_CCARD

Enhancements

You can find the Business Add-In (BAdI) BAdI for UpdateBusinessPartnerAsBulk(FSBP_FND_SE_UPDATE_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 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.