82a0a579eac14c53af9724ac64dbd3ab

Download as pdf or txt
Download as pdf or txt
You are on page 1of 62

Upgrade Master Guide | PUBLIC

Document Version: 1.0.0 – 2023-09-14

Integration with Sales Orders in SAP S/4HANA


Cloud
© 2023 SAP SE or an SAP affiliate company. All rights reserved.

THE BEST RUN


Content

1 Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3 Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

4 Configuration in SAP CPQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8


4.1 Create Communication User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
4.2 Enable the Integration with SAP Cloud Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
4.3 Enable the Integration with SAP S/4HANA Cloud. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
4.4 Enable the Integration with SAP Variant Configuration and Pricing . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.5 Configuration in SAP Event Mesh for sending quote from SAP CPQ to SAP S/4HANA Cloud. . . . . . . . 10
4.6 Add Subscription to Event. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.7 Pricing Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Create Market. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Discounting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Discounting Priorities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Pricing Procedure Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.8 Configure Workflow in SAP CPQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Enable Workflow Actions and Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.9 Partner Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Set Sold-To Party to Mandatory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Partner Functions in SAP CPQ Quote. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Maintain Business Partner Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.10 Product Replication Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Products: Types and Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Maintain Product Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Maintain Products Categories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.11 Enable Quote and Item Comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Make the Fields Visible on Quotes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Make the Fields Editable on Quotes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

5 Configuration in SAP S/4HANA Cloud. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21


5.1 Maintaining Trust between SAP Cloud Integration (SCI) and SAP S/4HANA Cloud. . . . . . . . . . . . . . .21
Download the SAP Cloud Integration Certificate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Upload SAP Cloud Integration Certificate to SAP S/4HANA Cloud. . . . . . . . . . . . . . . . . . . . . . . .21
5.2 Configuring SAP Master Data Integration for Business Partners Replication. . . . . . . . . . . . . . . . . . . 22
Service Instance Creation for Business Partner Read and Replicate. . . . . . . . . . . . . . . . . . . . . . 22

Integration with Sales Orders in SAP S/4HANA Cloud


2 PUBLIC Content
Setting up Generic Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Create Outbound Destinations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Create Distribution models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.3 Create Communication User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

5.4 Create Communication System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Create Communication System for SAP Cloud Integration Connections. . . . . . . . . . . . . . . . . . . 24

Create Communication System for SAP Master Data Integration Connections. . . . . . . . . . . . . . .26

5.5 Create Communication Arrangements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Create Communication Arrangement Using Communication Scenario SAP_COM_0288 for


Sales Order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Create Communication Arrangement Using Communication Scenario SAP_COM_0008 for


Business Partner Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Create Communication Arrangement Using Communication Scenario SAP_COM_0009 for


Product. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

5.6 Pricing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

Condition Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

Pricing Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Pricing Procedure Determination. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

6 SAP Cloud Integration Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6.1 Creating User Credentials in SAP Cloud Integration System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6.2 View Prepackaged integration flows using SAP Cloud Integration Web UI. . . . . . . . . . . . . . . . . . . . . 46

6.3 Copy the Package for configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

6.4 Configuration of the Integration flow “Create Sales Order from SAP CPQ in S4HANA
Cloud_Quote2.0_SOAP”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

6.5 Configuration for integration flow “Replicate Sales Order status from SAP S4HANA to SAP CPQ
Quote 2.0”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

6.6 Configuration for integration flow “Replicate Product from SAP S/4HANA”. . . . . . . . . . . . . . . . . . . 50

6.7 Configuration for integration flow “Replicate Business Partner from SAP Master Data Integration”
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

6.8 Value Mapping for SAP CPQ integration with SAP S/4HANA Cloud. . . . . . . . . . . . . . . . . . . . . . . . . 53

7 Data Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

7.1 Business Partner (Customer Master). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

7.2 Product Master. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

7.3 Verify Products in SAP CPQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

7.4 Verify Business Partners in SAP CPQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

8 Master Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Integration with Sales Orders in SAP S/4HANA Cloud


Content PUBLIC 3
1 Purpose

Learn how to configure the basic integration between SAP CPQ and sales orders in SAP S/4HANA Cloud using
SAP Cloud Integration.

SAP CPQ can be integrated with SAP S/4HANA Cloud to provide a workflow for users to automatically create a
sales order in SAP S/4HANA Cloud whenever a SAP CPQ quote is sent to SAP S/4HANA Cloud. The follow-up
documents are then created in SAP S/4HANA Cloud automatically.

 Note

The setup instructions in this guide only describe the basic authentication. Nevertheless, a certificate-
based authentication might also be possible, depending on the system preconditions.

Limitations
• This integration works only with the Quote 2.0 engine in SAP CPQ.
• This integration supports only simple products and single-level configurable products.

Data Transfer in Integration Flow


• The integration flow is triggered by the Place Order event in an SAP CPQ quote, that is, when the user
finishes the quote process and sends the final quote to the backend, which in turn creates a sales order.
• SAP Variant Configuration and Pricing is used as default mechanism for configuring and pricing sales
products in SAP CPQ.
• If the quote item is configurable, the quote data from SAP CPQ and the configuration data from SAP
Variant Configuration and Pricing are combined and sent to SAP S/4HANA Cloud. Otherwise, only the
standard product information and pricing details are transferred to SAP S/4HANA Cloud.
• Products and attributes that have not been replicated from SAP S/4HANA Cloud, but created directly in
SAP CPQ, are ignored in the integration flow.

Integration with Sales Orders in SAP S/4HANA Cloud


4 PUBLIC Purpose
2 System Requirements

Learn about the system requirements for an integration between SAP CPQ and sales orders in SAP S/4HANA
Cloud.

You must fulfill the following system requirements for a successful configuration:

1. SAP S/4HANA Cloud


2. SAP CPQ
3. SAP Business Technology Platform
1. SAP Cloud Integration
You can find the runtime URL for the SAP Cloud Integration tenant in
the SAP Cloud Integration provisioning email (for example, https://<tenant
ID>.cfapps.<region>.hana.ondemand.com/).
2. SAP Variant Configuration and Pricing
Ensure that your SAP Variant Configuration and Pricing instance is integrated with SAP S/4 HANA
Cloud and that configured products are replicated between the two systems.
3. SAP Master Data Integration
4. SAP Event Mesh

Integration with Sales Orders in SAP S/4HANA Cloud


System Requirements PUBLIC 5
3 Prerequisites

Learn about the prerequisites for an integration between SAP CPQ and sales orders in SAP S/4HANA Cloud.

 Note

You can only set up this integration using Quote 2.0, not Quote 1.0.

SAP CPQ

• You have enabled Quote 2.0 and business partners in the SAP CPQ tenant.
• You have configured the application parameter Allowed origins for the CORS filter. If one or more domains
are entered in this field, only the API calls from these domains are allowed. This means: If the parameter
is not set to *, you must enter both the URL of your tenant and the URLs of the integrated applications to
enable API communication. Values are separated with a semicolon (“;”).

SAP S/4HANA Cloud

• You have a business user that contains the SAP_CORE_BC_COM (Communication Management) business
catalog, for example, a user based on the the SAP_BR_ADMINISTRATOR (Administrator) business role
template.
The business catalog contains the following apps:
• Maintain Communication Users
• Communication Arrangements
• Communication Systems
For more information about business users and business roles, see Identity and Access Management.
• The following scope items are active in your system:
• Sell from Stock (BD9)
• Make-to-Order Production with Variant Configuration (1YT)
• Business Event Handling (1NN)
For more information about these sope items, see SAP Signavio Process Navigator .
Depending on your configuration environment for SAP S/4HANA Cloud, choose one of the following
options to check the status:
• Manage Your Solution View Solution Scope
• SAP Central Business Configuration Explore Activities . Search for Define Scope, and choose
Open.
If a scope item hasn't been activated yet, please create a support ticket on component XX-S4C-OPR-SRV
to request the activation.

For any integration issues related to SAP S/4HANA Cloud, please create a support ticket on component
CA-GTF-INT.

Others

• You have contacted the Network Security team to prepare the network environment across different
systems and to check security aspects.

Integration with Sales Orders in SAP S/4HANA Cloud


6 PUBLIC Prerequisites
• SAP CPQ and SAP S/4HANA Cloud are synchronized for products (that is, materials) master, business
partners, and markets. Products are replicated using SAP Cloud Integration. Products that have not been
replicated from SAP S/4HANA Cloud, but are created directly in SAP CPQ, are not replicated in the
integration flow. Therefore, you must set up the products and business partner replication from SAP S/
4HANA Cloud to SAP CPQ.

 Note

Markets are not replicated, so you must create them manually in SAP CPQ. Sales organizations in SAP
S/4HANA Cloud correspond to markets in SAP CPQ.

• Your SAP Cloud Integration tenant has been provisioned. For more information, see SAP Cloud Integration.

Integration with Sales Orders in SAP S/4HANA Cloud


Prerequisites PUBLIC 7
4 Configuration in SAP CPQ

This chapter describes the configuration that needs to be done in SAP CPQ system to integrate it with SAP
S/4HANA Cloud.

4.1 Create Communication User

A communication user needs to be created in SAP CPQ System, which will be used in SAP Cloud Integration for
basic authentication to SAP CPQ.

1. Log on to the SAP CPQ system using an Administrator User.


2. Choose Setup in the left menu bar and choose Setup.
3. In left navigation bar, select Users under Users.
4. Choose Add New User.
5. Enter the First Name, Last Name and Email for Communication User under General tab.
6. Enter Username, for example <COM_USER_SAP CPQINT>.
7. Choose User Type, for example as <Sales>.
8. Set the Administrator flag.
9. Select Company.
10. Choose Save.

 Note

After creating the user, the communication user will receive 2 E-Mails: One for the SAP CPQ user
registration and one for the SAP CPQ password creation. Login to SAP CPQ system using the above
username and create the password. The same password is to be used in SAP Cloud Integration at the time
of creating user credentials for SAP CPQ.

4.2 Enable the Integration with SAP Cloud Integration

1. Login to your SAP CPQ system using an Administrator User.


