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:
Category GHG Scope Examples Employee commute Scope 3 Daily commutes, remote work Business travel Scope 3 Flights, trains, hotel stays Invoices Scope 2 Electricity, gas, water bills Purchases Scope 3 Goods, services, raw materials Shipments Scope 3 Merchandise transport
Employee Commute Track how employees travel to and from work.
List Employees dcy employee list # Filter by year dcy employee list --year 2024 # Limit results dcy employee list --limit 50
Show Employee Details dcy employee show < employee-i d >
Create Employee dcy employee create employee --name "Jane Doe" --email jane@company.com
Flag Default Description --nameEmployee name --emailEmployee email --situationactiveEmployee situation --statusuploadedEmployee status --transportCommute transport mode --start-datePeriod start date (YYYY-MM-DD) --end-datePeriod end date (YYYY-MM-DD) --total-kmTotal km per period --weekly-travelsWeekly commute trips --daily-tripsDaily trips --vehicle-sizeVehicle size --fuelFuel type --renewable-energyUses renewable energy --carpoolCarpooling --commuting-typeCommuting type
Edit Employee dcy employee set info < employee-i d > --name "Jane Smith" --email jane.smith@company.com
Flag Description --nameNew name --emailNew email --situationNew situation
Add Period to Employee dcy employee create add-period < employee-i d > \ --transport car \ --start-date 2024-01-01 \ --end-date 2024-12-31 \ --total-km 4800
Required: --transport, --start-date, --end-date.
Import Employees Bulk import employee commute periods from CSV:
# Dry run dcy employee create import-periods employees.csv --dry-run # Import dcy employee create import-periods employees.csv # Skip overlapping periods dcy employee create import-periods employees.csv --skip-overlap
Update Historic Data Update past employee commute data to reflect current emission factors:
dcy employee set update-historic --dry-run dcy employee set update-historic
Delete Employee dcy employee delete < employee-i d > --yes
Business Travel Track corporate travel emissions (flights, trains, car rentals).
List Travels dcy travel list # Filter by year dcy travel list --year 2024 # Filter by month dcy travel list --month 2024-03 # Limit results dcy travel list --limit 50
Transport Routes Track upstream/downstream transport routes.
List Transport Routes dcy transport list # Filter by type dcy transport list --type upstream dcy transport list --type downstream # Filter by year dcy transport list --year 2024 # Limit results dcy transport list --limit 50
Show Transport Details dcy transport show < transport-i d >
Edit Transport Route dcy transport edit < transport-i d > --name "New Route Name" --quantity 1500 --unit kg
Flag Description --nameRoute name --supplierSupplier name --quantityQuantity transported --unitUnit of measurement --start-dateStart date (YYYY-MM-DD) --end-dateEnd date (YYYY-MM-DD)
Delete Transport Route dcy transport delete < transport-i d > --yes
Energy Invoices Manage electricity, gas, and utility invoices for facilities.
List Invoices dcy invoice list # Filter by facility dcy invoice list --facility < facility-i d > # Filter by type dcy invoice list --type electricity # Filter by year dcy invoice list --year 2024 # Set page size dcy invoice list --size 200
Invoice Types Type Unit Scope electricitykWh Scope 2 natural_gaskWh / m³ Scope 1 district_heatingkWh Scope 2 waterm³ Scope 3
Show Invoice Details dcy invoice show < invoice-i d >
Edit Invoice # Enable/disable dcy invoice edit < invoice-i d > --enabled dcy invoice edit < invoice-i d > --disabled # Change status dcy invoice edit < invoice-i d > --status completed
Download Invoice # Download to current directory dcy invoice download < invoice-i d > # Download to specific path dcy invoice download < invoice-i d > --output ./invoices/ # Overwrite existing file dcy invoice download < invoice-i d > --output invoice.pdf --overwrite
Delete Invoice dcy invoice delete < invoice-i d > --yes
Migrate Invoices to Another Facility Move invoices from one facility to another using a CSV file with invoice IDs:
# Preview dcy invoice migrate --file invoices.csv --to-facility < facility-i d > --dry-run # Execute dcy invoice migrate --file invoices.csv --to-facility < facility-i d > --yes
Recalculate Invoice Emissions dcy invoice recalculate --facility < facility-i d > # Also recalculate completed invoices dcy invoice recalculate --facility < facility-i d > --completed --yes
Purchases Track goods and services purchased from suppliers.
List Purchases dcy purchase list # Search by description or supplier dcy purchase list --search "steel" # Filter by status dcy purchase list --status validated # Filter by type dcy purchase list --purchase-type goods # Filter by expense type dcy purchase list --expense-type capital_goods # Pagination dcy purchase list --page 2 --size 100
Show Purchase Details dcy purchase show < purchase-i d >
Edit Purchase dcy purchase edit < purchase-i d > --description "Updated desc" --quantity 500
Flag Description --descriptionPurchase description --quantityQuantity --purchase-datePurchase date (YYYY-MM-DD) --recycledRecycled value --product-nameProduct name --unit-idUnit ID --expense-typeExpense type
Upload Purchases dcy purchase upload purchases.csv dcy purchase upload purchases.csv --skip-validation
Delete Orphan Suppliers Remove suppliers that have no associated purchases:
dcy purchase purge-orphan-suppliers --yes
Supplier-Specific Emission Factors Upload custom emission factors for specific suppliers:
# Generate template dcy purchase supplier-specific upload-suppliers --template # Validate without uploading dcy purchase supplier-specific upload-suppliers factors.csv --dry-run # Upload emission factors dcy purchase supplier-specific upload-suppliers factors.csv
Upload purchases linked to supplier-specific factors:
# Generate template dcy purchase supplier-specific upload-purchases --template # Validate without uploading dcy purchase supplier-specific upload-purchases purchases.csv --dry-run # Upload dcy purchase supplier-specific upload-purchases purchases.csv
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 dcy shipment list # Filter by direction dcy shipment list --direction sent dcy shipment list --direction received # Filter by date range dcy shipment list --start-date 2024-01-01 --end-date 2024-06-30 # Filter by supplier dcy shipment list --supplier "Acme Corp" # Pagination dcy shipment list --page 1 --size 50
Show Shipment Details dcy shipment show < shipment-i d >
Create Shipment dcy shipment create \ --quantity 1500 \ --unit < unit-i d > \ --direction sent \ --supplier "Acme Corp" \ --date 2024-03-15
Flag Required Description --quantityYes Quantity transported --unitYes Unit ID --directionYes sent/received or downstream/upstream--supplierNo Supplier name --descriptionNo Description --dateNo Shipment date (YYYY-MM-DD) --refrigeratedNo Is refrigerated transport
Delete Shipment dcy shipment delete < shipment-i d > --yes
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 dcy 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
Logistics Bulk upload transport requests and fuel data
Projects Organize emissions data into sustainability projects
Own Workforce Manage own workforce records and reference data
Examples See end-to-end workflow examples
