How to integrate SAP Ariba with Sapho version 4.3 or greater

Last update:

Contents

  1. Requirements
  2. Tutorial: How to set up the SAP Ariba integration in Sapho
  3. Troubleshooting

Requirements

Your organization must be in United States or Europe.

You must have a current license for an SAP Ariba Solution or an Ariba Network Solution component.

You must have an SAP Ariba Open APIs Administrator Account. Your organization’s SAP Ariba Administrator can request access to the SAP Ariba Open APIs Developer Portal from one of the following links:

United States: https://developer.ariba.com/api/

Europe https://eu.developer.ariba.com/api/

If your internal server hosting Sapho is behind a firewall, you will need to allow access to hostname https://openapi.ariba.com/api/approval/v1/ with port 443, so Sapho can connect to the SAP Ariba open API.

 

Tutorial: How to set up the SAP Ariba integration in Sapho

Step 1: Sign in

Log in to https://developer.ariba.com/api/ with an administrator account.

Step 2: On the welcome page

On the welcome page, click the Create application button.

SapAriba1a.png

Enter an application name and description. Click Submit.

SapAriba2a.png

Your application will be sent for approval to the SAP Ariba Open APIs Team.

Once the application is approved, the requestor will receive an email with the OAuth secret token. The SAP Ariba Open APIs Team will setup and enable the back end with your realm ID.

Step 3: Get the OAuth Client ID and Application Key

Note: This step assumes that your application has been approved.

Go to the Manage Applications page. Click on the application your previously created. Copy the OAuth Client ID and Application Key and paste them in a secure place for later reference.

SapAriba3a.png

Step 4: Log in the Sapho Builder (Admin)

Go to the Integrations or Micro Apps page and start Add SAP Ariba Integration or Add SAP Ariba Micro App wizard by clicking on the SAP Ariba icon.

Step 5: Enter the API URL

Default API URL is: https://openapi.ariba.com/api/approval/v1/.

It can be different for you application. Please contact your SAP Ariba administrator. 

Step 6: Enter the OAuth Client ID

This is the OAuth Client ID you obtained at step 3.

Step 7: Enter the OAuth Client Secret

This is the OAuth secret token that you obtained by email. Secret can be obtained by SAP Ariba administrator on the Manage Applications page.

Step 8: Enter the Application Key 

This is the Application Key you obtained at step 3.

Step 9: Enter the Realm ID

Realm ID is setup by SAP Ariba Open APIs Team.

Step 10: Finish the creation of the integration

Click Next and finish the creation of the integration.

 

Audit Trail

Once you have created a dedicated account in Expensify and set up the integration in Sapho using that account, you will be able to ensure transparency in your audit logs.

 

Troubleshooting

Possible issue #1: Sapho on-premises (most likely behind a firewall) might not be able to connect to SAP Ariba.

Solution: In your firewall settings, allow access to hostname developer.ariba.com/api with port 443, so Sapho can connect to the SAP Ariba.

Possible issue #2: The site of https://openapi.ariba.com/api/approval/v1/ is down.

Solution: Check the status of the site here. If it’s marked as down, all you can do is to wait.