2. Choose Setup Setup in the left menu bar.
3. Under Providers in the left navigation bar, select SAP Integrations.
4. From the General section, select Mandatory Settings.
5. Activate Enable SAP Cloud Integration.
6. Expand the Authentication Mode list and select BasicAuth.
Enter the credentials of the SAP Cloud Integration User (Integration username and Integration password).

Integration with Sales Orders in SAP S/4HANA Cloud


8 PUBLIC Configuration in SAP CPQ
7. In the REST API base URL address, enter the SAP Cloud Integration URL and a suffix /http to connect to
http adapter.
8. Choose Save.

4.3 Enable the Integration with SAP S/4HANA Cloud

To manage the pricing procedures, enable the SAP S/4HANA Cloud integration in SAP CPQ.

Context

When the integration is enabled, administrators see new settings in the setup:

• New section Pricing/Calculations Pricing Procedures . In this section, administrators can map pricing
procedure properties to the corresponding fields in the quote or the quote item.
• New column Synced from Back Office in the product grid ( Setup Product Catalog Product ). This
column indicates if a product is replicated from S/4HANA Cloud or is created in SAP CPQ.

Procedure

1. Login to your SAP CPQ system using an Administrator User.


2. Choose Setup Setup in the left menu bar.
3. Under Providers in the left navigation bar, select SAP Integrations.
4. Under Back End, select SAP S/4HANA / ERP.
5. Activate Enable SAP S/4HANA / ERP Integration.
6. Choose Save.

4.4 Enable the Integration with SAP Variant Configuration


and Pricing

The integration with SAP Variant Configuration and Pricing is to be enabled as described in the documentation.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP CPQ PUBLIC 9
4.5 Configuration in SAP Event Mesh for sending quote
from SAP CPQ to SAP S/4HANA Cloud

The prepackaged integration content uses the SAP Event Mesh to process events.For the initial setup of SAP
Event Mesh please refer to the link to create the SAP Event Mesh Service Instance. The following steps describe
how to enable the event processing in SAP Event Mesh.

1. Create Service Key: In the BTP Cockpit navigate to the details of the Event Mesh instance and Create a
service key. Provide a service key name, leave the field for the parameters in JSON format empty and
choose Create
2. Create Queue for the Business Solution Quote events in SAP Event Mesh:
To process the events from SAP CPQ a queue needs to be created in SAP Event Mesh.
1. Navigate to your Cloud Foundry space and select your SAP Event Mesh service instance.
2. In the left pane, select Service Instances.
3. Choose Open Dashboard under the list of Actions that correspond to your SAP Event Mesh service
instance.
4. In the messaging administration page, select Message Clients, select the Message Client that was
created when the instance was created in SAP BTP cockpit
5. Select the Queues tab and choose the Create Queue button
6. Enter the queue name, leave all other values as suggested

4.6 Add Subscription to Event

1. Login to your SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. Select Subscription to Events under Providers in left navigation bar.
4. Choose Add new Subscription to Event button.
5. Enter name of the subscription to event to send sales order to SAP S/4HANA Cloud through Event Mesh,
for example <SalesOrder_to_S4HANACloud_via_EventMesh> in Name field.
6. Enter a short description, for example <Send Sales Order to SAP S/4HANA Cloud via SAP
Event Mesh> in Description.
7. Enter the endpoint URL of the SAP Event Mesh Queue in Webhook URL field.
8. Select POST under Webhook HTTP method.
9. Select QuoteEvent under Event name.
10. Select Quote Event as OnPlaceOrder.
11. Select Authentication type as OAuth.
12. Enter the Authentication URL from the service key of SAP Event Mesh instance.
13. Choose Authentication HTTP method as POST.
14. In the Client ID field, add for example Client ID from the SAP Event Mesh service key.
15. In the Client Secret Field, add for example Client Secret from the SAP Event Mesh Service
key .

Integration with Sales Orders in SAP S/4HANA Cloud


10 PUBLIC Configuration in SAP CPQ
16. Under Custom Headers enter key as x-qos and Value as 1.
17. Choose Save.
18. Choose Add new Subscription to Event button.
19. Enter name of the Subscription to event to update Sales Quote, for example <UpdateSalesQuote> in
Name field.
20.Enter a short description, for example <Update Sales Quote> in Description.
21. Enter the endpoint URL of Integration flow to update quote in Webhook URL field.
22. Select POST under Webhook HTTP method.
23. Select QuoteEvent under Event name.
24. Select Quote Event as UpdateSalesQuote.
25. Select Authentication type as Basic.
26. Enter the username of SAP Cloud Integration user in Username field.
27. Enter the password of SAP Cloud Integration user in the Password field.
28. Choose Save.
29. Choose Add new Subscription to Event button.
30.Enter name of the Subscription to event to update Sales Quote on Save Quote in Name field, for example
<UpdateSave>
31. Enter a short description in Description.
32. Enter the endpoint URL of the Integration flow to update quote in Webhook URL field.
33. Select POST under Webhook HTTP method.
34. Select QuoteEvent under Event name.
35. Select Quote Event as OnQuoteSaved.
36. Select Authentication type as Basic.
37. Enter the username of SAP Cloud Integration user in the Username field.
38. Enter the password of SAP Cloud Integration user in the Password field.
39. Choose Save.

4.7 Pricing Setup

Context

The default pricing for the products coming from SAP S/4HANA Cloud to SAP CPQ is the SAP Variant
Configuration and Pricing. Alternatively, you can also use the CPQ pricing instead.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP CPQ PUBLIC 11
Procedure

Steps to map the general attributes after connecting SAP CPQ to SAP Variant Configuration and Pricing:

1. Login to your SAP CPQ system using an Administrator User.


2. Choose Setup Setup in the left menu bar.
3. Under Providers in the left navigation bar, select SAP Integrations.
4. Under Back End, select General Attribute Mappings.
5. Under Global Attributes, fill out the following fields:
1. In Country/Region Code, enter a two-character country/region code for example, <US>.
A country/region code should be used only if Variant Configuration runs product rules that rely on the
country/region code. This is not a mandatory setting. This value is used for the execution of product
rules and pricing procedure evaluation in SAP Variant Configuration and Pricing. If it is not used for
either of those, please skip this setting.
2. In Division, enter a two-character code representing the SAP S/4HANA Cloud division, for example, 01.
3. In Pricing Procedure Name, enter the name of the pricing procedure.
4. In Pricing Procedure Name for Catalog Prices, enter the name of the pricing procedure used for
obtaining base price values for synchronized products and displaying them in the Catalog. In a typical
use case, this pricing procedure contains the base price calculation. It is less complex than the pricing
procedure used for obtaining both the base price and variant condition values.
5. In Document Pricing Procedure Name, enter the value that will be used for determining which pricing
procedure is used on the quote when pricing conditions are mapped in SAP CPQ.

For further details, see Define SAP General Attribute Mappings.

4.7.1 Create Market

A market is created in SAP CPQ against every Sales Organization of SAP S/4HANA Cloud system. This will help
in pricing determination in Quote in SAP CPQ system.

Procedure

1. Login to your SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. In left navigation bar, select Markets under Pricing/Calculations.
4. Choose Add new button.
5. Enter the Sales Organization of SAP S/4HANA Cloud system for example, <2020> in Market Code field.
6. Enter for example, <Sales Org US> in Market Name field.
7. Select for example, <USD> as Currency.
8. Enter Market Factor field as 1.
9. Choose Save.
10. In left Navigation bar, select Market Visibility under Pricing/Calculations.
11. Choose Add New button.

Integration with Sales Orders in SAP S/4HANA Cloud


12 PUBLIC Configuration in SAP CPQ
12. Select the market name created above for example, <Sales Org US> under Market Name in Step 2
section.

 Note

Step 1 section can be left empty

13. In Step 3 section, enter Visibility Condition as 1.


14. Choose Save.

4.7.2 Discounting

One of the major functionalities of SAP CPQ is on the fly discounts based on products, product types, product
categories, users and user types.

You can setup discounting in Quote in your SAP CPQ system following below procedure. This chapter is
optional.

Procedure

1. Login to SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. In left navigation bar, select Discounts under Pricing/Calculations.
4. Choose Add New button.
5. Choose Select button to maintain USER TYPE as Sales under Step 1 section

 Note

The above selection will allow users with user type ‘Sales’ to give discounts on the quote which we will
be defining in next step. Any condition for discount selection with User, User Type, Product, Product
Type or Category can be created.

6. Maintain Maximum Value for Discount as 10. It will allow Sales User to give maximum of 10 percent
discount. Above 10 percent discount will be subject to approval.
7. Under Step 3 section, enter Condition as 1. Conditions can also be created using scripting languages.
8. Choose Save.

4.7.3 Discounting Priorities

In SAP CPQ, discount to customers can be provided in Quote based on User, User Type, Product, Product Type
or Product Category conditions.

There might be a case with two or more valid conditions. Priority of the conditions is maintained as below. This
chapter is optional.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP CPQ PUBLIC 13
Procedure

1. Login to SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. In left navigation bar, select Discounting Priorities under Pricing/Calculations.
4. Select Rank as 1 for User Group to have highest priority.
5. Further select Rank for User as 2, Category as 3, Product as 4 and Product Type as 5.
6. Choose Save.

4.7.4 Pricing Procedure Mapping

SAP CPQ administrators can map pricing conditions from pricing procedures in SAP S/4HANA Cloud to quote
item or header fields in SAP CPQ. That way, the prices from SAP CPQ are sent to the back-end system when an
order is placed.

Pricing procedures exist in the back-end system, but they need to be specified manually in SAP CPQ for which
steps from the link are to be followed.

4.8 Configure Workflow in SAP CPQ

The default status of the quote is Preparing and changes to Order Confirmation Pending when the Place Order
action is executed. In that moment SAP CPQ publishes event and SAP Cloud Integration creates Sales Order in
S/4HANA Cloud. To support errors that might occur in quote data replication process, SAP Cloud Integration
implements error handling logic which requires additional workflow settings in SAP CPQ. The error handling
requires the setup of additional quote status as an interim status between Preparing and Order Placed.

