The Viessmann API Themen

Aktualisiere deinen API-Client im Viessmann Developer Portal Warnung · Von Viessmann ViCare gemeldet!

ckoeber — Fri, 29 May 2026 09:10:47 GMT

ViCare wurde auf OAuth2-Authentifizierung umgestellt. Deine bestehende Sitzung funktioniert weiterhin, aber falls eine erneute Authentifizierung erforderlich wird, musst du deinem API-Client zuerst eine Redirect-URI hinzufügen.

Gehe zum [Viessmann Entwicklerportal] (https://app.developer.viessmann-climatesolutions.com) und füge die folgende Redirect-URI zu deinem API-Client hinzu:

https://my.home-assistant.io/redirect/oauth

Dies ist nicht dringend, aber wir empfehlen, es bald zu tun.

Vitocal 250-A in Home Assistant integrieren

mdiehl — Tue, 19 May 2026 21:02:01 GMT

Hallo,
ich versuche meine Viessmann Anlage (Vitocal 250-A) über die offizielle ViCare API in Home Assistant zu integrieren. Die Authentifizierung funktioniert korrekt, jedoch erhalte ich folgenden Fehler: "Viessmann API denied access (PACKAGE_NOT_PAID_FOR). Feature not available: User does not have access to given feature." Meine Anlage ist in der ViCare App vollständig sichtbar und online. Können Sie bitte prüfen, - ob mein Account für die API freigeschaltet ist - und ob ein entsprechendes API Package aktiv ist?
Vielen Dank!

ISSUE WITH VICARE INTEGRATION: PACKAGE_NOT_PAID_FOR ERROR

huejanus — Thu, 14 May 2026 10:30:53 GMT

Several Home Assistant users, including myself, are having critical problems with the ViCare integration. I bought my Viessmann Vitodens 050-W last year, and the integration worked perfectly until I accidentally deleted my Viessmann account and then re-registered.

It seems that these problems have occurred recently, specifically impacting newly registered accounts. Your literature clearly states that the Basic API tier is free. Yet, anyone trying to use the ViCare integration with a new account is greeted with this log error:

--- ERROR LOG START ---
Logger: PyViCare.PyViCareCachedService
Source: components/vicare/utils.py:40
First occurred: 09:23:01 (3 occurrences)
Last logged: 09:23:02

Viessmann API denied access (PACKAGE_NOT_PAID_FOR). Features unavailable: (PyViCareNotPaidForError(...), 'Feature not available: User does not have access to given feature.')
--- ERROR LOG END ---

If Viessmann is now operating a paywall for new customers, the least you could do is be honest and inform everyone. People could then make informed decisions on whether or not to buy future Viessmann products. The only reason I chose a Viessmann boiler over a Worcester model was the advertised Home Assistant functionality.

Could support please clarify why newly re-registered accounts are being blocked from the free Basic API tier?

Vitocal 250-A für die ViCare App in Home Assistant

Lars13 — Fri, 08 May 2026 13:21:14 GMT

Hallo,

die Verbindung der offiziellen ViCare Home Assistant Integration schlägt fehl.

Im Log erscheint:
PACKAGE_NOT_PAID_FOR
Feature not available: User does not have access to given feature

Können Sie prüfen, ob mein Climate Solutions Account bzw. meine Vitocal 250-A für die ViCare API freigeschaltet ist?

Vielen Dank.

Gruß Lars

Weitere API-Probleme / More API Problems

jpuk — Tue, 05 May 2026 08:03:27 GMT

Seit etwa dem 27.04.2026 schlagen meine API-Aufrufe fehl.

Zuerst dachte ich, es handle sich lediglich um die üblichen, gelegentlichen API-Probleme. Bei genauerer Betrachtung stellte ich jedoch fest, dass ich an die Ratenbegrenzung stoße:

PyViCare.PyViCareUtils.PyViCareRateLimitError: (PyViCareRateLimitError(...), 'API rate limit development portal "xxxxxxxxxxxxxxxxxx" daily limit exceeded. Max 1450 calls in timewindow. Limit reset at 2026-05-06T00:00:04.802000.')

Das ist merkwürdig, da mein Code so getaktet ist, dass er diese Limits deutlich unterschreitet – an einem normalen Tag stelle ich üblicherweise weniger als 350 Verbindungen zum API-Endpunkt her.

In den letzten Tagen hat sich die Anzahl der Verbindungen durch ein einzelnes Skript jedoch deutlich erhöht. Dieses Skript erfasst alle 5 Minuten die Außentemperaturdaten (d. h. ca. 288 Mal pro Tag) und versucht es nach 1 Minute erneut, falls keine Daten empfangen werden.

Das folgende Protokoll zeigt normale Tage im Vergleich zu den letzten Tagen:

Timestamp, MinTemp, MaxTemp, AvTemp, RunCount, TempCount

20260424, 1.6, 18.5, 10.03, 287, 286
20260425, -0.8, 19.3, 10.02, 287, 287
20260426, 3.8, 19.9, 12.43, 287, 286
20260427, 5.3, 21.7, 13.16, 626, 201
20260428, 9.3, 10.9, 9.73, 940, 122
20260429, 6.6, 15.9, 9.26, 940, 122
20260430, 7.6, 17.4, 11.03, 940, 122
20260501, 7.1, 16.5, 10.32, 1008, 105
20260502, 7.8, 11.9, 9.37, 1158, 67
20260503, 11.2, 13.3, 12.22, 1159, 67
20260504, 12.5, 13, 12.51, 1157, 67

Die letzten beiden Einträge jeder Zeile zeigen die Gesamtzahl der Verbindungsversuche und die Anzahl der erfolgreichen Datenerfassungen an. Die Subtraktion des letzten Wertes (z. B. 67) von der Gesamtzahl (z. B. 1157) ergibt die Anzahl der fehlgeschlagenen Verbindungen.

Es sieht also so aus:

1) Es gibt Backend-Fehler in der API.

