v1.3.0 - Automated parameters, enhanced billing flexibility, enhanced precision
🆕 What's New in Version 1.3.0
Major Improvements
- Automatic ARERA parameter retrieval: No more manual entry of energy quotas, transport fees, ASOS/ARIM values
- Automatic Portale delle Offerte integration: Automatic retrieval of tax rates (IVA, accisa), network loss percentages
- Enhanced billing flexibility: Configurable monthly/bimonthly billing with invoice shift options
- Improved sensor organization: Sensors grouped into logical devices for better HA interface management
- Precision calculations: Fixed rounding issues - now matches actual utility bills exactly
- Tested and validated: Calculations verified against real utility bills with cent-level accuracy
New Configuration Options
- House type selection: Residential vs Non-residential properties
- Billing period switches: Monthly billing and invoice shift toggles
- Power contract level: Differentiated parameters based on contract power (≤3kW vs >3kW)
Automated Data Sources
- ARERA Excel files: Quarterly updated tariff parameters automatically downloaded and parsed
- Portale delle Offerte CSV: Daily updated tax parameters and system charges
- GME market data: Hourly PUN prices for accurate calculations
Automatic PUN Calculation
The integration supports a PUN mode option (selected during config flow or from the integration Options):
- Calculated (default) — PUN is retrieved/averaged by the integration from hourly GSE zonal prices and used to compute the bill (this is the original behavior).
- Fixed — PUN is taken from a fixed numeric value entered by the user (option
fixed_pun_value, expressed in€/kWh). When set, the integration uses that fixed value for all PUN-dependent calculations.