From status Preparing, the status should change to Order Confirmation Pending if the Place Order action is
executed. From Order Confirmation Pending, there are two options:

• If SAP S/4HANA Cloud returns an error, the quote goes to status Order Failed. From here, by executing the
Place Order action, the user can go back to status Order Confirmation Pending. This status allows to make
necessary adjustments and execute Place Order action again
• If SAP S/4HANA Cloud does not return an error, the quote goes to status Order Placed.

When the SAP S/4HANA Cloud integration is enabled in SAP CPQ, the system will automatically make the
following adjustments in the Workflow created.

• Order Confirmation Pending and Order Placed statuses have been created in the system, if they were not
available before.
• The Order Status Update action has been set up to lead from the Order Confirmation Pending status to
Order Placed when the SAP S/4HANA Cloud integration is enabled.

1. Login to SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.

Integration with Sales Orders in SAP S/4HANA Cloud


14 PUBLIC Configuration in SAP CPQ
3. In left navigation bar, select Workflow under Workflow/Approval.
4. In the My Quotes tab, in the grid, Left side, vertical statuses are start statuses and Horizontal, top statuses
are target statuses.
5. Find the crossing of Preparing in vertical column and Order Confirmation Pending in horizontal row and
Select it. Scroll to action Place Order and select the checkbox in Selected column.
6. Choose Save.
(This means once, an order is placed, the quote status changes from Preparing to Order Confirmation
Pending)
7. Find the crossing of Order Confirmation Pending in vertical column and Order Placed in horizontal row and
select it. Scroll to action Order Status Update and select the checkbox in Selected column.
8. Choose Save.
9. Find the crossing of Order Failed in vertical column and Order Confirmation Pending in horizontal row and
select it. Scroll to action Place Order and select the checkbox in Selected column.
10. Choose Save.

SAP CPQ Quote is sent via SAP Cloud Integration to SAP S/4HANA Cloud. The success or error message
from SAP S/4HANA Cloud are received asynchronously and sent back to SAP CPQ via SAP Cloud Integration
(through the Integration flow Sales Order Status from SAP S/4HANA Cloud to SAP CPQ). Errors which are
returned from SAP S/4HANA Cloud are stored in SAP CPQ quote header with a generic error text. A detailed
error description is visible for administrators in the SAP CPQ log. The reason for this is that error messages are
returned from SAP S/4HANA Cloud in the language the user used for integration.

4.8.1 Enable Workflow Actions and Permissions

The action for creating Sales Order in SAP S/4HANA Cloud needs to be enabled in SAP CPQ.

1. Login to SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. In left navigation bar, select Workflow under Workflow/Approval.
4. In My Quotes tab, find the crossing of Preparing in vertical column and Order Confirmation Pending in
horizontal row and Choose it. Scroll to action Place Order and select the checkbox in Selected column.
5. Choose Save.
6. Find the crossing of Order Confirmation Pending in vertical column and Order Confirmation Pending in
horizontal row and Choose it. Scroll to actions Edit, Place Order, Save Quote and select the checkboxes in
Selected column.
7. Choose Save.
8. Find the crossing of Order Placed in vertical column and Order Placed in horizontal row and select it. Scroll
to actions Edit, History and select the checkboxes in Selected column.
9. Choose Save.

 Note

Copy the same settings from My Quotes to Other Quotes tab as well. To do this, open the Other Quotes tab,
Select My Quotes from the dropdown selection in the Copy from field and choose Copy button.

Enable the workflow permission as below:

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP CPQ PUBLIC 15
1. In left navigation bar, select Workflow Permissions under Workflow/Approval.
2. Under Action Permissions, search for Place Order action.
3. Choose Add button (+), Select the checkbox for the User type Sales.
4. Choose Save.
5. In the same way add the User Type Sales for all the actions like Edit, History, Order Status Update and Save
Quote under Action Permissions.

4.9 Partner Functions

Ensure the below Partner Functions that are supported in the integration between SAP CPQ and SAP S/
4HANA Cloud are available in SAP CPQ. This can be checked in the path Setup Setup Quotes Partner
Functions :

• Sold-To Party (mandatory)


• Ship-To Party
• Bill-To Party
• Payer Party
• Contact Person

4.9.1 Set Sold-To Party to Mandatory

Procedure:

1. Login to SAP CPQ system using an Administrator user.


2. In the left menu bar, choose Setup Setup .
3. In left navigation bar, select Workflow/Approval Required Fields by Workflow Action .
4. The table shows field names on the vertical axis and actions on the horizontal axis.
5. Check the intersection of Sold-to Party and Place Order.
6. Choose Save.

As the Sold-To Party is mandatory, it is useful to display this partner function by default for a new quote.

1. Login to SAP CPQ system using an Administrator User.


2. In the left menu bar, choose Setup Setup .
3. In left navigation bar, select Quotes Partner Functions .
4. Choose Edit for Sold-to party function.
5. Turn on the Show by default on new quotes.

Integration with Sales Orders in SAP S/4HANA Cloud


16 PUBLIC Configuration in SAP CPQ
6. Choose Save.

4.9.2 Partner Functions in SAP CPQ Quote

The SAP S/4HANA Cloud system can only deal with one value per partner function. Therefore, the SAP CPQ
system must not send more than one business partner for each partner function.

Procedure

1. Login to SAP CPQ system using an Administrator user.


2. In the left menu bar, choose Setup Setup .
3. In left navigation bar, choose Quotes Partner Functions .
4. Choose Edit for Sold- to party, Ship-to party, Bill-to party, and Payer partner functions as they should be
transferred to SAP S/4HANA Cloud.
5. Turn on the Can be used only once on quote for each partner function.
6. Choose Save.

 Note

Partner functions can only be replicated from SAP CPQ to SAP S/4HANA Cloud if the partner function key
exists in SAP S/4HANA Cloud and was entered on the More tab in the integration flow configuration.

4.9.3 Maintain Business Partner Permissions

According to the Permission groups maintained in SAP CPQ, the Business Partners can be used in the quote
creation.

Procedure

1. Login to SAP CPQ system using an Administrator user.


2. In the left menu bar, choose Setup Setup .
3. In left navigation bar, choose Business Partners Business Partner Permissions .
4. Choose Add New and maintain the following details:
• Name, for example as <Integration>
• Active is turned on
• User Type, choose for example, <Sales>

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP CPQ PUBLIC 17
• All business partners are visible to selected groups is turned on
5. Choose Save.

4.10 Product Replication Setup

Products: Types and Configuration [page 18]

Maintain Product Types [page 19]

Maintain Products Categories [page 19]

4.10.1 Products: Types and Configuration

The integration of SAP CPQ with the SAP S/4HANA Cloud sales order supports these product types:

• Simple products
• Single-level configurable products

Products are mastered in SAP S/4HANA Cloud and they arrive via SAP Cloud Integration to SAP CPQ. If
single-level configurations are needed, SAP Variant Configuration and Pricing Service attributes are added to
the simple products.

Replicated Data

Products are replicated from SAP S/4HANA Cloud into SAP CPQ using the ImportMaterialsFromERP SOAP
API.

The following product details are sent to SAP CPQ from SAP S/4HANA Cloud via the SAP Cloud Integration:

• name
• system ID
• product type
• part number
• unit of measure
• category

If SAP Variant Configuration is used for product configuration, the attributes (VC characteristics) are
synchronized from SAP Variant Configuration to SAP CPQ via knowledge base synchronization.

Integration with Sales Orders in SAP S/4HANA Cloud


18 PUBLIC Configuration in SAP CPQ
4.10.2 Maintain Product Types

Follow the below procedure to create Product Type in SAP CPQ. This Product Type is mapped from SAP
S/4HANA Cloud Material Group in SAP Cloud Integration middleware. If during product replication a product
type does not exist in SAP CPQ, the product is not replicated, and an error is raised. You have to replicate the
product manually, after you maintained the product type in SAP CPQ.

1. Login to SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. In left navigation bar, select Product Types under Product Catalog.
4. Choose Add New button.
5. Maintain Product Type Name for example as <Metal Processing> and Product Type Rank, for example
<10>.
6. Choose Save.
7. Choose Add New button.
8. Maintain Product Type Name for example, <Electronics> and Product Type Rank for example <11>.
9. Choose Save.

4.10.3 Maintain Products Categories

As there is no product hierarchy in SAP S/4HANA Cloud, the Category is always the same for every replicated
product. The name of this category can be entered during the configuration of the product replication
Integration flow. If you want more than one category for the replicated products, the categories must be
manually created and assigned in the SAP CPQ Setup.

 Note

This Chapter is optional and is required when more than one category is used.

1. Login to SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. In left navigation bar, select Categories under Product Catalog.
4. Choose Add New button.
5. Maintain the Product Category by giving Category Name for example, <Machines>, Category Description
for example, <Machines>, Rank for example, <10> and check the Active checkbox.
6. Choose Save.
7. In left navigation bar, select Products under Product Catalog.
8. Choose Edit on the product for which the product category should be changed.
9. Choose Select Categories and choose the newly created category from the list.
10. Choose Save.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP CPQ PUBLIC 19
4.11 Enable Quote and Item Comments

Users of SAP CPQ and SAP S/4HANA Cloud have the possibility to exchange comments, both global quote
level comments and item level comments. To make this possible for users, you need to make the fields visible
on the quote and to give users the editing permissions.

4.11.1 Make the Fields Visible on Quotes

1. Login to your SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. Select Fields, Calculations, Layout under Quotes in left navigation bar.
4. Go to Layout Permissions tab.
5. Under Select Permission Group, expand for example, <User Types> and select for example, <Sales>.
6. Under Select Layout Items select for example, <Columns> or for example, <Sections> or any
subcategories under each of them.
(The above steps are done to delimit, to which users are the fields visible by selecting their company,
permission group, etc)
7. Choose Save.

4.11.2 Make the Fields Editable on Quotes

1. Login to your SAP CPQ system using an Administrator User.


