Zonneplan integration for Home Assistant

Unofficial integration for Zonneplan. This integration uses the official Zonneplan API to pull the same data available in the Zonneplan app into your Home Assistant instance.

Available sensors

Zonneplan:

Solar panels: (available when you have 1 or more Zonneplan solar inverters)
- Yield today: kWh (combined yield of all Zonneplan solar inverters) (can be used as entity on Energy Dashboard)
General energy values: (available when there is a Zonneplan Connect P1 reader)
- Electricity consumed today: kWh (can be used as entity on Energy Dashboard)
- Electricity returned today: kWh (can be used as entity on Energy Dashboard)
- Gas consumption today: m³
- Electricity today low tariff: kWh (can be used as entity on Energy Dashboard, default disabled)
- Electricity today normal tariff: kWh (can be used as entity on Energy Dashboard, default disabled)
- Electricity today high tariff: kWh (can be used as entity on Energy Dashboard, default disabled)

Zonneplan Connect (P1 reader):

Sensors available if you have a Zonneplan Connect P1 reader

- Electricity consumption: `W` - Electricity production: `W` - Electricity average: `W` (average use over the last 5min) - Electricity first measured: `date` _(default disabled)_ - Electricity last measured: `date` - Electricity last measured production: `date` - Gas first measured: `date` _(default disabled)_ - Gas last measured: `date`

Zonneplan Energy contract related:

Sensors available if you have a Zonneplan energy contract

- Current Zonneplan Electricity tariff: `€/kWh` - The full Electricity forecast is available as a forecast attribute of this sensor - Current Zonneplan Gas tariff: `€/m³` - Next Zonneplan Gas tariff: `€/m³` - 8 hours forecast of Zonneplan Electricity tariff: `€/kWh` _(default disabled, available when you have a energy contract)_ - Current electricity usage - Sustainability score - Electricity delivery costs today - Electricity production costs today - Gas delivery costs today

Zonneplan Solar inverter:

Sensors available if you have a Zonneplan solar inverter

- Yield total: `kWh` - First measured: `date` _(default disabled)_ - Last measured value: `W` - Last measured: `date` - Powerplay enabled: `on/off` _(default disabled)_ - Powerplay/power limit active: `on/off` _(default disabled)_ - Powerplay total: `€` _(default disabled)_ - Powerplay today: `€` _(default disabled)_ - Current scenario _(default disabled)_

Zonneplan Charge point/Laadpaal:

Sensors available if you have a Zonneplan charge point/laadpaal

- Charge point state - Charge point power `W` - Charge point energy delivered session `kWh` - Charge point next schedule start `date` - Charge point next schedule end `date` - Charge point dynamic load balancing health _(default disabled)_ - Charge point connectivity state `on/off` - Charge point can charge `on/off` - Charge point can schedule `on/off` - Charge point charging manually `on/off` - Charge point charging automatically `on/off` - Charge point plug and charge `on/off` - Charge point overload protection active `on/off` _(default disabled)_ - Buttons to start/stop charge

Zonneplan Battery:

Sensors available if you have a Zonneplan Nexus battery

- Battery state - Percentage `%` - Power `W` _(default disabled)_ - Delivery today `kWh` - Production today `kWh` - Today `€` - Total `€` - Dynamic charging enabled `on/off` - Dynamic load balancing overload active `on/off` - Dynamic load balancing overload enabled `on/off` - Manual control enabled `on/off` - Inverter state _(default disabled)_ - Manual control state _(default disabled)_ - First measured `datetime` _(default disabled)_ - Last measured `datetime`

Installation

Install with HACS (recommended)

Ensure you have HACS installed.

Click the above My button or search HACS integrations for Zonneplan
Click Install
Restart Home Assistant
Continue with setup

Install manually

1. Install this platform by creating a `custom_components` folder in the same folder as your configuration.yaml, if it doesn't already exist. 2. Create another folder `zonneplan_one` in the `custom_components` folder. 3. Copy all files from `custom_components/zonneplan_one` into the newly created `zonneplan_one` folder.

Installing main/beta version using HACS

1. Go to `HACS` => `Integrations` 1. Click on the three dots icon in right bottom of the **Zonneplan** card 1. Click `Reinstall` 1. Make sure `Show beta versions` is checked 1. Select version `main` 1. Click install and restart HA

Setup

Click the above My button (or navigate to Configuration -> Integrations -> + Add integration and search for and select Zonneplan ONE)
Enter you emailaddress you also use in the Zonneplan app
You will get an email to verify the login.
Click "Save"
Enjoy

Setup Energy Dashboard

Solar production

Zonneplan Yield total is what your panels produced

Grid consumption

Zonneplan Electricity consumption today is what you used from the grid

Return to grid

Zonneplan Electricity returned today is what you returned to the grid

Troubleshooting

If you run into issues during setup or when entries do not update anymore please increase logging and provide them when creating an issue. Add custom_components.zonneplan_one: debug to the logger config in you configuration.yaml:

logger:
  logs:
    custom_components.zonneplan_one: debug

fsaris / home-assistant-zonneplan-one

readme