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, can cover one or more SKUs via its sku sub-command, and can be assigned to an organization supplier via its supplier sub-command.

dcy ppwr packaging-unit <subcommand> [flags]
dcy ppwr packaging-unit sku <subcommand> [flags]
dcy ppwr packaging-unit supplier <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
`supplier list`	List packaging units assigned to a supplier
`supplier add`	Assign packaging units to a supplier
`supplier remove`	Unassign packaging units from a supplier

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

Packaging Unit Supplier Assignment

Each packaging unit can be assigned to at most one organization supplier — the platform enforces this with a database-level constraint, so assigning a unit already held by another supplier fails with a 409 instead of silently reassigning it. add and remove are additive/subtractive: they read the supplier’s current assignments, merge in your change, and write back the full set — they never drop unrelated assignments.

There’s no additive backend endpoint, so add/remove do a read-then-write. Running them concurrently against the same supplier (from two terminals, a script, and the UI at once, etc.) can silently lose one of the changes — last write wins. Fine for normal one-at-a-time admin use.

List Assignments

dcy ppwr packaging-unit supplier list <supplier-id> --project <project-id>

Output:

Showing 2 assignment(s)
assignment=321d28a6-... | packaging_unit=c98a814a-72e4-4b44-bd3f-99af3d1f8172
assignment=faeaa75b-... | packaging_unit=0308a307-94d7-47b6-b5d0-747c9fd04b6a

assignment is the id of the supplier↔packaging-unit link itself, not the supplier or packaging unit id.

Flag	Required	Description
`--project`	Yes	Project ID
`--org`	No	Organization ID override

Assign Packaging Units to a Supplier

dcy ppwr packaging-unit supplier add <supplier-id> <packaging-unit-id> [<packaging-unit-id>...] --project <project-id>

# Assign one unit
dcy ppwr packaging-unit supplier add <supplier-id> <packaging-unit-id> --project <project-id>

# Assign several at once
dcy ppwr packaging-unit supplier add <supplier-id> <unit-id-1> <unit-id-2> --project <project-id>

If a unit is already assigned to a different supplier, the command fails:

Error: conflict: {"code":"PACKAGING_UNIT_ALREADY_ASSIGNED","detail":{"message":"One or more packaging units are already assigned to a different supplier.","packaging_unit_ids":["c98a814a-..."]}} (status 409)

Unassign it from the other supplier first with supplier remove.

Flag	Required	Description
`--project`	Yes	Project ID
`--org`	No	Organization ID override

Unassign Packaging Units from a Supplier

dcy ppwr packaging-unit supplier remove <supplier-id> <packaging-unit-id> [<packaging-unit-id>...] --project <project-id>

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

If a given unit wasn’t actually assigned to this supplier, the command prints a warning to stderr (... was not assigned to this supplier, nothing to remove) instead of failing — useful when scripting idempotent cleanup.

Flag	Required	Description
`--project`	Yes	Project ID
`--org`	No	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

​Packaging Unit Supplier Assignment

​List Assignments

​Assign Packaging Units to a Supplier

​Unassign Packaging Units from a Supplier

​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

Packaging Unit Supplier Assignment

List Assignments

Assign Packaging Units to a Supplier

Unassign Packaging Units from a Supplier

Common Options

Workflows

Set Up a New Packaging Unit

Piping with jq