Step 4: Generate & Interpret GLEC Reports

Understanding the GLEC Company Report

The GLEC Company Report is the standard output of the GLEC v3.0 Framework. It provides a complete emissions breakdown for a logistics organization over a reporting period, structured by:

Emission scopes (1, 2, 3) as defined by the GHG Protocol
Transport activity with intensity values (gCO2e/tkm)
Hub operations with intensity values (gCO2e/tonne)
Per-TOC breakdown showing emissions by vehicle type
Per-HOC breakdown showing emissions by hub category

┌──────────────────────────────────────────────────────────────────────────────┐
│                     GLEC COMPANY REPORT STRUCTURE                            │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  SCOPE 1                  SCOPE 2                SCOPE 3                    │
│  ────────                 ────────               ────────                   │
│  TTW emissions            Hub purchased          WTT emissions              │
│  (own fleet direct        energy (electricity,   (upstream fuel             │
│   fuel combustion)        district heating)       production)               │
│                                                                              │
│  Hub on-site fuel                                WTW subcontracted          │
│  (generators, heating)                           (3rd party transport)      │
│                                                                              │
│                                                  Hub emissions              │
│                                                  (subcontracted hubs)       │
│                                                                              │
│                                                  Cleaning emissions         │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│  COMPANY METRICS                                                             │
│  ───────────────                                                             │
│  Transport Activity IV: gCO2e/tkm  |  Hub Operation IV: gCO2e/tonne       │
│  Total tkm               Total tonnes handled                              │
│  Total transport CO2e    Total hub CO2e                                     │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│  BREAKDOWNS                                                                  │
│  ──────────                                                                  │
│  By TOC (vehicle type): IV, tkm, emissions, fuels used                     │
│  By HOC (hub category): IV, emissions, tonnes                              │
│  By transport mode: IV, tkm, emissions, DAF applied                        │
│  Emission factors used: all fuel and TOC factors applied                    │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Two report types are available:

GLEC Company Report (legacy endpoint) — Full GLEC v3.0 structure with Scope 1/2/3, TOC/HOC breakdowns, and intensity values. Available via GET /logistics/report.
ISO 14083 Summary Report (new API) — Simplified aggregated report with category breakdown. Available via GET /v1/logistics/report.

This guide covers both, with the GLEC Company Report as the primary focus.

Prerequisites

Before generating a report, ensure you have:

Transport legs created (Step 1)
Optionally: hubs configured (Step 2) and fuel recharges uploaded (Step 3)
A reporting period (start and end dates)

Step 4.1: Generate the ISO 14083 Summary Report

The new API provides a quick summary report with category breakdown:

📋 Data Map: Summary Report

Parameter	Type	Required	Description	Example
`start_date`	string	Yes	Start of reporting period (YYYY-MM-DD)	`"2025-01-01"`
`end_date`	string	Yes	End of reporting period (YYYY-MM-DD)	`"2025-12-31"`
`client`	string	No	Filter by client identifier	`"AMAZON"`

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('DCYCLE_API_KEY')}",
    "Content-Type": "application/json",
    "x-organization-id": os.getenv("DCYCLE_ORG_ID"),
    "x-user-id": os.getenv("DCYCLE_USER_ID"),
}

# Generate ISO 14083 summary report
report = requests.get(
    "https://api.dcycle.io/v1/logistics/report",
    headers=headers,
    params={
        "start_date": "2025-01-01",
        "end_date": "2025-12-31",
    },
).json()

print(f"Methodology: {report['methodology']}")
print(f"Period: {report['period']['start_date']} to {report['period']['end_date']}")
print(f"Data source: {report['data_source']}")
print()
print(f"Summary:")
print(f"  Total items: {report['summary']['total_items']:,}")
print(f"  Total CO2e: {report['summary']['total_co2e_kg']:,.1f} kg ({report['summary']['total_co2e_kg']/1000:.2f} tonnes)")
print(f"  Total distance: {report['summary']['total_distance_km']:,.0f} km")
print(f"  Avg CO2e per item: {report['summary']['avg_co2e_per_item']:.2f} kg")
print()
print(f"By transport category:")
for cat in report["by_category"]:
    print(f"  {cat['category']:12s} | {cat['items']:>6,} items | {cat['co2e_kg']:>12,.1f} kg CO2e | {cat['percentage_co2e']:.1f}%")