2) Das API-Ratenlimit zählt die Anzahl der Verbindungsversuche, nicht die Anzahl der erfolgreichen API-Aufrufe.

Ich bin überrascht, dass ich seit dem 27./28. April keine weiteren Meldungen zu API-Ausfällen gefunden habe. Hat sonst noch jemand diese lange Ausfallzeit und die fehlerhafte Verbindungszählung erlebt?

Vielen Dank!

jpuk

---------------------------------

Since ~27/04/26, my API calls have started failing.

Initially, I thought it was simply the 'usual;' API intermittent flakiness, however looking deeper, I can see that I am hitting rate limits:

This is strange because my code is timed to be well within these limits - on a normal day, I would usually make <350 connections to the API endpoint.

In the last few days, the number from a single script has increased significantly. This script collects outside temperature data every 5 minutes (i.e. ~288x per day), but will retry after 1 minute if no data is received.

The following log shows normal days compared to the last few days:

Timestamp, MinTemp, MaxTemp, AvTemp, RunCount, TempCount

20260424, 1.6, 18.5, 10.03, 287, 286
20260425, -0.8, 19.3, 10.02, 287, 287
20260426, 3.8, 19.9, 12.43, 287, 286
20260427, 5.3, 21.7, 13.16, 626, 201
20260428, 9.3, 10.9, 9.73, 940, 122
20260429, 6.6, 15.9, 9.26, 940, 122
20260430, 7.6, 17.4, 11.03, 940, 122
20260501, 7.1, 16.5, 10.32, 1008, 105
20260502, 7.8, 11.9, 9.37, 1158, 67
20260503, 11.2, 13.3, 12.22, 1159, 67
20260504, 12.5, 13, 12.51, 1157, 67

