You are on page 1of 43

Building block Configuration Guide CUSTOMER

SAP Cloud for Customer


December 2018
English

Opportunity to Order Scenario with SAP Cloud for Customer


Order using SAP Cloud Platform Integration
1RI
Typographic Conventions

Type Style Description

Example Words or characters quoted from the screen. These include field names, screen titles, pushbuttons
labels, menu names, menu paths, and menu options.
Textual cross-references to other documents.

Example Emphasized words or expressions.

EXAMPLE Technical names of system objects. These include report names, program names, transaction codes,
table names, and key concepts of a programming language when they are surrounded by body text,
for example, SELECT and INCLUDE.

Example Output on the screen. This includes file and directory names and their paths, messages, names of
variables and parameters, source text, and names of installation, upgrade and database tools.

Example Exact user entry. These are words or characters that you enter in the system exactly as they appear in
the documentation.

<Example> Variable user entry. Angle brackets indicate that you replace these words and characters with
appropriate entries to make entries in the system.

EXAMPLE Keys on the keyboard, for example, F 2 or E N T E R .

Opportunity to Order Scenario with SAP Cloud for Customer Order using SAP CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 2
Document History

Revision Date Change

0 December, 2018

Opportunity to Order Scenario with SAP Cloud for Customer Order using SAP CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 3
Table of Contents

1 Purpose 5

2 Prerequisite 6

3 Configuration in SAP Cloud for Customer 7


3.1 Scoping 7
3.2 Fine Tuning 11
3.2.1 Adjust Business Roles 11
3.2.2 Master Data Preparation Manually 12
3.2.2.1 Job Definition 12
3.2.2.2 Add Activities into Project for Integration 14
3.2.2.3 Configure Sales Quote 14
3.2.2.4 Configure Sales Order 15
3.2.3 Configure Communication Arrangement 15
3.3 Manual Code List Mapping 18

4 Configuration in SAP S/4HANA 21


4.1 Maintain Endpoints for Services 21
4.2 Define Sales Order 22
4.3 Automatically generate Integration settings for Data exchange 22
4.4 ALE Setting for the HTTP Inbound 27
4.5 Sales Contract 28
4.5.1 Define Sales Contract Type 28
4.5.2 Initial Data Load 29
4.5.3 Configuration for Sales Contract Delta load. 29

5 Configuration in Cloud Platform Integration 31


5.1 How to get the CPI Runtime URL 31
5.2 How to get the CPI Client Certificate 31
5.3 Configure and Deploy the iFlow Using SAP Web UI 31
5.4 Maintain CPI Value Mapping 34

6 Appendix 37
6.1 Troubleshooting 37
6.1.1 SAP Cloud for Customer Sales Quote External Pricing Error 37
6.2 Monitor Phase: Monitor Message Flow Across Systems 37
6.3 Remove Expired Certificate from CPI Keystore 38
6.4 Configuration in SAP Cloud for Customer: Screen Adaption (optional) 38
6.4.1 Home Screen Adaption 38
6.4.2 Adapt Work Center Sales View Opportunities 38
6.5 Outbound Sales Order IDoc Configuration Setup 39
6.5.1 Maintain Output Type 39
6.5.2 Maintain Output Determination Procedure 40
6.5.3 Create Output –Condition Records 42

Opportunity to Order Scenario with SAP Cloud for Customer Order using SAP CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 4
1 Purpose

The purpose of this document is to describe the general configuration steps required to manually set up the configuration within the system
landscape that has already been installed.
This document describes the procedure to configure settings for the Integration between on premise SAP S/4HANA and SAP Cloud for
Customer using SAP Cloud Platform Integration for setting up the Opportunity to Order scenario with SAP Cloud for Customer Order in
Cloud system.
Network Security team takes the responsibility of preparing the network environment across different systems and its security aspects.

Important:
If you have any queries or feedback on this document, please create a ticket for the CSN component SV-RDS-CFC

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 5
2 Prerequisite

Please implement the document 1EL: Setting up master data for S/4HANA and SAP Cloud for Customer Integration using SAP Cloud Platform
Integration. Refer to the prerequisite matrix for the order of configuration guides to be implemented.

Note
SAP Hana Cloud Platform (HCP), Integration Service system is renamed to SAP Cloud Platform Integration (CPI).

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 6
3 Configuration in SAP Cloud for Customer

3.1 Scoping
1. Login with the PROJECTADMIN user.

Note
Login with the Administrator user that was created based on the Basic Guide.
2. Choose work center view:

Work Center BUSINESS CONFIGURATION

View IMPLEMENTATION PROJECTS

3. Select First Implementation project.


4. Choose Edit Project Scope button.

5. In the Country and Type of Business step, choose Edit Countries.