2. Choose Setup in left menu bar and choose Setup.
3. Select Fields, Calculations, Layout under Quotes in left navigation bar.
4. Go to Field Editability tab.
5. Under Select Permission Group, expand for example, <User Types> and select for example, <Sales>.
6. Under Select Quote Status select for example, <Preparing>
7. Check the checkboxes under Selected fields are editable.
(The above steps are followed to delimit which users have the rights to post comments by selecting their
company, permission group, etc. and then selecting in which quote status is the comment editable.
For example:
• User Description – item-level comment, should be selected for both main and line items.
• Cart Comment – global quote-level comment)
8. Choose Save.

Integration with Sales Orders in SAP S/4HANA Cloud


20 PUBLIC Configuration in SAP CPQ
5 Configuration in SAP S/4HANA Cloud

Learn about the configuration in SAP S/4HANA Cloud for an integration with SAP CPQ.

5.1 Maintaining Trust between SAP Cloud Integration (SCI)


and SAP S/4HANA Cloud

Trust relationships enable you to establish secure connections between known servers whose identity can be
confirmed by a signed certificate. You need to download the certificate of SAP Cloud Integration (SCI) tenant
from a web browser and import it in SAP S/4HANA Cloud. We recommend using Google Chrome.

5.1.1 Download the SAP Cloud Integration Certificate

1. Access SAP Cloud Integration using a URL like the following: https://<tenant management node>/itspaces
2. In the browser address bar, choose the lock icon and then Connection is secure.
3. Choose Certificate is valid.
4. In the Certificate Viewer, go to the Details tab.
5. Choose Export.
6. Enter a file name, choose where to save the file, and save it (for example, in format Base64-encoded ASCII,
single certificate (*pem;*crt)).

5.1.2 Upload SAP Cloud Integration Certificate to SAP S/


4HANA Cloud

1. Log on to your SAP S/4HANA Cloud system.


2. Open the Maintain Certificate Trust List app.

 Note

Check if the certificate for SAP Cloud Integration is already available. If yes, you can ignore the
following steps.

3. Next to the Certificate Trusts table, choose the plus icon to add the certificate.
4. Browse for the SAP Cloud Integration certificate that you downloaded previously and choose Upload.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 21
5.2 Configuring SAP Master Data Integration for Business
Partners Replication

5.2.1 Service Instance Creation for Business Partner Read


and Replicate

1. Go to the SAP BTP subaccount where you want the SAP Master Data Integration instance to be created.
On the left side, under Services, select Instances and Subscriptions.
2. On the top right, choose Create.
3. Select the following:
• Service: Master Data Integration
• Plan: sap-integration
• Runtime Environment: <Cloud Foundry>
• Space: for example <mdi-hybrid-2021>
4. Enter the Instance Name, for example <CG4_100>.
5. Choose Next, and enter the JSON to create the service instance.
6. Choose Next, review, and choose Create.
7. Select the Service Instance that you created and choose Create service Key.
8. Choose Next and then Create.

5.2.2 Setting up Generic Configuration

1. Go to the SAP BTP subaccount where you want the SAP Master Data Integration instance to be created.
On the left side, under Services, select Instances and Subscriptions.
2. On the top right, choose Create.
3. Select the following:
• Service: Master Data Integration
• Plan: sap-integration
• Runtime Environment: <Cloud Foundry>
• Space: for example <mdi-hybrid-2021>
4. Enter the Instance Name, for example <Generic_configuration>.
5. Choose Next, and enter the JSON to create the service instance.
6. Choose Next, review, and choose Create.
7. Select the Service Instance that you created and choose Create service Key.
8. Choose Next and then Create.

Integration with Sales Orders in SAP S/4HANA Cloud


22 PUBLIC Configuration in SAP S/4HANA Cloud
5.2.3 Create Outbound Destinations

1. Navigate to your subaccount and choose Connectivity and then the Destinations tab on the left side.
2. Choose New Destination.

Name Use the name of the business system created ear-


lier, and add the suffix BPOUTBOUND, for example,
<BusinessSystemName_BPOUTBOUND. SAP Master
Data Integration checks for this suffix and sends out data
to these systems.

Type HTTP

URL Use the endpoint URL of the business part-


ner integration flow in SAP Cloud Integra-
tion, for example, <https://<CPI URL>/cxf/
scpmasterdata/bpreplicationtocpq>.

Proxy Type Cloud

Authentication Basic Authentication

User Use the credentials of the SAP Cloud Integration commu-


nication user.

3. Choose Save.
4. Select MDOConsumer as true under Additional Properties.
5. Repeat the above steps to create <Business_System_Name>_BPCONFIRM,
<Business_System_Name>_BPRELOUTBOUND, BP_RELCONFIRM.

5.2.4 Create Distribution models

1. Go the SAP BTP subaccount where you want the SAP Master Data Integration instance to be created. In
the left-hand side, under Services, select Instances and Subscriptions.
2. Select Master Data Integration Application under Subscriptions. (Subscribe to it if already not present)
3. Select Manage Distribution Model.
4. Select Create.
5. Provide a name for the Model and select Business Partner in the Business Object Type dropdown.
6. Set the Continuous distribution checkbox if you want the business partners to be replicated as soon as they
are created/updated.
7. Provide a value for Package Size. Package size specifies up to how many objects are contained in a single
outbound XML message from SAP Master Data Integration to the client system
8. Select Mode as Push.
9. Maintain a Description with Language as English and Item for example as <Replicate Business
Partner>
10. Select the latest stable API under the Provider Interface API as MDI_SOAP_BUSINESS_PARTNER
11. To create a Provider, click the Create button and select the provider: MDI
12. Similarly, for the Consumer, select the target destination. You can select the appropriate Application
Category if required.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 23
13. Set Data filters if required.
14. Activate the Replication Model.

 Note

NOTE: Please refer to the link for any further details related to Business Partner replication through Master
Data Integration.

5.3 Create Communication User

The communication user defined in the SAP S/4HANA Cloud system is used for inbound communication and
processing messages in the system. Technically, the user is needed to call services in SAP S/4HANA Cloud.

1. Log on to your SAP S/4HANA Cloud system.


2. Open the Maintain Communication Users app.
3. Choose New.
4. Enter a User Name, Description, and Password.

Field Value

User Name <COM_USER_S4C>

Description Add a short description.

Password Enter the password.

 Note

If you don’t use role-based authentication, upload an SSL client certificate.

5. Choose Create.

5.4 Create Communication System

If communication systems for SAP Cloud Integration connections or SAP Master Data Integration connections
are already in place, use these. If not, create new communication systems as described.

5.4.1 Create Communication System for SAP Cloud


Integration Connections

The communication system is used to define the host name of the SAP Cloud Integration and to assign
inbound and outbound users of SAP S/4HANA Cloud.

Integration with Sales Orders in SAP S/4HANA Cloud


24 PUBLIC Configuration in SAP S/4HANA Cloud
1. Log on to your SAP S/4HANA Cloud system.
2. Open the Communication Systems app.
3. Choose New.
4. Enter the following data and choose Create.

Field Value

System ID This communication system should contain all connec-


tions that are related to the SAP Cloud Integration that
is used, for example, <SCI_123>.

System Name We recommend to use the same name as the system ID,
for example, <SCI_123>.

5. Maintain the Host Name of the fully qualified SAP Cloud Integration runtime URL.

Field User Action or Value

Host Name <XXXX-


iflmap.avtsbhf.eu1.hana.ondemand.com>

 Note
Make sure that https:// is not included in the host
name.

6. Maintain the Logical System and the Business System.

Field User Action or Value

Logical System We recommend to use the same name as the system ID,
for example, <SCI_123>.

Business System We recommend to use the same name as the system ID,
for example, <SCI_123>.

7. Optionally, maintain Contact Information.


8. Under Users for Inbound Communication, choose the plus icon to add a user.
9. In the Username field, select the communication user that you created earlier. From the Authentication
Method dropdown list, select Username and Password.

Field User Action or Value

Username <COM_USER_S4C>

Authentication System Choose the preferred authentication method.

10. Choose OK.


11. Under Users for Outbound Communication, choose the plus icon to add a user. From the Authentication
Method dropdown list, select Username and Password. Enter the credentials of the SAP Cloud Integration
Suite technical user.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 25
 Note

Username and password are the Client ID and client secret respectively from the service key of the SAP
Cloud Integration instance in SAP BTP.

12. Choose Create.


13. Choose Save to save the communication system.

5.4.2 Create Communication System for SAP Master Data


Integration Connections

The communication system is used to define the host name of the SAP Master Data Integration and to assign
inbound and outbound users of SAP S/4HANA Cloud.

1. Log on to your SAP S/4HANA Cloud system.


2. Open the Communication Systems app.
3. Choose New.
4. Enter the following data and choose Create.

Field Value

System ID This communication system should contain all connec-


tions that are related to the SAP Master Data Integration
that is used, for example, <MDI_123>.

System Name We recommend to use the same name as the system ID,
for example, <MDI_123>.

5. Maintain the Host Name of the fully qualified SAP Cloud Integration runtime URL.

Field User Action or Value

Host Name <one-mds.cfapps.sap.hana.ondemand.com>

 Note
Make sure that https:// is not included in the host
name.

6. Maintain the Logical System and the Business System.

Field User Action or Value

Logical System We recommend to use the same name as the system ID,
for example, <MDI_123>.

Business System We recommend to use the same name as the system ID,
for example, <MDI_123>.

7. Optionally, maintain Contact Information.

Integration with Sales Orders in SAP S/4HANA Cloud


26 PUBLIC Configuration in SAP S/4HANA Cloud
8. Under Users for Inbound Communication, choose the plus icon to add a user.
9. In the Username field, select the communication user that you created earlier. From the Authentication
Method dropdown list, select Username and Password.

Field User Action or Value

Username <COM_USER_S4C>

Authentication Method Choose the preferred Authentication method

10. Choose OK.


11. Under Users for Outbound Communication, choose the plus icon to add a user. From the Authentication
Method dropdown list, select Username and Password. Enter the credentials of the SAP Master Data
Integration technical user.

 Note

Username and password are the Client ID and client secret respectively from the service key of the SAP
Master Data Integration instance in SAP BTP.