The last two entries on each row show the total number of connection attempts and the number of successful data collections. Subtracting the last value (e.g. 67) from the total (e.g. 1157) provides the number of failed connections.

So it looks like:

1) there are some back-end failures in the API

2) the API rate limit is counting the number of attempted connections, not the number of successful API calls.

I am surprised that I couldn't find any other messages relating to API failure since 27th / 28th April - is anyone else experiencing this long outage and unfortunate connection counting?

Thanks!

jpuk

heating.device.smartGrid — Verfügbarkeit und Nutzung per API?

alper-zf — Tue, 21 Apr 2026 15:18:35 GMT

Hallo,

ich entwickle eine Integration mit der Viessmann IoT API zur Wärmepumpensteuerung. Mein Gerät ist eine Vitocal E3 (E3_Vitocal_16).

Ziel: Den SG-Ready-Boost-Modus (Zustand 4) per API aktivieren — ohne physische Pinverdrahtung.

Problem:

Laut Dokumentation gibt es folgende Features:

heating.device.smartGrid — "Zeigt den aktuellen SG-Ready-Zustand und erlaubt es, einen bestimmten Zustand anzufordern"

heating.device.smartGrid.active

Bei einem GET-Request auf beide Features erhalte ich:

{ "statusCode": 404, "errorType": "FEATURE_NOT_FOUND" }

Meine Fragen:

Auf welchen Geräten/Firmwareversionen ist heating.device.smartGrid verfügbar? Unterstützt die Vitocal E3 dieses Feature grundsätzlich?

Ist es für Geräte ohne heating.device.smartGrid korrekt, heating.dhw.oneTimeCharge + heating.circuits.N.operating.programs.forcedLastFromSchedule als Boost-Alternative zu verwenden? Gibt es dabei bekannte Einschränkungen?

Kann heating.device.smartGrid verwendet werden, wenn die SG-Ready-Pins bereits physisch verdrahtet sind? Oder schließen sich physische Verdrahtung und Software-Override gegenseitig aus?

Danke im Voraus!

Vitocal 250-a und evcc

CaptainVis — Mon, 20 Apr 2026 14:03:50 GMT

Servus, ich habe eine vitocal 250-a und möchte Sie gerne übers Netzwerk mit evcc auslesen/steuern.

Folgende Fehlermeldung bekomme ich:

https://iam.viessmann-climatesolutions.com/idp/v3/authorize?client_id=a403e8d75ea0fbb519f81b5&code_c...

{"error":"invalid_request", "error_description":"Invalid redirection URI."}

Habt ihr eine Idee oder Hilfestellung? Vielen Dank.

Fehler API Homeassistent

Glowik — Thu, 16 Apr 2026 18:18:57 GMT

Hallo. Ich habe seit ca. 2 Wochen eine Vitocal 250A. Es funktioniert alles super bis auf die API. In meinem Homeassistent wird zwar die Vitocal als solches angezeigt aber keine Entitäten dazu. Es ist nichts enthalten. In in Log-datei steht folgender Fehler: errorType': 'PACKAGE_NOT_PAID_FOR', 'message': '', 'extendedPayload . Ich habe hier in der Community schon gelesen das der Fehler Dur h die Viessmann IT irgendwie behoben wurde. Kann mir hier jemand helfen?

[Script] Viessmann Heizungs‑Ein/Aus‑Steuerung über Viessmann‑API mit Auto‑Trigger

franzhau2022 — Mon, 13 Apr 2026 13:36:25 GMT

Das Script realisiert eine sichere, triggerbasierte Heizungssteuerung über den Viessmann‑API‑Adapter in ioBroker. Die beiden Funktionen können zeitgesteuert, ereignisgesteuert oder manuell über zwei boolesche Trigger gestartet werden.

Beim Start legt das Script die beiden Steuer‑Datenpunkte 0_userdata.0.Heizung.Heizung_EIN und 0_userdata.0.Heizung.Heizung_AUS automatisch an, initialisiert sie sauber auf false und stellt damit sicher, dass die Trigger jederzeit definiert und einsatzbereit sind.