6. Add US to the Selected Countries and choose OK.
7. Choose Next.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 7
8. In the Implementation Focus step, the Implementation Focus SAP Cloud for Customer is Selected, Choose Next

Implementation Focus Selected


SAP Cloud for Customer Checked

9. In the Scoping step, maintain the following values and choose Next:

Scoping Element L1 Scoping Element L2 Scoping Element L3


<all>
Expand the scoping element and
Product and Service Portfolio for check the sub element “Sell
Sales Sales Standard Products”.

Sales New Business Sales Order

Sales New Business Sales Quote

Sales New Business Sales Contract

Sales Planning (SAP Cloud for


Sales Customer) <all>

Business Performance
Management <all> <all>

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 8
Scoping Element L1 Scoping Element L2 Scoping Element L3
Communication and Integration with External Integration into Sales, Service, and
Information Exchange Applications and Solutions Marketing Process

Communication and Integration with External


Information Exchange Applications and Solutions Integration with SAP ERP

Note
Scoping depends on the business needs. Some of the Elements are selected automatically due to business logic. This is needed for
Communication and Information Exchange.

10. Choose Next.


11. In the Questions step, navigate using the following path.
Communication and Information ExchangeIntegration with External Applications and Solutions
12. Select the Scoping element, On the right pane maintain the following values:

13. Mark In Scope for below Elements

Scoping Element Business Option

Integration into Sales, Service, Do you want to use an external application to determine prices for
and Marketing Processes opportunities in your cloud solution?

Integration into Sales, Service, Do you use an external application to determine prices, free goods, product
and Marketing Processes availability, and credit status for sales quotes in your cloud solution?

Integration into Sales, Service, Do you want to replicate sales orders from an external application or solution
and Marketing Processes to your cloud solution?

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 9
Integration into Sales, Service, Do you use an external application to determine prices, free goods, product
and Marketing Processes availability, and credit status for sales order in your cloud solution?

Integration into Sales, Service, Do you want to replicate sales orders from your cloud solution to an external
and Marketing Processes application?

Integration into Sales, Service, Do you want to replicate contracts between your cloud solution and external
and Marketing Processes application?

14. Choose Next.


15. Choose Yes on the pop-up to confirm the values selected in the Questions step.
16. Review the Scoping Setting and choose Finish to complete the Scoping.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 10
17. On the Confirmation step choose Close.

3.2 Fine Tuning

3.2.1 Adjust Business Roles


1. Navigate to below work center.

Work Center ADMINISTRATOR

View GENERAL SETTINGS

2. Select Business Roles under the section Users.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 11
3. Select the Business role with ID SALES_ROLE and choose Edit.

4. Choose the WORK CENTER AND VIEW ASSIGNMENTS tab.


5. Select below assignment.

Tab Work Center/View ID Work Center/View Name

WORK CENTER AND VIEW COD_SALES_WCF  Sales -> Sales Quotes


ASSIGNMENTS COD_QUOTE_WCVIEW Sales -> Sales Orders
CONTRACT_WCF  Contracts -> Contracts
CONTRACT_WCVIEW

6. Choose Save and select confirm on pop-up window then Close the business roles page.

3.2.2 Master Data Preparation Manually

3.2.2.1 Job Definition

1. Navigate to the below work center.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 12
Work Center ADMINISTRATOR

View GENERAL SETTINGS

Note
Some work centers are not displayed on the UI, Use the Tab menu on the top- right corner to select from the list.
2. Under the section Company, choose Job Definition.

3. Choose New and input Job Name and Job ID.


4. Choose SAVE then choose NEW.

5. Repeat the previous two steps for the following entries.

Example
Job Name Job ID

Sales Manager SALESMGNR

Sales Director SALESDTR

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 13
6. Close the page.

3.2.2.2 Add Activities into Project for Integration


1. Navigate to the following work center view.

Work Center BUSINESS CONFIGURATION

View IMPLEMENTATION PROJECTS

2. Choose Open Activity List.


3. Choose Fine-Tune tab.
4. Select All Activities in the Show dropdown field.
5. Add below activities to the project scope by selecting them and choose Add to Project

Activities Activity Group

Sales Quotes Sales

Sales Orders Sales

Sales Contracts Sales

External Pricing Communication and Information Exchange

6. Choose Close.

3.2.2.3 Configure Sales Quote


1. Navigate to the following work center view.

Work Center BUSINESS CONFIGURATION

View IMPLEMENTATION PROJECTS

2. Choose Open Activity List.


