Skip to content
EN | DE

Viessmann Heatpump consumption (API)

This page shows the nightly version. There is no release version yet.

Reads the heat pump's current electrical power consumption (heating.power.consumption.current) as an additional consumer (aux). The heat pump then appears under "Consumption" in the energy flow and its usage feeds the evcc statistics - independent of whether evcc controls the heat pump.

Usage areas

  • Smart consumer

Parameters

NameDescriptionValueLevel
clientidClient IDoptional
redirecturiRedirect URI

Redirect URI of the evcc instance. Must match the redirect URI set in the Viessmann developer portal.

optional
gateway_serialGateway Serial

Determined automatically after login. Alternatively enter manually (ViCare app -> Settings -> Communication module -> Serial number)

optional
installation_idInstallation ID

Determined automatically after login.

optional
device_idDevice ID

typically 0

Default: 0
optional
Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

meters:
- name: my_aux
type: template
template: viessmann
usage: aux
clientid: # Client ID, Configure at [app.developer.viessmann-climatesolutions.com](https://app.developer.viessmann-climatesolutions.com)
redirecturi: # Redirect URI, Redirect URI of the evcc instance. Must match the redirect URI set in the Viessmann developer portal.
gateway_serial: # Gateway Serial, Determined automatically after login. Alternatively enter manually (ViCare app -> Settings -> Communication module -> Serial number)
installation_id: # Installation ID, Determined automatically after login.
device_id: 0 # Device ID, typically `0`