12. Choose Create.


13. Choose Save to save the communication system.

5.5 Create Communication Arrangements

The communication arrangement in the SAP S/4HANA Cloud system defines all relevant information for the
interface. The inbound and outbound authentication is set on communication system level and is automatically
passed on to the related communication arrangements.

5.5.1 Create Communication Arrangement Using


Communication Scenario SAP_COM_0288 for Sales
Order

Learn how to set up communication scenario SAP_COM_0288 for transactional data integration for sales
orders with the Communication Arrangements app.

1. Log on to the SAP Fiori launchpad.


2. Open the Communication Arrangements app.
3. To create a new communication arrangement, choose New.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 27
4. Enter the following data:

Field Value

Scenario SAP_COM_0288 (Sales Order Bulk Integration)

 Note
You can use the value help to search for a specific
scenario.

Arrangement Name Enter the communication arrangement name, for exam-


ple, <SAP_COM_0288_SCI_SalesOrder>.

5. Choose Create.
6. Maintain Common Data. In the Communication System field, select the communication system for the SAP
Cloud Integration connections that you created earlier, for example, <SCI_123>.
7. The inbound and outbound communication user is entered automatically.
8. The following Outbound Services need to be active and the details filled as follows:

Outbound Application
Service Service Status Protocol Port Path Service URL Use WSRM

Sales Order - Active SOAP 443 Endpoint of the Automatically no


Confirm sales order sta- put together
Processing tus integration from protocol,
(A2A) flow, for exam- SAP Cloud In-
ple </cxf/ tegration host-
SalesOrder name, and
_Status_CP path
Q_SOAP>

Sales Order - Inactive SOAP


Send
Processing
Notification
(A2A)

Sales Order - Active SOAP 443 Endpoint of the Automatically no


Send Error Log sales order sta- put together
(A2A) tus integration from protocol,
flow, for exam- SCI hostname,
ple, </cxf/ and path
SalesOrder
_Status_CP
Q_SOAP>

 Note

For all the service endpoints, you must add the prefix /cxf to the path. Ensure that the service URLs
match the configuration of endpoints in the respective integration flows. The endpoint of the sales
order status integration flow is set during the integration flow configuration or can be looked up in the
SAP Cloud Integration under Overview Manage Integration Content . Select the integration flow

Integration with Sales Orders in SAP S/4HANA Cloud


28 PUBLIC Configuration in SAP S/4HANA Cloud
Sales Order Status from SAP S/4HANA Cloud to SAP CPQ and check the last part of the URL under
Endpoints.

9. Choose Save to save the communication arrangement.


10. The communication arrangement is now active.

5.5.2 Create Communication Arrangement Using


Communication Scenario SAP_COM_0008 for
Business Partner Replication

Learn how to set up communication scenario SAP_COM_0008 for master data integration for business
partner, customer, and contact with the Communication Arrangements app.

1. Log on to the SAP Fiori launchpad.


2. Open the Communication Arrangements app.
3. To create a new communication arrangement, choose New.
4. Enter the following data:

Field Value

Scenario SAP_COM_0008 (Business Partner, Customer and


Supplier Integration)

 Note
You can use the value help to search for a specific
scenario.

Arrangement Name Enter the communication arrangement name, for exam-


ple, <SAP_COM_0008_MDI_BusinessPartner>.

5. Choose Create.
6. Maintain Common Data. In the Communication System field, select the communication system for SAP
Master Data Integration connections that you created earlier, for example, <MDI_123>.

 Note

For all the service endpoints, you must add the prefix /cxf to the path. Ensure that the service URLs
match the configuration of endpoints in the respective integration flows.

7. Deactivate all IDoc-based outbound services. To find out if a service is IDoc-based, look at the Application
Protocol field.
8. The following outbound services need to be active and the details filled as follows:

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 29
Outbound Application
Service Service Status Protocol Port Path Service URL Use WSRM

Business Active SOAP 443 Path to the Automatically No


Partner - SAP Master put together
Replicate from Data Integra- from protocol,
SAP S/4HANA SAP Cloud In-
tion Business
Cloud to Client tegration host-
Partner Repli-
name, and
cation, for ex- path
ample </
businesspa
rtner/v0/
soap/
BusinessPa
rtnerBulkR
eplicateRe
questIn?
tenantId=m
asterdata>

Business Active SOAP 443 Path to the Automatically No


Partner SAP Master put together
Relationship - Data Integra- from protocol,
Replicate from SAP Cloud In-
tion Business
SAP S/4HANA tegration host-
Partner Rela-
Cloud to Client name, and
tionship, for ex- path
ample </
businesspa
rtner/v0/
soap/
BusinessPa
rtnerRelat
ionshipBul
kReplicate
RequestIn?
tenantId=
masterdata
>

Integration with Sales Orders in SAP S/4HANA Cloud


30 PUBLIC Configuration in SAP S/4HANA Cloud
Outbound Application
Service Service Status Protocol Port Path Service URL Use WSRM

Business Active SOAP 443 Path to the Automatically No


Partner - Send SAP Master put together
Confirmation Data Integra- from protocol,
from SAP S/ SAP Cloud In-
tion Business
4HANA Cloud tegration host-
Partner Confir-
to Client name, and
mation, for ex- path
ample </
businesspa
rtner/v0/
soap/
BusinessPa
rtnerBulkR
eplicateRe
questConfI
n?
tenantId=m
asterdata>

BP Active SOAP 443 Path to the Automatically No


Relationship - SAP Master put together
Send Data Integra- from protocol,
Confirmation SAP Cloud In-
tion Business
from SAP S/ tegration host-
Partner Rela-
4HANA Cloud name, and
to Client tionship Con- path
firmation, for
example </
businesspa
rtner/v0/
soap/
BusinessPa
rtnerRelat
ionshipBul
kReplicate
RequestCon
firmIn?
tenantId=m
asterdata>

9. For the Additional Properties section of the active outbound service Business Partner - Replicate from SAP
S/4HANA Cloud to Client, select the following values:

Property Name Property Value

Replication Model Enter a name that indicates what the replication model
does, for example, <RE_BP_CPQ>.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 31
Property Name Property Value

Replication Mode I (initial load)

System Filter Can be left empty

Output Mode D (direct output)

10. Choose Save.


11. The communication arrangement is now active.

5.5.3 Create Communication Arrangement Using


Communication Scenario SAP_COM_0009 for
Product

Learn how to set up communication scenario SAP_COM_0009 for master data integration for products with
the Communication Arrangements app.

1. Log on to the SAP Fiori launchpad.


2. Open the Communication Arrangements app.
3. To create a new communication arrangement, choose New.
4. Enter the following data:

Field Value

Scenario SAP_COM_0009 (Product Integration)

 Note
You can use the value help to search for a specific
scenario.

Arrangement Name Enter the communication arrangement name, for exam-


ple, <SAP_COM_0009_SCI_Product>.

5. Choose Create.
6. Maintain Common Data. In the Communication System field, select the communication system for
SAP Cloud Integration connections that you created earlier, for example, <SCI_123>. The inbound and
outbound communication users are entered automatically.
7. The following outbound services need to be active and the details filled as follows:

Outbound Application
Service Service Status Protocol Port Path Service URL Use WSRM

Replicate Inactive IDoc 443


Product from
S/4 System to
Client

Integration with Sales Orders in SAP S/4HANA Cloud


32 PUBLIC Configuration in SAP S/4HANA Cloud
Outbound Application
Service Service Status Protocol Port Path Service URL Use WSRM

Product Master Active SOAP 443 Endpoint of the Automatically No


- Replicate product repli- put together
from SAP S/ cation integra- from protocol,
4HANA Cloud tion flow, for SAP Cloud In-
to Client example tegration host-
</cxf/S4/C name, and
PQ/ path
ProductRep
lication>

Product Master Inactive SOAP 443


- Confirmation
from SAP S/
4HANA Cloud
to Client

 Note

For all the service endpoints, you must add the prefix /cxf to the path. Ensure that the service URLs
match the configuration of endpoints in the respective integration flows.

8. For the Additional Properties section of the active outbound service Product Master - Replicate from SAP
S/4HANA Cloud to Client, select the following values:

Property Name Property Value

Replication Model Enter a name that indicates what the replication model
does, for example <RE_PRD_CPQ>.

Replication Mode I (initial load)

System Filter Can be left empty

Output Mode D (direct output)

9. Choose Save.
10. The communication arrangement is now active.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 33
5.6 Pricing

Learn how to set up pricing for an integration between SAP CPQ and sales orders in SAP S/4HANA Cloud.

5.6.1 Condition Types

Learn how to set up pricing condition types for an integration between SAP CPQ and sales orders in SAP
S/4HANA Cloud.

In a sales order, price elements are represented by condition types. Price elements can be, for example, prices,
surcharges, discounts, taxes or freight, and are stored in the system in condition records. You can, for example,
define whether a discount is calculated as a percentage or a fixed amount using the condition type. You specify
an access sequence in every condition type. In this way you define which fields the system checks when
searching for a valid condition record.

 Note

If you don't use SAP Variant Configuration and Pricing [page 9], you can define condition types without
access sequences. In SAP CPQ, you must then assign these condition types to CPQ item prices.

1. In your configuration environment, use the search function to open the following activity: Set Condition
Types for Pricing in Sales.
2. Choose Configure and then New Entries to create the necessary condition types.

 Example

The following condition types illustrate how you can set up discounts and surcharges that are then used in a
pricing procedure.

Condition Type 1
Field Value

Condition Type YK07 Customer Discount

Access Sequence K307

Control Data 1

Condition Class A (Discount or Surcharge)

Calculation Type A (Percentage)

Plus/Minus X (Negative)

Changes which can be made

Manual Entries <blank> (No limitations)

Item Condition X

Delete X

Amount/Percent X

Integration with Sales Orders in SAP S/4HANA Cloud


34 PUBLIC Configuration in SAP S/4HANA Cloud
Field Value

Master Data

Delete from DB Do not delete (set the deletion flag only)

Scales

Scale Base Type B (Value scale)

Condition Type 2
Field Value

