Skip to main content

Configure SAP Ariba in Ironclad

This article goes over the setup and configuration steps for connecting SAP Ariba to Ironclad. This integration pulls data from Ariba into Ironclad to prefill launch forms. While drafting, you can manually refresh Ariba to bring in the latest data. After a contract is signed in Ironclad, it’s published back to the related Ariba contract workspace with a signed PDF attached or as a link.

Use Case

Before your legal and procurement teams can share data between SAP Ariba and Ironclad, an admin needs to establish the connection. Set up this integration once so that, going forward, your teams can pull supplier and requisition data into Ironclad at launch, refresh it during negotiation, and automatically send executed contracts back to SAP Ariba.

Prerequisites

Features

Integrations, APIS

Connected Systems

  • SAP Ariba

  • SAP products required for integration:

    • SAP Ariba Procurement

    • SAP Ariba Sourcing

    • SAP Ariba Contracts

    • SAP Ariba Supplier Lifecycle and Performance (Supplier Management)

    • SAP Ariba Developer Portal

Packages

SAP Data Foundation or SAP Procurement Automation

Permissions

Admins or users with Integrations Management permissions.

Connect the SAP Ariba Integration to Ironclad

There are three steps you'll need to complete to use Ironclad's SAP Ariba integration:

  1. Set up the API keys needed to support the SAP Ariba integration

  2. Set up a Contract Workspace (Procurement) System Template

  3. Link Ironclad to SAP Ariba

Step 1: Set Up API Keys

To enable APIs for this integration:

  1. Register for the SAP Ariba Developer Portal.

  2. Create a client application for each integration-specific Ariba API within the SAP Ariba Developer Portal:

    1. Create the application, then click Actions > Request API access.

    2. Select an API from the dropdown and choose the realm(s) to enable. Repeat these steps for the following APIs:

      • Contract Workspace State Change API

      • Document Approval API

      • Event Management API

      • Strategic Contract Workspaces

      • Supplier Data API with Pagination

    3. Wait for SAP Support to approve each client application (estimated wait time: 12 to 24 hours).

    4. Once an application is approved, click Actions > Generate OAuth Client Secret and save the provided client credentials for later use.

  3. Modify the Sourcing and Contracts configuration parameters using the Intelligent Configuration Manager in your parent realm:

  4. Add custom fields to the Contract Workspace object.

    1. Submit a support case via SAP for Me.

    2. Request that the custom fields defined in this spreadsheet are added to the Contract Workspace object in your realm(s).

    3. Specify that these custom fields should be carried over to the Contract Compliance document as well.

API Field Reference

Each API requires the following fields:

Field

Description

Data Center

The SAP Ariba data center hosting your realm (for example, US PROD (openapi.ariba.com)). Select the one that matches your instance.

SAP Ariba Realm

The name of your SAP Ariba realm (your company’s SAP Ariba environment).

SAP Ariba API Key

The API key for the client application you registered for this API in the SAP Ariba Developer Portal.

SAP Ariba Username

The username of the default user associated with contracts created or retrieved in SAP Ariba.

SAP Ariba Password Adapter

The authentication adapter for that user. Select a value from the dropdown:

  • Enterprise User

  • Sourcing Supplier User

  • Third Party User

SAP Ariba Client ID

The OAuth client ID generated for the client application.

SAP Ariba Client Secret

The OAuth client secret generated alongside the client ID. Store this securely.


Step 2: Create a Contract Workspace (Procurement) System Template

To create and publish a Contract Workspace in SAP Ariba, the Ironclad integration needs a compatible system template to exist in your realm.

  1. Log in to your SAP Ariba realm.

  2. Navigate to Manage > Templates.

  3. Click the Actions menu and select Import > Template.

    • Note: You can also click a sub-folder of your choice and select Import > Template.

  4. Import the following sample template. Once created, it'll be in Draft status.

  5. Open the imported template.

  6. Review and modify the following details:

    • Name

    • Description

    • Owner

    • Access Control

    • Lock Access Control

    • Team Members

  7. Under the Overview tab, click Actions > Publish.


Step 3: Link Ironclad to Your Company’s SAP Ariba Realm

To link Ironclad to your SAP Ariba Realm:

  1. In Ironclad, click your profile icon in the top right corner and select Company Settings.

  2. Click Integrations from the left sidebar menu.

  3. Under Procurement, click SAP Ariba.

  4. Click Link account.

  5. Follow the prompts to link your Ironclad account to Ariba.

Your account should now be linked. You’ll be taken back to the Integrations page.

Before you can start pulling in supplier or requisition data from SAP Ariba into Ironclad launch forms, an admin must enable the SAP Ariba integration for your Ironclad instance.

You will also need the following SAP Ariba APIs set up for the integration to work as expected:

  • Document Approval API

  • Supplier Data API with Pagination

  • Contract Workspace Management API

  • Contract Workspace State Change API

  • Project Document Management API


Step 4 (Optional): Ensure Integration and APIs Are Enabled

Once you’re done linking Ironclad to SAP Ariba, you can check to make sure that the integration and APIs are all working as expected:

  1. In Ironclad, click your profile icon in the top right corner and select Company Settings.

  2. Click Integrations from the left sidebar menu.

  3. Under Procurement, click SAP Ariba.

  4. Click the Connection Settings tab.

  5. Make sure you have the following APIs set up:

    1. Supplier Data API with Pagination

    2. Document Approval API

  6. Under Supplier Data API with Pagination, click Edit Connection Settings.

  7. Make sure the following fields are filled out:

    1. Data Center

    2. SAP Ariba Realm

    3. SAP Ariba API Key

    4. SAP Ariba Client ID

    5. SAP Ariba Client Secret

Once you’ve confirmed that the required APIs are set up, you can start adding workflow configurations.

Resources

Explore articles, courses, and support options to get the most out of Ironclad.

Help Center

Support

Did this answer your question?