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 |
|
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:
Set up the API keys needed to support the SAP Ariba integration
Set up a Contract Workspace (Procurement) System Template
Link Ironclad to SAP Ariba
Step 1: Set Up API Keys
To enable APIs for this integration:
Register for the SAP Ariba Developer Portal.
Note: If you're having trouble setting up SAP Ariba, visit the SAP Help Portal | Help for the SAP Ariba Developer Portal
Create a client application for each integration-specific Ariba API within the SAP Ariba Developer Portal:
Create the application, then click Actions > Request API access.
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
Wait for SAP Support to approve each client application (estimated wait time: 12 to 24 hours).
Once an application is approved, click Actions > Generate OAuth Client Secret and save the provided client credentials for later use.
Modify the Sourcing and Contracts configuration parameters using the Intelligent Configuration Manager in your parent realm:
Add custom fields to the Contract Workspace object.
Submit a support case via SAP for Me.
Request that the custom fields defined in this spreadsheet are added to the Contract Workspace object in your realm(s).
CSV File: Contract Workspace Template
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:
|
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.
Log in to your SAP Ariba realm.
Navigate to Manage > Templates.
Click the Actions menu and select Import > Template.
Note: You can also click a sub-folder of your choice and select Import > Template.
Import the following sample template. Once created, it'll be in Draft status.
Sample Template: Sample_Contract_Workspace_Template
Open the imported template.
Review and modify the following details:
Name
Description
Owner
Access Control
Lock Access Control
Team Members
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:
In Ironclad, click your profile icon in the top right corner and select Company Settings.
Click Integrations from the left sidebar menu.
Under Procurement, click SAP Ariba.
Click Link account.
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:
In Ironclad, click your profile icon in the top right corner and select Company Settings.
Click Integrations from the left sidebar menu.
Under Procurement, click SAP Ariba.
Click the Connection Settings tab.
Make sure you have the following APIs set up:
Supplier Data API with Pagination
Document Approval API
Under Supplier Data API with Pagination, click Edit Connection Settings.
Make sure the following fields are filled out:
Data Center
SAP Ariba Realm
SAP Ariba API Key
SAP Ariba Client ID
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.