# Setup in SAP Ariba

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

### Requirements <a href="#requirements" id="requirements"></a>

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.](https://docs.fairmarkit.com/buyers/integrations/sap-ariba-integration/setup-in-sap-ariba/sap-ariba-apis)
* User name and password for the RequisitionImportPullOperation()endpoint
* Access to the [RequisitionImportPull](https://docs.fairmarkit.com/buyers/integrations/sap-ariba-integration/setup-in-sap-ariba/sap-ariba-apis) 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) <a href="#enableopenapisrest" id="enableopenapisrest"></a>

{% stepper %}
{% step %}
Log in to the [SAP Ariba Developer Portal](https://developer.ariba.com/api/).
{% endstep %}

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

* [Operational Reporting for Procurement](https://docs.fairmarkit.com/buyers/integrations/sap-ariba-integration)
* [Document Approval](https://docs.fairmarkit.com/buyers/integrations/sap-ariba-integration)
  {% endstep %}

{% step %}
Generate the secret key for the API.
{% endstep %}
{% endstepper %}

### Enable Web Service (SOAP) APIs <a href="#enablewebservicesoapapis" id="enablewebservicesoapapis"></a>

#### 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

{% stepper %}
{% step %}
Go to your Ariba UI portal and log in as an administrator.
{% endstep %}

{% step %}
If you are not in Core Administration, select the Core Administration option in the bottom, left corner.
{% endstep %}
{% endstepper %}

#### Create a new endpoint

{% stepper %}
{% step %}
Select **Integration Manager** > **End Point Configuration**.
{% endstep %}

{% step %}
Complete the following:

* Enter a name (e.g., Fairmarkit RequisitionImportPull).
* Create a user.
* Set the password.
  {% endstep %}
  {% endstepper %}

#### Enable the endpoint

{% stepper %}
{% step %}
Select **Integration Manager** > **Integration Configuration**.
{% endstep %}

{% step %}
Search for **Requisition Import**.
{% endstep %}

{% step %}
Click **Edit**.
{% endstep %}

{% step %}
Select the endpoint you created (e.g., Fairmarkit RequisitionImportPull).
{% endstep %}

{% step %}
Click **Save**.
{% endstep %}

{% step %}
Search for **Requisition Import**, right-click on it and select **Enable**.
{% endstep %}
{% endstepper %}

### Get API key <a href="#getapikey" id="getapikey"></a>

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.

{% stepper %}
{% step %}

###

{% endstep %}

{% step %}

###

{% endstep %}
{% endstepper %}

1. Log in to the [SAP Ariba Developer Portal](https://docs.fairmarkit.com/buyers/integrations/sap-ariba-integration).
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**.<br>

#### 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 <a href="#addafairmarkitapprovalnodetoworkflow" id="addafairmarkitapprovalnodetoworkflow"></a>

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.\
   Not&#x65;*: 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fairmarkit.com/buyers/integrations/sap-ariba-integration/setup-in-sap-ariba.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.