Eine geprüfte Schreibfunktion (safeSet) verhindert Fehlzustände, indem sie vor jedem Setzen prüft, ob der Ziel‑State existiert und beschreibbar ist. Dadurch werden fehlerhafte API‑Aufrufe und unnötiger Log‑Spam zuverlässig vermieden.

Die beiden Trigger steuern den Heizkreis direkt über die Viessmann‑API:

Heizung EIN setzt den Betriebsmodus auf heating, aktiviert den Heizzeitplan und stellt die Vorlauftemperatur auf 35 °C.
Heizung AUS setzt den Modus auf standby, deaktiviert den Zeitplan und setzt die Temperatur auf 0 °C.

Nach jeder Ausführung setzt sich der jeweilige Trigger automatisch wieder auf false, sodass jede Aktion exakt einmal ausgeführt wird und keine Mehrfachauslösungen entstehen.

// =============================================================== // Triggerbasierte Viessmann‑Heizungssteuerung (Ein/Aus) // Automatische DP‑Initialisierung + sichere Schreibfunktion // Steuerung über Viessmann‑API (heating / standby) // Version mit xxxxxx als Geräte-ID // =============================================================== // === Trigger-Datenpunkte beim Start anlegen und initialisieren === function ensureDP(id) { if (!existsState(id)) { createState(id, false, { type: "boolean", role: "switch", read: true, write: true }, () => { setState(id, false, true); console.info("ANGELEGT: " + id); }); } else { setState(id, false, true); } } // Trigger anlegen ensureDP("0_userdata.0.Heizung.Heizung_EIN"); ensureDP("0_userdata.0.Heizung.Heizung_AUS"); // === Hilfsfunktion zum sicheren Schreiben === function safeSet(id, value) { if (!existsState(id)) { console.info("FEHLT: " + id); return; } const obj = getObject(id); if (!obj || !obj.common || obj.common.write !== true) { console.info("NICHT SCHREIBBAR: " + id); return; } setState(id, value, false); console.info("SET: " + id + " -> " + value); } // === TRIGGER: HEIZUNG EIN === on({ id: "0_userdata.0.Heizung.Heizung_EIN", val: true }, () => { console.info("TRIGGER: Heizung EIN gestartet"); safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.operating.modes.active.commands.setMode.setValue", "heating"); safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.heating.schedule.properties.active.value", true); safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.temperature.properties.value.value", 35); console.info("Heizung EIN ausgefuehrt."); // Trigger zurücksetzen setState("0_userdata.0.Heizung.Heizung_EIN", false, false); }); // === TRIGGER: HEIZUNG AUS === on({ id: "0_userdata.0.Heizung.Heizung_AUS", val: true }, () => { console.info("TRIGGER: Heizung AUS gestartet"); safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.operating.modes.active.commands.setMode.setValue", "standby"); safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.heating.schedule.properties.active.value", false); safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.temperature.properties.value.value", 0); console.info("Heizung AUS ausgefuehrt."); // Trigger zurücksetzen setState("0_userdata.0.Heizung.Heizung_AUS", false, false); });

Error: PACKAGE_NOT_PAID_FOR

dctherandomguy — Sun, 12 Apr 2026 17:10:28 GMT

Hi,

I have set up my developer portal and configured a client, but any API call results in "PACKAGE_NOT_PAID_FOR" I don't think this should be the case for trying to do basic things with the free tier. My emails to developer@viessmann-climatesolutions.com are not being answered. Please advise.

Thanks

503 Service Unavailable - no available server

etienne31 — Wed, 08 Apr 2026 12:10:14 GMT

Since today (April 8th), I started to experience problems with the API.

10:30 UTC - Read timed out (Error 500 after 30s)

10:35 UTC - 401 Unauthorized

