Set Up SAP S/4HANA for Tekst

This guide is for your SAP S/4HANA administrator. It explains how to set up SAP S/4HANA Cloud Public Edition so that the Tekst iFlows on your SAP BTP Cloud Integration (CPI) tenant can call it.

You create a communication user, a communication system that represents your CPI tenant, and a communication arrangement for each SAP scenario your Tekst blocks use. At the end, you hand the API host and the communication user to whoever deploys the Tekst iFlow package in CPI.

This is the second step of the SAP S/4HANA setup. It comes after Set Up the SAP BTP Role and Service Key for Tekst and before Deploy the Tekst iFlow Package in CPI.

Before you start

You need:

• Administrator access to SAP S/4HANA Cloud Public Edition, including the apps to maintain communication users, communication systems and communication arrangements
• The CPI runtime host: the url value of the Tekst service key, without https:// (for example, your-tenant.it-cpitrial06-rt.cfapps.us10-001.hana.ondemand.com). Your SAP BTP administrator gets this value when creating the service key.

Step 1: Create a communication user

The communication user is the account the Tekst iFlows sign in with when they call SAP S/4HANA.

1. Open the Maintain Communication Users app and click New.
2. Enter a User Name (for example, TEKST_CPI_USER) and a Description.
3. Under Password, click Propose Password and copy the password. Keep it somewhere safe: it is needed again in CPI.
4. Click Create.

Step 2: Create a communication system

The communication system represents your CPI tenant in SAP S/4HANA.

1. Open the Communication Systems app and click New.
2. In the New Communication System dialog, enter a System ID and a System Name (for example, TEKST_CPI) and click Create.

3. On the General tab, under Technical Data, fill in:
   • Host Name: your CPI runtime host, which is the service key's url without https://. Enter the host only, with no path.
   • Port: 443

4. On the Users for Inbound Communication tab, click +. In the New Inbound Communication User dialog, set Authentication Method to User Name and Password, select the communication user from step 1 in User Name/Client ID, and click OK.

5. Save the communication system.

Step 3: Create the communication arrangements

A communication arrangement connects an SAP scenario to your communication system. Which arrangements you need depends on the Tekst blocks you use:

Scenario	Scenario name	Needed for these Tekst blocks
SAP_COM_0109	Sales Order Integration	Create sales order, Update sales order, Get sales order
SAP_COM_0008	Business Partner, Customer and Supplier Integration	Get business partner, Get customer ship-to locations
SAP_COM_0009	Product Integration	Get product
SAP_COM_0053	Purchase Order Integration	Get purchase order
SAP_COM_0118	Sales Quotation Integration	Get sales quotation

To create sales orders with the Create sales order block, set up at least SAP_COM_0109, SAP_COM_0008 and SAP_COM_0009.

For each scenario:

1. Open the Communication Arrangements app and click New.
2. In the New Communication Arrangement dialog, select the Scenario. The Arrangement Name fills in with the scenario ID, which you can keep. Click Create.

3. Under Common Data, select the communication system from step 2 in Communication System.
4. Under Inbound Communication, User Name fills in automatically with the communication user from step 1. Check that it is the right user.
5. If the arrangement lists Outbound Services, leave Service Status unchecked (not Active) for each of them. Tekst only calls into SAP S/4HANA, so no outbound service is needed.

6. Save the arrangement.

Check the result

Open the SAP_COM_0109 arrangement. Under Inbound Services, the list shows Sales Order (A2X) with application protocol OData V2 and a service URL like https://myXXXXXX-api.s4hana.cloud.sap/sap/opu/odata/sap/API_SALES_ORDER_SRV.

Step 4: Hand over the API host and the communication user

Give two things to whoever deploys the Tekst iFlow package in CPI:

• The API host of your SAP S/4HANA system. Copy the API-URL under Common Data of any of your arrangements, such as SAP_COM_0109, for example https://myXXXXXX-api.s4hana.cloud.sap. It is the host only, with no path.
• The communication user from step 1 and its password.

They enter both in CPI, as described in Deploy the Tekst iFlow Package in CPI.

Other SAP S/4HANA editions

On SAP S/4HANA Private Cloud or on-premise, your SAP team makes the same APIs available its own way, through a Cloud Connector.