Viessmann API gibt 402 (Payment Required) zurück – evcc kann Vitocal 250-A nicht fernsteuern

[dieschleg]

Hallo zusammen,

ich habe seit Kurzem evcc (Heimenergiemanagement) auf meinem Heimserver laufen und möchte damit meine Viessmann Vitocal 250-A Wärmepumpe einbinden, um den Stromverbrauch zu optimieren. Die Authentifizierung per ClientId/Token über die Viessmann API hat soweit problemlos funktioniert. Allerdings scheitert evcc beim Versuch, die Wärmepumpe tatsächlich fernzusteuern, mit folgendem Fehler im Log:

ERROR 2026/03/16 15:07:33 charger enabled: unexpected status: 402 (Payment Required) GET https://api.viessmann-climatesolutions.com/iot/v2/features/installations/xxxxxx/gateways/xxxxxx/devi...

Was bedeutet der 402-Fehler bei der Viessmann API?

Ich habe die Viessmann API-Dokumentation durchforstet, aber einen HTTP-Statuscode 402 findet man dort leider nicht explizit beschrieben. Hat jemand diesen Fehler schon erlebt oder weiß, was er bedeutet?

Meine Vermutung:

Nach etwas Recherche habe ich den Verdacht, dass der 402-Fehler darauf hinweist, dass das Fernsteuerungs-Feature (Remote Control / Schreibzugriff auf die Wärmepumpe) nicht im kostenlosen Basic-Plan der Viessmann API enthalten ist. Laut der Viessmann Entwickler-FAQ umfasst der Basic-Plan zwar "Remote Monitoring, Remote Control, Device Status and Statistics", allerdings scheint es so, dass bestimmte Steuerbefehle möglicherweise dem kostenpflichtigen Advanced-Plan vorbehalten sind.

Meine Fragen:

1. Kann jemand bestätigen, dass heating.dhw.oneTimeCharge (Steuerbefehle/Schreibzugriff) tatsächlich nur im Advanced-Plan verfügbar ist?

2. Hat jemand eine Möglichkeit gefunden, die Wärmepumpe trotzdem (z. B. über einen alternativen Endpunkt oder lokale Schnittstelle wie SG-Ready) fernzusteuern?

Freue mich über jeden Hinweis. Danke!​

[qwert089]

ärgere dich nicht weiter mit der Api rum:

https://community.viessmann.de/t5/Konnektivitaet/CAN-Bus-Home-Automation-E3-Generation-lokal-und-kos...

[RaiJue]

Hallo Dieschleg,

hast du eine Lösung gefunden? Ich stehe vor dem selben Problem oder hast du es aufgeben?

Viele Grüße, Rainer

[Scotty]

Hallo,

zwischen 10.2. und heute finde ich insgesamt 6 Anfragen zu diesem Problem:

10.2. https://community.viessmann.de/t5/The-Viessmann-API/Error-PACKAGE-NOT-PAID-FOR-bei-AOI-Zugriff/td-p/...
10.2. https://community.viessmann.de/t5/The-Viessmann-API/API-Error-PACKAGE-NOT-PAID-FOR/td-p/604493

25.3. https://community.viessmann.de/t5/The-Viessmann-API/ViCare-Integration-funktioniert-nicht/td-p/61236...

27.3. https://community.viessmann.de/t5/The-Viessmann-API/Fehler-quot-PACKAGE-NOT-PAID-FOR-quot/td-p/61286...

30.3. https://community.viessmann.de/t5/The-Viessmann-API/homeassistant-keine-Entitaeten/td-p/613353

Keine Antwort von Viessmann und eine andere Möglichkeit ein Problem zu meldenals dieses Forum sehe ich nicht.

Ich verstehe sowieso nicht, warum Viessmann es seinen Kunden so schwer macht. Schließlich will ich nur Daten meiner Anlage (für die ich einen 5stelligen Betrag gezahlt habe) in mein SmartHome-System integrieren. Schon diese Cloud-Lösung ist ein Witz für eine Anlage die in meinem lokalen Netzwerk hängt. Ich verstehe nicht, warum Viessman - wie viele andere Hersteller auch - nicht MQTT oder wenigstens Modbus anbietet. So langsam kommt bei mir das Gefühl auf, den falschen Hersteller ausgewählt zu haben.

[AWa1]

Eine  MQtt Lösung gibt es über Home Assiatant nennt sich Viessmann2MQTT.

Damit werden mehr Daten ausgegwbwn!

[Scotty]

Viessmann2MQTT greift aber auch auf die API zu und hat damit das selbe Problem. Ich jedenfalls warte seit 2 Wochen auf eine Lösung und einigen anderen geht es ebenso. Kundenfreundlichkeit geht anders.

[RaiJue]

Auf diesem Weg kommen allerdings die Daten im HA an.