Filter by Client

Generate a report for a specific client:

# Client-specific report
client_report = requests.get(
    "https://api.dcycle.io/v1/logistics/report",
    headers=headers,
    params={
        "start_date": "2025-01-01",
        "end_date": "2025-12-31",
        "client": "RETAILCO",
    },
).json()

print(f"Client: {client_report['client']}")
print(f"Total CO2e: {client_report['summary']['total_co2e_kg']:,.1f} kg")

Step 4.2: Generate the Full GLEC Company Report

The legacy endpoint provides the complete GLEC v3.0 company report with Scope 1/2/3 breakdown:

📋 Data Map: GLEC Company Report

Parameter	Type	Required	Description	Example
`start_date`	timestamp	Yes	Start of period (Unix timestamp)	`1704067200`
`end_date`	timestamp	Yes	End of period (Unix timestamp)	`1735689600`
`report_type`	string	No	`"company"` or `"client"`	`"company"`
`client`	string	No	Client name (for client reports)	`"RETAILCO"`

import time
from datetime import datetime

headers_legacy = {
    "Authorization": f"Bearer {os.getenv('DCYCLE_API_KEY')}",
    "Content-Type": "application/json",
    "x-organization-id": os.getenv("DCYCLE_ORG_ID"),
    "x-partner": os.getenv("DCYCLE_PARTNER_ID"),
}

# Convert dates to timestamps
start_ts = int(datetime(2025, 1, 1).timestamp())
end_ts = int(datetime(2025, 12, 31, 23, 59, 59).timestamp())

# Generate GLEC company report
report = requests.get(
    "https://api.dcycle.io/logistics/report",
    headers=headers_legacy,
    params={
        "start_date": start_ts,
        "end_date": end_ts,
        "report_type": "company",
    },
).json()

Interpreting the Report

Scope Breakdown

# Scope 1: Direct emissions
scope_1 = report["scope_1"]
print("SCOPE 1 (Direct Emissions)")
print(f"  TTW emissions (own fleet): {scope_1['ttw_emissions']['value']:,.2f} {scope_1['ttw_emissions']['units']}")
print(f"  Hub emissions (on-site):   {scope_1['hubs_emissions']['value']:,.2f} {scope_1['hubs_emissions']['units']}")

# Scope 2: Purchased energy
scope_2 = report["scope_2"]
print("\nSCOPE 2 (Purchased Energy)")
print(f"  Hub emissions (electricity): {scope_2['hubs_emissions']['value']:,.2f} {scope_2['hubs_emissions']['units']}")

# Scope 3: Indirect emissions
scope_3 = report["scope_3"]
print("\nSCOPE 3 (Indirect Emissions)")
print(f"  WTT emissions (fuel upstream):  {scope_3['wtt_emissions']['value']:,.2f} {scope_3['wtt_emissions']['units']}")
print(f"  Subcontracted WTW:              {scope_3['wtw_subcontracted_emissions']['value']:,.2f} {scope_3['wtw_subcontracted_emissions']['units']}")
print(f"  Hub emissions (subcontracted):  {scope_3['hub_emissions']['value']:,.2f} {scope_3['hub_emissions']['units']}")
print(f"  Cleaning emissions:             {scope_3['cleaning_emissions']['value']:,.2f} {scope_3['cleaning_emissions']['units']}")

# Total
total = report["total_scopes"]
print(f"\nTOTAL: {total['emissions']['value']:,.2f} {total['emissions']['units']}")

Company Metrics (Intensity Values)

company = report["company_emissions"]

# Transport Activity IV
transport = company["transport_activity"]
print("TRANSPORT ACTIVITY")
print(f"  Intensity Value: {transport['iv']['value']:.2f} {transport['iv']['units']}")
print(f"  Total tkm:       {transport['tkm']['value']:,.0f} {transport['tkm']['units']}")
print(f"  Total emissions: {transport['emissions']['value']:,.2f} {transport['emissions']['units']}")

