Thema "Betreff: Viessmann API gibt 402 (Payment Required) zurück – evcc kann Vitocal 250-A nicht fernsteuern" in The Viessmann API

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

dieschleg — Mon, 16 Mar 2026 14:22:59 GMT

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/devices/0/features/heating.dhw.oneTimeCharge

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:

Kann jemand bestätigen, dass heating.dhw.oneTimeCharge (Steuerbefehle/Schreibzugriff) tatsächlich nur im Advanced-Plan verfügbar ist?
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!

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

qwert089 — Mon, 16 Mar 2026 14:38:09 GMT

ärgere dich nicht weiter mit der Api rum:

https://community.viessmann.de/t5/Konnektivitaet/CAN-Bus-Home-Automation-E3-Generation-lokal-und-kostenlos/td-p/356066

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

RaiJue — Fri, 27 Mar 2026 15:16:20 GMT

Hallo Dieschleg,

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

Viele Grüße, Rainer

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

Scotty — Wed, 01 Apr 2026 09:54:33 GMT

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/604485
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/612369

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

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.

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

AWa1 — Sat, 04 Apr 2026 10:31:11 GMT

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

Damit werden mehr Daten ausgegwbwn!

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

Scotty — Thu, 09 Apr 2026 10:07:28 GMT

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.

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

RaiJue — Thu, 09 Apr 2026 10:36:21 GMT

Auf diesem Weg kommen allerdings die Daten im HA an.