ballerinax/sap.s4hana.api_salesorganization_srv Ballerina library

Overview

S/4HANA is a robust enterprise resource planning (ERP) solution, designed for large-scale enterprises by SAP SE.

The ballerinax/sap.s4hana.api_salesorganization_srv package provides APIs that enable seamless integration with the Sales Organization - Read API v1.0.0. The service allows users to read sales organization master data.

Setup guide

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

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

   

3. In the search bar, type SAP Analytics Cloud for Planning Integration and select the corresponding scenario from the results.

   

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

   

5. Enter a unique name for the arrangement.

   

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

   

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

   

Quickstart

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

Step 1: Import the module

Import the sap.s4hana.api_salesorganization_srv module.

import ballerinax/sap.s4hana.api_salesorganization_srv as salesorg;

Step 2: Instantiate a new connector

Use the hostname and credentials to initiate a client

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

salesorg:Client salesOrgClient = check new (
    hostname = hostname,
    config = {
        auth: {
            username,
            password
        }
    }
);

Step 3: Invoke the connector operation

Now, utilize the available connector operations.

salesorg:Wrapper listASalesOrganization = check salesOrgClient->listA_SalesOrganizations();

Step 4: Run the Ballerina application

bal run

Examples

The S/4 HANA Sales and Distribution Ballerina connectors provide practical examples illustrating usage in various scenarios. Explore these examples, covering use cases like accessing S/4HANA Sales Order (A2X) API.

1. Salesforce to S/4HANA Integration - Demonstrates leveraging the sap.s4hana.api_sales_order_srv:Client in Ballerina for S/4HANA API interactions. It specifically showcases how to respond to a Salesforce Opportunity Close event by automatically generating a Sales Order in the S/4HANA SD module.