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

Overview

The shipment command tracks merchandise transport emissions — goods shipped to or received from third parties.
dcy shipment <subcommand> [flags]

Available Commands

CommandDescription
listList shipments
showShow shipment details
createCreate a shipment
deleteDelete a shipment

List Shipments

dcy shipment list [flags]

# Aliases
dcy shipment ls

Examples

# List all 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

# JSON output
dcy shipment list --format json

Flags

FlagShortDefaultDescription
--direction-dFilter by direction (sent, received)
--supplier-sFilter by supplier name (case-insensitive match)
--statusFilter by status
--start-dateFilter from date (YYYY-MM-DD)
--end-dateFilter to date (YYYY-MM-DD)
--page1Page number
--size50Page size
--orgOrganization ID override

Show Shipment Details

dcy shipment show <shipment-id>

Examples

dcy shipment show 00000000-0000-0000-0000-000000000000

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

Flags

FlagDescription
--orgOrganization ID override

Create Shipment

dcy shipment create [flags]

Examples

dcy shipment create \
  --quantity 1500 \
  --unit <unit-id> \
  --direction sent

dcy shipment create \
  --quantity 1500 \
  --unit <unit-id> \
  --direction sent \
  --supplier "Acme Corp" \
  --date 2024-03-15 \
  --description "Monthly delivery"

Flags

FlagShortRequiredDefaultDescription
--quantity-qYesQuantity transported
--unit-uYesUnit ID (use dcy units list for valid IDs)
--direction-dYessent/received or downstream/upstream
--supplier-sNoSupplier name
--descriptionNoDescription
--dateNotodayShipment date (YYYY-MM-DD)
--refrigeratedNofalseIs refrigerated transport
--orgNoOrganization ID override

Delete Shipment

dcy shipment delete <shipment-id> [flags]

# Aliases
dcy shipment rm <shipment-id>

Examples

# Interactive confirmation
dcy shipment delete <shipment-id>

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

Flags

FlagShortDefaultDescription
--yes-yfalseSkip confirmation prompt
--orgOrganization ID override

Common Options

All shipment commands support:
FlagDescription
--format jsonJSON output (default: text)
--verboseShow HTTP request/response details
--timeoutRequest timeout in seconds