PPWR - Dcycle Platform Docs

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

Overview

The ppwr packaging-unit command manages PPWR packaging units — the containers, boxes, films, and other packaging assessed under Regulation (EU) 2025/40. Each packaging unit belongs to a project and can cover one or more SKUs via its sku sub-command.

dcy ppwr packaging-unit <subcommand> [flags]
dcy ppwr packaging-unit sku <subcommand> [flags]

Available Commands

Command	Description
`list`	List packaging units for a project
`show`	Show packaging unit details
`create`	Create a packaging unit
`edit`	Edit a packaging unit
`delete`	Delete a packaging unit (cascades to its BOM items, substances, SKUs)
`sku list`	List SKUs covered by a packaging unit
`sku add`	Add a SKU to a packaging unit
`sku edit`	Edit a packaging unit SKU
`sku delete`	Delete a packaging unit SKU

Aliases: dcy ppwr packaging-units, dcy ppwr pkg-unit.

List Packaging Units

dcy ppwr packaging-unit list --project <project-id> [flags]

# Alias
dcy ppwr packaging-unit ls --project <project-id>

Examples

# List all packaging units in a project
dcy ppwr packaging-unit list --project <project-id>

# Filter by unit name or SKU reference
dcy ppwr packaging-unit list --project <project-id> --search "verde"

# JSON output for scripting
dcy ppwr packaging-unit list --project <project-id> --format json | jq '.[] | {id, name, status}'

Flags

Flag	Required	Description
`--project`	Yes	Project ID
`--search`	No	Filter by unit name or SKU reference
`--org`	No	Organization ID override

Output

Showing 2 packaging unit(s)
2ecd5181-... | CT 60X40X150 VERDE (LECHUGA) | primary/grouped | skus=1 | draft
7bc3d200-... | CT 40X30X8.5 VERDE           | secondary/sales | skus=0 | compliant

Columns: ID, name, packaging type/PPWR category, SKU count, status.

Show Packaging Unit Details

dcy ppwr packaging-unit show <packaging-unit-id>

Examples

dcy ppwr packaging-unit show 00000000-0000-0000-0000-000000000000

# JSON output
dcy ppwr packaging-unit show <packaging-unit-id> --format json

Flags

Flag	Description
`--org`	Organization ID override

Output

ID: 2ecd5181-b973-4000-8cac-a7f53b49c8f9
Name: CT 60X40X150 VERDE (LECHUGA)
Packaging Type: primary
PPWR Category: grouped
Status: draft
Description: 300-Jaula, contenedor.
Food Contact: false
Single Use: true
Weight: 463 g
SKU Count: 1
Project ID: 516bb7a2-56c9-46a6-92d0-483183c96d87
Created: 2026-07-22
Updated: 2026-08-04

Create Packaging Unit

dcy ppwr packaging-unit create --project <project-id> --name <name> --type <type> [flags]

Examples

dcy ppwr packaging-unit create --project <project-id> --name "Caja cartón 40x30" --type secondary

dcy ppwr packaging-unit create \
  --project <project-id> \
  --name "Film BOPP" \
  --type primary \
  --category sales \
  --food-contact \
  --weight 3.4

Flags

Flag	Short	Required	Default	Description
`--project`	—	Yes	—	Project ID
`--name`	`-n`	Yes	—	Packaging unit name
`--type`	`-t`	Yes	—	Packaging type: `primary`, `secondary`, `tertiary`, `transport`
`--category`	`-c`	No	—	PPWR category: `sales`, `grouped`, `transport`, `e_commerce`
`--description`	`-d`	No	—	Description
`--food-contact`	—	No	`false`	Intended for food contact
`--ean`	—	No	—	EAN code
`--weight`	—	No	—	Weight in grams
`--volume`	—	No	—	Volume in ml
`--units-per-pallet`	—	No	—	Units per pallet
`--single-use`	—	No	`false`	Single-use (not designed for reuse)
`--void-space-pct`	—	No	—	Declared void-space ratio (%)
`--target-markets`	—	No	—	Comma-separated ISO 3166-1 alpha-2 country codes
`--org`	—	No	—	Organization ID override

Edit Packaging Unit

dcy ppwr packaging-unit edit <packaging-unit-id> [flags]

Examples

dcy ppwr packaging-unit edit <packaging-unit-id> --weight 218 --food-contact
dcy ppwr packaging-unit edit <packaging-unit-id> --status compliant

Flags

Accepts the same flags as create (all optional — only provided fields are updated), plus:

Flag	Description
`--status`	Status: `draft`, `assessed`, `compliant`, `non_compliant`

Delete Packaging Unit

dcy ppwr packaging-unit delete <packaging-unit-id> [flags]

# Alias
dcy ppwr packaging-unit rm <packaging-unit-id>

Cascades to the unit’s BOM items, substances, and SKUs.

Examples

# Interactive confirmation
dcy ppwr packaging-unit delete <packaging-unit-id>

# Skip confirmation
dcy ppwr packaging-unit delete <packaging-unit-id> --yes

Flags

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

Output

Delete packaging unit CT 60X40X150 VERDE (LECHUGA) (2ecd5181-...)? This cascades to its BOM items, substances and SKUs. [y/N]

packaging unit deleted successfully: CT 60X40X150 VERDE (LECHUGA)

Packaging Unit SKUs

SKUs track the specific product references covered by a packaging unit’s declaration of conformity.

List SKUs

dcy ppwr packaging-unit sku list <packaging-unit-id>

Output:

Showing 1 SKU(s)
abc123-... | 2-201-524-CT 40X30X8.5 VERDE | CT 40X30X8.5 VERDE

Add a SKU

dcy ppwr packaging-unit sku add <packaging-unit-id> --reference "2-201-524-CT 40X30X8.5 VERDE"

dcy ppwr packaging-unit sku add <packaging-unit-id> \
  --reference "2-201-524-CT 40X30X8.5 VERDE" \
  --weight 218 \
  --ean 8412345678901

Flag	Short	Required	Description
`--reference`	`-r`	Yes	SKU reference (unique per packaging unit)
`--name`	`-n`	No	SKU name
`--ean`	—	No	EAN code
`--weight`	—	No	Weight in grams
`--volume`	—	No	Volume in ml
`--order-index`	—	No	Display order
`--org`	—	No	Organization ID override

Edit a SKU

dcy ppwr packaging-unit sku edit <packaging-unit-id> <sku-id> --weight 220

Accepts the same flags as sku add (all optional — only provided fields are updated).

Delete a SKU

# Interactive confirmation
dcy ppwr packaging-unit sku delete <packaging-unit-id> <sku-id>

# Skip confirmation
dcy ppwr packaging-unit sku delete <packaging-unit-id> <sku-id> --yes

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

Common Options

All PPWR commands support:

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

Workflows

Set Up a New Packaging Unit

# 1. Create the packaging unit
UNIT=$(dcy ppwr packaging-unit create \
  --project <project-id> \
  --name "CT 40X30X8.5 VERDE" \
  --type secondary \
  --category sales \
  --format json)

UNIT_ID=$(echo "$UNIT" | jq -r '.id')

# 2. Cover its SKUs
dcy ppwr packaging-unit sku add "$UNIT_ID" --reference "2-201-524-CT 40X30X8.5 VERDE"

# 3. Review and mark compliant once assessed
dcy ppwr packaging-unit show "$UNIT_ID"
dcy ppwr packaging-unit edit "$UNIT_ID" --status compliant

Piping with jq

# List packaging unit IDs for scripting
dcy ppwr packaging-unit list --project <project-id> --format json | jq -r '.[].id'

# Find units missing a weight
dcy ppwr packaging-unit list --project <project-id> --format json | jq '[.[] | select(.weight_grams == null)]'

# Count units by status
dcy ppwr packaging-unit list --project <project-id> --format json | jq 'group_by(.status) | map({status: .[0].status, count: length})'

​Overview

​Available Commands

​List Packaging Units

​Examples

​Flags

​Output

​Show Packaging Unit Details

​Examples

​Flags

​Output

​Create Packaging Unit

​Examples

​Flags

​Edit Packaging Unit

​Examples

​Flags

​Delete Packaging Unit

​Examples

​Flags

​Output

​Packaging Unit SKUs

​List SKUs

​Add a SKU

​Edit a SKU

​Delete a SKU

​Common Options

​Workflows

​Set Up a New Packaging Unit

​Piping with jq

Overview

Available Commands

List Packaging Units

Examples

Flags

Output

Show Packaging Unit Details

Examples

Flags

Output

Create Packaging Unit

Examples

Flags

Edit Packaging Unit

Examples

Flags

Delete Packaging Unit

Examples

Flags

Output

Packaging Unit SKUs

List SKUs

Add a SKU

Edit a SKU

Delete a SKU

Common Options

Workflows

Set Up a New Packaging Unit

Piping with jq