10:40 UTC - Read timed out (Error 500 after 30s)

10:45 UTC - OK

10:50 UTC - Read timed out (Error 500 after 30s)

10:55 UTC - 503 - no available server

11:00 UTC - 502 Bad Gateway

11:05 UTC - 503 - no available server -> until 11:45 UTC - always 503
Then 11:50 / 55/ also 503

Now 12:00 UTC - Read timed out (Error 500 after 30s)

It looks like problems on Viessmann server side, right ? Or should I do something ? I already tried to reboot everything, but no success.
Thanks!

Totalausfall Vicare App

AWa1 — Wed, 08 Apr 2026 11:45:16 GMT

Spinner leiert wieder mal vor sich hin !

Kein Zugang zum Developer Portal !

Excuse me

We were unable to load the data to your account. Please try again later.

homeassistant keine Entitäten

erichuebsch — Mon, 30 Mar 2026 15:50:45 GMT

HI zusammen,

ich habe versucht die Vicare Integration auf Home Assisant zu machen. Es ist auch verbunden und ich sehe im developer portal auch, dass API Transaktionen stattfinden. Jedoch zeigt es mir im HA nichts an.

In den Fehler Logs steht immer wieder drin, PACKAGE_NOT_PAID_FOR', 'message': '', 'extendedPayload': {'monetization': 'User does not have access to given feature.':

Logger: homeassistant.components.fan
Quelle: helpers/entity_platform.py:455
Integration: Ventilator (Dokumentation, Probleme)
Erstmals aufgetreten: 17:14:09 (1 Vorkommnis)
Zuletzt protokolliert: 17:14:09

Error while setting up vicare platform for fan: {'viErrorId': '00-fa4468106663d0939fe9746fd411f057-3b815a1ebedf9e16-00', 'errorType': 'PACKAGE_NOT_PAID_FOR', 'message': '', 'extendedPayload': {'monetization': 'User does not have access to given feature.'}}

Lost Connection to Vitoconnect 100 OPTO1

Mayone — Mon, 30 Mar 2026 13:42:51 GMT

Good morning, for a few days now I've been unable to contact the Vitoconnect 100 OPTO1 module, either via the ViCare app or via HomeAssistant. I checked and the module is correctly connected to the network, and I see that the firewall sees requests to the Viessmann cloud, but nothing appears on the app or HomeAssistant. I've already tried disabling and reactivating the Wi-Fi network, but to no avail. Can you give me any suggestions? Thanks!

ViCare + Add block app

MaxiElle — Mon, 30 Mar 2026 11:54:29 GMT

Hallo, ich verwende auf meinem Smartphone / Tablet einen Adblocker, um z.B. Werbung in einzelnen Apps abzuschalten, das verhindert aber auch die Nutzung von Vicare.

"Keine Verbindung zum Server" wird dann immer angezeigt im Vicare-App. Ich habe versucht, diverse URLs von Viessmann in der whitelist zu erlauben, z.B. die gängigen

*.viessmann.com

*.viessmann.de

*googleapis.com

api.viessmann.com oder .de

etc...

Allerdings hilft nur den Addblocker für alle apps auszuschalten.

gibts hierzu Erfahrungswerte?

HomeAssist vicare nicht vorhanden!

zwerg63 — Sun, 29 Mar 2026 11:45:48 GMT

Hallo,

ich möchte in Homeassist Vicare einrichten, es ist aber nicht vorhanden, siehe Screenshot.

Woran kann das liegen?

Im Developer-Portal habe ich mich erfolgreich registriert.

Vieventlog funktioniert auch.

Danke

Gas-Verbrauchswerte werden seit 27.03.2026 nicht mehr übertragen

UweSt — Sun, 29 Mar 2026 11:04:43 GMT

