Skip to Content
Technical Articles
Author's profile photo Varun Venkat

Multiple address handling for sales documents in SAP S/4HANA Cloud

As an S/4HANA Cloud consultant, you might come across a scenario where sales documents need to contain varying data for the different partner roles of a certain business partner. In SAP S/4HANA Cloud, multiple address handling allows you to maintain different addresses for a single business partner, depending on the partner role. Some of the commonly used partner roles in sales documents are:

  • Sold-to Party
  • Ship-to Party
  • Bill-to Party
  • Payer

To illustrate a common business example, a business partner that manages multiple production/storage locations can have shipping addresses that differ from the standard sold-to address of the business partner. In this blog, we will look at the steps to set up multiple address handling for the different partner roles mentioned above in SAP S/4HANA Cloud.

Prerequisite: Enable Multiple Address Handling in Customizing

The prerequisite to use the multiple address handling capability is to enable this in the customizing of your system. For this, open the “Configure Your Solution” app and type in “Address handling” into the search field. Navigate into the entries highlighted in Figure 1.


Figure 1

After clicking into the Business Partner item, activate the configuration step 17 ‘Activate Multiple Address Handling for Customer Master Data in SAP BP’ as shown in Figure 2.


Figure 2

Analogous to this, activate configuration step 7 ‘Activate Multiple Address Handling in SD Documents Using SAP BP’ for the Partner Determination item (Figure 3).


Figure 3

Now that the configuration is out of the way, let’s dive into how to actually assign multiple addresses to the various partner roles.

Select a business partner

Open the “Manage Business Partner” app and search for a business partner that you want to use for test purposes. For this blog, I will be using the BP 10100009 (Inlandskunde DE 9). Navigate into the Business Partner view.

Create a new address

In the Address header under the section ‘Address Details’, click the “Create” Button to create a new address entry. Make sure you are in Edit mode to be able to do this.


Create new address

Now click on the newly created blank row to go into the item level. Fill out the address fields such as ‘Country’, ‘City’, ‘Street’ etc.

Add a usage type for the new address

Now scroll down to the ‘Address Usage’ section. This is the crucial step in the whole process. Click on the “Create” button here to add a new address usage line. Pick values for the ‘Valid From’ and ‘Valid To’ fields and for Address Type, choose Delivery Address (SHIP_TO). This will indicate to the system that the newly created address in the previous step will be used for the Ship-To party partner role.


Add usage type


Apply the changes and save the draft to persist your changes. You can repeat this process (creating a new address and assigning an address usage) for other partner roles such as Bill-to party and Payer as well.

Use the multiple address handling in your sales documents

Having completed the setup, we can now run a test to see how the multiple address handling comes into effect. Open the “Create Sales Orders – VA01” app. Choose the Order type “OR” (Standard Order) and the sales organization (1010 in my case) of the BP you are testing with. Hit Enter.

In the Sold-to Party field, enter your BP ID and hit enter. You will now see one or multiple popups, where you can select the address value to be used for the respective partner role. After this step, fill out values for the fields Customer reference and Customer reference date. After hitting enter, you will notice that the correct address for the Ship-to Party has automatically been determined based on the address usage that was assigned earlier.

To view the address of all the partner roles, go into the header level of the Sales order by clicking on the icon next to the ‘Cust. Ref. Date’ field (document with magnifying glass symbol). In the Partners tab here, you can now see an overview of the addresses for the various partner roles.


Multiple address handling in SAP S/4HANA Cloud is a powerful feature that allows you to maintain different addresses for a single business partner, depending on the partner role. By following the steps outlined in this blog, you can set up multiple address handling for different partner roles in SAP S/4HANA Cloud and ensure that your address data is organized, role-based and accurate.

For more resources related to S/4HANA Cloud, make sure to follow the respective community page and blog feed.


Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Harish Chinnakotla
      Harish Chinnakotla

      It's working, Thank you

      Author's profile photo Varun Venkat
      Varun Venkat
      Blog Post Author

      Hi Harish, thanks for the feedback. Glad you found it useful!

      Author's profile photo Osman Bozdogan
      Osman Bozdogan

      Thanks for the post Varun!

      You post was helpful!