Setup in SAP Ariba

For your integration between SAP Ariba Cloud and Fairmarkit, you will need to complete some configuration in SAP Ariba.

Requirements

You will need to provide the following information to Fairmarkit:

  • Ariba DSC with Administrator privileges

  • Create an application for each Open API For more information about the necessary APIs, see SAP Ariba APIs.

  • User name and password for the RequisitionImportPullOperation()endpoint

  • Access to the RequisitionImportPull wsdl file (e.g., https://s1.ariba.com/Buyer/soap/BU-1-T/RequisitionImportPull?wsdl&validate=false)

  • SAP Ariba buyer email (testuser@yourdomain) for Fairmarkit with permission to create and approve requisitions. This user will be used when you create your approval node, and your credentials will stay confidential and do not need to be shared with Fairmarkit.

  • Access to SAP Ariba staging UI for testing purposes (Suggested)

  • Provide Fairmarkit your credentials for each Open API and Web Service

Enable Open APIs (REST)

1

Log in to the SAP Ariba Developer Portal.

2

Create an app for each relevant API. Allow 12 hours for Ariba to auto-approve API access.

3

Generate the secret key for the API.

Enable Web Service (SOAP) APIs

Enable Application.Purchasing.AllowRequisitionImportAndExport

First, you will need to contact Ariba support and ask them to enable the Application.Purchasing.AllowRequisitionImportAndExport feature.

Login to SAP Ariba UI

1

Go to your Ariba UI portal and log in as an administrator.

2

If you are not in Core Administration, select the Core Administration option in the bottom, left corner.

Create a new endpoint

1

Select Integration Manager > End Point Configuration.

2

Complete the following:

  • Enter a name (e.g., Fairmarkit RequisitionImportPull).

  • Create a user.

  • Set the password.

Enable the endpoint

1

Select Integration Manager > Integration Configuration.

2

Search for Requisition Import.

3

Click Edit.

4

Select the endpoint you created (e.g., Fairmarkit RequisitionImportPull).

5

Click Save.

6

Search for Requisition Import, right-click on it and select Enable.

Get API key

As part of the set up, you will need to provide an SAP Ariba API key for Fairmarkit.

Request API Key

First, you will need to request an SAP Ariba API key. You will need to be a Developer or Organization Admin.

1

2

  1. Log in to the SAP Ariba Developer Portal.

  2. From the navigation menu, select Manage.

  3. Click Applications.

  4. Search for the application you want to enable.

  5. Select Actions > Request API Access.

  6. In API Names, select the API you want to access using this application. And then, enter the following information.

    • In Realm Name, enter the realm name of the site that you want to enable.

    • Enter the ANID in the AN-ID.

    • Select the Production or Test realm type.

  7. Click Submit.

Approve API Key request

Next, you will need to approve the API key request. You will need to be an Organization Admin.

  1. From the navigation menu, select Manage.

  2. Click Applications.

  3. Search for the application you want to approve.

  4. Click Approve. Allow 12 hours for the API key to be enabled.

Access key

Once ready, you can access the application Client ID from Account Settings > API Management Section in your SAP Ariba account.

Add a Fairmarkit approval node to workflow

You will need to edit your existing SAP Ariba approval workflow to add a step for Fairmarkit. Fairmarkit should be the first approver in the workflow and should not be added as a parallel approver with another approver in your workflow.

  1. Go to Manage > Approval Processes. Note: All roles will not have access to the Approval Process.

  2. Search for the currently active Requisition approval process. You will need to edit or copy/create a new process while in development and activate it when you're ready to go live.

  3. Just before the approval step, click the arrow. This is where you add Fairmarkit to the process as the first approver.

  4. Select one of the following rules. With both rules, the requisition is not fully approved until Fairmarkit approval is complete.

    • Select Add Serial Rule. This will insert an approval before the approver.

    • Select Parallel Approval Rule. This will send to Fairmarkit while other approvals are happening.

  5. Name the new rule Fairmarkit Sourcing and add a description to explain the program.

  6. If applicable, set the conditionals to determine which purchase requisitions should be sent to Fairmarkit for sourcing.

  7. In Actions, select to either Add Approver and Group or Use Approver Lookup Table. If you select to use an lookup table, Upload the provided template to perform a lookup, setting conditions appropriate to your needs. The user is your Fairmarkit user in SAP Ariba

PreviousSAP Ariba integrationNextSAP Ariba APIs

Last updated

Was this helpful?