What is polska-faktura-za-prad?

This is a Home Assistant custom integration that calculates a Polish electricity bill from scratch inside your smart home dashboard. Polish electricity invoices are unusually complex: they contain around a dozen separate line items covering active energy, distribution charges, quality fees, capacity fees, OZE (renewable) and cogeneration levies, a subscription fee, and excise tax, each with its own rate and VAT percentage. Those rates also change frequently. The integration models every one of these line items as a separate editable entity in the Home Assistant interface, so when a rate changes you update it in the UI and the bill recalculates immediately without restarting anything. The integration exposes sensors for the total amount due (gross), the net total, the VAT amount, and consumption. It also groups the line items into three subtotals: energy sales, distribution, and taxes. Each individual line item gets its own diagnostic sensor showing the quantity, rate, VAT, and gross amount as attributes. A set of number entities labeled with the Polish rate names lets you override any rate. For consumption data, you can point it at an existing Home Assistant sensor such as a utility meter, or enter kilowatt-hours manually. A zero-point feature lets you set the starting meter reading for a billing period, so the running cost always reflects consumption since the last invoice. There are also modes for pulling historical consumption from the Home Assistant recorder for a specific date range, or entering start and end meter readings directly. A separate optional feature estimates the CO2 emissions cost (ETS) embedded in the energy price. This appears as an overlay with its own sensors and chart, showing what share of your bill comes from carbon allowance costs, without affecting the main bill calculation. A ready-made dashboard YAML file is included, which adds a dedicated sidebar panel showing the total due, a breakdown by category, cost per kilowatt-hour, and daily, weekly, and monthly cost charts powered by the ApexCharts Home Assistant card. Installation is through HACS (the Home Assistant Community Store) by adding the repository as a custom integration, or by manually copying the component folder. Tariff profiles for PGE G11, G12, and G12w are included out of the box.