Hallo zusammen, seit dem 27.03.2026 bekomme ich über die API bei der Abfrage zu den Gas-Verbrauchswerten des gestrigen Tages keinen Wert zurück geliefert, was etliche Wochen lang mit dem gleichen Programm funktioniert hat.
Gleichzeitig erhalte ich das gleiche Fehlerbild in der ViCareApp (3.38.1)
Es wird für die laufende Woche jeder Tag mit Verbrauch 0 angezeigt, nur für den laufenden Tag gibt es eine Anzeige (auch mein Programm liefert dafür einen Wert), allerdings wird auch dafür in der ViCareApp 0 angezeigt.
Hat jemand ähnliches bemerkt?

Danke im Voraus
Uwe

Einstellungen in iobroker

tomtomviessmann — Sun, 29 Mar 2026 06:10:22 GMT

Hallo, ich habe ein Vitocal 252 mit einem Pufferspeicher mit Mischer der mir im iobroker als

viessmannapi.0.XXXXXX.0.features.heating.secondaryCircuit.operation.state.properties.targetValue.value
angezeigt wird. Wenn ich diesen Wert im iobroker ändere wird er nach einer Zeit wieder automatisch überschrieben. Kann ich den Wert dauerhaft manuell ändern und wie ?

Gruß tomtomviessmann

Fehler "PACKAGE_NOT_PAID_FOR"

Scotty — Fri, 27 Mar 2026 14:58:37 GMT

Hallo,
ich habe lt. Dashboard "Developer Portal Basic" gebucht. Trotzdem bekomme ich "PACKAGE_NOT_PAID_FOR" auf API-Calls wie "

https://api.viessmann.com/iot/v2/features/installations/{{installationId}}/gateways/{{gatewaySerial}}/devices/{{deviceId}}/features".

Was mache ich falsch?

BTW: Vielleicht könnte mal jemand die Dokumentation anpassen (api.viessmann-climatesolutions.com).

Danke und Gruß
Reinhold

Internetverbindung wieder herstellen

Ebs1 — Thu, 26 Mar 2026 15:30:33 GMT

Hallo,

habe Probleme die Verbindung zum Gerät wieder her zustellen.

Was kann ich machen ?

Danke.

The Viessmann API Themen

Aktualisiere deinen API-Client im Viessmann Developer Portal Warnung · Von Viessmann ViCare gemeldet!

Vitocal 250-A in Home Assistant integrieren

ISSUE WITH VICARE INTEGRATION: PACKAGE_NOT_PAID_FOR ERROR

Vitocal 250-A für die ViCare App in Home Assistant

Weitere API-Probleme / More API Problems

heating.device.smartGrid — Verfügbarkeit und Nutzung per API?

Vitocal 250-a und evcc

Fehler API Homeassistent

[Script] Viessmann Heizungs‑Ein/Aus‑Steuerung über Viessmann‑API mit Auto‑Trigger

Error: PACKAGE_NOT_PAID_FOR

503 Service Unavailable - no available server

Totalausfall Vicare App

Excuse me

homeassistant keine Entitäten

Lost Connection to Vitoconnect 100 OPTO1

ViCare + Add block app

HomeAssist vicare nicht vorhanden!

Gas-Verbrauchswerte werden seit 27.03.2026 nicht mehr übertragen

Einstellungen in iobroker

viessmannapi.0.XXXXXX.0.features.heating.secondaryCircuit.operation.state.properties.targetValue.value angezeigt wird. Wenn ich diesen Wert im iobroker ändere wird er nach einer Zeit wieder automatisch überschrieben. Kann ich den Wert dauerhaft manuell ändern und wie ?

Fehler "PACKAGE_NOT_PAID_FOR"

Internetverbindung wieder herstellen

viessmannapi.0.XXXXXX.0.features.heating.secondaryCircuit.operation.state.properties.targetValue.value
angezeigt wird. Wenn ich diesen Wert im iobroker ändere wird er nach einer Zeit wieder automatisch überschrieben. Kann ich den Wert dauerhaft manuell ändern und wie ?