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)
• Charge point session cost €
• Charge point cost total €
• Charge point session average costs €/kWh
• Charge point start mode (default disabled)
• Charge point dynamic load desired distance km
• Charge point dynamic load desired end time datetime
• Charge point session start time datetime
• Charge point session charged distance km
• Charge point dynamic charging enabled on/off
• Charge point dynamic charging flex enabled on/off
• Charge point dynamic charging flex suppressed 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.

1. Click the above My button or search HACS integrations for Zonneplan
2. Click Install
3. Restart Home Assistant
4. 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
2. Click on the three dots icon in right bottom of the Zonneplan card
3. Click Reinstall
4. Make sure Show beta versions is checked
5. Select version main
6. Click install and restart HA

Setup

1. Click the above My button (or navigate to Configuration -> Integrations -> + Add integration and search for and select Zonneplan ONE)
2. Enter you emailaddress you also use in the Zonneplan app
3. You will get an email to verify the login.
4. Click "Save"
5. 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