🇵🇱 ENTSO-E Ceny Energii

---

Profesjonalna integracja HACS dla Home Assistant, pobierająca ceny energii day-ahead z platformy ENTSO-E Transparency.

Domyślnie skonfigurowana dla Polski — z przeliczeniem na PLN/kWh, automatycznym kursem EUR/PLN z NBP i polskim VAT 23%.

🏠 Wydawca: Smarting HOME — inteligentne zarządzanie energią w domu

---

✨ Funkcje

Funkcja	Opis
⚡ Aktualna cena	Cena energii w bieżącej godzinie
⏭️ Następna godzina	Cena na kolejną godzinę
📉 Minimum dzisiaj	Najniższa cena dnia + godzina
📈 Maksimum dzisiaj	Najwyższa cena dnia + godzina
📊 Średnia dzisiaj	Średnia cena dnia
💰 Najtańsze 3h	Najtańsze 3 kolejne godziny
🏦 Auto-kurs NBP	Automatyczny kurs EUR/PLN z Narodowego Banku Polskiego
📋 Ceny today/tomorrow	Pełna lista cen w atrybutach sensora
🇵🇱 Polski interfejs	Pełne tłumaczenie na język polski
🌍 60+ stref	Wszystkie europejskie bidding zones

📦 Instalacja

HACS (zalecane)

1. Otwórz HACS → Integracje
2. Kliknij ⋮ → Repozytoria niestandardowe
3. Dodaj URL: https://github.com/GregECAT/entsoe-e
4. Kategoria: Integracja
5. Zainstaluj ENTSO-E Ceny Energii
6. Uruchom ponownie Home Assistant

Ręcznie

1. Skopiuj folder custom_components/entsoe_prices/ do katalogu custom_components/ w Home Assistant
2. Uruchom ponownie Home Assistant

⚙️ Konfiguracja

1. Settings → Devices & Services → Add Integration
2. Wyszukaj "ENTSO-E Ceny Energii"
3. Wypełnij formularz:

Pole	Opis	Domyślnie
🔑 Klucz API	Token z ENTSO-E	— (wymagany)
🌍 Strefa cenowa	Bidding zone	🇵🇱 Polska
💱 Waluta	EUR lub PLN	PLN
⚡ Jednostka	kWh lub MWh	kWh
🧾 VAT (%)	Stawka VAT	23.0
🏦 Auto-kurs NBP	Automatyczny kurs walut	✅ Tak
📝 Kurs ręczny	Gdy auto-kurs wyłączony	4.30
🔌 Encja RCE	Entity ID sensora RCE PSE (spread)	sensor.rce_pse_cena

Jak uzyskać klucz API

1. Zarejestruj konto na transparency.entsoe.eu
2. Wyślij email na transparency@entsoe.eu z tematem "Restful API access"
3. Po aktywacji: My Account → Web API Security Token

📖 Pełna dokumentacja API: Postman Collection

📊 Sensory (Entities)

📖 Pełna dokumentacja sensorów: docs/SENSORS.md — wzory, instrukcje, przykłady automatyzacji

Po konfiguracji pojawią się 26 sensorów (22 zwykłe + 4 binarne):

Ceny hurtowe

Sensor	Entity ID	Opis
⚡ Aktualna cena	sensor.entso_e_aktualna_cena_energii	Cena w bieżącej godzinie (PLN/kWh)
⏭️ Następna godzina	sensor.entso_e_cena_za_nastepna_godzine	Cena na kolejną godzinę
📉 Minimum	sensor.entso_e_minimum_dzisiaj	Najniższa cena dnia
📈 Maksimum	sensor.entso_e_maksimum_dzisiaj	Najwyższa cena dnia
📊 Średnia	sensor.entso_e_srednia_dzisiaj	Średnia cena dnia

Koszt all-in (realny koszt zakupu z sieci)

Sensor	Entity ID	Opis
💵 All-in teraz	sensor.entso_e_koszt_all_in_teraz	Cena + marża + akcyza + dystrybucja + VAT
💵 All-in +1h	sensor.entso_e_koszt_all_in_nastepna_h	Pełny koszt na kolejną godzinę
⬇️ All-in min	sensor.entso_e_koszt_all_in_min_dzisiaj	Najniższy pełny koszt dnia
⬆️ All-in max	sensor.entso_e_koszt_all_in_max_dzisiaj	Najwyższy pełny koszt dnia

Okna cenowe

