Integracja z kotłem Viessmann umożliwia zdalne monitorowanie i sterowanie ogrzewaniem (CO) oraz ciepłą wodą użytkową (CWU).
Aby korzystać z integracji, musisz najpierw uzyskać własny Client ID z portalu Viessmann Developer.
Pobierz aplikację ViCare na telefon (iOS/Android).
Załóż konto Viessmann w aplikacji.
Dodaj swój kocioł do aplikacji ViCare zgodnie z instrukcją producenta.
Upewnij się, że kocioł jest widoczny i działa w aplikacji.
Wejdź na stronę developer.viessmann-climatesolutions.com.
Zaloguj się tymi samymi danymi co do aplikacji ViCare (email i hasło).


Kliknij My Dashboard w górnym menu strony.
Znajdź sekcję „Your clients”.
Kliknij przycisk „+ Add”.
Wypełnij formularz:
Name – dowolna nazwa (np. „sinum”, „moja_integracja”),
Redirect URIs – wpisz http://localhost:4200/.
Kliknij „Create Client”.

Po utworzeniu klienta zostanie wygenerowany Client ID – długi ciąg znaków.

Skopiuj wygenerowany Client ID (np. a57a6ca6c0cc1f7f55ddb89b0e5cbc31).
Użyj go w konfiguracji urządzenia.
Po uzyskaniu Client ID możesz skonfigurować połączenie z API Viessmann.
Kliknij ikonę ⋯ (menu) w prawym górnym rogu ekranu głównego.
Wybierz Konfiguracja.

| Pole | Opis |
|---|---|
| Client ID | Wklej identyfikator Client ID uzyskany z portalu Viessmann Developer Portal. |
| Adres e-mail konta Viessmann (ten sam, który jest używany w aplikacji ViCare). | |
| Hasło | Hasło do konta Viessmann. |
Kliknij przycisk Zaloguj.
Poczekaj na wyświetlenie komunikatu „✓ Zalogowano!”.
W przypadku wyświetlenia komunikatu o błędzie sprawdź poprawność wprowadzonych danych logowania.
Jeżeli chcesz korzystać z trybu harmonogramu dla CWU:
W polu Plan pracy CWU wybierz harmonogram przekaźników.
Upewnij się, że harmonogram został wcześniej utworzony w systemie (typ harmonogramu: relay_control).
Kliknij przycisk Zakończ konfigurację, aby zapisać ustawienia i przejść do ekranu głównego.

Ekran główny prezentuje najważniejsze informacje dotyczące stanu pracy kotła.
| Element | Opis |
|---|---|
| CO: 42,6°C | Aktualna temperatura zasilania instalacji grzewczej. |
| 🔥 | Ikona ognia pojawia się, gdy kocioł aktualnie ogrzewa obieg CO. |
| Tryb | Lista rozwijana umożliwiająca wybór trybu pracy: GRZANIE / CZUWANIE. |
| Zadana | Suwak umożliwiający ustawienie temperatury zadanej w zakresie 20–82°C. |
| Element | Opis |
|---|---|
| CWU: 43,8°C | Aktualna temperatura zasobnika CWU. |
| 🔥 | Ikona ognia pojawia się, gdy kocioł aktualnie ogrzewa zasobnik CWU. |
| Tryb | Lista rozwijana umożliwiająca wybór trybu pracy: Zrównoważony, Wyłączony, Harmonogram. |
| Status | Wyświetla aktualny stan pracy CWU w trybie harmonogramu. |
| Dogrzej | Przycisk umożliwiający jednorazowe dogrzanie zasobnika CWU. |
| Zadana CWU | Suwak umożliwiający ustawienie temperatury zadanej CWU. |
| Element | Opis |
|---|---|
| Kocioł: praca / off | Informacja, czy palnik kotła jest aktualnie aktywny. |
| Modulacja: 16,9% | Aktualna moc palnika wyrażona w procentach. |
| Tryb | Opis |
|---|---|
| GRZANIE | Ogrzewanie aktywne — kocioł pracuje do osiągnięcia temperatury zadanej. |
| CZUWANIE | Ogrzewanie wyłączone — aktywna jedynie funkcja ochrony przed zamarzaniem. |
Użyj suwaka Zadana lub przycisków – / +.
Aktualna wartość temperatury wyświetlana jest po prawej stronie suwaka.
Zakres regulacji temperatury wynosi 20–82°C.
Zmiana temperatury jest wysyłana do kotła natychmiast po jej ustawieniu.
Dla zapewnienia niezawodnego sterowania pracą kotła zaleca się stosowanie styku beznapięciowego zamiast wyłącznie sterowania przez API.
| Metoda | Zalety | Wady |
|---|---|---|
| Tylko API | Prosta konfiguracja. | Wymaga dostępu do internetu, możliwe opóźnienia. |
| Styk beznapięciowy | Działanie lokalne, wysoka niezawodność. | Wymaga wykonania okablowania. |
Uwaga:
API Viessmann działa w oparciu o połączenie internetowe. W przypadku awarii sieci lub serwerów Viessmann sterowanie kotłem może nie działać. Styk beznapięciowy funkcjonuje niezależnie od internetu i zapewnia wyższą niezawodność działania.
Podłącz styk beznapięciowy do wejścia termostatu pokojowego („pokojówki”) w kotle Viessmann.
Ustaw kocioł w trybie stałego grzania — CO: GRZANIE.
Styk steruje pracą kotła:
styk zamknięty — kocioł grzeje,
styk otwarty — kocioł oczekuje.
Skonfiguruj wirtualny styk w systemie Sinum (szczegóły w kolejnej sekcji).
Szczegółowa instrukcja konfiguracji wirtualnego styku dostępna jest w bazie wiedzy Sinum:
🔗 Konfiguracja ogrzewania — wirtualny styk
Przejdź do Ustawienia → Urządzenia → Urządzenia wirtualne.
Kliknij + i wybierz Wirtualny styk.
Nadaj nazwę urządzeniu oraz przypisz:
Urządzenia wymagane — termostaty do obsługi,
Urządzenia dodatkowe — przekaźnik ogrzewania.
Zapisz konfigurację.

