Sales Scheduling Agreements - 3NR - Set-Up HANNA
Sales Scheduling Agreements - 3NR - Set-Up HANNA
1 Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Cloud-to-Cloud Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1 Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
2.2 Communication Arrangement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Communication User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Communication Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Maintain Communication Arrangement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3 Configuration in SAP Integration (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Deploy Technical Communication User Data with Credential Artifact. . . . . . . . . . . . . . . . . . . . . . . . . 8
Deployment and Configuration of Integration Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.4 Configuration in S/4HANA Cloud. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Application Related Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Define Mapping for Inbound Texts for Integration with Buyers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
BRF+Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Assign Recipients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Maintain Customer Material (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
This document describes additional configuration steps that must be carried out by customers to activate the
Integration of SAP S/4HANA Sales Scheduleing Agreement (3NR) scope item. Since these configuration steps are
customer-specific, they cannot be delivered by SAP and must be carried out by the customer.
Setting up this scenario depends on the type of the buyer system. If the buyer system is an SAP S/4HANA cloud
system, follow the instructions in the Cloud-to-Cloud Integration chapter. The chapter describes how you can
implement the cloud-to-cloud deployment option without the SAP Integration middleware in between, as depicted
in the following figure:
If the buyer
system is an SAP on-premise system, follow the instructions in the Cloud-to-On-Premise Integration chapter. With
this deployment option, you will implement the integration of the SAP S/4HANA Sales system with an SAP S/
4HANA or SAP ERP Buyer on-premise system through SAP Integration as depicted in the following figure:
2.1 Preparation
2.1.1 Prerequisites
Depending on your configuration environment for SAP S/4HANA Cloud, choose one of the following options to
check the status:
If the scope item is not active, request the activation through BCP – Ticket Component: XX-S4C-OPR-SRV.
During the activities described in this guide, you are required to enter or provide system-specific information. To
ensure a smooth and efficient integration to SAP S/4HANA, ensure that you have the information listed in the
following table before starting the integration process.
SAP S/4HANA Clooud System System details such as URL, Username, and Password
Note
These are just examples since details depend on the
actual supplier system. Liaise with your supplier to get the
required system information.
Buyer System System details, such as host name, URLs, URIs, Username,
and Password
You must activate a communication arrangement in SAP S/4HANA for communication with Web services.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Communication Management Maintain Communication Users .
3. Choose New.
4. Enter User Name, Description, and Password.
5. Choose Create.
Purpose
Procedure
Note
6. Under Business Partner, choose Add to add the Supplier Business Partner ID, for example, 10100003.
7. In the Usewr for Inbound Communication area, choose Add.
The Inbound Communication User mentioned in the procedure here must be used as an Outbound
Communication User in the buyer system.
8. On the New Inbound Communication User screen, enter the following details:
○ User Name: <User name that you have created eariler>
○ Authentication Method: User Name and Password
9. Choose OK.
10. In the User for Outbound Communication area, choose Add.
11. On the New Outbound Communication User screen, enter the following details:
○ User Name: <Inbound Communication User details provided by the buyer>
○ Password: <Password>
○ Authentication Method: User Name and Password
12. Choose OK and then save.
Purpose
Procedure
8. The system now automatically updates default information from the communication system and
communication scenario. For example, user IDs as well as inbound and outbound services.
9. Choose Save.
Note
To work with the integration flows of this package, copy the prepackaged integration flow scenario to your
workspace. Then configure the integration flows. Finally, to activate the integration flows, deploy them.
To carry out configuration in the S/4HANA Cloud Integration, the URL of your Cloud Integration tenant is required.
This URL is provided by the Cloud Integration tenant provisioning mail.
Purpose
Note
Procedure
1. Open the Cloud Integration tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Monitor.
Name <s4cesupplier_credential>
Description <Optional>
Name <opbuyer_credential>
Description <Optional>
Name <MailUserCredential>
Description <Optional>
Procedure
1. Open the Cloud Integration tenant Web UI, for example, https://<your SAP Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Discover.
3. Select All to see all the published integration packages.
Setting up the connection between buyer and supplier using EDI requires some basic configuration activities as
described in the following chapters.
To configure the EDI integration, users require the following catalog roles in S/4HANA Cloud:
Purpose
In this Customizing activity, you map the External Partner number to Internal Partner number.
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Sales Scheduling Agreement Master Data Assign Sold-to Parties .
○ On the list page of the fiori app, you can see all the processing options that are saved in database as well as
the draft processing options.
3. On click of Create (+), you can create a new Sold-to Party assignment with Supplier, Partner Description,
Unloading Point and valid Sold-to Party.
4. Choose +, and enter the following details:
Unloading Point
Sold-to Party 10100003 (invalid Sold-to Party or empty Sold-to Party will
result in error)
5. Choose Save (ensure that the supplier, Partner Description, unloading point combination is unique).
Purpose
In this master data fiori app, you can define Sold-to Party and Unloading Point and also configure the behavior of
Check purchase order number and unloading point.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Sales Scheduling Agreement Master Data Manage Delivery Schedule Processing .
○ On the list page of the fiori app, you can see all the processing options that are saved in database as well as
the draft processing options.
3. On click of Create (+), you can create a new processing option with valid Sold-to Party and enter an unloading
point. You can also maintain the check for purchase order number and unloading point. Unloading point is
optional.
4. Choose +, and enter the following details:
Sold-to Party 10100003 (invalid Sold-to Party or empty Sold-to Party will
result in error)
Unloading Point
5. Choose Save (ensure that the supplier, plant, unloading point combination is unique).
Purpose
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Customer Master Manage Customer Master Data .
3. On the list page of the fiori app, choose the Business Partner Number, such as 10100003 for DE, 17100003 for
US.
4. Choose Go and select the customer entry.
5. On the screen of Customer, choose Edit, navigate to Sales Areas tab, choose the line of sales organization, for
example, 1010 for DE, 1710 for US.
6. On the Sales Area screen, navigate to Partner Functions tab , make following entries:
Purpose
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Customer Master Manage Customer Master Data .
3. On the list page of the Fiori app, choose the Business Partner Number, such as 10100003 for DE, 17100003 for
US.
4. Choose Go and select the customer entry.
5. On the screen of Customer, choose Edit, navigate to Company Codes tab, choose the line of company code, for
example, 1010 for DE, 1710 for US.
6. On the Company Code screen, navigate to Correspondence tab , make following entries:
Purpose
An external buyer system might send long texts relevant for the supplier using the SOAP service interface. For
example, a purchase order message sent from the external buyer system can contain texts that need to be stored
with the corresponding sales order in the supplier system.
For integration with the external buyer system, you can define the mapping between the inbound SOAP service text
types and the text IDs in the supplier's SAP S/4HANA Cloud system.
Depending on your configuration environment for SAP S/4HANA Cloud, choose one of the following options:
1 Log On Log on to the SAP Fiori launchpad as a The SAP Fiori launch
BPC_EXPERT . pad displays.
6 Change item cate Choose New Entries. You can create your own
gory assignment entries as shown in the following examples, and
choose Save:
XML XML
Msg. Text
Type Txt.Obj. Type TxSch ID
1 Log on Log on to the project experience in SAP Central The SAP Fiori
Business Configuration. launchpad displays.
3. Check Flexible Choose New Entries. You can create your own
Workflow for PO entries as shown in the following examples, and
Approval choose Save:
XML
Msg. XML Text
Type Txt.Obj. Type TxSch ID
Purpose
In BRF+, you set parameters that control the output from SAP S/4HANA.
Purpose
In this Customizing activity, you define how the system determines output parameters for Advance Shipping Notice
(ASN).
Prerequisites
You must have the user and password along with authorization to access the S/4HANA cloud system.
Procedure
Test Step # Test Step Name Instruction Expected Result Pass / Fail / Comment
Determination Step:
Output Type
● #: <next
higher
number>
● Delivery Type:
<blank>
● Output Type:
DELIVERY_NOT
E(Delivery
Note)
● Dispatch Time: 1
(Immediately)
● #: <next
higher
number>
● Output Type:
blank
● Role: WE
● Exclusive Indicator:
False
Choose Edit.
● #: <next
higher
number>
● Output Type:
DELIVERY_NOT
E(Delivery
Note)
● Role: WE
● Receiver ID:
<blank>
● Channel: EDI
Choose Edit.
● #: <next
higher
number>
● Output Type:
DELIVERY_NOT
E(Delivery
Note)
● Document Cat.:
J(Delivery)
● TotalGdsMvtStat: C
(Completely
processed)
● Relevance
Indicator: X
(True)
Purpose
In this Customizing activity, you define how the system determines output parameters for Supplier invoice.
You must have the user and password along with authorization to access the SAP S/4HANA cloud system.
Procedure
2 Output In the Select Business Rules section, enter the re Details are displayed
Type quired details: in the Maintain
Business Rules sec
Show Rules for: Billing Document
tion.
Determination Step: Output Type
Choose Edit.
Choose Edit.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Select Message Monitoring Assign Recipients to Users .
3. On the Assign Recipients to User screen, Choose Add User.
4. On the Add User screen, enter your Name or ID, for example, CONF_EXPERT_BUS_NET_INT, then Choose Add.
5. If the user to be assigned to recipients already exists, directly choose the user in the left area, then on the right
Recipients for User screen, choose Assign.
6. In the Assign Receiptents dialog box enter below entries and choose Assign.
7. Choose Assign.
8. Repeat the steps from 5 to 7 for both Namespace and Recipient for Alert.
/SDEDI EDI_SD_INVC_RECIPIENT
/LEEDI EDI_DELOUT_RECIPIENT
Purpose
Note
If the customer-masterial info record already exists, or if you want to maintain the customer
material manually when creating the scheduling agreement, you may skip the step.
This chapter is about master data maintenance and does not refer to a customizing activity.
In this activity, you maintain unique customer-specific names for your company's products.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system with role
SAP_BR_INTERNAL_SALES_REP.
2. Choose Manage Customer Materials.
3. Choose Create Object.
4. Enter Customer, Product, Sales Organization, Distribution Channel, and Customer Material.
5. Choose Save.
For each material that customers order through EDI, you maintain a customer material. The customer material
maps the ID, which the customer uses for the material ordered, to a material.
Follow the instructions in this chapter only if the buyer system is an SAP on-premise system that you connect with
through SAP Cloud Integration.
3.1 Prerequisites
It is mandatory that Sales Scheduling Agreements(3NR)Scope Item is active. You can check this in the Manage Your
Solution App under View Solution Scope.
If the scope item is not active, request the activation through BCP – Ticket Component: XX-S4C-OPR-SRV.
During the activities described in this guide, you are required to enter or provide system-specific information. To
ensure a smooth and efficient integration to SAP S/4HANA, ensure that you have the information listed in the
following table before starting the integration process:
SAP S/4HANA Cloud Platform Integration System System details such as URL, Username, and Password
Note
These are just examples since details depend on the
actual supplier system. Liaise with your supplier to get the
required system information.
Buyer System System details, such as host name, URLs, URIs, Username,
and Password
Supplier System System details such as host name, URLs, URIs, User, and
Password
Note
These are just examples since details depend on the
actual supplier system. Liaise with your supplier to get the
required system information.
To configure the EDI integration, users require the following business roles in S/4HANA Enterprise Cloud:
For more information about how to manage business users and business roles, see Identity and Access
Management in the SAP Help Portal.
For all scenarios integrating SAP S/4HANA Cloud with SAP On-Premise scenarios, the SAP_COM_0200 – Cloud
Connector communication arrangement must be activated. This is a prerequisite for all other communication
arrangements.
To check if the SAP_COM_0200 – Cloud Connector communication arrangement is active in your system, go to the
Maintain Communication Arrangements app. If it is not active, you must set it up.
To set up the communication scenario, follow the procedure under Integrating SAP Cloud Connector.
Purpose
In this master data fiori app, you can define Supplier, Partner Description, Unloading Point and Sold-to Party.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Sales Scheduling Agreement Master Data Assign Sold-to Parties .
○ On the list page of the fiori app, you can see all the processing options that are saved in database as well as
the draft processing options.
3. On click of Create (+), you can create a new Sold-to Party assignment with Supplier, Plant, Unloading Point and
valid Sold-to Party.
4. Choose +, and enter the following details:
Purpose
In this master data fiori app, you can define Sold-to Party and Unloading Point and also configure the behavior of
Check purchase order number and unloading point.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Sales Master Data Manage Delivery Schedule Processing .
○ On the list page of the fiori app, you can see all the processing options that are saved in database as well as
the draft processing options.
3. On click of Create (+), you can create a new processing option with valid Sold-to Party and enter an unloading
point. You can also maintain the check for purchase order number and unloading point. Unloading point is
optional.
4. Choose +, and enter the following details:
Sold-to Party 10100003 (invalid Sold-to Party or empty Sold-to Party will
result in error)
5. Choose Save (ensure that the supplier, plant, unloading point combination is unique).
Purpose
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Customer Master Manage Customer Master Data .
3. On the list page of the fiori app, Choose the Business Partner Number, such as 10100003 for DE, 10100007 for
US.
4. On the screen of Customer, Choose Edit, navigate to Sales Areas tab, choose the line of sales organization, for
example, 1010 for DE, 1710 for US.
5. On the Sales Area screen, navigate to Partner Functions tab , make following entries:
Purpose
An external buyer system might send long texts relevant for the supplier using the SOAP service interface. For
example, a scheduling agreement message sent from the external buyer system can contain texts that need to be
stored within the corresponding scheduling agreement in the supplier system.
For integration with the external buyer system, you can define the mapping between the inbound SOAP service text
types and the text IDs in the supplier's SAP S/4HANA Cloud system.
Procedure
Depending on your configuration environment for SAP S/4HANA Cloud, choose one of the following options:
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Implementation Cockpit Manage Your Solution Configure Your Solution .
3. On the Configure Your Solution: Realize Phase screen, make the following entries:
○ Application Area: Sales
○ Sub Application Area: Blank
4. In the Configuration Item area, choose the entry that has these values and also the Name as Integration
with Buyers.
8. Choose Save.
4. Choose Save.
Purpose
In BRF+, you set parameters that control the output from SAP S/4HANA.
Purpose
In this Customizing activity, you define how the system determines output parameters for Advance Shipping Notice
(ASN).
Prerequisites
You must have the user and password along with authorization to access the S/4HANA cloud system.
Procedure
Test Step # Test Step Name Instruction Expected Result Pass / Fail / Comment
Determination Step:
Output Type
● #: <next
higher
number>
● Delivery Type:
<blank>
● Output Type:
DELIVERY_NOT
E(Delivery
Note)
● Dispatch Time: 1
(Immediately)
● #: <next
higher
number>
● Output Type:
blank
● Role: WE
● Exclusive Indicator:
False
Choose Edit.
● #: <next
higher
number>
● Output Type:
DELIVERY_NOT
E(Delivery
Note)
● Role: WE
● Receiver ID:
<blank>
● Channel: EDI
Choose Edit.
● #: <next
higher
number>
● Output Type:
DELIVERY_NOT
E(Delivery
Note)
● Document Cat.:
J(Delivery)
● Goods Mvmnt Sts:
C (Completely
processed)
● Relevance
Indicator: X
(True)
Purpose
In this Customizing activity, you define how the system determines output parameters for Supplier invoice.
You must have the user and password along with authorization to access the SAP S/4HANA cloud system.
Procedure
Test Step # Test Step Name Instruction Expected Result Pass / Fail / Comment
Determination Step:
Output Type
● #: <next
higher
number>
● Delivery Type:
<blank>
● Output Type:
BILLING_DOCUM
ENT(Billing
Document)
● Dispatch Time: 1
(Immediately)
● #: <next
higher
number>
● Output Type:
BILLING_DOCUM
ENT(Billing
Document)
● Role: RE
● Exclusive Indicator:
false
Choose Edit.
● #: <next
higher
number>
● Output Type:
BILLING_DOCUM
ENT(Billing
Document)
● Role: <blank>
● Receiver ID:
BILL-TO PARTY
(Example for US is
1710001 and for
DE is 17100001)
● Channel: EDI
Choose Edit.
● #: <next
higher
number>
● Output Type:
BILLING_DOCUM
ENT(Billing
Document)
● Posting Status: C
(Posting
document has
been created)
● TotalGdsMvtStat: C
(Completely
processed)
● Relevance
Indicator: X
(True)
Note
● You can make table entries with an empty Receiver ID to make it applicable to all receivers (wildcard). If a
more specific entry with a Receiver ID exists, it would overrule the more generic entry without Receiver ID.
● If you are maintaining entries without Receiver ID, make sure that you put them at the end of the list.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Select Message Monitoring Assign Recipients to User .
3. On the Assign Recipients to User screen, Choose Add User.
4. On the Add User screen, enter your Name or ID, for example, CONF_EXPERT_BUS_NET_INT, then Choose Add.
5. On the Assign Receipts screen, enter below entries and choose Assign.
6. Choose Assign.
7. On the Recipients (Cloud Edition) screen, choose Append Row.
8. Repeat the steps from 3 to 7 for both Namespace and Recipient for Alert.
/SDSAR EDI_SD_INVC_RECIPIENT
/LEEDI EDI_DELOUT_RECIPIENT
Purpose
This chapter is about master data maintenance and does not refer to a customizing activity.
In this activity, you maintain unique customer-specific names for your company's products. This must be done for
all materials, which customers order through EDI.
Procedure
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.
2. Choose Manage Customer Materials.
Purpose
Procedure
1. Log on as SAP Integration Administrator to your Cloud Integration tenant WEB UI, for example, https://
<your SAP BTP tenant URL>/itspaces.
2. In the tenant menu, choose Monitor.
3. Choose the Keystore in the Manage Security section.
4. Search for sap_cloudintegrationcertificate. (Type Key Pair).
5. Choose Download Certificate.
6. Enter or select the file path to store the certificate in your local machine.
Procedure
1. 1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud Supplier system.
2. Choose Communication Management Maintain Communication Users .
3. Choose New.
4. Maintain the Username and Description.
5. Assign a password for the user to use basic authentication. Else, assign the SAP Integration public client
certificate to the user for certificate-based authentication.
Note
Basic authentication with a username and password is possible, but not recommended in a productive
environment due to security reasons.
Procedure
Field Value
5. Choose OK.
6. In the Uder for Outbound Communication User screen, choose Add.
7. On the New Outbound Communication User screen, enter the following details:
○ User Name: <User details provided by the Buyer>
For username, enter <CPI Tenant UserName>.
○ Authentication Method: Username and Password or SSL Client certificate
○ For Client Certificate, enter Default Client Certificate.
6. Choose Save.
Procedure
○ Inbound Services:
5. Choose Save.
Procedure
For certificate-based authentication, a certificate signed by one of the CAs mentioned in the SAP BTP Integration
Service operations guide is mandatory. For a list of supported CAs, in the SAP Help Portal, proceed as follows:
1. Go to transaction SE16.
2. On the Data Browser: Initial screen, enter Table Name as STRUSTSSL.
3. Choose Table and then Create Entries.
4. Confirm the Information dialog box with Enter.
5. Choose New Entries.
6. On the New Entries: Overview of Added Entries screen, enter a new SSL Client name (with Identity as SAPCPI
and Description as CPI Connection).
7. Choose Save and then select or create a workbench request.
8. Go to transaction STRUST.
9. On the Trust Manager: List screen, a new entry appears with the name SSL Client <Description text in step 6>.
Note
It is also possible to use an already-available signed certificate. In that case, import the p12 file into the PSE
mentioned in step 11. For more information about how to import the p12 file into PSE, see Importing a
PKCS#12 File.
12. Double-click the PSE in the SSL Client <Description text in step 6> folder. The details of the PSE are displayed
on the right side.
13. Choose the Import Certificate icon in the Certificate section.
14. Enter or select the File path to one of the public certificates of the SAP HCP integration service load balancer:
○ Baltimore Cybertrust Root
○ GTE CyberTrust Global Root
15. Choose Enter.
16. Choose the Add to Certificate List icon. The certificate appears in Certificate List of Own Certificate.
17. Repeat the steps for the second public certificate of the SAP HCP integration service load balancer.
18. Choose Save.
Purpose
This public certificate of the on-premise system is required to configuration the Integration Flows.
Procedure
1. Go to transaction STRUST.
2. On the Trust Manager: Display screen, choose the SSL Client (Standard or Anonymous or your own SSL Client
PSE).
3. Double-click Own Certificate on the right side.
4. Verify certificate details in the Certificate section.
5. Choose Display Change (Ctrl+F1) .
6. Choose Export Certificate in the Certificate section to export the public certificate.
7. Accept the default File Format, and in the Export Certificate dislog box, enter or select a File path (with
extension .cer or .crt).
8. Choose Enter to continue and store the certificate.
Basic authentication with a user and password is possible. However, it is not recommended in a productive
environment due to security reasons.
To connect the on-premise system to the Cloud Integration service, you require an SAP BTP integration service
user with the appropriate roles assigned. This should be a generic user. Ideally, an explicit SAP SCN user must be
created for this.
Procedure
Purpose
For setting up certificate-based authentication, a communication user is required to configure the basic
authentication or to be mapped to a client certificate.
Procedure
1. Go to transaction SU01.
2. In the User field, enter the system username.
5. Choose Save.
Purpose
For setting up certificate-based authentication, a client certificate must be mapped to the communication user.
Procedure
1. Go to transaction SM30.
2. Enter the name of the VUSREXTID view in the Table/View field and choose Maintain.
3. In the External ID type field, enter DN and choose Continue.
4. Create a new entry by choosing New Entries.
5. Choose Import to import the public client certificate from the SAP integration system.
6. Select the file that contains the public certificate and choose Open.
7. Enter the sequence, for example 000, the User ID you have created.
8. Select the Activated checkbox.
9. Choose Save.
To work with the integration flows of this package, copy the prepackaged integration flow scenario to your
workspace. Then configure the integration flows. Finally, to activate the integration flows, deploy them.
To carry out configuration in the HANA Cloud Integration, the URL of your Cloud Integration tenant is required. This
URL is provided by the Cloud Integration tenant provisioning mail.
Purpose
Note
In the Communication Arrangement chapter, a Communication User in your SAP S/4HANA Cloud (buyer and
supplier) system was created. You must store these credentials in your Cloud Integration tenant as User Credential.
Procedure
1. Open the Cloud Integration tenant Web U, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Monitor.
3. Choose Security Material in the Manage Security Material section.
4. Choose Add.
5. Select User Credentials.
6. Enter the following values in the Add Users Credential dialog box:
Suppplier Cloud System Credentials
Name <s4cesupplier_credential>
Description <Optional>
Name <opbuyer_credential>
Description <Optional>
Name <MailUserCredential>
Description <Optional>
Procedure
1. Open the Cloud Integration tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Discover.
3. Select All to see all the published integration packages.
4. Search for the Integration package name SAP S/4HANA Cloud for Sales Integration with SAP S/4HANA.
5. Choose the package to display the package content.
6. To copy the integration package of the catalog to your customer workspace, choose Copy Package in the upper
right corner.
7. In the tenant menu, choose Design.
Purpose
Value mappings are required and are delivered as a template. This template is part of the prepackaged SAP Cloud
Integration content. This value mapping template must be adapted based on the configuration settings in
customer systems (SAP S/4HANA cloud and SAP S/4HANA/ERP on-premise).
Procedure
1. In the Design section, select the package, which contains the integration content.
An overview of the artifacts available in the selected integration package is displayed in the Artifacts tab.
2. Select the value mapping artifact Value Mapping for Supplier in Cloud and Buyer in OnPremise.
3. To configure value mapping, choose Configure in the Actions column for the respective artifact.
4. In the Value Mappings section, depending on your customizing, check and adapt the values of mappings of the
following fields:
○ PartnerNumber
○ TextIDHeader
Maintain corresponding values in the on-premise system for the following Text IDs available in S/4HANA Cloud
system:
○ SalesNote
○ PickPackInstruction
○ ShippingInstructions
For example:
EKKO SalesNote
○ TextIDItem
○ PickPackInstructions
EKPO SalesNote
Note
Text node is created and the corresponding text is passed to the receiver system only if the TextID is
maintained in the Value Mapping table.
5. Choose Save.
Procedure
1. Choose the icon in the top left corner and select the Design section from the dropdown list.
All available integration packages for the tenant are displayed.
2. Search for the package name Integration of SAP S/4HANA Cloud for Sales Integration with SAP S/4HANA.
3. Choose the integration package.
The package content list is displayed.
4. Select Artifacts.
All the artifacts are listed at the bottom of the page.
5. In the Actions menu of the value mapping artifact, choose Deploy.
Procedure
1. Open the Cloud Integration tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Design.
3. On the Design tab page, select the package Integration of SAP S/4HANA Cloud for Sales Integration with SAP
S/4HANA, which contains the integration flows objects.
Field Value
Sender OPBuyer
Address /EDI/DELINS_DELFOR02
This address must be unique on Cloud Integration tenant. If you want to deploy this scenario
twice on the same tenant, change this address.
For Certificate Choose Browse and select the stored certificate (see Export S/4 HANA Cloud Supplier Public
Authentication Certificate).
6. Enter the relevant details on the Receiver tab page for the receiver, S4CEsupplier:
Field Value
Receiver S4CESupplier
To retrieve the SOAP Service URL, check the Communication Arrangement created in Create
7. Enter the relevant details on the Receiver tab page for Cloud Integration error mail notification. (Optional - Keep
default values if Mail Notification is not active):
Field Value
Receiver CPI_Error
Address <smtp.server.com:port>
From <mailfrom@mail.com>
To <mailto@mail.com>
CC <cc@mail.com>
BCC <bcc@mail.com>
If you want to receive the complete error log, keep the mail
body unchanged.
8. If you want to implement mapping extension for this iFlow, enter the relevant details on the Receiver tab page
for the receiver, IDOC2SOAP_SalesSchedulingAgreementCustomMapping_iFlow:
Field Value
Address /EDI/DELINS_DELFOR02_CustomMap
This address must be unique on Cloud Integration Tenant. If this scenario has to be deployed twice
on the same tenant, you must change this address. In addition to that, the address maintained here
must be the same as the one defined for the sender ProcessDirect adapter in the corresponding
order confirmation custom integration flow.
For more information about the mapping extension process, refer to the Developing and Deploying Mapping
Extensions for Integration Package chapter.
Field Value
Enable Logging Set to true if payload must be logged as an attachment to Message Processing Log (MPL). The
attachments can be found in the message details under Web UI Operations View
Mail Notification For SAP S/4HANA, if you require mail notifica- tions for integration service errors and SAP S/
4HANA Cloud Sales errors, enter true to set it to active.
Procedure
1. Open the Cloud Integration tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Design.
3. On the Design tab page, select the required package, which contains the integration scenarios.
An overview of the artifacts available in the selected integration package is displayed.
4. To configure the Invoice Request, choose Configure in the Actions column of the Receive Supplier Invoice
artifact.
5. Enter the relevant details on the Sender tab page:
Sender S4CESupplier
Address /EDI/InvoiceRequest_in
(This address must be unique on Cloud Integration Tenant. If you want to deploy this scenario
twice on the same tenant, change this address.)
For Certificate Choose Browse and select the stored certificate (see Export S/4 HANA Cloud Supplier Public
Authentication Certificate).
6. Enter the relevant details on the Receiver tab page for the receiver, OPBuyer:
Field Value
Receiver OPBuyer
https://<ReverseProxy/Webdispatcher host>:<ReverseProxy/
Webdispatcher port>/sap/bc/srt/idoc?sap- client=<OP_Client>
http://<opbuyer_host>:<opbuyer_port>/sap/bc/srt/idoc?sap-
client=<op_client>
Ensure that the host and port of the on-premise system are accessible through public
network. Reverse proxy/SAP Webdispatcher or cloud connector, depending on customer
landscape, can be used to expose on-premise system to the public.
The usage of a Cloud connector is recommended. Details for configuring a Cloud connector
are available in the SAP Help Portal.
Authentication Basic Authentication or Certificate Authentication (for Cloud connector, only Basic or None)
For more information about certificate to user mapping, see Configure SSL Client certificates
for On-Premise chapter.
7. If you want to implement mapping extension for this iFlow, enter the relevant details on the Receiver tab page
for the receiver, SOA2IDoc_InvoiceCustomMapping_iFlow:
Field Value
Address EDI/SupplierInvoiceRequest_CustomMap
For more information about the mapping extension process, refer to the Developing and Deploying Mapping
Extensions for Integration Package chapter.
8. Enter the relevant details on the Receiver tab page for Cloud Integration error mail notification. (Optional - keep
default values if Mail Notification is not active):
Field Value
Receiver CPI_Error
Address <smtp.server.com:port>
From <mailfrom@mail.com>
To <mailto@mail.com>
If you want to receive the complete error log, keep the mail
body unchanged.
Field Value
Enable Logging Set to true if payload must be logged as an attachment to Message Processing Log (MPL). The
attachments can be found in the message details under Web UI Operations View
Mail Notification For SAP BTP, if you require mail notifica- tions for integration service errors and SAP S/4HANA
Cloud Sales errors, enter true to set it to active.
Receiver Parnter <Logical system name of SAP on-premise system in the format
SIDCLNTXXX, where SID is the system ID of SAP on-premise system
and XXX denotes Client number (as defined in transaction WE20
under Partner Type LS)>
Receiver Port <Logical system name of SAP on-premise system in the for mat
SIDCLNTXXX, where SID is the system ID of SAP on- premise system
and XXX denotes Client number (as defined in transaction WE20
under Partner Type LS)>
Sender Partner <Logical system name of SAP S/4HANA as explained in the Define
Logical System chapter> (can be checked using transaction WE20Partner Type LS)
Sender Port <Free text to be mapped to the RCVPOR field in IDoc>. For example, the
Logical System name in Define Logical System.
Procedure
1. Open the Cloud Integration tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Design.
3. On the Design tab page, select the required package, which contains the integration scenarios.
An overview of the artifacts available in the selected integration package is displayed.
4. To configure the Delivery Request, choose Configure in the Actions column of the Advance Shipping Notification
artifact.
5. Enter the relevant details on the Sender tab page:
Field Value
Sender S4CESupplier
Address /EDI/DeliveryRequest_in
(This address must be unique on SAP Cloud BTP Tenant. If you want to deploy this scenario
twice on the same tenant, change this address.)
For Certificate Choose Browse and select the stored certificate (see Export S/4 HANA Cloud Supplier Public
Authentication Certificate).
6. Enter the relevant details on the Receiver tab page for the receiver, OPBuyer:
Field Value
Receiver OPBuyer
https://<ReverseProxy/Webdispatcher host>:<ReverseProxy/
Webdispatcher port>/sap/bc/srt/idoc?sap- client=<OP_Client>
http://<opbuyer_host>:<opbuyer_port>/sap/bc/srt/idoc?sap-
client=<op_client>
Ensure that the host and port of the on-premise system are accessible through public
network. Reverse proxy/SAP Webdispatcher or cloud connector, depending on customer
landscape, can be used to expose on-premise system to the public.
The usage of a Cloud connector is recommended. Details for configuring a Cloud connector
are available in the SAP Help Portal.
Authentication Basic Authentication or Certificate Authentication (for Cloud connector, only Basic or None)
For more information about certificate to user mapping, see Configure SSL Client certificates
for On-Premise chapter.
7. If you want to implement mapping extension for this iFlow, enter the relevant details on the Receiver tab page
for the receiver, SOA2IDoc_DeliveryCustomMapping_iFlow:
Field Value
Address /EDI/DeliveryRequest_CustomMap
For more information about the mapping extension process, refer to the Developing and Deploying Mapping
Extensions for Integration Package chapter.
8. Enter the relevant details on the Receiver tab page for SAP Integration error mail notification. (Optional - keep
default values if Mail Notification is not active):
Field Value
Receiver CPI_Error
Address <smtp.server.com:port>
Authentication
From <mailfrom@mail.com>
To <mailto@mail.com>
If you want to receive the complete error log, keep the mail
body unchanged.
Field Value
Enable Logging Set to true if payload must be logged as an attachment to Message Processing Log (MPL). The
attachments can be found in the message details under Web UI Operations View
Mail Notification For SAP S/4HANA , if you require mail notifica- tions for integration service errors and SAP S/
4HANA Cloud Sales errors, enter true to set it to active.
Receiver Parnter <Logical system name of SAP on-premise system in the format
SIDCLNTXXX, where SID is the system ID of SAP on-premise system
and XXX denotes Client number (as defined in transaction WE20
under Partner Type LS)>
Receiver Port <Free text to be mapped to the RCVPOR field in IDoc in the
format SAPSID, where SID is the system ID of the SAP on- premise
system>
Sender Partner <Logical system name of SAP S/4HANA as explained in the Define
Logical System chapter> (can be checked using transaction WE20Partner Type LS)
Sender Port <Free text to be mapped to the RCVPOR field in IDoc>. For example, the
Logical System name in Define Logical System.
The Integration of SAP S/4HANA Sales Scheduling Agreements enables you to implement the following processes:
scheduling agreement between buyer and supplier, outbound delivery, and customer invoice. For each process, a
standard structure for source and target messages, including messages mappings, is delivered and used in the
corresponding integration flow out of the box.
For some or other reasons, you may want to change the standard process by adding, for example, new fields to the
standard messages structure, or by changing the messages mappings. This section describes how you can add
custom fields to your standard structure for source and target messages and provide a custom message mapping
to reflect the fields enhancement in your Integration Content.
To facilitate the extension process as described above, a dedicated Integration Package named SAP S/4HANA
Cloud for Sales Integration with SAP S/4HANA - Extension Mapping has also been published in the content catalog.
For each integration flow available in the standard integration package, a corresponding custom (or mapping)
integration flow has been delivered within the mapping extension package. This allows you to define or customize
your mapping or field extensions. For example, for the invoice process a corresponding integration flow is available
in the mapping extension package. It can be used to define any mapping deviation from the standard process.
From a technical perspective, SAP Integration provides an adapter called ProcessDirect adapter to connect the
standard iFlow (also known as producer) and custom iFlow (also known as consumer). The ProcessDirect adapter
connects the plug-in touchpoints at a lower network latency in comparison to the SOAP or HTTP adapter.
Providing a dedicated custom integration package combined with the ProcessDirect adapter for extension
purposes has the following advantages:
For more information about ProcessDirect adapter, see Configure Communication Channel with ProcessDirect
Adapter in SAP Help Portal.
The package SAP S/4HANA Cloud for Sales Integration with SAP S/4HANA - Extension Mapping comes with the
following integration flows out of the box:
● Receive Supplier Invoice Custom Mapping-to define mapping extension for invoice process
● Advance Shipping Notification Custom Mapping-to define mapping extension for the outbound delivery process
● Update Sales Scheduling Agreements Custom Mapping-to define mapping extension for the sales scheduling
agreement delivery schedule process
To aid in the implementation of your mapping extensions, templates for custom integration flows, defining some
processing steps are delivered. The delivered templates are generic and provide quite the same steps for all custom
integration flows.
You must understand the structure of the template before you start implementing the extension. The most
important parts of the templates are the following:
● Sender component
It represents the producer or the standard integration flow.
● Sender ProcessDirect adapter
The adapter is used to consume data from the standard integration flow.
Note that the address maintained in the Sender ProcessDirect adapter must be the same as the one defined in
the Receiver ProcessDirect adapter in standard integration flow. Those parameters have been externalized to
allow you to configure them easily during the integration flow configuration.
● Exception subprocess
It is used to handle exceptions directly in custom integration flows.
The extension procedure is the same for all integration flows. The procedure described here is a general one and
applies to all custom integration flows.
First, you must extend either your target structure or source structure, or both, directly in the source system or
target system. This can be an IDoc type or a SOAP message, depending on your business requirements. Second,
you must generate a corresponding WSDL file to be imported and used in your custom integration flow in Cloud
Integration Service.
For more information about how to extend an IDoc type in an on-premise system (S/4HANA or SAP ERP), see the
respective chapter on SAP Help Portal.
For information about how to extend a SOAP API in S/4HANA using the Custom Fields and Logic app, see the
respective chapter on SAP Help Portal.
Note
The custom mapping integration package is released only once, and its lifecycle management is under the
control of the customer. So, you must always make sure that the standard WSDLs files used in the mapping
extension integration flow objects are up-to-date or consistent with the corresponding WSDLs files of the
standard integration flow before extending or using them in the mapping integration flow objects.
To generate and download a WSDL for the IDoc-XML message structure in your Supplier system (SAP S/4HANA or
ERP), do as follows:
To download the WSDL of the extended SOAP API in your Buyer system (SAP S/4HANA Cloud), do as follows:
1. Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system
2. Go to Communication Management Communication Arrangements .
3. Search for the communication arrangement object (created in the Create Communication Arrangement
chapter).
This object was created using the SAP_COM_0444 communication scenario.
4. Select the communication arrangement to open it.
5. To download WSDL for the outbound API (in this case, Purchase Order), scroll down to the Outbound Services
section.
6. Choose Download WSDL on the right side of the API name.
7. Save the downloaded file in your local system.
8. To download WSDLs for inbound APIs (in this case, Order Confirmation, Invoice and Delivery), scroll down to
the Inbound Services section.
9. Choose the arrow (WSDL Column) on the right side of the Service URL/Service Interface column.
10. Save the downloaded file in your local system.
Procedure
Purpose
After implementing and testing your custom mapping, configure and deploy the custom integration flow during the
runtime of the SAP BTP integration service.
Procedure
1. Open the SAP Cloud BTP tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Design.
3. On the Design tab page, select the package Integration of SAP S/4HANA Cloud for Sales Integration with SAP
S/4HANA - Extension Mapping, which contains the integration flows objects.
4. Choose Configure in the Actions column of the custom integration flow that you want to configure. For example,
Update Sales Scheduling Agreements Custom Mapping.
5. Enter the relevant details on the Sender tab page:
Field Value
Sender OPBuyer
This address must be unique on the Cloud Integration tenant. If you want to deploy this
scenario twice on the same tenant, change this address. Additionally, the address maintained
here must be the same as the one defined for the receiver ProcessDirect adapter in the
standard integration flow.
6. Enter the relevant details on the Receiver tab page for the receiver, Custom_CPI_Error:
Field Value
Receiver Custom_CPI_Error
Address <smtp.server.com:port>
From <mailfrom@mail.com>
To <mailto@mail.com>
If you want to receive the complete error log, keep the mail
body unchanged.
Field Value
Mail Notification For SAP BTP, if you require mail notifications for integration service errors and SAP S/4HANA
Cloud Sales errors, enter true to set it to active.
8. Choose Save.
9. Choose Deploy to directly deploy the iFlow.
Purpose
By activating the extension process, the custom integration flow where you have implemented your custom
mapping, is called through a touch point defined in the standard integration flow. This touch point or exit point is
defined using an external property, which can be set to true or false by configuring the standard integration flow.
Procedure
1. Open the Cloud Integration tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. In the tenant menu, choose Design.
3. On the Design tab page, select the package Integration of SAP S/4HANA Cloud for Sales Integration with SAP
S/4HANA, which contains the integration flows objects.
Field Value
6. On the Receiver tab, choose the receiver corresponding to your custom integration flow as defined in the
standard integration flow.
For example, Create, Change, or /EDI/DELINS_DELFOR02_CustomMap.
7. Ensure that the value maintained for the Address parameter is the same as the one maintained in the sender
ProcessDirect adapter of the custom integration flow.
8. Choose Save.
9. Choose Deploy.
Purpose
On the SAP Integration Web UI, you can analyze the deployed integration flows in the Monitoring section.
Procedure
Purpose
On the SAP Integration Web UI, you can analyze the deployed integration flows in the Monitoring section.
1. Open the Cloud Integration tenant Web UI, for example, https://<your Cloud Integration tenant
URL>/itspaces.
2. Choose Monitor.
3. On the Overview screen, choose the tile with a message status you want to analyze.
4. On the left side, select the message you want to analyze. The issues that occurred on the right pane are
displayed.
Purpose
Procedure
1. Log on to FLP and navigate to Message Monitoring tab. Open the Message Dashboard.
2. Choose Sales SchedgAgrmt process integration - /SDSAR.
3. Choose All Messages to check all relevant AIF messages.
4. Below error messages are usually displayed in message dashboard.
Error Description Multiple sales scheduling agreements are found for Sold-to
Party &1
Diagnosis The system uses the following search criteria to search for a
sales scheduling agreement:
○ The Sold-to Party that either comes in with the EDI
message or is determined in the Assign Sold-to Parties
app.
○ Customer material, partner description, and unloading
point (if any) that comes in with the EDI message.
Procedure
○ Delete the old sales schedule agreement in Change
Document Delete .
○ Reject both header and item level of sales schedule
agreement in Change Sales Scheduling Agreement
app Reason for Rejection .
Diagnosis The system uses the following search criteria to search for a
sales scheduling agreement:
○ The sold-to party that either comes in with the EDI
message or is de-termined in the Assign Sold-to
Parties app.
○ Customer material, partner description, and unloading
point (if any) that comes in with the EDI message
System Response
Error Description Unloading point &1 does not match in sales scheduling
agreement &2
Error Description Delivery schedule processing option not found for sold-to
party &1
Diagnosis
Diagnosis MRP for DS type setting to E JIT delivery schedules are not
used in sales schedule agreement
System Response If only created JIT delivery schedule release, system stops
processing the EDI message.
If create both FRT and JIT schedule release, system will only
process FRT release, JIT will not process
Error Description Release no. &1 has already been allowed for in scheduling
agreement &2 (OP)
Diagnosis The release number entered has already been allowed for,
that is, it corresponds to the release number for the
preceding release number
Procedure Choose another release number from the number for the
preceding release number, change in Change Sales
Scheduling Agreement app Select Item Fore.DlSch or
JIT DlSch Dlv.schedule filed .
Error Description The text ID for the received text type &1 cannot be
determined
Procedure Define mapping for inbound texts type for integration with
buyers.
Line 1 in CL_GOAL_ACCESS================CM01I
(CL_GOAL_ACCESS================CP)
System Response The system stops processing and raise exception when JIT
release coming and execute first.
Error Description The old delivery schedule &1 is not identical with delivery
schedule &2.
Procedure Choose another release number from the number for the
preceding release number, change in Change Sales
Scheduling Agreement app > Select Item > Fore.DlSch or JIT
DlSch > Dlv.schedule filed .
Procedure As the message sender, you review the schedule line in the
purchase scheduling agreement. To recreate those old
schedule lines that are not copied, you do it manually.
System Response The system adds (a) order quantities in the existing
schedule lines or (b) existing schedule lines by the quantity
that has been delivered behind schedule.
System Response The system reduces (a) order quantities in the existing
schedule lines or (b) existing schedule lines by the quantity
that has been delivered ahead of schedule.
Procedure Manually correct the date type to one of the followings and
reprocess the message:
D (Day)
W (Week)
M (Month)
3.7 Appendix
All CA-GTF-INT-EDI
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 a 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.
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.
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.