Skip to main content
The UnitOfMeasure enum represents all units of measure supported by the FacturaE 3.2.2 XSD specification. Each unit has a unique code used in the XML output.

​
Enum Cases

The following table lists all 36 units of measure available:
CaseCodeDescriptionCommon Use
Units01UnitsGeneral items, pieces
Hours02HoursServices, labor
Kilograms03KilogramsWeight measurements
Liters04LitersLiquids, volume
Other05Other unitsCustom/unspecified
Boxes06BoxesPackaging
Trays07TraysFood service
Barrels08BarrelsBulk liquids
Jerricans09JerricansContainers
Bags10BagsBulk goods
Carboys11CarboysLarge bottles
Bottles12BottlesBeverages
Canisters13CanistersContainers
Tetrabriks14TetrabriksBeverage packaging
Centiliters15CentilitersSmall volumes
Centimeters16CentimetersLength
Bins17BinsStorage
Dozens18DozensGroups of 12
Cases19CasesBulk packaging
Demijohns20DemijohnsLarge bottles
Grams21GramsSmall weights
Kilometers22KilometersDistance
Cans23CansFood/beverage
Bunches24BunchesProduce
Meters25MetersLength, fabric
Millimeters26MillimetersPrecision length
SixPacks27Six-packsBeverage packaging
Packages28PackagesGeneral packaging
Portions29PortionsFood service
Rolls30RollsPaper, fabric
Envelopes31EnvelopesMailing
Tubs32TubsContainers
CubicMeters33Cubic metersVolume
Seconds34SecondsTime
Watts35WattsPower
KWh36Kilowatt-hoursEnergy

​
Usage Examples

​
Services Billed by Hours

use PhpFacturae\Enums\UnitOfMeasure;

$invoice->addItem(
    name: 'Web Development',
    quantity: 40,
    unitOfMeasure: UnitOfMeasure::Hours,
    price: 75.00
);

​
Products by Units

use PhpFacturae\Enums\UnitOfMeasure;

$invoice->addItem(
    name: 'Laptop Computer',
    quantity: 5,
    unitOfMeasure: UnitOfMeasure::Units,
    price: 899.99
);

​
Goods Sold by Weight

use PhpFacturae\Enums\UnitOfMeasure;

$invoice->addItem(
    name: 'Organic Coffee Beans',
    quantity: 2.5,
    unitOfMeasure: UnitOfMeasure::Kilograms,
    price: 18.50
);

​
Liquids by Volume

use PhpFacturae\Enums\UnitOfMeasure;

$invoice->addItem(
    name: 'Premium Olive Oil',
    quantity: 10,
    unitOfMeasure: UnitOfMeasure::Liters,
    price: 12.00
);

​
Energy Consumption

use PhpFacturae\Enums\UnitOfMeasure;

$invoice->addItem(
    name: 'Electricity Consumption',
    quantity: 500,
    unitOfMeasure: UnitOfMeasure::KWh,
    price: 0.15
);

​
Fabric or Materials by Meters

use PhpFacturae\Enums\UnitOfMeasure;

$invoice->addItem(
    name: 'Premium Linen Fabric',
    quantity: 25,
    unitOfMeasure: UnitOfMeasure::Meters,
    price: 8.50
);

​
Bulk Packaging

use PhpFacturae\Enums\UnitOfMeasure;

$invoice->addItem(
    name: 'Wine Bottles',
    quantity: 10,
    unitOfMeasure: UnitOfMeasure::Dozens,
    price: 95.00
);

​
Most Common Units

The most frequently used units of measure are:
  1. Units (01) - Default for countable items
  2. Hours (02) - Professional services, labor
  3. Kilograms (03) - Products sold by weight
  4. Liters (04) - Liquids and beverages
  5. Meters (25) - Construction materials, fabric
  6. KWh (36) - Utilities and energy

​
Notes

  • If no unit is specified, Units is typically used as the default
  • The unit of measure is required for each line item in the invoice
  • Fractional quantities are allowed (e.g., 2.5 kilograms)
  • The unit appears in the XML output’s UnitOfMeasure field
  • Choose the unit that best represents how the item is sold or billed

​
See Also

Build docs developers (and LLMs) love

Get started for freeTalk to us