Updating Customer in SAP S/4HANA Public Cloud via PATCH Requests

SAP S/4 HANA Public Cloud allows customers to update their information via HTTP adapter using the PATCH method. The API_BUSINESS_PARTNER service is the primary resource for business partners (customers), and customers can modify their core business partner information, sales area data, and customer address by sending targeted updates to the respective endpoints.

SAP S/4HANA Public Cloud offers a robust platform for businesses to manage their customer data efficiently. One of the key features of this platform is the ability to update customer information via the OData HTTP adapter using the PATCH method. This capability allows businesses to make targeted updates to various aspects of their customer profiles, enhancing data accuracy and customer service.

The primary resource for managing customer data in SAP S/4HANA is the API_BUSINESS_PARTNER service. This service enables customers to modify core business partner information, sales area data, and customer addresses through specific API endpoints. The PATCH method is used to make these updates, ensuring that only the necessary data is changed while the rest remains intact.

Updating Core Business Partner Information
To update fundamental details about a customer, such as their name, businesses can use the following API endpoint:
```
/sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartner('CUSTOMER-NUMBER')
```
Replace `CUSTOMER-NUMBER` with the actual customer ID. The request body should include only the fields that need to be updated. For example, to change the customer's first name and last name, the request body would be:
```json
{ "FirstName": "FIRST NAME", "LastName": "LAST NAME" }
```

Updating Sales Area Data
Sales area data is crucial for sales processes, defining how a customer interacts with the sales organization, distribution channel, and division. The API endpoint for updating sales area data is:
```
/sap/opu/odata/sap/API_BUSINESS_PARTNER/A_CustomerSalesArea(Customer='CUSTOMER-NUMBER',SalesOrganization='SALES-ORG',DistributionChannel='DISTR-CHANNEL',Division='DIVISION')
```
For example, to update the Customer Group for a specific customer, the request body would be:
```json
{ "CustomerGroup": "CUSTOMER-GROUP" }
```

Updating Customer Address
Updating customer addresses involves a two-step process. First, retrieve the AddressID by querying the business partner:
```
API Endpoint (GET Request): /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartner('CUSTOMER-NUMBER')$expand=to_BusinessPartnerAddress
```
Once the AddressID is obtained, use it to update the address details:
```
API Endpoint: /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartnerAddress(BusinessPartner='CUSTOMER-NUMBER',AddressID=ADDRESS-ID)
```
The request body for updating the address would include the new address details:
```json
{ "Country": "COUNTRY", "CityName": "CITY", "StreetName": "STREET", "HouseNumber": "HOUSE-NUMBER", "PostalCode": "ZIP-CODE" }
```

Updating Customer Email
Updating customer email addresses also requires a two-step process. First, retrieve the current email address details:
```
API Endpoint: /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartner('${property._CustomerNumber}')$expand=to_BusinessPartnerAddress/to_EmailAddress
```
Once the necessary details are obtained, use them to update the email address:
```
API Endpoint: /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_AddressEmailAddress(AddressID='ADDRESS-ID',Person='PERSON',OrdinalNumber='ORDINAL-NUMBER')
```
The request body for updating the email address would include the new email address:
```json
{ "EmailAddress": "NEW@EMAIL.COM" }
```

By leveraging the OData HTTP adapter and the PATCH method, businesses can efficiently manage and update their customer data within SAP S/4HANA Public Cloud. This capability not only enhances data accuracy but also streamlines customer service processes, providing a better overall experience for customers.

References:
[1] https://community.sap.com/t5/technology-blog-posts-by-members/updating-customer-in-sap-s-4-hana-public-cloud-via-odata-http-adapter/ba-p/14109511