Skip to main content

Prepare PCF data - 9.0.0

All PCF endpoints must perform schema validation in order to be certified.

If the provided PCF data does not conform to the defined schema, Dataspace OS application will make the validation on reject the faulty PCF data.

Resources

What changed from v7.0.0 to v9.0.0

The v9.0.0 model reorganizes the flat v7 structure into grouped entities, each wrapped in its own array (a "Collection"). The seven top-level groups are:

Top-level property

Required at root?

scopeOfPcfForm

Yes

companyAndProductInformation

Yes

pcfAssessmentAndMethodology

Yes

general

Yes

carbonContent

Yes

productLifeCycleStagesAndEmissions

Yes

attestationOfConformance

No — optional at root

Notable model changes worth flagging if you are migrating from v7:

  • declaredUnitOfMeasurement enum gained hour, megabit, and second; dropped the plain ton/kilometer combo in favor of ton kilometer.

  • Emissions are now split by lifecycle stage (productionStage, distributionStage, packagingStage) instead of one flat block.

  • exemptedEmissionsPercent now allows up to 10% (was 0–5 in the v7 excerpt).

  • id now also accepts the urn:uuid: prefixed form, in addition to a bare UUID v4.

  • attestationOfConformance is a full collection with its own required fields, and is optional at the root level.

1. scopeOfPcfForm (ScopeOfPCFFormEntity)

Property

Mandatory

Validator / Enum Values

Example

specVersion

Yes

Text (string)

urn:io.catenax.pcf:datamodel:version:9.0.0

partialFullPcf

Yes

Enum: Cradle-to-gate, Cradle-to-grave

Cradle-to-gate

2. companyAndProductInformation

2.a CompanyInformationEntity

Property

Mandatory

Validator / Enum Values

Example

companyName

Yes

Non-empty string

My Corp

companyIds

Yes

Array of URIs, unique items, ≥ 1

["urn:BPNL000000000DWF"]

2.b ProductInformationEntity

Property

Mandatory

Validator / Enum Values

Example

productNameCompany

Yes

Non-empty string

My Product Name

productIds

Yes

Array of URIs, unique items

["urn:mycompany.com:product-id:401765"]

declaredUnitOfMeasurement

Yes

Enum: liter, kilogram, cubic meter, kilowatt hour, megajoule, ton kilometer, square meter, piece, hour, megabit, second

liter

declaredUnitAmount

Yes

Number > 0 (strictly positive)

1.0

productMassPerDeclaredUnit

Yes

Number ≥ 0

0.456

productClassifications

No

Array of unique strings, URN format recommended (e.g. urn:gtin:...)

["urn:gtin:4712345060507"]

productDescription

No

Text

Ethanol, 95% solution

3. pcfAssessmentAndMethodology

(Root sub-entity itself only requires dataSourcesAndQuality; the other sub-entities below apply when present.)

3a. DataSourcesAndQualityEntity

Property

Mandatory

Validator / Enum Values

Example

primaryDataShare

No

Number 0–100

56.12

secondaryEmissionFactorSources

No

Array of unique strings

["ecoinvent 3.8"]

technologicalDQR

No

Number 1–5

2

temporalDQR

No

Number 1–5

2

geographicalDQR

No

Number 1–5

2

3b. PCFAssessmentInformationEntity — required sub-groups: technology, idAndVersion, boundarySpecifications, geography, time

  • Technology (TechnologyEntity)

Property

Mandatory

Validator / Enum Values

Example

ccsTechnologicalCO2CaptureIncluded

Yes

Boolean

false

boundaryProcessesDescription

No

Text

Electricity consumption included as an input in the production phase

  • ID and Version (IDAndVersionEntity)

Property

Mandatory

Validator / Enum Values

Example

id

Yes

UUID v4, optionally prefixed urn:uuid:: (^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)

3893bb5d-da16-4dc1-9185-11d97476c254

version

Yes

Number ≥ 0 (default 0 for Catena-X)

0

status

Yes

Enum: Active, Deprecated

Active

retroOrProspectivePcfType

Yes

Enum: Retrospective PCF, Prospective PCF without forerunner, Prospective PCF of further developed product with forerunner, Prospective PCF for current product for future production date, Progressive PCF

Retrospective PCF

precedingPfIds

No

Array of objects (footprint identifier history, most recent first)

[{}]

  • Boundary Specifications (BoundarySpecificationsEntity)

Property

Mandatory

Validator / Enum Values

Example

exemptedEmissionsPercent

Yes

Number 0–10

0

exemptedEmissionsDescription