Condition Type YBHD Freight

Control Data 1

Condition Class A (Discount or Surcharge)

Calculation Type B (Fixed Amount)

Condition Category F (Freight)

Plus/Minus A (Positive)

Changes which can be made

Manual Entries <blank> (No limitations)

Header Condition X

Delete X

Amount/Percent X

Master Data

Delete from DB Do not delete (set the deletion flag only)

5.6.2 Pricing Procedure

Learn how to set up pricing procedures for an integration between SAP CPQ and sales orders in SAP S/4HANA
Cloud.

After having created the condition types, you can create pricing procedures using these condition types. In
the pricing procedures, you define which condition types are to be taken into account and in which sequence.
During pricing, the system automatically determines which pricing procedure is valid for a sales order. The
system then takes the condition types contained in the pricing procedure into account, one after the other. If
you want to use one-time prices and cumulated discounts, you must create your own pricing procedures.

The integration between SAP CPQ and sales orders in SAP S/4HANA Cloud uses document pricing (that is,
the determined prices are applied to the entire quote). You can define mappings between the SAP CPQ quote
or custom fields and the price conditions in the pricing procedure in SAP S/4HANA Cloud. In this scenario,
you must create the quote before you can add a product. This allows the system to determine the pricing
procedure in advance, so that SAP Variant Configuration and Pricing can do the necessary calculations. Once
you add, delete, or change items in the SAP CPQ quote, SAP Variant Configuration and Pricing is called and all
mapped conditions are sent.

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 35
1. In your configuration environment, use the search function to open the following activity: Set Pricing
Procedures.
2. Choose Configure and then New Entries to create the necessary pricing procedures.
3. Create a new procedure (for example, ZCPQDP) and add a description (for example, CPQ Sales Order
for Doc Prc).
4. Select your procedure and choose Procedures - Control Data.

 Example

The following settings illustrate how you can set up a pricing procedure.

Pricing Procedure
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

10 0 PCO Ac- 0 0 X B 2 0 0 ERL


1 tual
Cost
s

20 0 PPR Pric 0 0 X 2 0 0 ERL


0 e

30 0 PVA Var- 0 0 a 2 0 0 ERL


0 iant
Pric
e

35 0 PVA Var- 0 0 a 2 0 0 ERL


1 iant
Pric
e
(%)

60 0 PMP Man 0 0 X 2 0 0 ERL


0 ual
Pric
e

90 0 Sub- 30 35 5 0 0 0
total
Var-
iant
Pric
e

Integration with Sales Orders in SAP S/4HANA Cloud


36 PUBLIC Configuration in SAP S/4HANA Cloud
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

100 0 Gros 10 80 a 1 0 2 0
s
Valu
e

120 0 DPG Cust 0 0 a 2 0 0 YB2


1 .
Grp
/
Ma-
te-
rial

130 0 DCM Cus- 0 0 a 2 0 0 YB2


1 to-
mer
/
Ma-
te-
rial

135 0 DCH Cus- 0 0 a 2 0 0 YB2


1 to-
mer
Hier-
arch
y

140 0 DC0 Divi- 0 0 a 2 0 0 YB2


1 sion
/
Cus-
to-
mer

145 0 YK0 Cus- 0 0 b 2 0 0 YB2


7 to-
mer
Dis-
coun
t

150 0 DM0 Ma- 0 0 a 2 0 0 YB1


1 te-
rial

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 37
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

160 0 DPG Cus- 0 0 a 2 0 0 YB2


2 to-
mer
Pric
e
Grou
p

170 0 DPG Ma- 0 0 a 2 0 0 YB1


3 te-
rial
Pric
e
Grou
p

180 0 DPG Cus- 0 0 a 2 0 0 YB2


4 to-
mer
/
Mat.
Pr.Gr
p

190 0 DPG Cust 0 0 a 2 0 0 YB2


5 .
Grp/
Mat.
Pr.Gr
p

195 0 DPH Prod 0 0 a 2 0 0 YB1


1 uct
Hier-
arch
y

200 0 DRG % 100 0 X a 2 0 0 YB3


1 Gros
s
Amo
unt 1

210 0 DRN % 0 0 X a 2 0 0 YB3


1 Net
Amo
unt 1

Integration with Sales Orders in SAP S/4HANA Cloud


38 PUBLIC Configuration in SAP S/4HANA Cloud
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

220 0 DRQ +/- 0 0 X a 2 0 0 YB3


1 as to
Qua
ntity
1

230 0 DRV Fixe 0 0 X a 2 0 0 YB3


1 d
Amo
unt 1

240 0 DRW +/- 0 0 X a 2 0 0 YB3


1 as to
Grss
Wgh
t1

300 0 Sum 101 299 0 0 0


Sur-
char
ges/
Dis-
coun
ts

310 0 PNP Net 0 0 X 2 6 3 ERL


0 Pric
e

390 0 D10 100 0 0 a G 55 0 28 ERS


0 %
dis-
coun
t

700 0 Net 0 0 a 2 0 2 0
Valu
e1

701 0 DRE Re- 0 0 a 2 0 2 ERS


1 fund
De-
duc-
tion

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 39
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

740 0 Stat. 0 0 0 82 0
Valu
e
with-
out
Freig
ht

745 0 FPA1 Pack 0 0 X B 4 2 0 0 ERF


ag-
ing
fee

750 0 YBH Freig 0 0 X B 4 2 0 13 ERF


D ht

770 0 FIN1 In- 0 0 X B 4 2 0 0 ERF


sur-
ance
fee

780 0 DPR Pric 0 0 X X 0 0 0


1 e-
Re-
lated
Diff.

781 0 DQU Qty- 0 0 X X 0 0 0


1 Re-
lated
Diff.

800 0 Net 0 0 3 0 2 0
Valu
e2

821 0 PI02 In- 740 770 X B 22 0 0 ERL


ter-
com
pany
%

Integration with Sales Orders in SAP S/4HANA Cloud


40 PUBLIC Configuration in SAP S/4HANA Cloud
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

822 0 PI01 In- 0 0 X B 22 0 0 ERL


ter-
com
pany
Pric
e

849 0 DCD Cas 0 0 X D 14 0 2


2 h
Dis-
coun
t Net

850 0 UTX Tax 800 0 X X 84 300 16


J Ju-
ris-
dict.
Cod
e

851 0 JR1 Tax 800 0 X B 0 0 0


Jur
Cod
e
Leve
l1

852 0 JR2 Tax 800 0 X B 0 0 0


Jur
Cod
e
Leve
l2

853 0 JR3 Tax 800 0 X B 0 0 0


Jur
Cod
e
Leve
l3

854 0 JR4 Tax 800 0 X B 0 0 0


Jur
Cod
e
Leve
l4

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 41
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

855 0 XR1 Tax 0 0 X B 0 0 16


Jur
Cod
e
Leve
l1

856 0 XR2 Tax 0 0 X B 0 0 16


Jur
Cod
e
Leve
l2

857 0 XR3 Tax 0 0 X B 0 0 16


Jur
Cod
e
Leve
l3

858 0 XR4 Tax 0 0 X B 0 0 16


Jur
Cod
e
Leve
l4

859 0 XR5 Tax 0 0 X B 0 0 16


Jur
Cod
e
Leve
l5

860 0 XR6 Tax 0 0 X B 0 0 16


Jur
Cod
e
Leve
l6

899 0 DRD Rou 0 0 X 13 16 4 ERS


1 ndin
g Off

Integration with Sales Orders in SAP S/4HANA Cloud


42 PUBLIC Configuration in SAP S/4HANA Cloud
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

900 0 Total 0 0 A 0 4 0
Valu
e

910 0 DCD Cas 0 0 X 9 0 11


1 h
Dis-
coun
t
Gros
s

935 0 PC0 Cal- 0 0 X X B 0 0 0


2 cu-
lated
cost
s

950 0 Profi 0 0 0 11 0
t
Mar-
gin

960 0 PSA Stan 0 0 X 99 0 0


M da-
lone
(Mat
.)

965 0 DCE Tol- 0 0 X 0 0 0


V eran
ce
f.Exp
.Val.

970 0 PCE Cust 0 0 X X 0 8 0


1 .-Ex-
pect
ed
Pric
e

Integration with Sales Orders in SAP S/4HANA Cloud


Configuration in SAP S/4HANA Cloud PUBLIC 43
Rel-
evan
t for
Ac-
cou Alt. Alt.
nt Calc Cnd
De- . n
Con- De- ter- Re- Cnd Bas Ac- Ac-
Step di- scri Fro Re- Sta- min- Prin quir n e cou Ac- cess
Num Cou tion ptio m To Man quir tis- atio t Sub- eme Amn Valu nt crua Leve
ber nter Type n Step Step ual ed tics n Type total nt t e Key ls l

971 0 PCE Cust 0 0 X X 0 8 0


2 .-Ex-
pect
ed
Valu
e

5.6.3 Pricing Procedure Determination

Learn how to set up the pricing procedure determination for an integration between SAP CPQ and sales orders
in SAP S/4HANA Cloud.

When you set a pricing procedure determination, you define how the system determines the correct
pricing procedure every time a sales order is created. The pricing procedure should follow the setup of the
organizational structure in the system.

1. In your configuration environment, use the search function to open the following activity: Set Pricing
Procedure Determination.
2. Choose Configure and then New Entries to create the necessary pricing procedure determination.
3. Create a new procedure (for example, ZCPQDP) and add a description (for example, CPQ Sales Order
for Doc Prc).

 Example

The following settings illustrate how you can set up the pricing procedure determination, using the pricing
procedure created before.

Pricing Procedure Determination


Condition
Sales Organi- Distribution Doc. Pricing Cust.Pric.Pro- Pricing Proce- Type for Fast
zation Channel Division Proc. cedure dure Entry

1710 10 00 Y1 Z3 ZCPQDP

Integration with Sales Orders in SAP S/4HANA Cloud


44 PUBLIC Configuration in SAP S/4HANA Cloud
6 SAP Cloud Integration Configuration

Before the integration flow can be used, it must be copied to the local environment and configured. During this
configuration, the integration flow is adapted to the integration environment by providing system details of the
sending and receiving system.