| Element | Ustawienie |
|---|---|
| Tryb CO w urządzeniu Viessmann | GRZANIE (stałe) |
| Sterowanie pracą kotła | Wirtualny styk w systemie Sinum |
| Połączenie fizyczne | Styk beznapięciowy → wejście pokojówki kotła |
| Tryb | Opis |
|---|---|
| Zrównoważony | CWU włączone — kocioł podgrzewa wodę, gdy temperatura spadnie poniżej zadanej. |
| Wyłączony | CWU wyłączone — brak podgrzewania wody użytkowej. |
| Harmonogram | CWU sterowane według harmonogramu (wymaga wcześniejszej konfiguracji). |
Użyj suwaka Zadana CWU lub przycisków – / +.
Zakres regulacji zależy od ustawień kotła (typowo 30–60°C).
Tryb harmonogramu pozwala automatycznie włączać i wyłączać CWU zgodnie z wcześniej zdefiniowanym planem.
Wymagania:
Utworzony harmonogram przekaźników typu relay_control w systemie.
Harmonogram wybrany w konfiguracji urządzenia.
Działanie:
System sprawdza stan harmonogramu co minutę.
Gdy harmonogram wskazuje ON → CWU przełącza się na Zrównoważony.
Gdy harmonogram wskazuje OFF → CWU przełącza się na Wyłączony.
Status harmonogramu:
Obok pola trybu wyświetlany jest aktualny stan:
CWU: włączone — harmonogram włączył CWU,
CWU: wyłączone — harmonogram wyłączył CWU.
Uwaga: Opcja Harmonogram pojawia się w liście trybów tylko wtedy, gdy harmonogram został wybrany w konfiguracji urządzenia.
Funkcja umożliwia jednorazowe dogrzanie wody użytkowej niezależnie od aktualnego trybu CWU.
Widoczność przycisku:
Przyciski Dogrzej są widoczne, gdy tryb CWU to Wyłączony lub Harmonogram.
W trybie Zrównoważony przycisk jest ukryty (CWU i tak jest aktywne).
Działanie:
Kliknij przycisk Dogrzej.
CWU zostaje włączone na 1 godzinę.
W polu statusu wyświetlany jest pozostały czas dogrzewania, np. „Dogrzewanie: 45:30”.
Dogrzewanie kończy się, gdy:
upłynie 1 godzina, lub
temperatura CWU osiągnie wartość zadaną.
Po zakończeniu dogrzewania:
Jeśli poprzedni tryb był Harmonogram → system sprawdza harmonogram i przywraca odpowiedni tryb.
Jeśli poprzedni tryb był Wyłączony → system wyłącza CWU.
Przerwanie dogrzewania:
Zmiana trybu CWU na dowolny inny automatycznie przerywa dogrzewanie.