API Configuration

To enable the SAP Ariba and Keelvar Sourcing Optimizer integration using the Keelvar SAP Ariba Connector, four APIs must be configured within SAP Ariba.

Optionally, the Keelvar SAP Ariba Connector can output data directly from the Keelvar Sourcing Optimizer event to SAP Ariba Contracts. To enable this feature, two SAP Ariba Contracts Web Services must also be configured.

This article outlines the steps required to configure the APIs and the SAP Ariba Contracts Web Services.

API Configuration

The following SAP Ariba APIs must be configured to use the Keelvar SAP Ariba Connector v2:

  • External Approval API for Sourcing and Supplier Management (v2)
  • Event Management API (v2)
  • Surrogate Bidding API (v1)
  • Sourcing Project Management API (v2)

There are three key steps to complete when configuring an API in SAP Ariba: Creating a new application, requesting API access, and generating the API details.

Figure 1. Creating a new application
Figure 2. Requesting API access
Figure 3. Generating the API details

Configuring an API in SAP Ariba

Each of the required APIs is accessed and configured from the SAP Ariba APIs Portal. Complete the following procedure for each of the four APIs, selecting the relevant API on the Request API Access step of the procedure. Note that only someone with the Administrator role can complete this step. For each API, note and save the Application Key, the OAuth Client Id, and the OAuth Secret. This information must be submitted to Keelvar using the Keelvar SAP Ariba Connector — Configuration Data Form.

For additional information refer to the Help for SAP Ariba developer portal documentation.

  1. Log in to https://developer.ariba.com/
  2. Go to Manage > Applications.
  3. Create a new application.
    1. In the top-left corner of the page, next to the search bar, click the +
    2. In the Application Name field, enter a name for the application.
    3. In the Description field, enter a description for the application.
    4. Click Submit.
  4. Request API access.
    1. In the top-right corner of the page, on the card for the application you just created, click Actions, and then click Request API Access.
    2. From the Select an API dropdown list, select the API you want to access.
    3. Select the Sourcing checkbox, and then, from the dropdown list, select the required sourcing realm.
    4. Click Submit.
      The request is sent to SAP Ariba for approval.
      Note: The approval process usually takes less than 12 hours. After the request is approved, you will receive an email with further instructions.
  5. Generate the API details.
    1. In the top-right corner of the page, click the Actions button, and then click Generate OAuth Secret.
    2. Copy or download the information.
      Note: Keelvar Sourcing Optimizer requires the Application Key, the OAuth Client Id, and the OAuth Secret.
    3. Click Close.

SAP Ariba Contracts Web Service Configuration

If you want to output data from the Keelvar SAP Ariba Connector to SAP Ariba Contracts, you can configure the SAP Ariba Contracts Web Service.

The following Web Services must be configured to export data to SAP Ariba Contracts:

  • Import Procurement Contract Workspace
  • Import CLID using XML

There are two key steps to complete when configuring web services in SAP Ariba: Creating an endpoint, and activating the web service task.

Figure 4. Creating an endpoint
Figure 5. Activating the web service

Configuring an SAP Ariba Contracts Web Service

Complete the following procedure for each of the two required web services, selecting the relevant web service on the Integration Configuration step of the procedure. For each web service, note and save the endpoint username and password, and the URL from the integration configuration. This information must be submitted to Keelvar using the Keelvar SAP Ariba Connector — Configuration Data Form.

For additional information, refer to the SAP CC Web Services documentation.

  1. Go to your Ariba realm.
  2. Create an endpoint.
    1. Go to Administration > Integration Manager > End Point Configuration.
    2. Click Create New.
    3. In the Name field, enter a name for the endpoint.
    4. For Type, click Inbound.
    5. At the bottom if the screen, enter the username and password that will be used by the Keelvar SAP Ariba Connector when calling the API.
    6. Click Save.
  3. Activate the web service task.
    1. Go to Administration > Integration Manager > Integration Configuration.
    2. Search for the web service you want to activate.
    3. In the Configuration area, in the row of the web service you want to activate, click Actions, and then click Edit.
    4. In the Edit data import/export task area, for Status, click Enabled.
    5. Copy and save the URL.
    6. Click Save.