ballerinax/sap Ballerina library

Overview

SAP is a global leader in enterprise resource planning (ERP) software. Beyond ERP, SAP offers a diverse range of solutions including human capital management (HCM), customer relationship management (CRM), enterprise performance management (EPM), product lifecycle management (PLM), supplier relationship management (SRM), supply chain management (SCM), business technology platform (BTP), and the SAP AppGyver programming environment for businesses.

The ballerinax/sap package provides an HTTP client for interfacing with APIs across SAP's product suite. This client comes with built-in SAP system-complient CSRF token authentication.

Setup guide

In this guide, we'll be utilizing the S/4HANA Sales Order API to showcase the capabilities of the SAP Client.

Step 1: Login

1. Sign in to your S/4HANA dashboard.

Step 2: Create a Communication System

1. Under the Communication Management section, click on the Display Communications Scenario title.

   

2. In the top right corner of the screen, click New.

   

3. Give a system id.

   

4. Give the hostname as your S/4HANA hostname.

   

5. Add Users for Inbound Communication.

   

6. Select the Authentication Method and User.

   

7. Click Save.

Step 3: Create a Communication Arrangement

1. Under the Communication Management section, click on the Display Communications Scenario title.

   

2. In the search bar, type Sales Order Integration and select the corresponding scenario from the results.

   

3. In the top right corner of the screen, click on Create Communication Arrangement.

   

4. Enter a unique name for the arrangement.

   

5. Choose an existing Communication System from the dropdown menu and save your arrangement.

   

6. The hostname (<unique id>-api.s4hana.cloud.sap) will be displayed in the top right corner of the screen.

   

Quickstart

To use the sap connector in your Ballerina application, modify the .bal file as follows:

Step 1: Import the module

Import the sap module.

import ballerinax/sap;

Step 2: Instantiate a new connector

configurable string hostname = ?;
configurable string username = ?;
configurable string password = ?;

sap:Client sapClient = check new (string `https://${hostname}/sap/opu/odata/sap/API_SALES_ORDER_SRV`, {
    auth: {
        username,
        password
    }
});

Step 3: Invoke the connector operation

Now, utilize the available connector operations.

json salesOrderList = check sapClient->/A_SalesOrder();

Step 4: Run the Ballerina application

bal run

Examples

The sap connector provides practical examples illustrating usage in various scenarios. Explore these examples, covering use cases like accessing S/4HANA Sales Order (A2X) API.

1. Send a reminder on approval of pending orders - This example illustrates the use of the sap:Client in Ballerina to interact with S/4HANA APIs. Specifically, it demonstrates how to send a reminder email for sales orders that are pending approval.