Track goods and services purchased from suppliers for Scope 3 emissions
Early Access - The Dcycle CLI is currently available for enterprise customers.
Contact us to learn more about access.
Overview
The purchase command tracks goods and services purchased from suppliers, covering GHG Protocol Scope 3 Category 1 (Purchased Goods & Services) and Category 2 (Capital Goods).
dcy purchase <subcommand> [flags]
Available Commands
Command
Description
list
List purchases
show
Show purchase details
edit
Edit a purchase
upload
Upload purchases from CSV
purge-orphan-suppliers
Remove suppliers with no associated purchases
supplier-specific upload-suppliers
Upload supplier-specific emission factors
supplier-specific upload-purchases
Upload purchases linked to supplier-specific factors
List Purchases
dcy purchase list [flags]# Aliasesdcy purchase ls
Examples
# List all purchasesdcy purchase list# Search by description or supplierdcy purchase list --search "steel"# Filter by exact descriptiondcy purchase list --description "Steel beams"# Filter by status (repeatable for multiple values)dcy purchase list --status validateddcy purchase list --status validated --status uploaded# Filter by purchase type (repeatable)dcy purchase list --purchase-type goodsdcy purchase list --purchase-type spend_based# Filter by expense type (repeatable)dcy purchase list --expense-type capital_goodsdcy purchase list --expense-type capex# Paginationdcy purchase list --page 2 --size 100# JSON output for scriptingdcy purchase list --format json
Flags
Flag
Default
Description
--search
—
Search by description or supplier name
--description
—
Filter by exact description
--status
—
Filter by status (repeatable)
--purchase-type
—
Filter by purchase type (repeatable)
--expense-type
—
Filter by expense type (repeatable)
--page
1
Page number
--size
50
Page size
--org
—
Organization ID override
Output
Showing 3 of 42 purchases in Acme Corpabc123-... | Steel Beams | 500.00 kg | capex | validated | SupplierCodef456-... | Office Paper | 20.00 EUR | opex | uploaded | PaperIncghi789-... | IT Equipment | 3 units | capex | active | TechSupply
Upload custom emission factors from specific suppliers, then upload purchases linked to those factors. This improves accuracy over generic spend-based calculations.