3. Choose Fine-Tune.
4. Choose Sales Quotes.
5. Choose Maintain Document Types.
6. Choose Add Row.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 14
7. Enter ZA in the Document Type field and enter Description as Sales Quote with External Pricing.
8. Choose External Pricing check box for this newly added document type
9. Choose Save and Close.
10. Choose Close.
11. Choose External Pricing from the Fine-Tune activity.
12. Choose External Pricing Procedure.
13. Choose Add Row.
14. In Pricing Procedure column, maintain the same Pricing Procedure name that is maintained in SAP S/4HANA system for the Sales
Quote document type. For example, if Sales Quote Type AG in SAP S/4HANA has the pricing procedure Y17101, then maintain this
Pricing Procedure name here.
15. In Description column, maintain the description as Sales Quote with External Pricing
16. Choose Save and Close
17. Choose Close.

Note
Please check the Pricing procedure in S/4HANA system using S/4HANA IMG path: Sales and Distribution - Basic Functions - Pricing - Pricing
Control - Define and Assign Pricing Procedures - Define Pricing Procedure Determination

3.2.2.4 Configure Sales Order


1. Navigate to the following work center view.

Work Center BUSINESS CONFIGURATION

View IMPLEMENTATION PROJECTS

2. Choose Open Activity List.


3. Choose Fine-Tune.
4. Choose Sales Order.
5. Choose Maintain Document Types.
6. Choose Add Row
7. Enter ZAR in the Document Type Field and enter Description as Sales Order with External Pricing and the
Maintenance Mode as Internal & External.
8. Choose Save and Close.

3.2.3 Configure Communication Arrangement

Note
For Integration with Basic Authentication Configuration and not Certificate based Authentication please refer configuration guide
1EL: Basic Integration setup using SAP Cloud Platform Integration, Section 8.1 Integration with Basic Authentication.

Communication scenarios mentioned in the table below are relevant for your project scope, create them one after the other:

Communication Scenario Communication Services

Inbound Outbound
Pricing in Opportunity Follow  Request Opportunity Data from SAP
Up Scenario in SAP Business Business Suite -Select
Suite

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 15
Sales Order Replication to  Replicate Sales Order to SAP Business
SAP Business Suite Suite-Select
 Replicate Sales Order Attachment to SAP
Business Suite- Select

Sales Order Replication from  Replicate Sales Order from SAP  Confirm Customer Order Replication to
SAP Business Suite Business Suite-Select SAP Business Suite-Select
 Replicate Sales Order Attachment
from SAP Business Suite-Select
Pricing in Sales Order  Request Sales Document Data from SAP
Replication Scenario in SAP Business Suite – Select
Business Suite

Print Preview of Business  Request Business Document Print


Documents in SAP Business Preview from SAP Business Suite-Select
Suite  Deprecated: Request Sales Document
Print Preview- Unselect

Pricing in Sales Quote Follow  Request Sales Document Data from SAP
Up Scenario in SAP Business Business Suite- Select
Suite

Contract Replication from  Replicate Contract Call-Off Statistics  Confirm Contract Replication to SAP
and to SAP Business Suite from SAP Business Suite - Select Business Suite- Select
 Replicate Contract from SAP  Replicate Contract to SAP Business Suite-
Business Suite- Select Select

Pricing in Contract  Request Contract Data from SAP


Replication Scenario in SAP Business Suite- Select
Business Suite

Business Document Flow  Request Document Flow from SAP


Query from SAP Business Business Suite-Select
Suite

Note
In case you do not see any of the configuration scenarios, re-check the project scoping to add the necessary scoping elements.

1. Navigate to Administrator General Settings Integration  Communication Arrangements.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 16
2. Choose New to create a new communication arrangement.
3. In Communication Scenarios table, select the Communication Scenario Sales order replication from SAP Business
Suite
4. Choose Next.
5. Choose System Instance ID from the value help. You have created this communication system ID of the SAP S/4HANA system in
the Define Communication System chapter.
6. Choose Code List Mapping as SAP On-Premise Integration.

7. Choose Next.
8. For INBOUND COMMUNICATION: BASIC SETTINGS, choose Application Protocol as Web Service and Authentication Method as
SSL Client Certificate.

9. Click Edit Credentials.


10. On the Certificate tab, choose Upload Certificate.

11. Choose the CPI client certificate and choose OK. See Chapter How to get the CPI Client Certificate for getting the client certificate.
12. For OUTBOUND COMMUNICATION CREDENTIALS click Download.
13. Enter a name for Cloud for Customer Client Certificate X.509 (example C4CSSLClient.cer) and choose Save.

Note
This certificate has to be uploaded while configuring SAP Cloud for Customer to CPI inbound iFlow.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 17
14. Choose Next and Finish.
15. Repeat the above-mentioned procedure for all the Outbound Scenarios like Sales Order with Pricing in SAP Business Suite and
configure the Outbound communication service Request Sales Document Data from SAP Business Suite
16. Choose outbound tab and enter the PATH. The path should be taken from the corresponding CPI iFlow.

