Connect Sana to SAP

To establish connection between Sana Commerce Cloud and SAP, in Sana Admin click: System > ERP connection and enter the necessary settings.

The table below provides the description of the settings necessary to establish connection between Sana Commerce Cloud and SAP.

Field Description
Connection type Select the necessary connection type:
  • SAP ECC: This connection method uses the username and password of the SAP user to authenticate requests. Sana Commerce Cloud includes these credentials in each request to SAP ECC, which then validates them to authorize access.
  • SAP S/4HANA: This connection method uses the username and password of the SAP user to authenticate requests. Sana Commerce Cloud includes these credentials in each request to SAP S/4HANA, which then validates them to authorize access. While simple to configure, this method is considered less secure compared to OAuth.
  • SAP S/4HANA (OAuth): This option leverages the OAuth 2.0 protocol through the SAP Integration Suite, providing a more secure and modern approach to authorization. Sana Commerce Cloud uses a client ID and secret to obtain a short-lived access token through a secure authorization flow. This token is included in each request, and SAP S/4HANA grants access based on its validity. This method enhances security by avoiding the need to transmit or store user credentials.
Webservice URL

Enter the Webservice URL.

  • For the SAP S/4 HANA (OAuth) connection through SAP Integration Suite, this would be an HTTP endpoint for the IFlow that forwards Sana Commerce Cloud requests to SAP.

  • For the SAP S/4HANA and SAP ECC connection types without middleware, use the NetWeaver Gateway ICF service URL with SSL enabled. For more information on how to get the webservice URL, see Web Service Configuration (NetWeaver Gateway / ICF) and Setup Web Service to Use SSL.

Authentication type
NOTE

Applies to
: SAP ECC and SAP S/4HANA connection types.

Select the authentication type that is used on the server where the SAP webservice is installed. To connect Sana Commerce Cloud to SAP, the authentication type must be the same for Sana and for ERP.

Available authentication types:

  • Basic
  • NTLM
  • Windows
Access Token URL
NOTE

Applies to
: SAP S/4HANA (OAuth) connection type.

Enter the Access Token URL, Client ID and Client secret generated from the service key of the process runtime instance in your SAP Business Technology Platform (BTP) account.

For more information, see Creating Service Instance and Service Key for Inbound Authentication on the SAP website.

Client ID
Client secret
Extra parameters This field is used when you need to specify some extra parameters in the connection to SAP. Use the ";" character to separate multiple parameters.
Connection timeout Determines the time to wait while trying to establish a connection before terminating the attempt. You can set the amount of time in seconds a connection waits to time out. A connection timeout means that a server is taking too long to reply to a data request. For more information, see Timeout.

Default: 60 seconds

User domain Enter your active directory that is associated with SAP.
User Enter the user name and password of the user created in SAP.
Password
Enable Logging If logging is enabled, all requests from the Sana Admin and webstore to SAP and responses will be written to the tracelog file on the server. By default logging is disabled as it affects performance and storage usage. Therefore, we recommend using it only for debugging purposes and disable when it is not needed.

Once this option is enabled, the logging will work for 8 hours. When the time runs out, logging will automatically stop. 8 hours is the default value, but you can change it if necessary. To do this, please contact your Sana Commerce representative.

For more information about logging in Sana, see Logs.

Enable connection This option is used to enable and disable SAP connection. When it is disabled, Sana Admin and webstore are not connected to SAP.

If you disable ERP connection, you cannot access pages in Sana Admin and manage data that depend on ERP, such as product pages and shop accounts. You can continue to create content as long as it doesn't depend on data from ERP, and, for example, work on webstore design and other settings.

If you have synced general settings, products and customers between Sana Commerce Cloud and your ERP system before disabling the ERP connection, your webstore can continue to operate in the maintenance mode.

Click Test connection, to check whether the connection between Sana and SAP is established.

Now the Sana web store is connected to SAP and you can try it out.

Get started with the Sana web store integrated with SAP:

  1. Use the Get Started guide to get to know about Sana Commerce.

  1. Read the Sana User Guide to learn about Sana Commerce features and tools and how to configure them.

  1. Refer to the SAP ECC and SAP S/4HANA Sana user manuals for in-depth information about the core settings which you need to configure in SAP ECC and SAP S/4HANA and master data management.