Skip to content

Commit 79bb210

Browse files
raimundo-henriquesraimundo-henriques
committed
feat: populate section on TOC integration in PACT data model
1 parent e9391d9 commit 79bb210

File tree

1 file changed

+158
-5
lines changed

1 file changed

+158
-5
lines changed

‎specs/index.bs

+158-5
Original file line numberDiff line numberDiff line change
@@ -984,7 +984,7 @@ The Data Type <{TOC}> has the following properties:
984984
<td>String
985985
<td>M
986986
<td>
987-
The Coefficient relating specified transport activity with WTW GHG emissions with unit `gCO2e` per <{TOC/co2eIntensityTTW}> as defined in the [[!GLEC]] Framework
987+
The Coefficient relating specified transport activity with WTW GHG emissions with unit `gCO2e` per <{TOC/co2eIntensityWTW}> as defined in the [[!GLEC]] Framework
988988
<tr>
989989
<td><dfn>co2eIntensityTTW</dfn> : [=Decimal=]
990990
<td>String
@@ -1733,13 +1733,13 @@ The list below contains the properties that were omitted for this reason.
17331733

17341734
### ServiceFootprint ### {#pcf-mapping-sf}
17351735

1736-
Note: This chaper refers to the PACT Data Model. See [[!PACTDX]] Chapter 4 for further details.
1736+
Note: This chapter refers to the PACT Data Model. See [[!PACTDX]] Chapter 4 for further details.
17371737

17381738
A ServiceFootprint CAN be integrated into the Pathfinder Data Model ([[!PACTDX]]) by storing a <{ShipmentFootprint}> as an extension (see [[!DATA-MODEL-EXTENSIONS]]) in a `ProductFootprint`.
17391739

17401740
For interoperability reasons, additional attributes of such a `ProductFootprint` SHOULD be derived from the <{ShipmentFootprint}>. This is specified in the table below.
17411741