Note
Example for PATH field: Login to CPI Web UI and go to corresponding CPI iFlow for your package content. In configure tab copy
the Address path. Add prefix /cxf and suffix ?sap-client= (Client number) to the copied path.
Ex: /cxf/C4C/S4/ExternalSalesDocumentDataQuery?sap-client=250

17. Choose Next and Finish.


18. Repeat the above-mentioned procedure for all the communication Scenarios mentioned in the table.

3.3 Manual Code List Mapping


Some of the code lists have to be manually maintained even after the automated code list mapping is executed For the code lists that
are not supported. Refer to https://help.sap.com/cloud4customer -> Integration-> View All ->Code Lists Supported.

1. Navigate to the following work center view.

Work Center BUSINESS CONFIGURATION

View IMPLEMENTATION PROJECTS

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 18
2. Choose Open Activity List.
3. Choose Fine-Tune Tab.
4. Choose Code List Mapping for Integration with External Applications and solutions in the Table.
5. Choose Maintain Code List Mapping.

Note
The code list mapping UI contains the following 3 tables which are hierarchical:

A. Local data type: This shows the data types available in the SAP Cloud for customer system. Here we select data type for which the code
list needs to be mapped.

B. Code list mapping rule: Here we set the code list mapping rules for the data type selected in the above table. There are 2 possible rules:
Local and Remote codes are equal: This rule can be used when the values in the SAP Cloud for customer system and the ones in the
S/4HANA system are the same. If this rule is selected, there is no need to do any mapping for the code values.
Map Individual values: This rule can be used when the values in the SAP Cloud for Customer system and the ones in the SAP S/4HANA
system are different. If this rule is selected, the individual code values for the data type need to be mapped with values in the S/4HANA
system. An example and the list of SAP S/4HANA tables corresponding to the local data types in mentioned in the next steps.

C. Code List mapping: Map each code value (only the required ones) for the local data type from SAP Cloud for customer system with the
corresponding values in the SAP S/4HANA system.

6. In the Code List Mapping Definition section, select the row with Local Data Type Name to configure the code list values.

7. In the Code List Mapping Rule section, maintain Mapping Rule.

Note
In the Code List Mapping section if you are unable to change existing value, delete the entries and create new ones.

8. In Code List Mapping section, Click Add Row to add new rows in the code list mapping table
9. Click Value selection in the field Local Code to get the pop up with the list of values.

Note
The steps to enter the mappings is available in the table below with an example.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 19
Field Value Example

Local Code <Code represented by the Cloud for Customer For the local code type
System> “BusinessTransactionDocumen
tProcessingTypeCode” With
value “ZAR”

Description <Description of what the code represents> Local code value “ZAR” has a
description “Sales Order with
External Pricing” in Cloud for
Customer.

External Code <Code as maintained in the backend S/4HANA> Refer the S/4HANA table for the
External code for sales order. (***)
Value: ZAR

Inbound Default < If this is checked the Inbound value is (*)


considered as default>

Outbound Default < If this is checked the Outbound value is (**)


considered as default >

(*) In case where each External code is mapped to multiple Internal codes
(**) In case where each Internal code is mapped to multiple External codes.

(***) Please maintain the language independent Sales Order type. Check this using below path.
Go to: SAP IMG Authoring->Sales and Distribution -> Sales -> Sales Document -> Sales Document Header -> Convert Language for Each
Sales Document Type

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 20
4 Configuration in SAP S/4HANA

4.1 Maintain Endpoints for Services

Purpose

In this chapter, we describe how to configure web service for synchronous request for S/4HANA system.

Procedure

1. Navigate using one of the following method.

Transaction Code SOAMANAGER

SAP S/4HANA IMG menu Integration with Other SAP Components 


Integration with SAP Cloud for Customer 
Communication Setup  Manually Adjust Integration
Settings for Data Exchange Configuration in SOA
Management

2. Click on Simplified Web Service Configuration under Service Administration.

3. Search for the object name: SalesDocumentPrintPreviewQuery.

4. Select the Web service name and click on Set Selected. Check the fields User Name/Password (Basic) and X.509 Client Certificate. De-
select SAP Logon Ticket field.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 21
Note
For Integration using Basic Authentication we need to check check-box for User Name/Password(Basic) and For Certificate
Authentication we need to check check-box X.509 Client Certificate

5. Choose Save.

6. Perform the previous steps for the following services:


o SALESORDERBYIDQUERYRESPONSEIN
o COD_SALESORDER_SIMULATE
o COD_ERP_GET_DOC_FLOW
o ATTACHMENTFOLDERREPLICATIONRE1

4.2 Define Sales Order


1. Access the following transaction:

Transaction Code VOV8

2. Mark the entry OR (Standard Order) and choose Copy As (F6).


3. Maintain the following values for the copied sales document.

Sales Document Type Description


