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. 
   • Note: If you're having trouble setting up SAP Ariba, visit the SAP Help Portal | Help 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: 

Parameter ID	Value
Application.ACM.IntendedIntegrateToSystem	Yes
Application.ACM.ThirdPartyCLMSystemIntegration.Enabled	Yes
Application.ACM.ThirdPartyCLMSystemIntegration.HostName	ironcladapp.com
Application.ACM.PDFAssembledDocs.Enabled	Yes
Application.ACM.SyncContractWorkspaceHeaderDataWithContractComplianceUsingAPI	Yes
Application.ACM.EnableEditingForPricingConditionAtContractContentHeader	Yes
Application.ACM.ContractLineItemsDocument.Enabled	Yes
Application.ACM.ReadOnlyTermsforExternalSystemLineItemDefinition	Yes
Application.ACM.EnableContractAmountSyncWithComplianceContracts	Yes

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).
      • CSV File: Contract Workspace Template
   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:

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.
   • Sample Template: Sample_Contract_Workspace_Template
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.