Skip to main content

Celonis Product Documentation

SAP Ariba

The SAP Ariba modules allow you to monitor, list, retrieve, update, and delete the approvable, approver group members, groups, group members, and download the attachments in your SAP Ariba account.

Getting Started with SAP Ariba

Prerequisites

  • An SAP Ariba account - create an SAP Ariba account by visiting ariba.com/ and contact the sales team.

The module dialog fields displayed in bold (in the Execution Management System Action Flow, not in this documentation article) are mandatory.

Connecting SAP Ariba to Execution Management System

To connect your SAP Ariba account to Execution Management System you need to obtain the Application Key, Client ID, and Client Secret from your SAP Ariba account and insert it in the Create a connection dialog in the Execution Management System module.

1. Log in to your developer.ariba.com/ account.

2. Click the Manage Application icon 61f1668ab4306.png

61f1668b9bf6f.png

3. Select the application for which you want to establish the connection. Click Action > Generate OAuth Secret.

61f1668ccc643.gif

4. Copy the Application Key, OAuth Client ID, and Client Secret values to a safe place or download and store the values to a safe folder.

61f16690bfa1a.png

5. Go to Execution Management Systemand open the SAP Ariba module's Create a connection dialog.

61f16691b9741.gif

6. In the Connection name field, enter a name for the connection.

7. In the Application Key, OAuth Client ID, and OAuth Secret fields enter the values copied in step 4 respectively.

8. In the Realm field, enter your application realm details. You can find the realm details on the application screen.

9. Click Continue.

The connection has been established.

Document Approval

Triggers when documents or tasks are pending approval.

Connection

Establish a connection to your SAP Ariba account.

Approvable Type

Select or map the option to watch the pending approvals:

  • Requisitions

  • Invoices

Limit

Set the maximum number of pending approvals Execution Management System should return during one scenario execution cycle.

User

Select or map the user whose pending approvals you want to watch.

Password Adapter

Enter (map) the password adapter to watch the pending approvals that match the password adapter.

List all documents or tasks that are pending approval.

Connection

Establish a connection to your SAP Ariba account.

Approvable Type

Select or map the option to list the pending approvals:

  • Requisitions

  • Invoices

Limit

Set the maximum number of pending approvals Execution Management System should return during one scenario execution cycle.

User

Select or map the user whose pending approvals you want to list.

Password Adapter

Enter (map) the password adapter to list the pending approvals that match the password adapter.

Retrieves a list of approvable whose approval state has changed since the last request by the last request ID.

or tasks that are pending approval.

Connection

Establish a connection to your SAP Ariba account.

Last Change ID

Enter (map) the Change Sequence ID of the most recent requisition processed. This ID is unnecessary if no requisitions have yet been processed.

Limit

Set the maximum number of pending approvals Execution Management System should return during one scenario execution cycle.

Retrieves a list of details of the approver group's members by the group name.

Connection

Establish a connection to your SAP Ariba account.

Group Name

Enter (map) or search the group name whose approver members you want to list.

Limit

Set the maximum number of approver group members Execution Management System should return during one scenario execution cycle.

Retrieves the details of an approvable by its ID.

ding approval.

Connection

Establish a connection to your SAP Ariba account.

Approvable Type

Select or map the approval type whose details you want to retrieve:

  • Requisitions

  • Invoices

Approver ID

Select or map the Approver ID whose details you want to retrieve.

Approves, denies, or withdraws an approvable by its ID.

Connection

Establish a connection to your SAP Ariba account.

Approvable Type

Select or map the approvable type whose approvable status you want to update:

  • Requisitions

  • Invoices

Approvable ID

Enter (map) the Approvable ID whose status you want to update.

Status

Select or map the status you want to update the Approvable ID to:

  • Approve

  • Deny

  • Withdraw

User

Password Adapter

Comment

Visible to Supplier

Retrieves the attachment of an approvable by its ID.

Connection

Establish a connection to your SAP Ariba account.

Approvable Type

Select or map the approvable type whose approvable attachment you want to download:

  • Requisitions

  • Invoices

Approvable ID

Enter (map) the Approvable ID whose attachment you want to download.

Attachment ID

Enter (map) the Attachment ID you want to download.

Other

Performs an arbitrary authorized API call.

Connection

Establish a connection to your SAP Ariba account.

URL

Enter a path relative to https://openapi.ariba.com/api/approval/v1/prod For example: /pendingApprovables

For the list of available endpoints, refer to the SAP Ariba API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

The following API call returns all the groups from your SAP Ariba account:

URL:/pendingApprovables

Method:GET

61f16693da408.png

Matches of the search can be found in the module's Output under Bundle > Body. In our example, 293 groups were returned:

Retrieves a list of groups.

Connection

Establish a connection to your SAP Ariba account.

Group Name Contains

Enter (map) the group name to list the groups that match the specified groups.

Limit

Set the maximum number of groups Execution Management System should return during one execution cycle.

List Group Members

Retrieves a list of details of the group members by the group ID.

Connection

Establish a connection to your SAP Ariba account.

Group ID

Enter (map) or search the Group ID to list the members that match the specified group.

Limit

Set the maximum number of group members Execution Management System should return during one execution cycle.