1742-
Note: Chapter [[#appendix-a-sf-example]] contains an example.
1742+
Note: Section [[#appendix-a-sf-example]] contains an example.
17431743

17441744
<figure id="pact-sf-mapping-table">
17451745
<table class="data">
@@ -1829,7 +1829,97 @@ Note: Chapter [[#appendix-a-sf-example]] contains an example.
18291829

18301830
### TOC ### {#pcf-mapping-toc}
18311831

1832-
Issue: this sections is still work in progress
1832+
Note: This chapter refers to the PACT Data Model. See [[!PACTDX]] Chapter 4 for further details.
1833+
1834+
A TOC CAN be integrated into the Pathfinder Data Model ([[!PACTDX]]) by storing a <{TOC}> as an
1835+
extension (see [[!DATA-MODEL-EXTENSIONS]]) in a `ProductFootprint`.
1836+
1837+
For interoperability reasons, additional attributes of such a `ProductFootprint` SHOULD be derived
1838+
from the <{TOC}>. This is specified in the table below.
1839+
1840+
Note: Section [[#appendix-a-toc-example]] contains an example.
1841+
1842+
<figure id="pact-toc-mapping-table">
1843+
<table class="data">
1844+
<thead>
1845+
<tr>
1846+
<th>PACT Data Type
1847+
<th>Property
1848+
<th>Value Derivation
1849+
<tbody>
1850+
<tr>
1851+
<td>ProductFootprint
1852+
<td>`productIds`
1853+
<td>
1854+
MUST contain the TOC ID <{TOC/tocId}>, encoded as
1855+
: `urn:pathfinder:product:customcode:vendor-assigned:<toc id>`
1856+
:: in case the [=transport service organizer=] has assigned a toc id, or
1857+
: `urn:pathfinder:product:customcode:buyer-assigned:<toc id>`
1858+
:: in case the [=transport service user=] has assigned a toc id
1859+
1860+
Note: `productIds` can contain multiple entries. If multiple or different
1861+
toc ids are assigned to a single TOC, `productIds` CAN contain
1862+
all of them.
1863+
<tr>
1864+
<td>ProductFootprint
1865+
<td>`productCategoryCpc`
1866+
<td>
1867+
MUST be set to the CPC code of logistics services (`83117`).
1868+
1869+
<tr>
1870+
<td>CarbonFootprint
1871+
<td>`declaredUnit`
1872+
<td>
1873+
MUST be set to `ton kilometer` conforming with the Pathfinder Tech Specs.
1874+
1875+
See [[!PACTDX]] Chapter 4 for further details.
1876+
1877+
<tr>
1878+
<td>CarbonFootprint
1879+
<td>`unitaryProductAmount`
1880+
<td>
1881+
MUST be set to `"1"` so that the ProductFootprint represents the emissions per ton kilometer of the TOC.
1882+
1883+
<tr>
1884+
<td>CarbonFootprint
1885+
<td>`pCfExcludingBiogenic`
1886+
<td>
1887+
MUST be set to the logistics emissions intensity of the TOC, excluding biogenic emissions,
1888+
found in <{TOC/co2eIntensityWTW }>.
1889+
1890+
<tr>
1891+
<td>CarbonFootprint
1892+
<td>`pCfIncludingBiogenic`
1893+
<td>
1894+
This property is OPTIONAL in the [[!PACTDX]] data Model.
1895+
1896+
It SHOULD be set to the logistics emissions intensity of the TOC,
1897+
including biogenic emissions, found in <{TOC/co2eIntensityWTW}>.
1898+
1899+
<tr>
1900+
<td>CarbonFootprint
1901+
<td>`fossilGhgEmissions`
1902+
<td>
1903+
see the specification for `pCfExcludingBiogenic` in this table
1904+
1905+
<tr>
1906+
<td>CarbonFootprint
1907+
<td>`packagingEmissionsIncluded`
1908+
<td>
1909+
see [[!PACTDX]] for further details
1910+
1911+
MUST be set to `false`.
1912+
1913+
<tr>
1914+
<td>CarbonFootprint
1915+
<td>`primaryDataShare`
1916+
<td>
1917+
The relative share of logistics emissions for which primary data has been used for the calculation.
1918+
1919+
See [[!PACTDX]] and the Pathfinder Framework ([[!PATHFINDER-FRAMEWORK]]) for further details.
1920+
</table>
1921+
<figcaption>Mapping of PACT Data Model properties to <{TOC}> properties</figcaption>
1922+
</figure>
18331923

18341924
# Appendix A: Example PCFs with iLEAP Data embedded # {#appendix-a}
18351925

@@ -1875,7 +1965,7 @@ A Product Footprint with a <{ShipmentFootprint}> highlighted:
18751965
"extensions": [
18761966
{
18771967
"specVersion": "2.0.0",
1878-
"dataSchema": "https://catalog.carbon-transparency.com/sfc-ileap/0.0.1/tce.json",
1968+
"dataSchema": "https://api.ileap.sine.dev/openapi.json",
18791969
"data": {
18801970
"mass": "87",
18811971
"shipmentId": "1237890",
@@ -1900,7 +1990,70 @@ A Product Footprint with a <{ShipmentFootprint}> highlighted:
19001990
</pre>
19011991
</div>
19021992

1993+
## TOC example ## {#appendix-a-toc-example}
1994+
1995+
A Product Footprint with a <{TOC}> highlighted:
19031996

1997+
<div class=example>
1998+
<pre highlight='json' line-highlight="37-54" line-numbers>
1999+
{
2000+
"id": "f3c04ec8-b33a-43b1-9fa7-d6a448fd60af",
2001+
"specVersion": "2.0.0",
2002+
"version": 0,
2003+
"created": "2022-05-22T21:47:32Z",
2004+
"status": "Active",
2005+
"companyName": "Super Duper Transport Co.",
2006+
"companyIds": [ "urn:epc:id:sgln:4063973.00000.8" ],
2007+
"productDescription": "Logistics emissions related to TOC with ID 4561230",
2008+
"productIds": [ "urn:pathfinder:product:customcode:vendor-assigned:4561230" ],
2009+
"productCategoryCpc": "83117",
2010+
"productNameCompany": "TOC with ID 4561230",
2011+
"comment": "",
2012+
"pcf": {
2013+
"declaredUnit": "ton kilometer",
2014+
"unitaryProductAmount": "1",
2015+
"pCfExcludingBiogenic": "3.6801",
2016+
"fossilGhgEmissions": "3.6801",
2017+
"fossilCarbonContent": "0.0",
2018+
"biogenicCarbonContent": "0.0",
2019+
"characterizationFactors": "AR6",
2020+
"ipccCharacterizationFactors": ["AR6"],
2021+
"crossSectoralStandardsUsed": [ "GHG Protocol Product standard" ],
2022+
"productOrSectorSpecificRules": [],
2023+
"boundaryProcessesDescription": "SFC GLEC Framework-conforming (W2W CO2e emissions)",
2024+
"referencePeriodStart": "2021-01-01T00:00:00Z",
2025+
"referencePeriodEnd": "2022-01-01T00:00:00Z",
2026+
"secondaryEmissionFactorSources": [ { "name": "Ecoinvent", "version": "3.9.1" } ],
2027+
"exemptedEmissionsPercent": 0.0,
2028+
"exemptedEmissionsDescription": "",
2029+
"packagingEmissionsIncluded": false,
2030+
"primaryDataShare": 56.12
2031+
},
2032+
"extensions": [
2033+
{
2034+
"specVersion": "2.0.0",
2035+
"dataSchema": "https://api.ileap.sine.dev/openapi.json",
2036+
"data": {
2037+
"tocId": "4561230",
2038+
"isVerified": true,
2039+
"isAccredited": true,
2040+
"mode": "Road",
2041+
"temperatureControl": "refrigerated",
2042+
"truckLoadingSequence": "FTL",
2043+
"energyCarriers": [
2044+
"energyCarrier": "Diesel",
2045+
"co2eIntensityWTW": "3.6801",
2046+
"co2eIntensityTTW": "3.2801"
2047+
],
2048+
"co2eIntensityWTW": "3.6801",
2049+
"co2eIntensityTTW": "3.2801",
2050+
"co2eIntensityThroughput": "tkm",
2051+
}
2052+
}
2053+
]
2054+
}
2055+
</pre>
2056+
</div>
19042057

19052058
<pre class=biblio>
19062059
{

0 commit comments

Comments
 (0)