Business Scenario
Exercise Options
Prerequisites
Task 1: Prepare the Remote System and Create a Destination
Steps
Prepare the remote system connectivity via a destination.
To navigate to the API Business Hub, open https://api.sap.com/ in a separate tab.
In the Search field, enter Sales Order (A2X), and choose Enter.
Scroll down.
Choose SAP S/4HANA Cloud Sales Order (A2X) OData API.
To view configuration details, select the scroll bar to scroll down.
Choose Configuration Details.

You can now copy the Value of SANDBOX URL and save it for later us.

Create a destination.
Use the following data:
Field | Value |
---|
Name | SalesOrderS4Sandbox |
Type | HTTP |
Description | Destination for SAP Business Accelerator Hub Sandbox API for SAP S/4HANA Cloud Sales Orders |
URL | https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV |
Proxy Type | Internet |
Authentication | NoAuthentication |
Key | sap.processautomation.enabled |
Value | true |
Open the SAP BTP cockpit for the subaccount where you use SAP Build Process Automation.
Choose Destinations.
Choose New Destination.
In the Name field, enter SalesOrderS4Sandbox.
As Type, choose HTTP.
In the Description field, enter Destination for SAP Business Accelerator Hub Sandbox API for SAP S/4HANA Cloud Sales Orders.
In the URL field, enter https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV.
As Proxy Type, choose Internet.
As Authentication, choose NoAuthentication.
Choose New Property.
In the Key field, enter sap.processautomation.enabled
In the Value field, enter true.
This property makes destinations configured in your SAP BTP subaccount visible to SAP Build Process Automation.
Choose Save.
Assign SalesOrderS4Sandbox to SAP Build Process Automation.
Open SAP Build Process Automation.
Choose Settings.
Choose Destinations.
Choose New Destination.
Select SalesOrderS4Sandbox.
Choose Add.
This destination is available for use within SAP Build Process Automation processes.
Task 2: Create a New Process and a Trigger Form for it
Steps
Create a new process to include an Action.

Use the following data:
Field | Value |
---|
Project Name | Read Sales Order info from SAP S/4HANA |
Short Description | Exercise using actions to communicate with SAP S/4HANA Sandbox API |
Name | GetSalesOrderInfo |
Identifier | getSalesOrderInfo (auto filled) |
Description | Process to read Sales Order info from SAP S/4HANA Sandbox API |
Choose Lobby.
Choose Create.
Choose Build an Automated Process.
Choose Business Process.
In the Project Name field, enter Read Sales Order info from SAP S/4HANA

NoteThe figure shows S/4HANA, only
In the Short Description field, enter Exercise using actions to communicate with SAP S/4HANA Sandbox API.
Choose Create.

NoteThe figure shows S/4HANA, only.
In the Name field, enter GetSalesOrderInfo.
In the Identifier field, you do not have to enter anything.
In the Description field, enter Process to read Sales Order info from SAP S/4HANA Sandbox API.
Choose Create.
Create a trigger form for the process.
Use the following data:
Field | Value |
---|
(Form) Name | GetSalesOrderInfoForm |
(Form) Identifier | getSalesOrderInfoForm (auto filled) |
Header |
Title | Enter the number of a Sales Order that needs to be checked |
(Text) Title | Sales Order Number |
Configuration | Required |
Choose Add → Forms → New Form.
In the Name field, enter GetSalesOrderInfoForm.
In the Identifier field, you do not have to enter anything, it will be filled automatically.
Choose Create.
Choose Form.
Choose H1.
In the Title field, enter Enter the number of a Sales Order that needs to be checked.
Choose Text.
In the Title field, enter Sales Order Number.
Select Required.
Choose Save.
Task 3: Use Actions
Steps
Include an Action in the process to call the SAP S/4HANA Sandbox API for sales orders.
Use the following data:
Field | Value |
---|
Action Identifier | SalesOrderAPIDestination (auto filled) |
Description | Destination for the Sales Order API in an SAP S/4HANA Cloud system |
Choose GetSalesOrderInfo.
Choose Add → Actions → Browser library.
Choose Add.
Choose Action.
Open the Destination variable list.
Select Create Destination Variable.
In the Identifier field, enter SalesOrderAPIDestination.
In the Description field, enter Destination for the Sales Order API in an SAP S/4HANA Cloud system.
Choose Create.
Use the destination variable.
You can now see that the destination variable was created as an environment variable in the project and can be managed via the project properties. This makes your process definition independent from the actual destination to be used, and lets you define it at each deployment of a new process version.
Choose Inputs.
Choose Select item for SalesOrder.
Choose Sales Order Number.

