Skip to content

IFS Connect for Climatiq Integration for Carbon Emissions Tracking in Procurement

The purpose of this document is to provide a guide on how to configure IFS Connect for Climatiq integration to retrieve emission values in Carbon Emission Tracking in Procurement. The integration ensures that emission data is accurately fetched and utilized within the procurement processes.

This guide provides details of how to configure IFS Connect for integrating Climatiq using two REST endpoints.

  1. A synchronous request send to Climatiq Procurement Endpoint and wait until spend based emission values are received for Parts.
  2. A synchronous request send to Climatiq Autopilot Endpoint and wait until emission values are received for No-Parts.

1. IFS Connect configurations for Climatiq Procurement REST Endpoint

  • Routing Rule: Example_Climatiq_Get_Emission_Integration
  • Routing Address: Example_Climatiq_Get_Emission_Integration
  • Prerequisites: Obtained API Key separately communicate to the customer

Configure Routing Address - Example_Climatiq_Get_Emission_Integration

Option 1: Create Routing Address manually from scratch.
  1. Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses.

  2. Click on (+) to add a new routing address.

  3. New Routing Address assistant start by opening the step Select Routing Address.

  4. Set the Transport Connector to REST.

  5. Set the Address Name to Example_Climatiq_Get_Emission_Integration in the Select Routing Address step.

  6. Proceed to the Rest Address Data step. Enter the required values as below.

  7. Set the Sender Instance to REST_SENDER1.
  8. Set the Rest Root End Point to https://api.climatiq.io/procurement/v1/spend
  9. Set Authentication Method to Bearer , The API Key field will become visible. Insert the obtained API Key into this field.
  10. Set **Rest Http Method ** to POST.

  11. Click Finish to complete the setup, and the Routing Address will be created.

Option 2: Import the Routing Address from a file.
  1. Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.
  2. Browse the File RoutingAddress_Example_Climatiq_Get_Emission_Integration.xml in file explorer.
  3. Set Import Method to Add.
  4. Click Import to complete the setup, and the Routing Address will be created.
  5. Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses. and search Routing Address named Example_Climatiq_Get_Emission_Integration
  6. Navigate to it's detailed window through Details and Replace the dummy API key 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX' with the API key obtained from the IFS in REST Address Data section.

Configure Routing Rule - Example_Climatiq_Get_Emission_Integration

Option 1: Create Routing Rule manually from scratch.
  1. Navigate to Solution Manager / Integration / IFS Connect / Routing Rules.

  2. Select the Outbound tab.

  3. Click on Create New and Assistant New Routing Rule will appear.

  4. Select Routing Rule type as Outbound and click Next.

  5. Select APPLICATION_MESSAGE to Route From and ensure the toggle Enabled is on.

  6. Enter Example_Climatiq_Get_Emission_Integration in the Rule Name field.

  7. Click on Finish to navigate to created Routing Rule.

  8. Go to the Content Based Conditions list, add a new record with Search set to MESSAGE_FUNCTION, Operation set to =(equal), and Match set to CLIMATIQ_PROC_INTEGRATION_SERVICE, then save it.

  9. In the Destination Address section, click Set Destination Address, and when the dialog pops up, search for Routing Address Example_Climatiq_Get_Emission_Integration, click OK, and the Routing Address will be added as the main address.

Option 2: Import the Routing Rule from a file.
  1. Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.

  2. Browse the File RoutingRule_Example_Climatiq_Get_Emission_Integration.xml in file explorer.

  3. Set Import Method to Add.

  4. Click Import to complete the Routing Rule setup, and the Routing Rule will be created.

2. IFS Connect configurations for Climatiq Autopilot REST Endpoint

  • Routing Rule: Example_Climatiq_AI_Integration_Service
  • Routing Address: Example_Climatiq_AI_Integration_Service
  • Prerequisites: Obtained API Key separately communicate to the customer

Configure Routing Address - Example_Climatiq_AI_Integration_Service

Option 1: Create Routing Address manually from scratch.
  1. Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses.

  2. Click on (+) to add a new routing address.

  3. New Routing Address assistant start by opening the step Select Routing Address.

  4. Set the Transport Connector to REST.

  5. Set the Address Name to Example_Climatiq_AI_Integration_Service in the Select Routing Address step.

  6. Proceed to the Rest Address Data step. Enter the required values as below.

  7. Set the Sender Instance to REST_SENDER1.
  8. Set the Rest Root End Point to https://api.climatiq.io/autopilot/estimate
  9. Set Authentication Method to Bearer , The API Key field will become visible. Insert the obtained API Key into this field.
  10. Set **Rest Http Method ** to POST.

  11. Click Finish to complete the setup, and the Routing Address will be created.

Option 2: Import the Routing Address from a file.
  1. Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.
  2. Browse the File RoutingAddress_Example_Climatiq_AI_Integration_Service.xml in file explorer.
  3. Set Import Method to Add.
  4. Click Import to complete the setup, and the Routing Address will be created.
  5. Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses. and search Routing Address named Example_Climatiq_AI_Integration_Service
  6. Navigate to it's detailed window through Details and Replace the dummy API key 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX' with the API key obtained from the IFS in REST Address Data section.

Configure Routing Rule - Example_Climatiq_AI_Integration_Service

Option 1: Create Routing Rule manually from scratch.
  1. Navigate to Solution Manager / Integration / IFS Connect / Routing Rules.

  2. Select the Outbound tab.

  3. Click on Create New and Assistant New Routing Rule will appear.

  4. Select Routing Rule type as Outbound and click Next.

  5. Select APPLICATION_MESSAGE to Route From and ensure the toggle Enabled is on.

  6. Enter Example_Climatiq_AI_Integration_Service in the Rule Name field.

  7. Click on Finish to navigate to created Routing Rule.

  8. Go to the Content Based Conditions list, add a new record with Search set to MESSAGE_FUNCTION, Operation set to =(equal), and Match set to CLIMATIQ_AI_INTEGRATION_SERVICE, then save it.

  9. In the Destination Address section, click Set Destination Address, and when the dialog pops up, search for Routing Address Example_Climatiq_AI_Integration_Service, click OK, and the Routing Address will be added as the main address.

Option 2: Import the Routing Rule from a file.
  1. Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.

  2. Browse the File RoutingRule_Example_Climatiq_AI_Integration_Service.xml in file explorer.

  3. Set Import Method to Add.

  4. Click Import to complete the Routing Rule setup, and the Routing Rule will be created.