Zonneplan
The Zonneplan integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you retrieve electricity and gas price information from Zonneplan, a Dutch provider of dynamic energy contracts and energy services, including home batteries and EV charge points. This integration currently provides electricity and gas price entities, your electricity and gas usage and costs for the current month, and the status of your Zonneplan home battery and EV charge point.
Prerequisites
To use this integration, you need an active Zonneplan account.
Configuration
To add the Zonneplan hub to your Home Assistant instance, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Zonneplan.
-
Follow the instructions on screen to complete the setup.
During setup, you are asked for the email address linked to your Zonneplan account. Zonneplan then sends a one-time password to that email address, which you need to enter to complete the setup.
Data updates
The Zonneplan integration retrieves data from the Zonneplan cloud API on a regular interval: prices and usage every 15 minutes, the status of each home battery every 5 minutes, and the status of each EV charge point every minute.
Supported functionality
Sensors
The following sensors are provided by this integration:
- Current electricity price: The electricity price for the current hour.
- Next hour electricity price: The electricity price for the next hour.
- Current electricity tariff group: How Zonneplan classifies the price of the current hour: Low, Normal, or High.
- Current sustainability score: Zonneplan’s score, from 0 to 100%, for how sustainable the electricity supplied in the current hour is.
- Lowest electricity price today: The lowest electricity price for today.
- Highest electricity price today: The highest electricity price for today.
- Lowest electricity price tomorrow: The lowest electricity price for tomorrow, once published (typically around 13:00 CET/CEST).
- Highest electricity price tomorrow: The highest electricity price for tomorrow, once published (typically around 13:00 CET/CEST).
-
Electricity prices tomorrow status: Indicates whether tomorrow’s electricity prices are already
available, or stillincoming. - Gas price daily: The gas price for today.
- Electricity used this month: The electricity you used from the grid so far this month, in kWh.
- Electricity returned this month: The electricity you returned to the grid so far this month, in kWh.
- Gas used this month: The gas you used so far this month, in m³.
- Electricity cost this month: The electricity delivery costs so far this month, including tax.
- Gas cost this month: The gas delivery costs so far this month, including tax.
The Electricity price low today start time and Electricity price low today end time sensors mark the block of consecutive hours around today’s lowest price. The matching tomorrow sensors do the same for tomorrow, once its prices are published. This lets you build automations that act on the entire block of cheap hours instead of a single hour.
Home battery
If your account has a Zonneplan home battery, the integration adds a device for each battery with these sensors:
- Battery: The state of charge, in %.
- Power: The power the battery delivers, in W. Positive while discharging, negative while charging.
-
Battery state: What the battery is doing:
Charging,Discharging,Operative,Standby,Sleeping,Starting,Throttled,Shutting down,Off,Updating,Cooling,Preheating,Backup power active,Fault,Permanent fault, orUnknown state. - Inverter state: What the battery inverter is doing, with the same states as Battery state.
- Total earned: What the battery has earned in total since it was installed.
- Earned today: What the battery has earned so far today. This can be negative.
- Energy charged today: The energy charged into the battery so far today, in kWh.
- Energy discharged today: The energy discharged from the battery so far today, in kWh.
- Charge cycles: The number of full charge cycles.
- Backup power capacity (diagnostic): The most energy that can be reserved for backup power, in Wh.
Binary sensors
- Electricity price low: On while the current hour falls in today’s block of cheapest hours, the same block as the low price start and end time sensors. Off at all other hours. The state updates at the start of every hour.
Home battery
Each home battery device also has these binary sensors:
- Home optimization active: On while home optimization is actively steering the battery.
- Grid congestion: On while grid congestion is limiting the battery.
- Load balancing overload: On while dynamic load balancing is limiting the battery to prevent overloading your grid connection.
- Backup power active: On while the battery supplies backup power to your home.
EV charge point
If your account has a Zonneplan EV charge point, the integration adds a device for each charge point with these binary sensors:
- Connectivity: On while the charge point is connected to Zonneplan.
- Overload protection: On while the charge point limits charging to prevent overloading your grid connection.
- Automatic charging paused: On after you stop a charging session by hand, while automatic charging stays paused.
Known limitations
Unsupported devices and functionality
The integration does not yet expose entities for Zonneplan solar panels. EV charge points can’t be controlled yet. Only the charge point entities listed above are available.
Delayed usage data
Zonneplan receives usage data from your grid operator a day or more after the fact, so the monthly usage and cost sensors lag behind, and a day’s values can still change afterwards. They stay unknown until the month has data. Because of this delay, these sensors are not suitable for the energy dashboard.
Removing the integration
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- Next to the entry you want to remove, select the three dots
menu. Then, select Delete. - Depending on the integration, the entries are listed under one of the following headings:
- Devices
- Hubs
- Services
- Integration entries
- Depending on the integration, the entries are listed under one of the following headings:
- To confirm, select Delete.
- Home Assistant also deletes the devices and entities of the entry.
- If Home Assistant asks you to restart, restart Home Assistant.
- If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
- If you keep them, Home Assistant uses them automatically when you add the integration again.
- To delete them later, refer to Deleting application credentials.