Sensor	Entity ID	Opis
💰 Najtańsze 2h/3h/4h	sensor.entso_e_najtansze_*_srednia	Najlepsze okna ładowania
📈 Najdroższe 2h/3h	sensor.entso_e_najdrozsze_*_srednia	Najlepsze okna sprzedaży

Analityka

Sensor	Entity ID	Opis
🔢 Ranking	sensor.entso_e_ranking_biezacej_godziny	Pozycja cenowa (1 = najtańsza)
📊 Percentyl	sensor.entso_e_percentyl_biezacej_godziny	0% = najtaniej, 100% = najdrożej
Δ Delta +1h/+3h	sensor.entso_e_zmiana_ceny_1h / _3h	Zmiana ceny w przyszłości

Binary sensors (ON/OFF)

Sensor	Entity ID	ON gdy...
🔋 Okno ładowania	binary_sensor.entso_e_okno_ladowania_aktywne	Teraz w najtańszym 3h oknie
💰 Okno sprzedaży	binary_sensor.entso_e_okno_sprzedazy_aktywne	Teraz w najdroższym 3h oknie
📈 Trend rosnący	binary_sensor.entso_e_trend_rosnacy_3h	Ceny rosną przez 3h
📉 Trend malejący	binary_sensor.entso_e_trend_malejacy_3h	Ceny maleją przez 3h

Sensory RCE Spread (opcjonalne — wymaga integracji RCE PSE)

Sensor	Entity ID	Opis
💱 Cena RCE teraz	sensor.entso_e_cena_rce_teraz	Bieżąca cena RCE (PLN/kWh)
📊 Spread kupno/sprzedaż	sensor.entso_e_spread_kupno_vs_sprzedaz	RCE sell − ENTSO-E all-in buy
📈 Spread peak dzisiaj	sensor.entso_e_spread_peak_dzisiaj	Max RCE − Min all-in (potencjał)
🔋 Arbitraż baterii	sensor.entso_e_spread_arbitraz_baterii	Spread z uwzgl. strat baterii (90%)

Spread > 0 = opłaca się sprzedawać | Spread < 0 = ładuj baterię
Instrukcja konfiguracji RCE: docs/SENSORS.md#instrukcja-konfiguracji-rce

Atrybuty sensora current_price

prices_today:
  - start: "2025-01-15T00:00:00+01:00"
    end: "2025-01-15T01:00:00+01:00"
    start_local: "00:00"
    value: 0.4523                    # PLN/kWh
    raw_eur_mwh: 78.50               # oryginalna cena EUR/MWh
  - ...
prices_tomorrow: [...]               # Dostępne ok. 13:00 CET
tomorrow_available: true
exchange_rate: 4.3215                # kurs NBP
updated_at: "2025-01-15T12:30:00+00:00"
today_min: 0.2105
today_max: 0.8734
today_avg: 0.4521
today_min_hour: "03:00"
today_max_hour: "18:00"
cheapest_hours_start: "02:00"
cheapest_hours_end: "05:00"
cheapest_hours_avg: 0.2234

📈 Wizualizacja — przykłady kart Lovelace

ApexCharts Card

type: custom:apexcharts-card
header:
  title: ⚡ Ceny energii — dzisiaj
  show: true
graph_span: 24h
span:
  start: day
series:
  - entity: sensor.entsoe_current_price
    data_generator: |
      return entity.attributes.prices_today.map(p => [
        new Date(p.start).getTime(),
        p.value
      ]);

Mini Graph Card

type: custom:mini-graph-card
entities:
  - sensor.entsoe_current_price
name: Cena energii
hours_to_show: 24
points_per_hour: 1
line_color: "#00CCAA"

Automatyzacja — najtańsze godziny

automation:
  - alias: "Włącz ładowanie w najtańszych godzinach"
    trigger:
      - platform: time
        at: sensor.entsoe_cheapest_hours_avg
    condition:
      - condition: numeric_state
        entity_id: sensor.entsoe_current_price
        below: 0.30
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.charger

🔄 Aktualizacja danych

Co	Częstotliwość
Ceny day-ahead	Co 30 minut
Kurs NBP	Raz dziennie
Ceny na jutro	Publikowane ok. 13:00 CET

🤝 Wsparcie

• 🐛 Błędy: GitHub Issues
• 🏠 Smarting HOME: smartinghome.pl
• 📖 API Docs: Postman Collection
• 📧 ENTSO-E: transparency@entsoe.eu

📄 Licencja

MIT License — LICENSE

---

Powered by Smarting HOME
Dane z ENTSO-E Transparency Platform · Kurs walut z API NBP