To successfully complete the Catena-X Product Carbon Footprint (PCF) use case, you can either use one of the certified applications available in the Cofinity-X Portal or implement the required backend API methods as described below.
If you choose to use a certified PCF application, follow the instructions provided by your application provider to complete the PCF exchange with Cofinity-X.
Inform the cofinity-x team when you are ready to receive a PCF request. When your setup is ready, send an email to: [email protected]
Subject:
DSA PCF requestInclude the following information:
EDC URL
BPNL
Product ID for which you want to share PCF data
Prepare PCF data for one of the specified product IDs.
The data must comply with the Catena-X PCF JSON schema v7.0.0:
Schema-compliant test data may also be provided.
Once you receive the PCF request from Cofinity-X, respond with your PCF data using the following details:
BPNL : BPNLCOFINITYEZFA
Asset ID: pcf-exchnage-endpoint-cofx-dsa
Confirm to Cofinity-X that you have successfully completed the PCF data sharing.
If you are using the Backend API approach, make sure you have the standardized endpoint to receive PCF requests.
1. Create Your PCF Exchange Endpoint
Set up your PCF exchange endpoint in accordance with the Catena-X Standard v2.0.1.
For detailed specifications, refer to: CX-0136 Use Case PCF Specification
1.1 Create an Asset
POST: {{PROVIDER_EDC_MANAGEMENT_API}}/v3/assets
{
"@context": {
"edc": "https://w3id.org/edc/v0.0.1/ns/",
"odrl": "http://www.w3.org/ns/odrl/2/",
"dcat": "http://www.w3.org/ns/dcat#",
"dct": "http://purl.org/dc/terms/",
"rdfs": "http://www.w3.org/2000/01/rdf-schema#",
"cx-taxo": "https://w3id.org/catenax/taxonomy#",
"cx-common": "https://w3id.org/catenax/ontology/common#",
"aas-semantics": "https://admin-shell.io/aas/3/0/HasSemantics/"
},
"@id": "c34018ab-5820-4065-9087-416d78e1ab60",
"@type": "edc:Asset",
"edc:properties": {
"rdfs:label": "PCF Data",
"rdfs:comment": "Endpoint for PCF data",
"cx-common:version": "1.1",
"aas-semantics:semanticId": {
"@id": "urn:samm:io.catenax.pcf:7.0.0#Pcf"
},
"edc:contentType": "application/json",
"dct:type": {
"@id": "cx-taxo:PcfExchange"
}
},
"edc:dataAddress": {
"edc:type": "HttpData",
"edc:baseUrl": "https://some.url/service",
"edc:proxyBody": "true",
"edc:proxyPath": "true",
"edc:proxyQueryParams": "true",
"edc:proxyMethod": "true",
"edc:contentType": "application/json"
}
}
1.2 Create Access and Usage Policies
Create an open access policy and usage policy.
POST: {{PROVIDER_EDC_MANAGEMENT_API}}/v3/policydefinitions
{
"@context": {
"@vocab": "https://w3id.org/edc/v0.0.1/ns/"
},
"@id": "a343fcbf-99fc-4ce8-8e9b-148c97605aab",
"policy": {
"@context": [
"https://www.w3.org/ns/odrl.jsonld",
{
"cx-policy": "https://w3id.org/catenax/policy/"
}
],
"@type": "Policy",
"profile": "cx-policy:profile2405",
"permission": [
{
"action": "use",
"constraint": {
"and": [
{
"leftOperand": "cx-policy:FrameworkAgreement",
"operator": "eq",
"rightOperand": "DataExchangeGovernance:1.0"
},
{
"leftOperand": "cx-policy:Membership",
"operator": "eq",
"rightOperand": "active"
},
{
"leftOperand": "cx-policy:UsagePurpose",
"operator": "eq",
"rightOperand": "cx.pcf.base:1"
}
]
}
}
]
}
}1.3 Create a Contract Definition
POST: {{PROVIDER_EDC_MANAGEMENT_API}}/v3/contractdefinitions
{
"@context": {},
"@id": "{{ID_CONTRACT_DEF}}",
"@type": "ContractDefinition",
"accessPolicyId": "{{ID_POLICY_ACCESS}}",
"contractPolicyId": "{{ID_POLICY_CONTRACT}}",
"assetsSelector": {
"@type": "CriterionDto",
"operandLeft": "{{EDC_NAMESPACE}}id",
"operator": "=",
"operandRight": "{{ASSET_ID}}"
}
}2. Notify the Cofinity-X Team
Once your endpoint setup is complete, inform the Cofinity-X Support Team that your PCF exchange endpoint is available and ready to receive PCF data requests.
Send an email to: [email protected]
with the subject:
DSA PCF request
Include the following information in your email:
EDC URL
BPNL
Product ID for which you want to share PCF data
The Cofinity-X team will notify you once the PCF data request has been successfully sent.
3. Prepare Your PCF Data
Prepare PCF data for one of the specified product IDs.
The payload must comply with the Catena-X PCF JSON schema v7.0.0:
You may also provide schema-compliant test data.
4. Respond to Incoming PCF Requests
Monitor incoming requests and respond to the PCF request received from Cofinity-X through contract negotiation using the asset below:
BPNL : BPNLCOFINITYEZFA
Asset ID: pcf-exchnage-endpoint-cofx-dsa
Once done, Product Carbon Footprint use case for Data Space Accelerator program is completed.