ZAR C4C Order - Ext Pricing

4. Choose E n t e r on your keyboard.


5. Confirm the Is this entry also relevant for copying control dialog box with Yes.

Note
If the Specify objects to be deleted dialog box occurs, choose all entries.
If you only allow specific sales order types for your sales areas, you must allocate the new sales document type to the relevant sales area
group. In S/4HANA Customizing, follow the path Sales and Distribution Sales Documents Sales Document Header Assign Sales
Area To Sales Document Types.

4.3 Automatically generate Integration settings for Data exchange


1. To automatically generate connectivity settings for Data Exchange navigate using one of the following paths.

Transaction code RCOD_CONNECTIVITY

SAP Reference IMG menu Integration with Other SAP Components  Integration With SAP Cloud for Customer
 Communication Setup  Automatically Generate Integration Settings for Data
Exchange

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 22
2. Generate Integration Settings: Step 1: Select SAP HANA Cloud Integration as the middleware and click Next.

3. Generate Integration Settings: Step 2: Select the scope of Integration exactly as scoped in the SAP Cloud for Customer Solution and
choose Next.
Select the following checkboxes:
 Sales Orders
 Opportunities
 Sales Quotes
 Contracts

4. Generate Integration Settings: Step 3: Maintain the following

Field Entry

Logical System Do one of the following:


 Enter the logical system of the S/4HANA
system or
 Click Create Logical System to create one.
The logical system ID should be the same
as the system ID of your SAP Cloud for
Customer solution.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 23
Field Entry

Note
To find the system ID, login to the SAP
Cloud for Customer system, and
navigate to
AdministratorCommunication
Arrangements. Open any
communication arrangement, say
Business Partner Replication from
External System. You find the ID in the
field My System ID.

Job Schedule Interval Enter the frequency with which the inbound and
outbound IDocs should be processed in the
S/4HANA system.

Job User Enter the user using which batch jobs are
scheduled.

5. Generate Integration Settings: Step 4: Enter the connection information about the CPI system to generate the RFC destinations.

Field Entry

