Skip to main content
Early Access - The Dcycle CLI is currently available for enterprise customers. Contact us to learn more about access.

Overview

Emissions data commands allow you to manage the primary data sources that feed into your carbon footprint calculations:
CategoryGHG ScopeExamples
Employee commuteScope 3Daily commutes, remote work
Business travelScope 3Flights, trains, hotel stays
InvoicesScope 2Electricity, gas, water bills
PurchasesScope 3Goods, services, raw materials
ShipmentsScope 3Merchandise transport

Employee Commute

Track how employees travel to and from work.

List Employees

dc employee list

Filter by Year

dc employee list --year 2024

Show Employee Details

dc employee show <employee-id>
Employee records include:
  • Commute mode (car, public transport, bike, etc.)
  • Distance traveled
  • Working days pattern
  • Remote work percentage

Business Travel

Track corporate travel emissions (flights, trains, car rentals).

List Travels

dc travel list

Filter Options

# By date range
dc travel list --from 2024-01-01 --to 2024-12-31

# By travel type
dc travel list --type flight

# By employee
dc travel list --employee <employee-id>

Travel Types

TypeEmission Factors
flightDistance-based (short/medium/long haul)
trainCountry-specific rail factors
carFuel type and distance
hotelNight stays by country

Energy Invoices

Manage electricity, gas, and utility invoices for facilities.

List Invoices

dc invoice list

Filter Options

# By facility
dc invoice list --facility <facility-id>

# By energy type
dc invoice list --type electricity

# By date range
dc invoice list --from 2024-01-01 --to 2024-12-31

Invoice Types

TypeUnitScope
electricitykWhScope 2
natural_gaskWh / m³Scope 1
district_heatingkWhScope 2
waterScope 3

Purchases

Track goods and services purchased from suppliers.

List Purchases

dc purchase list

Filter Options

# By supplier
dc purchase list --supplier <supplier-id>

# By category
dc purchase list --category "raw_materials"

# By date
dc purchase list --from 2024-01-01

Supplier-Specific Emission Factors

Upload custom emission factors for specific suppliers:
# Generate template
dc purchase supplier-specific upload-suppliers --template

# Upload emission factors
dc purchase supplier-specific upload-suppliers factors.csv
Example CSV:
supplier_name,supplier_vat,category,emission_factor,unit
Acme Steel,B12345678,raw_materials,2.5,kgCO2e/kg
Global Plastics,B87654321,packaging,3.2,kgCO2e/kg
Supplier-specific emission factors improve accuracy over generic spend-based factors. Provide real data from your suppliers’ environmental reports.

Shipments

Track merchandise transport emissions.

List Shipments

dc shipment list

Filter Options

# By direction
dc shipment list --direction sent
dc shipment list --direction received

# By mode of transport
dc shipment list --mode road

# By date
dc shipment list --from 2024-01-01 --to 2024-06-30

Shipment Fields

FieldDescription
originOrigin address or hub
destinationDestination address or hub
weightCargo weight (kg)
modeTransport mode (road, rail, sea, air)
distanceTotal distance (km)

Common Options

All emissions data commands support:
# Output formats
--format json     # JSON output
--format csv      # CSV output

# Pagination
--page N          # Page number
--size N          # Items per page

# Export
dc invoice list --format json > invoices.json

Data Quality Tips

Complete Address Data

Provide full addresses for accurate distance calculations in transport emissions.

Use Real Measurements

When possible, use metered data (kWh, km) rather than spend-based estimates.

Supplier Data

Request emission factors from key suppliers for Scope 3 accuracy.

Regular Updates

Upload data monthly or quarterly to track progress against targets.

Next Steps