Units of Measure (UOM/AUOM)
Many products are bought, stocked, and sold in different units — you purchase coffee by the carton, keep it on hand by the kilogram, and sell it by the bag. XBuddy’s UOM system (also called Alternative UOM, or AUOM) keeps quantities correct across all three without you converting anything by hand.
The building blocks
- Unit catalog & categories — units are defined once (PCS, BOX, KG, L, …) and grouped into categories (count, weight, volume). Conversions are only allowed within a category.
- Conversions — you define factors like
1 BOX = 24 PCS. The conversion engine can chain factors through intermediate units (multi-hop), so you don’t need every pair defined directly. - Per-product default units — each stock item carries a default sales unit, purchase unit, and inventory (base) unit. Line items auto-fill the right unit for the document type.
- Automatic conversion where stock moves — at goods receipt, received quantities convert into the base unit (and unit cost adjusts accordingly); at sales fulfillment, the sold quantity converts before stock is deducted. On-hand stock and COGS are always in the base unit.
⚠️
If two units differ and no conversion path exists, XBuddy blocks the goods receipt rather than silently receiving 1:1 — define the conversion first.
Feature toggles
| Toggle (Inventory group) | Effect |
|---|---|
uom_enabled | Turns the UOM system on (default: on) |
uom_auto_convert | Quantities convert automatically using defined factors |
enforce_uom_category | Rejects conversions across incompatible categories (e.g. KG → PCS) |
See Feature Toggles for where to manage them.
When you don’t need it
If every product is bought, stocked, and sold in the same unit, factors stay at 1 and UOM is invisible — no setup required. Configure units and conversions only for products where the units genuinely differ.