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.
- A synchronous request send to Climatiq Procurement Endpoint and wait until spend based emission values are received for Parts.
- 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.¶
-
Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses.
-
Click on (+) to add a new routing address.
-
New Routing Address assistant start by opening the step Select Routing Address.
-
Set the Transport Connector to
REST
. -
Set the Address Name to
Example_Climatiq_Get_Emission_Integration
in the Select Routing Address step. -
Proceed to the Rest Address Data step. Enter the required values as below.
- Set the Sender Instance to
REST_SENDER1
. - Set the Rest Root End Point to https://api.climatiq.io/procurement/v1/spend
- Set Authentication Method to
Bearer
, The API Key field will become visible. Insert the obtained API Key into this field. -
Set **Rest Http Method ** to
POST
. -
Click Finish to complete the setup, and the Routing Address will be created.
Option 2: Import the Routing Address from a file.¶
- Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.
- Browse the File
RoutingAddress_Example_Climatiq_Get_Emission_Integration.xml
in file explorer. - Set Import Method to
Add
. - Click Import to complete the setup, and the Routing Address will be created.
- Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses. and search Routing Address named
Example_Climatiq_Get_Emission_Integration
- 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.¶
-
Navigate to Solution Manager / Integration / IFS Connect / Routing Rules.
-
Select the Outbound tab.
-
Click on Create New and Assistant New Routing Rule will appear.
-
Select Routing Rule type as Outbound and click Next.
-
Select
APPLICATION_MESSAGE
to Route From and ensure the toggle Enabled is on. -
Enter
Example_Climatiq_Get_Emission_Integration
in the Rule Name field. -
Click on Finish to navigate to created Routing Rule.
-
Go to the Content Based Conditions list, add a new record with Search set to
MESSAGE_FUNCTION
, Operation set to=
(equal), and Match set toCLIMATIQ_PROC_INTEGRATION_SERVICE
, then save it. -
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.¶
-
Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.
-
Browse the File
RoutingRule_Example_Climatiq_Get_Emission_Integration.xml
in file explorer. -
Set Import Method to
Add
. -
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.¶
-
Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses.
-
Click on (+) to add a new routing address.
-
New Routing Address assistant start by opening the step Select Routing Address.
-
Set the Transport Connector to
REST
. -
Set the Address Name to
Example_Climatiq_AI_Integration_Service
in the Select Routing Address step. -
Proceed to the Rest Address Data step. Enter the required values as below.
- Set the Sender Instance to
REST_SENDER1
. - Set the Rest Root End Point to https://api.climatiq.io/autopilot/estimate
- Set Authentication Method to
Bearer
, The API Key field will become visible. Insert the obtained API Key into this field. -
Set **Rest Http Method ** to
POST
. -
Click Finish to complete the setup, and the Routing Address will be created.
Option 2: Import the Routing Address from a file.¶
- Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.
- Browse the File
RoutingAddress_Example_Climatiq_AI_Integration_Service.xml
in file explorer. - Set Import Method to
Add
. - Click Import to complete the setup, and the Routing Address will be created.
- Navigate to Solution Manager / Integration / IFS Connect / Routing Addresses. and search Routing Address named
Example_Climatiq_AI_Integration_Service
- 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.¶
-
Navigate to Solution Manager / Integration / IFS Connect / Routing Rules.
-
Select the Outbound tab.
-
Click on Create New and Assistant New Routing Rule will appear.
-
Select Routing Rule type as Outbound and click Next.
-
Select
APPLICATION_MESSAGE
to Route From and ensure the toggle Enabled is on. -
Enter
Example_Climatiq_AI_Integration_Service
in the Rule Name field. -
Click on Finish to navigate to created Routing Rule.
-
Go to the Content Based Conditions list, add a new record with Search set to
MESSAGE_FUNCTION
, Operation set to=
(equal), and Match set toCLIMATIQ_AI_INTEGRATION_SERVICE
, then save it. -
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.¶
-
Navigate to Solution Manager / Integration / IFS Connect / Import Configuration.
-
Browse the File
RoutingRule_Example_Climatiq_AI_Integration_Service.xml
in file explorer. -
Set Import Method to
Add
. -
Click Import to complete the Routing Rule setup, and the Routing Rule will be created.