Runtime URL Worker node URL of the CPI tenant (without


HTTPS ://)

Proxy details(Optional) Host name, service name, and the access details of
the forward or reverse proxy?

Authentication (basic or certificate) Either import the certificate or enter the user
credentials.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 24
Note
For Integration with Basic Authentication Configuration and not Certificate based Authentication please refer configuration guide
1EL: Basic Integration setup using SAP Cloud Platform Integration, Section 8.1 Integration with Basic Authentication.

6. Choose Next.
In Generate Integration Settings: Step 5 of 6-Consumer Proxy Settings screen, enter the URL Access path for Contract Call-off.

Note
You can take the URL Access Path from relevant IFlow Replicate Contract Call-off Statistics from SAP Business Suite of your CPI Web UI.

7. In the Summary screen, select the Generate button to generate the configuration entities.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 25
8. Choose Yes, in the confirm pop- up screen.

9. Check the log to see the created entities.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 26
4.4 ALE Setting for the HTTP Inbound
For immediate IDoc processing for HTTP inbound (without using a workflow), please do the following settings:

1. Open transaction OYEA.

2. Choose Edit and set Start W/O Event Linkage under IDoc Inbox HTTP in the Global Parameters for IDoc Interface screen.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 27
3. Choose Save.

4.5 Sales Contract

4.5.1 Define Sales Contract Type


1. Access the following transaction:

Transaction Code VOV8

2. Mark the entry CQ (Quantity Contract) and choose Copy As (F6).


3. Maintain the following values for the copied sales document.

Sales Document Type Description

ZSLC C4C Sales Contract

4. Choose E n t e r on your keyboard.


5. Confirm the Is this entry also relevant for copying control dialog box with Yes.

Note
If the Specify objects to be deleted dialog box occurs, choose all entries.
If you only allow specific sales order types for your sales areas, you must allocate the new sales document type to the relevant sales area
group. In S/4HANA Customizing, follow the path Sales and Distribution Sales Sales Documents Sales Document Header Assign
Sales Area to Sales Document Types.
Perform the CodeList Mapping in SAP Cloud for Customer for the respective value of Sales Contract type and Item category type in
S/4HANA.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 28
4.5.2 Initial Data Load

Purpose

The below steps describe how to execute an initial data load of Sales Contract from your S/4HANA system to the SAP Cloud for Customer
system.

Procedure

1. Open transaction SE38.


2. Input Program as RCOD_CONTRACT_EXTRACT
3. Choose Execute.
4. Select Contract data under Data Set to be extracted.
5. Under Selection of Contract, enter the criteria for which you want to execute the initial load.

Field Description Value

Contract ID Contract to be sent to C4C

Sales Organizational Unit For example: 1710


1010

Distribution Channel For example: 10


20

Division For example: 00


10

Logical System Cloud for Customer Logical <Logical system


System name of the Cloud
for Customer>
For example: 0LO7DJH

6. Disable Test Mode.


7. Choose Execute.
8. Log in to SAP Cloud for Customer system.
9. Navigate to Contracts  Contracts.
10. Check all the Sales Contracts are replicated to SAP Cloud for Customer System.

4.5.3 Configuration for Sales Contract Delta load.

Purpose

The below steps describe the configurations that need to be performed to trigger a Sales Contract Replication to SAP Cloud for Customer
on every Save of Sales Contract in SAP S/4HANA.

Procedure

1. Open transaction NACE.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 29
2. Select the application V1 (Sales), click on Condition records button and double click in COD5 (Contract Replication) output type.

3. Click on Execute and Maintain a new entry.


4. Enter Sales Document type of Sales Contract (e.g. ZSLC), medium as A (Distribution (ALE)) and Date/Time as 4 (Send immediately)

5. Choose Save and then Close.


6. Select the application V1 (Sales) and click on Output types button.

7. Select Output Type COD5 (Contract Replication) and click on Partner functions.

8. Maintain a new entry with Medium as Distribution(ALE) and Funct as SP (Sold-To Party).

9. Choose Save and then Close.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 30
5 Configuration in Cloud Platform Integration

Note
SAP provides prepackaged, generic integration content called integration flows (iFlows) for the integration of SAP Cloud for
Customer with SAP S/4HANA using SAP Cloud Platform Integration. The list of iFlows with their corresponding mappings, can be
downloaded as a spreadsheet. You can download and drill down for more detailed sample field mapping description in the
Integration Flows spreadsheet for each of the iFlows from SAP Service Marketplace
(https://help.sap.com/viewer/p/SAP_HYBRIS_CLOUD_FOR_CUSTOMER ).

Prerequisites
To be able to import and deploy iFlows, you need the AuthGroup.IntegrationDeveloper role assigned in your tenant.

5.1 How to get the CPI Runtime URL


The CPI Runtime URL is included in the CPI provisioning e-mail.

Alternatively, you can get it from the following place once the iFlow Request Sales Order Pricing from SAP Business Suite is deployed. See
Configure and Deploy iFlows using SAP CPI Web UI.

In the CPI Web UI navigate to Monitor. Click on the Started tile. Search for the iFlow iFlow Request Sales Order Pricing from SAP Business
Suite. Click on status Started. The first part of the listed endpoint is the needed CPI tenant runtime URL. Example: https://<tenant>-
iflmap.hana.ondemand.com

5.2 How to get the CPI Client Certificate


In the CPI provisioning e-mail follow the link under Certificate Information. In the resulting screen choose X509 Certificate with option
Binary CER. Download it to your local machine.

5.3 Configure and Deploy the iFlow Using SAP Web UI

Note
 If you have re-deployed key store (system.jks) in your CPI tenant, you need to re-deploy all the iFlows to avoid the
caching issues.
 For Integration with Basic Authentication Configuration and not Certificate based Authentication please refer
configuration guide 1EL: Basic Integration setup using SAP Cloud Platform Integration, Section 8.1 Integration with Basic
Authentication.

1. Connect to the tenant management node of the CPI system with the url http://<tenant management node>/itspaces
2. Go to Design view.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 31
3. Select the Integration Package in your workspace.
Note: Select the package that is used to set up master data.

4. All the iFlows will be shown/ listed under the Artifacts section of the page.

5. Select the iFlows described in the table below and choose Actions button in the right and select Configure.

iFlows to be configured
Name of the iFlow Description of the iFlow Direction of the Message flow

Request Business Document Print Preview Print Preview of Business S4 (Sender) to C4C (Receiver)
from SAP Business Suite Documents in SAP Business Suite

Request Sales Document Data from SAP Pricing in Sales Quote Follow Up C4C (Sender) to S4 (Receiver)
Business Suite Scenario in SAP Business Suite

Request Sales Order Pricing from SAP Pricing in Opportunity Follow Up C4C (Sender) to S4 (Receiver)
Business Suite Scenario in SAP Business Suite

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 32
Request Document Flow from SAP business Business Document Flow Query C4C (Sender) to S4 (Receiver)
Suite from SAP Business Suite

Confirm Customer Order Replication to Sales Order Replication from SAP C4C (Sender) to S4 (Receiver)
SAP Business Suite Business Suite

Create Sales Quote Follow Up Document in Creation of Sales Quote Follow Up C4C (Sender) to S4 (Receiver)
SAP Business Suite Document in SAP Business Suite

Replicate Sales Order and Sales Quote from Sales Order Replication from SAP S4 (Sender) to C4C (Receiver)
SAP Business Suite Business Suite

Notify Opportunity or Sales Quote of Creation of Opportunity Follow Up S4 (Sender) to C4C (Receiver)
Follow Up Document from SAP Business Document in SAP Business Suite
Suite Creation of Sales Quote Follow Up
Document in SAP Business Suite

Replicate Sales Order Attachment to SAP Sales Order Replication to SAP C4C (Sender) to S4 (Receiver)
Business Suite Business Suite

Attachment Replication from SAP Business Replicate Sales Order, Product and S4 (Sender) to C4C (Receiver)
Suite Contract attachment from SAP
Business Suite

Note
The same iFlow is used for Product,
Sales Order and Contract
Attachment replication from S4 to
C4C system.

Replicate Contract from SAP Business Suite Contract Replication from and to S4 (Sender) to C4C (Receiver)
SAP Business Suite

Confirm Contract Replication to SAP Contract Replication from and to C4C (Sender) to S4 (Receiver)
Business Suite SAP Business Suite

Replicate Contract Call-Off Statistics from Contract Replication from and to S4 (Sender) to C4C (Receiver)
SAP Business Suite SAP Business Suite

Request Contract Data from SAP Business Pricing in Contract Replication C4C (Sender) to S4 (Receiver)
Suite Scenario in SAP Business Suite

Note
Use the iFlow Replicate Contract Attachment to SAP Business Suite if you wish to replicate attachment for contract business
object.

Note
You can either configure a single iFlow or do a mass configuration by checking multiple artifacts and Selecting Configuration under
Action Button.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 33
6. Configure the sender system (in this example S4) and receiver system (in this example C4C) details as explained below:
a. Choose Sender Tab: Choose Authentication Method as Certificate-based Authentication
b. Browse for the certificate. See Define Communication system (Configuration in SAP S/4HANA) chapter for the details on the
certificate that needs to be uploaded here.
c. Choose Receiver Tab: Enter the host name as C4C tenant's URL (without https ://) and port as 443.
d. Choose the Authentication type as Client Certificate
e. Choose Save and Choose Deploy
f. Repeat the same procedure for all the iFlows that have the same sender system as S4 and Receiver System as C4C.
7. Choose iFlow to configure the sender system (in this example C4C) and receiver system (in this example S/4HANA) details.
a. Choose Sender Tab: Choose Authentication Method as Certificate-based Authentication.
b. Browse for the certificate. Import the SAP Cloud for Customer communication arrangement X.509 certificate using Browse
button.
c. Choose Receiver Tab: Enter the host name of the reverse proxy server and port of the S/4HANA system. Contact your system
administrator for these details.
d. Choose the Authentication type as Client Certificate.
e. Choose Save and Choose Deploy.

f. Repeat the same procedure for all the iFlows that have the same sender system as C4C and Receiver System as S4.

Note
Check with your system administrator for the Reverse proxy host details.
For the iFlows, which has receiver has C4C, the Host of C4C is the URL of SAP Cloud for Customer system without HTTPS
prefix.

8. The integration flows are deployed in the CPI tenant.


9. To see the deployed artifacts, Check Monitor -> Manage Integration Content.

5.4 Maintain CPI Value Mapping


1. Connect to the tenant management node of the CPI system with the url: http://<tenant management node>/itspaces

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 34
2. Go to Design view.
3. Select the Integration Package in your workspace.

4. All the iFlows will be shown/ listed under the Artifacts section of the page

5. Select the iFlows with name Value Mapping and choose Actions button in the right and select Configure.
All the Mapping Values will be shown/ listed.

6. Search for OrderReason Identifier from the search tab.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 35
7. Edit the value mapping for S4, OrderReason field and enter S4 target Value as “001”.

8. Choose Save and then Deploy.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 36
6 Appendix

6.1 Troubleshooting

6.1.1 SAP Cloud for Customer Sales Quote External Pricing Error
In case if you get an error ‘Business partner does not exist’ in the SAP Cloud for Customer system when executing the external pricing call
for a sales quote, perform the below steps:
1. Navigate to transaction code BP
2. Enter the BusinessPartner number and choose Start. Example, 17100003
3. Select SAP Credit Management in the dropdown field Display in BP role.
4. Choose Credit Profile tab.
5. Select Edit or Change mode.
6. Maintain values as shown in the below screenshot

7. Choose Save.

6.2 Monitor Phase: Monitor Message Flow Across Systems

Note
The way we do monitoring in S/4HANA is similar to SAP ERP /SAP CRM system. So, below guide will work fine to check data flow.

Refer to the ‘Monitoring Guide’ to monitor data flow from SAP ERP to SAP Cloud for Customer System and vice versa.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 37
6.3 Remove Expired Certificate from CPI Keystore

Note
Perform this step only if your CPI Client certificate is expired.

Please remove the expired CPI Client Certificate from system.jks of your Keystore. Add the new CPI Client certificate and re-deploy the
system.jks.

6.4 Configuration in SAP Cloud for Customer: Screen Adaption (optional)

6.4.1 Home Screen Adaption


1. Choose settingAdapt on title bar
2. Choose SALES_ROLE on the Select Role pop up,
3. Choose SettingEdit.
4. Select Tools.
5. Make setting as below:

Example
Item Add to Role Show or Hide

Getting Started Checked Show (Hide button displayed)

My Filters Unchecked

News Checked Show (Hide button displayed)

Shelf Checked Show (Hide button displayed)

6. Choose Publish
7. Choose Update all tiles and Choose Publish.

6.4.2 Adapt Work Center Sales View Opportunities


1. Open an Opportunity
2. Choose AdaptEnter Adaptation Mode on title bar and Choose Yes to continue
3. Choose AdaptEdit Screen, choose tab place, the Tabs setting appears and Select as below for the tab Screen layout

Example
Name Visible

OVERVIEW Checked

PRODUCTS Checked

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 38
SALES TEAM Checked

CONTACTS Checked

4. Choose the Grey Rectangle in Left Pane


5. Select the Opportunity ID and External ID in the Fields on the right
6. Choose Publish, Select Overwrite individual personalization changes to this screen and Choose Publish
7. Close the adaptation window to leave the adaption mode.

6.5 Outbound Sales Order IDoc Configuration Setup


Below configurations need to be done manually in case the entries are missing due to issues in execution of BC Set Activation as performed
in section Business Configuration Set

6.5.1 Maintain Output Type


The customizing entry described in this step is contained within the Business Configuration Set (BC Set) C4C_INTEGRATION_CS. Check if
the values are maintained as described in the following procedure.

Procedure

1. Access the following transaction:

Transaction Code V/30

2. Switch to edit mode.

3. Choose New Entries.


4. Create the Output type COD4 by maintaining the following values:

Field Value

Output Type COD4

Description Order Replication (COD)

Access sequence 0002 (Order Type)

Access to Conditions Yes (mark the checkbox)

Cannot be changed No (do not mark the checkbox)

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 39
Multiple issuing Yes (mark the checkbox)

Partner-indep. Output Yes (mark the checkbox)

Do not write processing log No (do not mark the checkbox)

5. Double click on Processing routines and add a processing routine for the transmission medium Distribution (ALE) by maintaining
values as shown in the following table:

6. Click Save. The system may ask you to create the request for this, maintain the meaningful information

6.5.2 Maintain Output Determination Procedure

Procedure

1. Access the transaction using one of the following navigation options:

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 40
Transaction Code SM34

IMG Menu Sales and Distribution Basic Functions Output Control Output
Determination Output Determination using the Condition Technique
Maintain Output Determination for Sales Documents Maintain Output
Determination Procedure

2. Choose the activity Maintain Output Determination Procedure. Maintain view VVC_T683_XX_V1 in SM34 transaction.

3. Mark the output determination procedure assigned to the following Order Types.

Order Type Procedure


Order Output V10000

4. Choose Control Data within the Dialog Structure


5. Choose New Entries and assign the output COD4 as shown in the following table:

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 41
Field Value
Step 99 (or any other unused step number)

Counter 0

Condition Type COD4

6. Choose Save.

6.5.3 Create Output –Condition Records

Procedure

1. Access the following transaction:

Transaction Code VV11

2. Choose the Output type as COD4 and select Key combination.


3. Enter below details for your sales document type.

4. Choose Save.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 42
www.sap.com/contactsap

© 2018 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.
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. Please see http://global.sap.com/corporate-
en/legal/copyright/index.epx#trademark for additional trademark
information and notices.
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 SE or its affiliated companies shall not be liable for
errors or omissions with respect to the materials. The only warranties
for SAP SE 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.
In particular, SAP SE or its affiliated companies have no obligation to
pursue any course of business outlined in this document or any
related presentation, or to develop or release any functionality
mentioned therein. This document, or any related presentation, and
SAP SE’s or its affiliated companies’ strategy and possible future
developments, products, and/or platform directions and functionality
are all subject to change and may be changed by SAP SE or its
affiliated companies at any time for any reason without notice. The
information in this document is not a commitment, promise, or legal
obligation to deliver any material, code, or functionality. All forward-
looking statements are subject to various risks and uncertainties that
could cause actual results to differ materially from expectations.
Readers are cautioned not to place undue reliance on these forward-
looking statements, which speak only as of their dates, and they
should not be relied upon in making purchasing decisions.

SAP Cloud for Customer Integration with SAP S/4HANA using SAP Cloud Platform Integration CUSTOMER
© 2018 SAP SE or an SAP affiliate company. All rights reserved. 43