Creating User Credentials in SAP Cloud Integration System [page 45]

View Prepackaged integration flows using SAP Cloud Integration Web UI [page 46]

Copy the Package for configuration [page 46]

Configuration of the Integration flow “Create Sales Order from SAP CPQ in S4HANA
Cloud_Quote2.0_SOAP” [page 47]

Configuration for integration flow “Replicate Sales Order status from SAP S4HANA to SAP CPQ Quote 2.0”
[page 49]

Configuration for integration flow “Replicate Product from SAP S/4HANA” [page 50]

Configuration for integration flow “Replicate Business Partner from SAP Master Data Integration” [page
52]

Value Mapping for SAP CPQ integration with SAP S/4HANA Cloud [page 53]

6.1 Creating User Credentials in SAP Cloud Integration


System

1. Log on to the tenant management node of the SAP Cloud Integration system with the URL http://
<tenant management node URL>/itspaces.
2. Choose Monitor from left navigation bar.
3. Navigate to Manage Security section and choose Security Material.
4. Choose Create and select User Credentials.
5. Enter the following details for user of SAP CPQ.

Field Value

Name For Example, < COM_USER_S4C>

Type User Credentials

User Communication user maintained in SAP CPQ # Domain of


SAP CPQ system.

For example, <COM_USER_S4C#SAPIEE_OP_TEST>

Integration with Sales Orders in SAP S/4HANA Cloud


SAP Cloud Integration Configuration PUBLIC 45
Field Value

Password Enter the password maintained for the communication


user in SAP CPQ system.

6. Choose Deploy.
7. Choose Create and select User Credentials.
8. Enter the following details for user of SAP S/4HANA Cloud.

Field Value

Name For Example, < COM_USER_S4C>

Type User Credentials

User For example, < COM_USER_S4C>

Password Enter the password of user COM_USER_S4C

9. Choose Deploy.

6.2 View Prepackaged integration flows using SAP Cloud


Integration Web UI

To import and deploy integration flows, AuthGroup.IntegrationDeveloper role is to be assigned in the tenant.

Upload SAP CPQ SSL Certificates in SAP Cloud Integration.

1. Access the SAP Cloud Integration Web UI from the provisioning e-mail. It should be in the format: http://
<tenant management node URL>/itspaces
2. On the Discover tab, you should be able to view all pre-packaged integration flows delivered by SAP.
3. Choose the package Create Sales Order from CPQ Quote 2.0 in SAP S/4HANA Cloud.
4. All the artifacts of this package will be displayed when Artifacts is selected.

6.3 Copy the Package for configuration

1. Connect to the tenant management node of the SAP Cloud Integration system with the URL: http://
<tenant management node URL>/itspaces.
2. 2. On the Discover tab, select the package for example, SAP CPQ - Quote 2.0 Integration with SAP S/
4HANA Sales Order. Choose Artifacts to view all the integration flows related to this integration package.
3. Choose Copy on the right top corner to copy it to design area.

Integration with Sales Orders in SAP S/4HANA Cloud


46 PUBLIC SAP Cloud Integration Configuration
 Note

If the Integration package were being created for the first time, then you would see the message
‘Integration Package Created’. If not, you will see the below dialog box asking to either Create a new
copy of the package or to Overwrite the existing integration package content. Choose Overwrite

4. Select the Design mode in left navigation bar.


5. Package is now visible in the design area and can be configured.

6.4 Configuration of the Integration flow “Create


Sales Order from SAP CPQ in S4HANA
Cloud_Quote2.0_SOAP”

1. Select the Integration Package copied.


2. Choose Artifacts tab of the package to view list of Integration flows.
3. Choose the Actions symbol beside the Integration flow, for example, <Create Sales Order from SAP
CPQ in S4HANA Cloud_Quote2.0_SOAP>.
4. Choose Configure.
5. The configuration is explained in the following topics. Configuration of the sender system (In this case, SAP
CPQ) and the receiver system (In this case, SAP S/4HANA Cloud) and additional information.
6. Choose Save after completing configuration in a tab.
7. Choose Deploy after completion of whole configuration.

 Note

The integration flow package does not have a retry mechanism and does not support certificate-based
authentication.

Receiver Tab

The receivers can be configured individually by choosing from the receiver dropdown.

Field Name Value

Receiver Quote2OrderPostProcessingExit

Adapter Type Process Direct

Address endpoint of the extension Integration flow

Integration with Sales Orders in SAP S/4HANA Cloud


SAP Cloud Integration Configuration PUBLIC 47
Field Name Value

Receiver • SAP_CPQ_QuotesAPI
• SAP_CPQ_QuoteItemsCountAPI
• S4_CPQ_1924
• SAP_CPQ_QuoteItemsAPI

Adapter Type HTTP

SAP CPQ Host URL of the SAP CPQ Host

Credential Name User Credentials created for SAP CPQ. For example,
<COM_USER_CPQINT_SCLOUD>

Timeout (in ms) Time until Connection Timeout, default Value is 60 000

Field Name Value

Receiver S4HANACLOUD

Adapter Type SOAP

S4HANA Host SAP S/4HANA Cloud Host address

Authentication Basic

Credential Name User Credentials created for SAP S/4HANA Cloud. For ex-
ample, <COM_USER_S4C>

Timeout (in ms) Time until Connection Timeout, default Value is 60 000

More Tab

Field Name Value

Type All Parameters

Connection Timeout Time until Connection Timeout, default Value is 60 000

Document Type Sales Order document type in SAP S/4HANA Cloud

Enable Log Default value is False

Extension Implemented Only configure this receiver if you intend to modify the
standard mapping through your own Integration flow. De-
fault value is False

S4 Item Increment Interval SAP S/4HANA Cloud has another numbering interval than
SAP CPQ. The items in the Sales Order might do not have
subsequent numbering as in SAP CPQ (1,2,3 etc.) but can
also be 10,20,30 etc. In this case, the value would be 10

S4_Language EN

Integration with Sales Orders in SAP S/4HANA Cloud


48 PUBLIC SAP Cloud Integration Configuration
Field Name Value

Sender Business System Name of the Business System from SAP S/4HANA Cloud.
This ID is important to identify the correct recipient
system for the Sales Order Confirmation. For example,
<SCI_123>. This is found in the Communication System
for SAP Cloud Integration connections

Recipient Business System This ID is important to identify the correct recipient system
for the Sales Order.

This can be found in the Communication Arrangement under


Common Data in the own system field

Deployment

1. Choose Deploy after all the above configurations are done.


2. Choose Monitor from the left navigation bar.
3. Choose All from Manage Integration Content.
4. Check if the deployment was successful. The status should be started and an endpoint URL is displayed.

6.5 Configuration for integration flow “Replicate Sales


Order status from SAP S4HANA to SAP CPQ Quote
2.0”

1. Select the Integration Package copied.


2. Choose Artifacts tab of the package to view list of Integration flows.
3. Choose the Actions symbol beside the Integration flow, for example,<Sales Order Confirmation in
S4HANA_Quote2.0_SOAP>.
4. Choose Configure.
5. The configuration is explained in the following topics. Configuration of the sender system and the receiver
system (in this case, SAP CPQ).
6. Choose Save after completing configuration in a tab.
7. Choose Deploy after completion of whole configuration.

Sender Tab

Field Name Value

Sender Sender

Integration with Sales Orders in SAP S/4HANA Cloud


SAP Cloud Integration Configuration PUBLIC 49
Field Name Value

Adapter Type SOAP

Address integration flow endpoint

Receiver Tab

Field Name Value

Receiver • CPQ_ErrorMessage_1924
• CPQ_Message_1923

Adapter Type HTTP

CPQ Host URL of the SAP CPQ Host

Credential Name User Credentials created for SAP CPQ. For example,
<COM_USER_CPQINT_SCLOUD>

Deployment

1. Choose Deploy after all the above configurations are done.


2. Choose Monitor from the left navigation bar.
3. Choose All from Manage Integration Content.
4. Check if the deployment was successful. The status should be started and an endpoint URL is displayed.

6.6 Configuration for integration flow “Replicate Product


from SAP S/4HANA”

1. Select the Integration Package copied.


2. Choose Artifacts tab of the package to view list of Integration flows.
3. Choose the Actions symbol beside the Integration flow, for example,<Replicate Product from SAP
S4HANA>..
4. Choose Configure.
5. The configuration is explained in the following topics. Configuration of the sender system (In this case, SAP
S/4HANA) and the receiver system (In this case, SAP CPQ) and additional information.
6. Choose Save after completing configuration in a tab.
7. Choose Deploy after completion of whole configuration.

Integration with Sales Orders in SAP S/4HANA Cloud


50 PUBLIC SAP Cloud Integration Configuration
Sender Tab

Field Name Value

Sender S4HANA

Adapter Type SOAP

Address Integration flow endpoint, For example, </S4/CPQ/


ProductReplicateRequest_Out>

Authorization User Role

User Role ESBMessaging.send

Receiver Tab

The receivers can be configured individually by choosing from the receiver dropdown.

Field Name Value

Receiver CPQ

Adapter Type SOAP

Address For example, <https://<SAP CPQ Host>/wsAPI/


wssrv.asmx>, www.webcomcpq.com is the SAP CPQ
Host

SAP CPQ Host For example, <www.webcomcpq.com>, without http pro-


tocol in front

Proxy Type Internet

Authentication Basic

Credential Name User Credentials created for SAP S/4HANA Cloud. For ex-
ample, <CPQS4HINTEG>

Timeout in ms 60000

Allow Chunking Selected

Field Name Value

Receiver MaterialReplicationPostExit

Adapter Type Process Direct

Address Endpoint URL. For example, </S4/CPQ/


ProductReplicateRequest_Out_PostExit>

Integration with Sales Orders in SAP S/4HANA Cloud


SAP Cloud Integration Configuration PUBLIC 51
More Tab

Field Name Value

Type Select All Parameters from the dropdown

Category Enter the name of the category where all products from SAP
S/4HANA Cloud will be replicated to for example, default
category is <SAP_CLOUD_CATEGORY>

