Fluvius Energy for Home Assistant (Marketplace integration)

Installs: 158 sharing analytics
GitHub stars: 49
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v1.3.0, October 20, 2026
Category: Energy, Meters and monitoring
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: fluvius
Source: github.com/sander110419/Fluvius-home-assistant
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Fluvius Energy is a Marketplace integration that imports electricity and gas consumption from Mijn Fluvius into Home Assistant. It relies on the Fluvius cloud, polls hourly, and is set up in the UI with one entry per meter. Because Fluvius publishes readings a day or more after use, the integration imports historical statistics at the original measurement times, so they can feed the Energy dashboard. It provides sensors for total, high tariff and low tariff consumption and injection, net daily consumption, peak power, and quarter-hourly or hourly interval values. Options cover how many days to fetch, daily, quarter-hour or hourly granularity, timezone, and kWh or m3 for gas meters. A cutoff date allows combining the history with a P1 meter, and professional accounts that need eID or itsme login are not supported.

Automatic summary of the README and code of sander110419/Fluvius-home-assistant. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect to Fluvius

Email addressUse the same email address you provide on mijn.fluvius.be.
PasswordSaved in the Home Assistant configuration and used to obtain a short-lived Fluvius token.
EAN number18-digit identifier printed on your utility bill (per meter).
Meter serial numberMatches the serial number shown in the Fluvius portal (for example 1SAG...).
Meter typeCreate one entry per meter and choose whether it is an electricity or a gas meter.
Gas unitGas only: choose kWh or m3 before the first import. Values are read in that unit; the integration does not convert them.

Reconnect to Fluvius

Email addressUpdate the email if your Fluvius login changed.
PasswordEnter the new password so the integration can refresh its session.
EAN numberConfirm the same EAN that this entry manages.
Meter serial numberConfirm the meter serial stored in Fluvius.
Meter typeIf you swapped hardware, pick the correct meter type before saving.
Gas unitGas only: choose kWh or m3 before the first import. Values are read in that unit; the integration does not convert them.

After setup

TimezoneUsed to build the date range when requesting history from Fluvius.
Days backNumber of days to fetch per refresh. Gas meters always request at least seven days.
GranularityDaily totals, electricity quarter-hours, or gas hours. Detailed readings must be enabled in Mijn Fluvius.
Meter typeChoose whether this entry targets an electricity or gas meter.
Gas unitFor gas meters, pick whether to store energy (kWh) or volume (m3).
Verbose loggingLog request dates and status for troubleshooting. Credentials and response bodies are not logged.
Import history until (optional)Exclusive cutoff for combining with a P1 meter. Only intervals ending at or before this time are imported. Clear this field to resume current history.

Texts from the code of sander110419/Fluvius-home-assistant.

Entities

SensorsTotal consumption, Consumption (high tariff), Consumption (low tariff), Total injection, Injection (high tariff), Injection (low tariff), Net consumption (day), Peak power, Consumption (quarter-hourly), Injection (quarter-hourly), Consumption (hourly), Shared energy received (today), and 5 more

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

Import electricity and gas consumption from Mijn Fluvius into Home Assistant. Fluvius publishes readings after the energy was used, often one or more days later. This integration polls hourly and imports historical statistics at the original measurement times.

From the README of sander110419/Fluvius-home-assistant, MIT License. Shortened.