Skip to main content
Administrator access to the SAP S/4HANA Cloud tenant is required to create Communication Users and Communication Arrangements, and you need a client certificate issued by a CA that SAP trusts.

​
Find your API host

The API host is where StackOne sends requests.

1

Work out the host

For Cloud Public Edition, take your Fiori launchpad host and add -api after the system ID.

  • Launchpad https://my123456.s4hana.cloud.sap/ui gives API host my123456-api.s4hana.cloud.sap
  • For Private Edition or on-premise, use the host and port your Basis team exposes for OData, e.g. s4.example.com:44300

​
Prepare the certificate

SAP only accepts client certificates signed by a CA on the SAP Global Trust List (SAP Note 2801396).

1

Get a CA-signed certificate

Obtain an X.509 client certificate and its private key from a CA on the SAP Global Trust List. You need both in PEM (Base64) format, with the private key unencrypted.

  • Convert a binary DER .cer with openssl x509 -inform der -in cert.cer -out cert.pem
  • Remove a key password with openssl pkey -in key.pem -out key-plain.pem
  • Private Edition and on-premise: import the issuing CA into STRUST (SSL server PSE) and map the certificate to a user with CERTRULE; no Communication User or Arrangement is used

​
Create the Communication User

The certificate identifies a Communication User.

1

Upload the certificate

Open Maintain Communication Users, click New, enter a User Name (e.g. STACKONE_INTEGRATION) and upload the client certificate under certificate-based authentication. Click Create.

​
Create the Communication Arrangements

Each API is enabled by a Communication Arrangement.

1

Create a Communication System

Open Communication Systems, create a system for StackOne and add the Communication User under Users for Inbound Communication with authentication method SSL Client Certificate.

2

Create the arrangements

Open Communication Arrangements and create one arrangement per API, each using the Communication System above.

  • SAP_COM_0008 for Business Partner, Customer and Supplier
  • SAP_COM_0009 for Product
  • SAP_COM_0109 for Sales Order and Sales Order Simulation
  • SAP_COM_0120 for Billing Document
  • SAP_COM_0118 for Sales Quotation, SAP_COM_0119 for Sales Contract
  • SAP_COM_0294 for Sales Pricing Condition Records, SAP_COM_0134 for Customer Material
  • SAP_COM_0164 for Material Stock, SAP_COM_0108 for Material Documents
  • SAP_COM_0374 for Warehouse, Storage Bins and Fixed Bins, SAP_COM_0755 for Warehouse Stock, SAP_COM_0353 for Warehouse Orders and Tasks
  • SAP_COM_0008 is needed for the connection test; for the others, create only the arrangements for the APIs you use, actions for other APIs return 403
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.