dev support: 💡 Odbierz 50 zł na prąd w Pstryk! Użyj mojego kodu E3WOTQ w koszyku w aplikacji. Bonus trafi do Twojego Portfela Pstryk po pierwszej opłaconej fakturze!

Integracja Home Assistant z Pstryk API

!!! Dedykowana Karta do integracji: https://github.com/balgerion/ha_Pstryk_card

Integracja dla Home Assistant umożliwiająca śledzenie aktualnych cen energii elektrycznej oraz prognoz z platformy Pstryk.

Status API

Integracja korzysta z nowego endpointu unified-metrics dla:

• cen zakupu i sprzedaży
• zużycia energii
• kosztów i bilansu

Funkcje

• Aktualna cena kupna i sprzedaży energii
• Tabela 24h z prognozowanymi cenami dla sensora API
• Tabela 48h z prognozowanymi cenami dla sensora MQTT
• Konfigurowalna liczba "najlepszych godzin"
• Konfigurowalna liczba "najgorszych godzin"
• Cena w następnej godzinie
• Średnia cena z pozostałej ilości godzin do końca doby
• Średnia cena wschód/zachód
• Automatyczna konwersja czasu UTC → lokalny
• Dane są aktualizowane minutę po pełnej godzinie
• Konfiguracja z poziomu integracji
• Walidacja klucza API / Cache danych / Zabezpieczenie przed timeoutem API
• Integracja wystawia po lokalnym MQTT tablice cen w natywnym formacie EVCC
• Średnia zakupu oraz sprzedaży - miesięczna/roczna
• Bilans miesięczny/roczny
• Debug i logowanie

Instalacja

Metoda 1: Via HACS

1. W HACS przejdź do Integracje
2. Kliknij Dodaj repozytorium
3. Wpisz URL: https://github.com/balgerion/ha_Pstryk
4. Wybierz kategorię: Integration
5. Zainstaluj i zrestartuj Home Assistant

Metoda 2: Ręczna instalacja

1. Utwórz folder custom_components/pstryk w katalogu konfiguracyjnym HA
2. Wgraj wszystkie pliki z repozytorium.
3. Zrestartuj Home Assistant

Testowanie API

W repo jest gotowa kolekcja Postmana:

• Pstryk Integrations API.postman_collection.json

Jak użyć:

1. Zaimportuj kolekcję do Postmana
2. Otwórz zakładkę Variables
3. Ustaw api_token na swój klucz API Pstryk
4. Uruchamiaj requesty z folderu Unified Metrics

Folder Legacy Comparison zostawiłem do ręcznego porównywania odpowiedzi ze starych endpointów podczas migracji.

Konfiguracja

1. Przejdź do Ustawienia → Urządzenia i usługi
2. Kliknij Dodaj integrację
3. Wyszukaj "Psrryk Energy"
4. Wprowadź dane:

• Klucz API: Twój klucz z platformy Pstryk
• Liczba najlepszych cen kupna: (domyślnie 5)
• Liczba najlepszych cen sprzedaży: (domyślnie 5)

Scrnshoty

Użycie

Dostępne encje

Nazwa encji	Opis
sensor.pstryk_current_buy_price	Aktualna cena kupna energii + tabela
sensor.pstryk_current_sell_price	Aktualna cena sprzedaży energii + tabela
sensor.pstryk_buy_monthly_average	Średnia miesięczna cena kupna energii
sensor.pstryk_buy_yearly_average	Średnia roczna cena kupna energii
sensor.pstryk_sell_monthly_average	Średnia miesięczna cena sprzedaży energii
sensor.pstryk_sell_yearly_average	Średnia roczna cena sprzedaży energii
sensor.pstryk_daily_financial_balance	Dzienny bilans kupna/sprzedaży
sensor.pstryk_monthly_financial_balance	Miesięczny bilans kupna/sprzedaży
sensor.pstryk_yearly_financial_balance	Roczny bilans kupna/sprzedaży

Przykładowa Automatyzacja:

Włączanie bojlera

alias: Optymalne grzanie wody
description: ""
triggers:
  - minutes: "1"
    trigger: time_pattern
    hours: /1
conditions:
  - condition: template
    value_template: >
      {% set current_hour = now().replace(minute=0, second=0,
      microsecond=0).isoformat(timespec='seconds').split('+')[0] %}

      {% set best_hours = state_attr('sensor.pstryk_current_buy_price',
      'best_prices') | map(attribute='start') | list %}

      {{ current_hour in best_hours }}
actions:
  - variables:
      current_hour: >-
        {{ now().replace(minute=0, second=0,
        microsecond=0).isoformat(timespec='seconds').split('+')[0] }}
  - choose:
      - conditions:
          - condition: state
            entity_id: light.shellypro3_34987a49142c_switch_2
            state: "off"
        sequence:
          - target:
              entity_id: switch.shellypro3_34987a49142c_switch_2
            action: switch.turn_on
            data: {}
          - data:
              message: |
                Grzanie włączone! Godzina: {{ current_hour }}, Cena: {{
                  state_attr('sensor.pstryk_current_buy_price', 'best_prices')
                  | selectattr('start', 'equalto', current_hour)
                  | map(attribute='price')
                  | first
                }} PLN
            action: notify.mobile_app_balg_iphone
      - conditions:
          - condition: state
            entity_id: light.shellypro3_34987a49142c_switch_2
            state: "on"
        sequence:
          - delay:
              hours: 1
              minutes: 5
          - target:
              entity_id: switch.shellypro3_34987a49142c_switch_2
            action: switch.turn_off
            data: {}

EVCC

Scrnshoty

Konfiguracja

Taryfy:

currency: PLN
grid:
  type: custom
  forecast:
    source: mqtt
    topic: energy/forecast/buy

feedin:
  type: custom
  forecast:
    source: mqtt
    topic: energy/forecast/sell