EnableLog Set true to enable log files, false to disable logs. Default value
is false

Extension Implemented By using an extension, it is possible to call a customer-spe-


cific Integration flow in the Extension subprocess. Default
value is false

6.7 Configuration for integration flow “Replicate Business


Partner from SAP Master Data Integration”

1. Select the Integration Package copied.


2. Choose Artifacts tab of the package to view list of Integration flows.
3. Choose the Actions symbol beside the Integration flow, for example,<Replicate Business Partners
from SAP Master Data Integration>.
4. Choose Configure.
5. The configuration is explained in the following topics. Configuration of the sender system (In this case, SAP
S/4HANA) and the receiver system (In this case, SAP CPQ) and additional information.
6. Choose Save after completing configuration in a tab.
7. Choose Deploy after completion of whole configuration.

Sender Tab

Field Name Value

Sender S4HANA

Adapter Type SOAP

Address For example, </scpmasterdata/


bpreplicationtocpq>

Authorization User role

User Role ESBMessaging.send

Integration with Sales Orders in SAP S/4HANA Cloud


52 PUBLIC SAP Cloud Integration Configuration
Receiver Tab

Field Name Value

Receiver CPQ

Adapter Type HTTP

Address SAP CPQ API for creating new Business Partner.


For example, <https://<SAP CPQ Host>/api/
businesspartner/v1/businesspartner> for
the API Endpoint /api/businesspartner/v1/
businesspartner

SAP CPQ Host For example, <https://www.webcomcpq.com>

Field Name Value

Receiver BusinessPartnerReplicationProcessingExit

Adapter Type Process Direct

Address Endpoint URL. For example, </S4/CPQ/


BusinessPartnerReplicate_PostExit >

More Tab

Field Name Value

Type Select All Parameters from the dropdown

CPQCredentials User Credentials created for SAP CPQ. For example,


<COM_USER_CPQINT_SCLOUD>

Post Processing Extensions Implemented By using an extension, it is possible to call a customer-spe-


cific Integration flow in the Extension subprocess. Default
value is false

6.8 Value Mapping for SAP CPQ integration with SAP S/


4HANA Cloud

1. Select the Integration Package copied.


2. Choose Artifacts tab of the package to view list of Integration flows.
3. Choose the Actions symbol beside the Integration flow, for example, <Value Mapping for Sales
Order>.
4. Choose Configure.
5. Choose Save after completing configuration in a tab.

Integration with Sales Orders in SAP S/4HANA Cloud


SAP Cloud Integration Configuration PUBLIC 53
 Note

The identifiers in the value mapping must be identical to the names that are mentioned in the following
chapters, including capitalization. As these identifiers are used to call the value mapping inside the
Integration flow, deviations would lead to Integration flow failure as the value mapping would not be
accessible if the respective identifier cannot be found.

Partner Function Key

1. In the Bi-Directional Mapping, create a new mapping by selecting Add.


2. Enter CPQ as Agency and Identifier as PartnerFunctionKey in the left side and Agency as S4 and Identifier
as PartnerFunction in the right side.
3. Mention the Partner Functions in integration flows system in right column S4, PartnerFunction.
4. Enter the respective Partner Function keys in SAP CPQ system in left column CPQ, PartnerFunctionKey.

Country

1. In the Bi-Directional Mapping, create a new mapping by selecting Add.


2. Enter Agency as S4 and Identifier as CountryCode in the left side and CPQ as Agency and Identifier as
Country in the right side.
3. Mention the Country Code in SAP S/4HANA Cloud in left column S4, CountryCode.
4. Enter the respective Country Code in SAP CPQ system in right column CPQ, Country

Region

1. In the Bi-Directional Mapping, create a new mapping by selecting Add.


2. Enter Agency as S4 and Identifier as RegionCode in the left side and CPQ as Agency and Identifier as State
in the right side.
3. Mention the Region Code in SAP S/4HANA Cloud in left column S4, RegionCode.
4. Enter the respective Region Code in SAP CPQ system in right column CPQ, State

Time Zone

1. In the Bi-Directional Mapping, create a new mapping by selecting Add.


2. Enter Agency as S4 and Identifier as RegionCode in the left side and CPQ as Agency and Identifier as State
in the right side.
3. Mention the Time Zones for Subscriptions on the left column, S4, TimeZoneCode.
4. Enter the respective Country Code in SAP CPQ system in right column, CPQ, TimeZone.

Integration with Sales Orders in SAP S/4HANA Cloud


54 PUBLIC SAP Cloud Integration Configuration
Primary Industry

1. In the Bi-Directional Mapping, create a new mapping by selecting Add.


2. Enter Agency as S4 and Identifier as IndustrialSectorCode in the left side and CPQ as Agency and Identifier
as PrimaryIndustry in the right side.
3. Mention the Industrial Sector Code for Subscriptions in SAP S/4HANA Cloud on the left column, S4,
IndustrialSectorCode.
4. Enter the respective Primary Industry value in SAP CPQ system in right column CPQ, PrimaryIndustry

Form of Address

1. In the Bi-Directional Mapping, create a new mapping by selecting Add.


2. Enter Agency as S4 and Identifier as FormOfAddressCode in the left side and CPQ as Agency and Identifier
as FormOfAddress in the right side.
3. Mention the Form of Address Code for Subscriptions in SAP S/4HANA Cloud on the left column, S4,
FormOfAddressCode.
4. Enter the respective Form of Address value in SAP CPQ system in right column CPQ, FormOfAddress

Integration with Sales Orders in SAP S/4HANA Cloud


SAP Cloud Integration Configuration PUBLIC 55
7 Data Replication

This section describes how to execute the initial data load of material and customer master from your SAP
S/4HANA Cloud system to the SAP CPQ system.

7.1 Business Partner (Customer Master)

Procedure

1. Log on to your SAP S/4HANA Cloud system as an Administrator.


2. Under Data Replication, choose the Replicate by Replication Model app.
3. In the Replication Model field, select Business Partner Replication Model, for example, <RE_BP_MDI>.
4. In the Replication Mode section, choose the Initialization radio button.
5. Choose Display Filter Criteria Edit .
6. In the Main Filters, choose Filter Object, BP Service Filter.
7. If you want to replicate specific business partner, then enter the filter criteria as follows under Filter Criteria
for Business Objects:

Field Name Operator User Action Values

Business Partner Number Equal to For example, <1710001>

8. Choose Apply Save .


9. Close the browser window and return to the Replicate by Replication Model screen.
10. Choose Replicate.

7.2 Product Master

Integration with Sales Orders in SAP S/4HANA Cloud


56 PUBLIC Data Replication
Procedure

1. Log on to your SAP S/4HANA Cloud system as an Administrator.


2. Under Data Replication, choose the Replicate by Replication Model app.
3. In the Replication Model field, select Product Replication Model, for example, <RE_PRD_CPQ>.
4. In the Replication Mode section, choose the Initialization radio button.
5. Choose Display Filter Criteria.
6. Choose Edit to adapt the filter criteria.
7. In the Main Filters, choose Filter Object, MDM:FILTER FOR Product Service.
8. If you want to replicate specific product, then enter the filter criteria as follows under Filter Criteria to
Include Business Object:

Field Operator User Action Values

Material Number <equal to > For example, <TG11>

9. Choose Apply Save .


10. Close the browser window and return to the Replicate by Replication Model screen.
11. Choose Replicate.

7.3 Verify Products in SAP CPQ

Procedure

1. Log in to your SAP CPQ system using an Administrator user.


2. In the left menu bar, choose Setup Setup .
3. In left navigation bar, select Product Catalog Product .
4. Search for the product in Filter by Name or Part Number, for example, <TG11>.
5. Choose Actions Edit .
6. Verify the following details in the Definitions and Pricing tabs:
• System ID: For example, <TG11>
• Part Number: For example, <TG11>
• Display Type: For example, <Simple Product>
• Product Type: For example, <L001>
• Unit Of Measure: For example, <PCE>
• Category: For example, <SAP_CLOUD_CATEGORY>
• Active: For example, <YES>
• Created By: For example, <COM_USER_CPQINT>

Integration with Sales Orders in SAP S/4HANA Cloud


Data Replication PUBLIC 57
7.4 Verify Business Partners in SAP CPQ

Procedure

1. Log in to your SAP CPQ system using an Administrator user.


2. In the left menu bar, choose Setup Setup .
3. In left navigation bar, select Business Partners. Business Partners .
4. Search for the product in Filter by Name. For example, <1710001>.
5. Choose Actions Edit .
6. Verify the following details in the General tab:
• Name: For example, <BP_test>
• Partner ID: For example, <123>
• First Name: For example, <Test>
• Last Name: For example, <BP>
• Address Info as provided in the SAP S/4HANA system

Integration with Sales Orders in SAP S/4HANA Cloud


58 PUBLIC Data Replication
8 Master Data

Master data relevant to 2TY is used in the integration.

Integration with Sales Orders in SAP S/4HANA Cloud


Master Data PUBLIC 59
Important Disclaimers and Legal Information

Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:

• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:

• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.

• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.

• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering an SAP-hosted Web site. By using
such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.

Videos Hosted on External Platforms


Some videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any
advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within
the control or responsibility of SAP.

Beta and Other Experimental Features


Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your
feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.

Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.

Integration with Sales Orders in SAP S/4HANA Cloud


60 PUBLIC Important Disclaimers and Legal Information
Integration with Sales Orders in SAP S/4HANA Cloud
Important Disclaimers and Legal Information PUBLIC 61
www.sap.com/contactsap

© 2023 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form


or for any purpose without the express permission of SAP SE or an SAP
affiliate company. The information contained herein may be changed
without prior notice.

Some software products marketed by SAP SE and its distributors


contain proprietary software components of other software vendors.
National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for


informational purposes only, without representation or warranty of any
kind, and SAP or its affiliated companies shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP or
SAP affiliate company products and services are those that are set forth
in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an
additional warranty.

SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.

Please see https://www.sap.com/about/legal/trademark.html for


additional trademark information and notices.

THE BEST RUN

You might also like