In the API call performed with the Action, the SalesOrder URL parameter will be filled with the actual Sales Order Number given by the end user in the trigger form when starting the process. The APIKey parameter does not need any special assignment, as you have maintained the API key as a default value in the Actions project earlier.
When using a real SAP S/4HANA Cloud system, the authentication and authorization are defined by the communication arrangement and the destination, thus, an APIKey will not be required in that case.

Choose Outputs.
To view the resulting data structure of the API call, choose the arrow.
You can now see the resulting data structure of the API call.
Create an approval form which displays the sales order data.
Use the following data:
Field | Value |
---|
Name | SalesOrderApprovalForm |
Identifier | salesOrderApprovalForm (auto filled) |
Choose Add → Approvals → New Approval Form.
In the Name field, enter SalesOrderApprovalForm.
In the Identifier field, you do not have to make an entry. It will be filled automatically.
Choose Create.
Choose Select item for Subject.
Choose Sales Order Number.
Choose Select item for Subject.
Select the scroll bar to scroll down.
Choose Process Started By.
Configure the SalesOrderApprovalForm.
Use the following data:
Type | Field | Value | Configuration |
---|
Header 1 | Title | Approval for Sales Order | |
Header 2 | Title | Sales Order Info | |
Text | Title | Sales Order Number | Read Only |
Choose Settings.
Choose Open Editor.
Choose H1.
In the Title field, enter Approval for Sales Order.
Choose H2.
In the Title field, enter Sales Order Info.
Choose Text.
In the Title field, enter Sales Order Number.
As Configuration, select Read Only.
This is the result:
Create another form.
Use the following data:
Category | Element | Title | Setting |
---|
Inputs | Text | Sales Order Type | Read Only |
Inputs | Text | Net Value | Read Only |
Inputs | Text | Distribution Channel | Read Only |
Inputs | Text | Division | Read Only |
Inputs | Text | Sales Organization | Read Only |
Inputs | Text | Sales Order Date | Read Only |
Inputs | Text | Customer Reference | Read Only |
Inputs | Text | Requested Delivery Date | Read Only |
Create the form as explained earlier.
Configure the form.
Use the following data:
Field | Value |
---|
(H2) Title | Add your comment here and select Approve or Reject |
(Text) Title | Approval Comment |
Choose H2.
In the Title field, enter Add your comment here and select Approve or Reject.
Choose Text Area.
In the Title field, enter Approval Comment.
Choose Save.
Choose Close.
Choose GetSalesOrderInfo.
Drag Reject, and drop on End.
Match the result of the Action API call with the approval form elements.
Use the following data:
Field | Value |
---|
Distribution Channel | DistributionChannel |
Division | OrganizationDivision |
Net Value | TotalNetAmount |
Requested Delivery Date | RequestedDeliveryDate |
Sales Order Date | SalesOrderDate |
Sales Order Number | GetSalesOrderInfoForm → Sales Order Number |
Sales Order Type | SalesOrderNumber |
Sales Organization | SalesOrganization |
Choose SalesOrderApprovalForm.
Choose Inputs.
Choose Select item for Customer Reference.
Choose PurchaseOrderByCustomer.
Similarly, use the assignments above for the remaining fields.
Choose Save.
This is the result:
Task 4: Release, Deploy, and Test the Process
Steps
Release and deploy the process.
Choose Release.
In the Version Comment field, enter Reads Sales Order info from SAP S/4HANA.
Choose Release.
Choose Deploy.
Open the Destination list.
Select SalesOrderS4Sandbox.
Choose Confirm.
Choose Deploy.
Test the deployed process.
Use the following data:
Field | Value |
---|
Approve Comment | Approved |
Choose GetSalesOrderInfo.
Choose GetSalesOrderInfoForm.
Choose Copy.
Open another tab in the browser and paste the copied link, then choose Enter.

The trigger form of the deployed process displays.
In the Sales Order Number field, enter 1.
Choose Submit.
You can now see that a pop-up displays that the request was submitted successfully.
Open the SAP Build Lobby.
Choose MyInbox.
You can now see a new workitem Sales Order 1.
Select the scroll bar to scroll down.
In the Approve Comment field, enter Approved.
Choose Approve.

You now know how to create an Actions project for a selected API from SAP Business Accelerator Hub, how to include a published Action in your process, and how to connect the external system to be called via a destination. This gives you many possibilities when required to create new business processes based on the data in your enterprise's systems.

Result
You have successfully performed calling remote systems APIs using Actions in a process.
This concludes the interactive tutorial.