Transport Routes - Dcycle Platform Docs

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

Overview

The transport command tracks upstream and downstream transport routes, covering GHG Protocol Scope 3 Categories 4 (Upstream Transportation) and 9 (Downstream Transportation).

dcy transport <subcommand> [flags]

Available Commands

Command	Description
`list`	List transport routes
`show`	Show transport route details
`edit`	Edit a transport route
`delete`	Delete a transport route

List Transport Routes

dcy transport list [flags]

# Aliases
dcy transport ls

Examples

# List all transport routes
dcy transport list

# By direction
dcy transport list --type upstream
dcy transport list --type downstream

# By year
dcy transport list --year 2024

# Filter by status
dcy transport list --status active

# Pagination
dcy transport list --page 2 --size 100

# JSON output
dcy transport list --format json

Flags

Flag	Short	Default	Description
`--type`	—	—	Direction: `upstream` or `downstream`
`--status`	—	—	Filter by status
`--year`	—	—	Filter by year
`--page`	—	`1`	Page number
`--size`	—	`50`	Page size
`--org`	—	—	Organization ID override

Output

Showing 3 of 8 transport routes
abc123-... | Raw Materials Import | upstream   | Shanghai -> Barcelona | 12500.00
def456-... | Product Distribution | downstream | Madrid   -> Lisbon    | 625.30
ghi789-... | Supplier Delivery    | upstream   | Paris    -> Madrid    | 1275.00

The last column shows the calculated distance in km.

Show Transport Details

dcy transport show <transport-id>

Examples

dcy transport show 00000000-0000-0000-0000-000000000000

# JSON output
dcy transport show <transport-id> --format json

Flags

Flag	Description
`--org`	Organization ID override

Shows full route details including origin, destination, distance (km), quantity, unit, supplier, frequency, and calculated CO2e.

Edit Transport Route

dcy transport edit <transport-id> [flags]

Examples

dcy transport edit <transport-id> --name "New Route Name"
dcy transport edit <transport-id> --quantity 1500 --unit <unit-id>
dcy transport edit <transport-id> --supplier "Acme Logistics"
dcy transport edit <transport-id> --start-date 2024-01-01 --end-date 2024-12-31

Flags

Flag	Short	Description
`--name`	`-n`	Route name
`--supplier`	`-s`	Supplier name
`--quantity`	`-q`	Quantity transported
`--unit`	`-u`	Unit of measurement (use `dcy units list` for valid IDs)
`--start-date`	—	Start date (YYYY-MM-DD)
`--end-date`	—	End date (YYYY-MM-DD)
`--org`	—	Organization ID override

Delete Transport Route

dcy transport delete <transport-id> [flags]

# Aliases
dcy transport rm <transport-id>

Examples

# Interactive confirmation
dcy transport delete <transport-id>

# Skip confirmation
dcy transport delete <transport-id> --yes

Flags

Flag	Short	Default	Description
`--yes`	`-y`	`false`	Skip confirmation prompt
`--org`	—	—	Organization ID override

Common Options

All transport commands support:

Flag	Description
`--format json`	JSON output (default: `text`)
`--verbose`	Show HTTP request/response details
`--timeout`	Request timeout in seconds

​Overview

​Available Commands

​List Transport Routes

​Examples

​Flags

​Output

​Show Transport Details

​Examples

​Flags

​Edit Transport Route

​Examples

​Flags

​Delete Transport Route

​Examples

​Flags

​Common Options

Overview

Available Commands

List Transport Routes

Examples

Flags

Output

Show Transport Details

Examples

Flags

Edit Transport Route

Examples

Flags

Delete Transport Route

Examples

Flags

Common Options