Beginner

UoM Package Mappings

Configure package quantities for different units of measure

2 min read
Last updated: November 11, 2025
6 views

UoM Package Mappings

Configure how packages relate to individual pieces for different units of measure.

What Are UoM Package Mappings?

Some suppliers sell products in different package sizes depending on the unit of measure:

  • Box: 24 pieces per box
  • Pallet: 1000 pieces per pallet
  • Case: 12 pieces per case

UoM mappings tell Pricelist Heaven how many pieces are in each package type.

When to Use

Use UoM mappings when:

  • Supplier prices are per package/box
  • You want Odoo to track individual pieces
  • Different products have different package sizes

Configuring Mappings

  1. Edit supplier
  2. Scroll to "UoM Package Mappings"
  3. Add mapping:
UoMPackage QuantityOdoo UoM ID
Box241
Pallet10005

Fields:

UoM Name: How it appears in the supplier file (e.g., "Box", "CTN")

Package Quantity: Number of pieces in one package

Odoo UoM ID: The Odoo unit of measure ID to use

How It Works

During import, if a product has UoM "Box":

  1. Supplier Price: €24.00 per box
  2. Package Quantity: 24 pieces
  3. Calculated Price: €24.00 ÷ 24 = €1.00 per piece

Odoo receives:

  • Price: €1.00 per piece
  • Minimum Quantity: 24 (must buy full box)
  • Purchase UoM: Box

Finding Odoo UoM IDs

In Odoo:

  1. Go to Inventory → Configuration → Units of Measure
  2. Enable Developer Mode (Settings → Activate developer mode)
  3. Open the UoM
  4. Check the ID in the URL or top-right

Default Package Quantity

If a UoM doesn't have a specific mapping, the supplier's default package quantity is used.

Example Configuration

For a supplier that ships in various packages:

Box: 24 pieces
Case: 12 pieces  
Pallet: 1200 pieces

Add three mappings to handle all package types.

Was this article helpful?

Let us know if this guide helped you get started