# Hub Operation IV
hub = company["hub_operation"]
print("\nHUB OPERATIONS")
print(f"  Intensity Value: {hub['iv']['value']:.2f} {hub['iv']['units']}")
print(f"  Total tonnes:    {hub['tonne']['value']:,.0f} {hub['tonne']['units']}")
print(f"  Total emissions: {hub['emissions']['value']:,.2f} {hub['emissions']['units']}")

Key metrics to track year-over-year:

Transport Activity IV (gCO2e/tkm): Lower = more efficient transport. Compare against industry benchmarks and previous years.
Hub Operation IV (gCO2e/tonne): Lower = more efficient hub operations.
Scope 1 share: Proportion of direct emissions — indicates fleet control level.
Subcontracted share: Proportion of Scope 3 subcontracted emissions — indicates supply chain dependency.

Per-TOC Breakdown

print("\nEMISSIONS BY VEHICLE TYPE (TOC)")
print(f"{'TOC':<30} {'IV (gCO2e/tkm)':>15} {'tkm':>12} {'CO2e (kg)':>12}")
print("-" * 72)

for toc_name, toc_data in report["tocs_info"].items():
    print(
        f"{toc_name:<30} "
        f"{toc_data['iv']:>15.2f} "
        f"{toc_data['tkm']:>12,.0f} "
        f"{toc_data['emissions']:>12,.2f}"
    )

Per-HOC Breakdown

print("\nEMISSIONS BY HUB CATEGORY (HOC)")
print(f"{'Hub Name':<35} {'Category':<25} {'IV (gCO2e/t)':>12} {'CO2e (kg)':>12}")
print("-" * 87)

for hub_name, hub_data in report["hocs_info"].items():
    print(
        f"{hub_name:<35} "
        f"{hub_data['hub_category']:<25} "
        f"{hub_data['iv']:>12.2f} "
        f"{hub_data['emissions']:>12,.2f}"
    )

Emission Factors Used

# List all emission factors applied in the report
print("\nEMISSION FACTORS USED")

print("\n  Fuels:")
for fuel in report["emission_factors_used"]["logistics_fuels"]:
    print(f"    {fuel}")

print("\n  TOCs:")
for toc in report["emission_factors_used"]["logistics_tocs"]:
    print(f"    {toc}")

Step 4.3: Generate Client-Level Reports

For carriers, generate reports per client to share emissions data with your customers:

# Get all clients
clients = requests.get(
    "https://api.dcycle.io/v1/logistics/clients",
    headers=headers,
).json()

# Generate report for each client
print("CLIENT EMISSIONS SUMMARY (2025)")
print(f"{'Client':<25} {'Items':>8} {'CO2e (kg)':>12} {'Distance (km)':>14}")
print("-" * 62)

for client_name in clients:
    client_report = requests.get(
        "https://api.dcycle.io/v1/logistics/report",
        headers=headers,
        params={
            "start_date": "2025-01-01",
            "end_date": "2025-12-31",
            "client": client_name,
        },
    ).json()

    summary = client_report["summary"]
    print(
        f"{client_name:<25} "
        f"{summary['total_items']:>8,} "
        f"{summary['total_co2e_kg']:>12,.1f} "
        f"{summary['total_distance_km']:>14,.0f}"
    )

Sharing with clients: Client-level GLEC reports help your customers account for Scope 3 Category 4 (upstream transport) or Category 9 (downstream transport) in their own GHG Protocol inventories. The more specific your TOC and fuel data, the more valuable the report.

Step 4.4: Export Report as CSV

Generate a downloadable CSV report:

from src.utils.filename_generator import generate_report_filename

# The GLEC report CSV follows the naming convention:
# reporte-glec_<org-name>_<start-date>_<end-date>_<timestamp>.csv
filename = generate_report_filename("glec", "my-org-name", "2025-01-01", "2025-12-31")
# → "reporte-glec_my-org-name_2025-01-01_2025-12-31_20250219.csv"

CSV export is available through the Dcycle web application. Navigate to your organization’s logistics dashboard, select the reporting period, and click Download GLEC Report.

