How to connect to SAP S/4HANA Cloud

The Apideck Accounting API uses Basic Authentication with a dedicated SAP Communication User. Before you can connect, an SAP administrator must create a Communication Arrangement that grants the Communication User access to the OData services this connector reads from.

Create a Communication Arrangement

1. Sign in to your SAP S/4HANA Cloud tenant as an administrator and open the Communication Arrangements app (Fiori launchpad → search "Communication Arrangements").

2. Choose New and activate the Communication Scenario that covers the resources you need. The most common scenarios used by this connector are:

   • SAP_COM_0008 – Business Partner Integration (customers, suppliers)
   • SAP_COM_0057 – Supplier Invoice Integration (bills, purchase orders)
   • SAP_COM_0120 – Billing Document Integration (invoices, invoice items)
   • SAP_COM_0303 – Accounting Document Integration (journal entries, payments, bill payments)
   • SAP_COM_0466 – Trial Balance Integration (balance sheet)
   • SAP_COM_0084 – Finance Master Data Integration (ledger accounts, cost centers, profit centers, company codes)

3. Bind a Communication User to the arrangement. If you do not already have one, create it from the Maintain Communication Users app and assign a strong password. Note the user's ID and password — you will paste these into Vault.

4. Authentication method on the arrangement must be User ID and Password (Basic Authentication). OAuth is rejected by several of the OData services used by this connector.

5. Save and activate the arrangement.

Find Your Tenant ID

Your tenant ID is the subdomain prefix of your SAP S/4HANA Cloud API host. For example, if your API host is my123456-api.s4hana.cloud.sap, then my123456 is your tenant ID. You can find it in the SAP BTP subaccount overview or in the URL bar when using the Fiori launchpad.

Vault Connection Setup

Paste the values below into Vault:

• Tenant ID – The subdomain prefix of your SAP S/4HANA Cloud API host (e.g., my123456). Do not include -api.s4hana.cloud.sap.
• Username – The Communication User ID from the Communication Arrangement.
• Password – The Communication User password.
• Default Company Code – A 1–4 character uppercase alphanumeric SAP company code (e.g., 1010). This is required for balance-sheet reads and is used as the default company code for other resources. It can be overridden per request with the x-apideck-company-id header.
• Default Ledger – The SAP ledger ID (1–2 uppercase alphanumeric characters, default 0L for the leading ledger). Used by the balance-sheet read.
• Default Financial Statement Hierarchy (optional) – The Financial Statement Version (FSV) ID (e.g., INT). When set, the balance-sheet response will be nested by FSV node.

Click Save, then click Authorize.

Your SAP S/4HANA Cloud account is now connected.