An operation that updates one or more business partners.
Entity Type |
Service Operation |
Released |
|
BusinessPartnerDataManagementBusinessPartnerIn.UpdateBusinessPartnerAsBulk |
|
Asynchronous |
|
Not applicable |
|
field-based updates and explicit list item updates/deletions |
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
Counterpart Operation
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.
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).
BusinessPartnerFSBulkUpdateRequest_V1
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 . 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.