Understanding the Report Output

Scope Allocation Summary

Emission Source	Own Fleet	Subcontracted
TTW (direct fuel combustion)	Scope 1	Scope 3
WTT (fuel production upstream)	Scope 3	Scope 3
Hub on-site fuel	Scope 1	—
Hub purchased electricity	Scope 2	—
Hub default HOC emissions	—	Scope 3
Vehicle cleaning	—	Scope 3

Benchmarking Intensity Values

Use these approximate benchmarks to contextualize your Transport Activity IV:

Mode	Good IV (gCO2e/tkm)	Average IV	Poor IV
Road (general)	< 50	50 – 120	> 120
Rail	< 15	15 – 30	> 30
Maritime	< 10	10 – 20	> 20
Air	< 500	500 – 800	> 800

These benchmarks are approximate and vary significantly by region, load factor, and vehicle age. Always compare against your own historical data and industry-specific benchmarks from the Smart Freight Centre.

Year-over-Year Tracking

Track these key indicators each reporting period:

Total CO2e: Are absolute emissions decreasing?
Transport Activity IV: Is emission efficiency improving?
Hub Operation IV: Are hub operations becoming greener?
Modal split: Is traffic shifting to lower-emission modes (rail, maritime)?
Fuel mix: Is the share of biofuels and electric vehicles increasing?
Subcontracted share: Are you gaining more control over your supply chain emissions?

Next Steps

Getting Started with GLEC

Review the GLEC framework overview and key concepts

Logistics API Reference

Complete API documentation for all endpoints

GHG Protocol Tutorial

Calculate non-transport emissions (Scope 1/2/3 corporate)

Custom Emission Factors

Use supplier-specific or custom factors

Calculate Emissions

ISO 14064

GHG Protocol

GLEC v3.0 Framework

Use Case Tutorials

Life Cycle Assessment (LCA)

Advanced

Automation & AI

Step 4: Generate & Interpret GLEC Reports

Understanding the GLEC Company Report

Prerequisites

Step 4.1: Generate the ISO 14083 Summary Report

Filter by Client

Step 4.2: Generate the Full GLEC Company Report

Interpreting the Report

Scope Breakdown

Company Metrics (Intensity Values)

Per-TOC Breakdown

Per-HOC Breakdown

Emission Factors Used

Step 4.3: Generate Client-Level Reports

Step 4.4: Export Report as CSV

Understanding the Report Output

Scope Allocation Summary

Benchmarking Intensity Values

Year-over-Year Tracking

Next Steps

Getting Started with GLEC

Logistics API Reference

GHG Protocol Tutorial

Custom Emission Factors

Calculate Emissions

ISO 14064

GHG Protocol

GLEC v3.0 Framework

Use Case Tutorials

Life Cycle Assessment (LCA)

Advanced

Automation & AI

​Understanding the GLEC Company Report

​Prerequisites

​Step 4.1: Generate the ISO 14083 Summary Report

​Filter by Client

​Step 4.2: Generate the Full GLEC Company Report

​Interpreting the Report

​Scope Breakdown

​Company Metrics (Intensity Values)

​Per-TOC Breakdown

​Per-HOC Breakdown

​Emission Factors Used

​Step 4.3: Generate Client-Level Reports

​Step 4.4: Export Report as CSV

​Understanding the Report Output

​Scope Allocation Summary

​Benchmarking Intensity Values

​Year-over-Year Tracking

​Next Steps

Getting Started with GLEC

Logistics API Reference

GHG Protocol Tutorial

Custom Emission Factors

Understanding the GLEC Company Report

Prerequisites

Step 4.1: Generate the ISO 14083 Summary Report

Filter by Client

Step 4.2: Generate the Full GLEC Company Report

Interpreting the Report

Scope Breakdown

Company Metrics (Intensity Values)

Per-TOC Breakdown

Per-HOC Breakdown

Emission Factors Used

Step 4.3: Generate Client-Level Reports

Step 4.4: Export Report as CSV

Understanding the Report Output

Scope Allocation Summary

Benchmarking Intensity Values

Year-over-Year Tracking

Next Steps