No

Text

No exemption

  • Geography (GeographyEntity)

Property

Mandatory

Validator / Enum Values

Example

geographyRegionOrSubregion

Yes

Enum: Africa, Americas, Asia, Europe, Oceania, Australia and New Zealand, Central Asia, Eastern Asia, Eastern Europe, Latin America and the Caribbean, Melanesia, Micronesia, Northern Africa, Northern America, Northern Europe, Polynesia, South-eastern Asia, Southern Asia, Southern Europe, Sub-Saharan Africa, Western Asia, Western Europe, Global, Several

Africa

geographyCountrySubdivision

No

Pattern (ISO 3166-2): [A-Z]{2}-[A-Z0-9]{1,3} or empty

US-NY

geographyCountry

No

Pattern (ISO 3166-1 alpha-2): [A-Z]{2}

DE

  • Time (TimeEntity)

Property

Mandatory

Validator / Enum Values

Example

referencePeriodStart

Yes

Timestamp (ISO 8601)

2022-01-01T00:00:01Z

referencePeriodEnd

Yes

Timestamp (ISO 8601)

2022-12-31T23:59:59Z

created

Yes

Timestamp (ISO 8601)

2022-05-22T21:47:32Z

validityPeriodEnd

Yes

Timestamp (ISO 8601)

2022-12-31T23:59:59Z

validityPeriodStart

No

Timestamp (ISO 8601)

2022-01-01T00:00:01Z

VerificationAndCertificationSharesEntity

Property

Mandatory

Validator / Enum Values

Example

programCertificationShare

No

Number 0–100

69.15

productVerificationShare1stParty

No

Number 0–100

0

productVerificationShare2ndParty

No

Number 0–100

0

productVerificationShare3rdParty

No

Number 0–100

0

3c PCFMethodologyEntity — required sub-groups: massBalancingInformation, standards, gwpCharacterizationFactorDetails, allocationInForeground

  • Mass Balancing Information (MassBalancingInformationEntity)

Property

Mandatory

Validator / Enum Values

Example

massBalancingUsed

Yes

Boolean

true

freeAttributionInMassBalancing

Yes

Enum (string): true, false, not applicable

"true"

massBalancingCertificateScheme

Yes

Non-empty string

ISCC+

  • Standards (StandardsEntity)

Property

Mandatory

Validator / Enum Values

Example

crossSectoralStandards

Yes

Array of strings

["ISO 14067"]

productOrSectorSpecificRules

Yes

Array of unique strings

["urn:tfs-initiative.com:PCR:..."]

  • GWP Characterization Factor Details (GWPCharacterizationFactorDetailsEntity)

Property

Mandatory

Validator / Enum Values

Example

ipccCharacterizationFactors

Yes

Enum: AR5, AR6, AR4, unspecified

AR5

  • Allocation in Foreground (AllocationInForegroundEntity)

Property

Mandatory

Validator / Enum Values

Example

allocationWasteIncineration

Yes

Enum: cut-off, reverse cut-off, system expansion, polluter pays principle

cut-off

allocationRulesDescription

No

Text

In accordance with Catena-X PCF Rulebook

allocationRecycledCarbon

No

Enum: upstream system expansion, cut-off

upstream system expansion

4. general (GeneralEntity)

Property

Mandatory

Validator / Enum Values

Example

comment

No

Text

Additional explanatory information not reflected by other attributes

pcfLegalStatement

No

Text

This PCF ... is for information purposes only.

5. carbonContent (CarbonContentEntity)

(No individually required fields; all values must be ≥ 0.)

Property

Mandatory

Validator / Enum Values

Example

carbonContentTotal

No

Number ≥ 0

0.52

fossilCarbonContent

No

Number ≥ 0

0.1

biogenicCarbonContent

No

Number ≥ 0

0

packagingBiogenicCarbonContent

No

Number ≥ 0

0

recycledCarbonContent

No

Number ≥ 0

0

6. productLifeCycleStagesAndEmissions

Required sub-groups: productionStage, distributionStage, packagingStage.

6a ProductionStageEntity — required: pcfIncludingBiogenicUptake, pcfExcludingBiogenicUptake

Property

Mandatory

Validator / Enum Values

Example

pcfIncludingBiogenicUptake

Yes

Number (positive or negative)

1.9

pcfExcludingBiogenicUptake

Yes

Number ≥ 0

2.9

fossilGhgEmissions

No

Number ≥ 0

0.5

biogenicNonCO2Emissions

No

Number ≥ 0

1

biogenicCO2Uptake

