What is a price model and how does it create detailed tenant bills?
A price model defines the individual charge components that make up a tenant's energy bill — similar to how a utility company itemizes their invoice. Instead of a single "electricity cost" line, a price model breaks it down into energy charge, grid fees, power demand charge, government levies, and more.
Price model components (unit lines)
Each price model contains unit lines, and each line has a source type that determines how it is calculated:
- Consumption-based (source_type = "consumption"): Calculated from kWh or m³ consumption. For electricity, uses the spot price + surcharge. Example: "Energiledd" (energy charge) = kWh × spot price.
- Power peak (source_type = "power_peak"): Based on peak demand in kW during the billing period. Example: "Effektledd" (capacity charge) = peak kW × price per kW.
- Fixed (source_type = "fixed"): A flat charge per period, allocated proportionally. Example: "Fastledd" (fixed monthly fee) = fixed amount × tenant's allocation percentage.
- Percentage (source_type = "percentage"): A percentage of another line item's amount. Example: "ENOVA avgift" = 1% of energy charge (a Norwegian energy efficiency levy).
How allocation works with price models
Each unit line is calculated using the tenant's allocation percentage from their meter connection:
- Consumption lines: use allocated kWh (total × allocation%)
- Power peak lines: use peak kW × allocation%
- Fixed lines: use fixed amount × allocation%
- Percentage lines: calculate from the referenced line's amount
The result is a detailed bill
The tenant sees an itemized invoice showing each charge component, its quantity, unit price, and amount — just like a real utility bill but for their allocated share.
Where to configure: Tenant Billing → Templates → select a template → add unit lines to define the price model structure.