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

Facilities

Facilities represent physical locations like offices, warehouses, factories, and stores.

List Facilities

dc facility list
Output:
┌────────────────────────────────────────┬─────────────────────┬───────────┬─────────┬────────┐
│ ID                                     │ Name                │ Type      │ Country │ Status │
├────────────────────────────────────────┼─────────────────────┼───────────┼─────────┼────────┤
│ abc123-def456-...                      │ Madrid HQ           │ office    │ ES      │ active │
│ def456-ghi789-...                      │ Barcelona Warehouse │ warehouse │ ES      │ active │
│ ghi789-jkl012-...                      │ Valencia Factory    │ factory   │ ES      │ active │
└────────────────────────────────────────┴─────────────────────┴───────────┴─────────┴────────┘

Filter Facilities

# By status
dc facility list --status active

# By type
dc facility list --type warehouse

# By country
dc facility list --country ES

# Combine filters
dc facility list --type office --status active --country ES

Show Facility Details

dc facility show abc123-def456-...
Output includes address, area (m²), energy configuration, and associated emissions data.

Vehicles

Manage your organization’s fleet of vehicles.

List Vehicles

dc vehicle list
Output:
┌────────────────────────────────────────┬───────────┬──────────┬──────────┬────────┐
│ ID                                     │ Plate     │ Type     │ Fuel     │ Status │
├────────────────────────────────────────┼───────────┼──────────┼──────────┼────────┤
│ v1-abc123-...                          │ 1234 ABC  │ van      │ diesel   │ active │
│ v2-def456-...                          │ 5678 DEF  │ truck    │ diesel   │ active │
│ v3-ghi789-...                          │ 9012 GHI  │ car      │ electric │ active │
└────────────────────────────────────────┴───────────┴──────────┴──────────┴────────┘

Filter Vehicles

# By type
dc vehicle list --type truck

# By fuel type
dc vehicle list --fuel electric

# By status
dc vehicle list --status active

Show Vehicle Details

dc vehicle show v1-abc123-...

Bulk Upload Vehicles

Upload multiple vehicles from a CSV file:
# Generate template
dc vehicle upload --template

# Upload CSV
dc vehicle upload vehicles.csv
Example CSV format:
plate,type,fuel,brand,model,year
1234 ABC,van,diesel,Ford,Transit,2022
5678 DEF,truck,diesel,Mercedes,Actros,2021
9012 GHI,car,electric,Tesla,Model 3,2023

Logistic Hubs

Hubs are distribution centers and logistic nodes used in transport calculations.

List Hubs

dc hub list

Show Hub Details

dc hub show <hub-id>

Hub Fields

FieldDescription
nameHub identifier
addressPhysical address
latitudeGeographic coordinate
longitudeGeographic coordinate
typeHub type (distribution, cross-dock, etc.)

Common Options

All asset commands support these options:
OptionDescription
--format jsonOutput as JSON
--format csvOutput as CSV
--page NPagination (page number)
--size NItems per page (default: 50)
--sort FIELDSort by field

Export to File

# Export vehicles to JSON
dc vehicle list --format json > vehicles.json

# Export facilities to CSV
dc facility list --format csv > facilities.csv

Best Practices

Use CSV templates for bulk uploads: Generate a fresh template with --template, fill it with your data, then upload. This ensures correct column names and formats.
# Recommended workflow for vehicle upload
dc vehicle upload --template > vehicles_template.csv
# Edit vehicles_template.csv with your data
dc vehicle upload vehicles_template.csv

Next Steps