Zonneplan integration for Home Assistant
![GitHub License](https://img.shields.io/github/license/fsaris/home-assistant-zonneplan-one?style=for-the-badge)
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.
![Direct link to Zonneplan in HACS](https://my.home-assistant.io/badges/hacs_repository.svg)
- 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
![Open your Home Assistant instance and start setting up Zonneplan.](https://my.home-assistant.io/badges/config_flow_start.svg)
- 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
![Open your Home Assistant instance and start setting up Energy sensors.](https://my.home-assistant.io/badges/config_energy.svg)
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