No

Number ≤ 0

-1

landUseChangeGhgEmissions

No

Number ≥ 0

1.4

landManagementBiogenicCO2Emissions

No

Number ≥ 0

1.4

packagingLandManagementBiogenicCO2Emissions

No

Number ≥ 0

0

landManagementBiogenicCO2Removals

No

Number ≤ 0

0

aircraftGhgEmissions

No

Number ≥ 0

0

6b. DistributionStageEntity — required: distributionStageIncluded

Property

Mandatory

Validator / Enum Values

Example

distributionStageIncluded

Yes

Boolean

false

distributionStagePcfIncludingBiogenicUptake

No

Number (positive or negative)

0.15

distributionStagePcfExcludingBiogenicUptake

No

Number ≥ 0

0.15

distributionStageFossilGhgEmissions

No

Number ≥ 0

0.15

distributionStageBiogenicNonCO2Emissions

No

Number ≥ 0

0

distributionStageBiogenicCO2Uptake

No

Number ≤ 0

0

distributionStageLandUseChangeGhgEmissions

No

Number ≥ 0

0

distributionStageLandManagementBiogenicCO2Emissions

No

Number ≥ 0

0

distributionStageLandManagementBiogenicCO2Removals

No

Number ≤ 0

0

distributionStageAircraftGhgEmissions

No

Number ≥ 0

0

6c. PackagingStageEntity — required: packagingEmissionsIncluded

Property

Mandatory

Validator / Enum Values

Example

packagingEmissionsIncluded

Yes

Boolean (defaults true per Catena-X Rulebook)

true

packagingPcfIncludingBiogenicUptake

No

Number ≥ 0

0.2

packagingPcfExcludingBiogenicUptake

No

Number ≥ 0

0

packagingFossilGhgEmissions

No

Number ≥ 0

0.2

packagingBiogenicNonCO2Emissions

No

Number ≥ 0

0.2

packagingBiogenicCO2Uptake

No

Number ≤ 0

0

packagingLandUseChangeGhgEmissions

No

Number ≥ 0

0

packagingLandManagementBiogenicCO2Emissions

No

Number ≥ 0

0

packagingLandManagementBiogenicCO2Removals

No

Number ≤ 0

0

packagingAircraftGhgEmissions

No

Number ≥ 0

0.2

Note: unlike the production and distribution stages, the schema defines packagingPcfIncludingBiogenicUptake as a non-negative number (PositiveEmissionsTrait), even though its description references the same +/-1 biogenic-uptake approach used elsewhere. Validate against the schema type, not the description text.

7.attestationOfConformance (optional collection)

Required within each entry: attestationType, standardName, attestationStandard, attestationOfConformanceId, providerName.

Property

Mandatory

Validator / Enum Values

Example

attestationType

Yes

Text

PCF Program Certification

standardName

Yes

Text

Catena-X Product Carbon Footprint Rulebook v4

attestationStandard

Yes

Text

PCF Verification and PCF Program Certification Framework V2

attestationOfConformanceId

Yes

Text (UUID v4 recommended for newly generated IDs)

4a7c4482-8431-4c31-a895-70341d2a1376

providerName

Yes

Text

TÜV-X

attestationOfConformanceLink

No

Text (URL)

www.Certifierrepository_example.com/Certificate 123456

providerId

No

Text

urn:cofinity-x.com:bpn:BPNL0000000AXXXX

completedAt

No

Timestamp (ISO 8601)

2022-12-31T23:59:59Z

Shared validators used throughout the schema

Trait / Characteristic

Definition

Text

Plain string, human-readable

NonEmptyStringTrait

String, minLength 1

Boolean

true / false

Timestamp

ISO 8601 date-time, optional timezone

UuidV4Trait

UUID v4, optionally prefixed urn:uuid:

PositiveEmissionsTrait

Number ≥ 0

NegativeEmissionsTrait

Number ≤ 0

PositiveOrNegativeEmission

Any number (no bound)

StrictlyPositiveDecimalTrait

Number > 0

PositiveDecimalWeightTrait

Number ≥ 0

PercentTrait / ProgramCertificationShareTrait

Number 0–100

DqiNumberTrait

Number 1–5

ExemptedEmissionsPercentTrait

Number 0–10

GeographyCountryTrait

Pattern [A-Z]{2} (ISO 3166-1 alpha-2)

GeographyCountrySubdivisionTrait

Pattern [A-Z]{2}-[A-Z0-9]{1,3} or empty (ISO 3166-2)

Related Articles
Did this answer your question?