Getting Started

The Packaging Units plugin adds catalog-level packaging unit management to Vendure. It lets you define packaging units (e.g. Piece, Box, Pallet), assign them to products, and configure per-variant conversion factors and ordering constraints -- giving B2B and wholesale storefronts full control over how products are sold and fulfilled in different quantities.

Core Concepts

• PackagingUnit -- A reusable, translatable catalog entry representing a unit of packaging (e.g. "Piece", "Box", "Pallet"). Each unit has a unique code and supports multi-language names and descriptions.
• ProductPackagingUnit -- A join between a Product and a PackagingUnit. Assigning a packaging unit to a product makes it available for configuration on that product's variants.
• ProductVariantPackagingUnit -- The per-variant configuration for a specific packaging unit. This is where you set the conversionFactor, minimum quantities, and quantity increments.
• OrderLine custom fields -- When a customer adds an item to the cart with a packaging unit, the plugin stores the packagingUnit relation, the packagingUnitConversionFactor, and the packagingUnitName on the order line for order history and fulfillment.