OTE-CR (Operátor trhu s elektřinou) to czeski operator rynku energii elektrycznej i gazu. Szablon TapHome pobiera ceny spot z rynku dnia następnego z publicznego API OTE-CR i udostępnia je jako urządzenia — aktualna cena, statystyki dzienne, ranking i warianty z oknem czasowym. Ceny są publikowane w EUR za MWh, a szablon zawiera wbudowaną zmienną do przeliczania walut w celu wyświetlania wartości w CZK.
Szablon odpytuje API OTE-CR raz na godzinę i pobiera do 96 godzinowych okresów cenowych (4 dni danych). Nie jest wymagane żadne uwierzytelnianie — punkt końcowy API jest publiczny.
Konfiguracja
Podczas importu szablonu TapHome łączy się z www.ote-cr.cz przez HTTPS (port 443). Nie jest potrzebny adres IP ani dane logowania — punkt końcowy jest stały.
Dwa opcjonalne parametry importu sterują urządzeniami z oknem czasowym:
- From — godzina początkowa (0–23, domyślnie: 9) dla filtra okna czasowego
- To — godzina końcowa (0–23, domyślnie: 17) dla filtra okna czasowego
Wartości domyślne (9–17) obejmują standardowe godziny pracy. Dostosuj je do preferowanego okna analizy.
Po imporcie zmienna Kurs wymiany walut (kurz) jest domyślnie ustawiona na 1 — co oznacza, że wszystkie urządzenia cenowe wyświetlają surowe wartości w EUR/MWh. Ustaw ją na aktualny kurs EUR/CZK (np. 25,2), aby wszystkie urządzenia cenowe wyświetlały wartości w CZK. Kurs możesz ustawić ręcznie w szczegółach urządzenia lub powiązać go z szablonem Kurs wymiany ČNB w celu automatycznych dziennych aktualizacji (patrz poniżej).
Możliwości urządzeń
Aktualna cena
Urządzenie Aktualna cena odczytuje cenę spot dla bieżącej godziny. Szablon określa aktywny okres na podstawie zegara systemowego i mnoży wartość w EUR przez kurs wymiany, aby wyświetlić cenę w CZK.
Ranking cen
- Ranking bieżącego okresu — pozycja ceny bieżącej godziny wśród wszystkich okresów dnia (1 = najtańszy, 24 = najdroższy)
- Ranking bieżącego okresu w oknie czasowym — ten sam ranking, ale ograniczony do zdefiniowanego przez użytkownika okna czasowego (From–To). Zwraca NaN, jeśli bieżąca godzina znajduje się poza oknem.
Dzienne statystyki cenowe
- Najwyższa cena dnia — maksymalna cena spot ze wszystkich okresów, przeliczona na CZK
- Najniższa cena dnia — minimalna cena spot ze wszystkich okresów, przeliczona na CZK
- Średnia cena dnia — średnia arytmetyczna ze wszystkich okresów, przeliczona na CZK
Statystyki cenowe okna czasowego
Każda statystyka dzienna ma odpowiednik z oknem czasowym, który filtruje okresy do zakresu From–To:
- Najwyższa cena w oknie czasowym
- Najniższa cena w oknie czasowym
- Średnia cena w oknie czasowym
Wszystkie urządzenia z oknem czasowym zwracają NaN, jeśli From >= To.
Nawigacja po okresach
- Najtańszy okres dnia — numer okresu (od 1) najtańszej godziny dnia
- Najtańszy pozostały okres — najtańsza godzina od bieżącego momentu
- Liczba okresów — łączna liczba dostępnych okresów cenowych (zazwyczaj 96)
- Liczba okresów w oknie czasowym — liczba okresów w zakresie From–To
Kurs wymiany walut
Urządzenie Kurs wymiany walut jest jedynym urządzeniem do odczytu i zapisu w szablonie. Przechowuje kurs przeliczeniowy EUR na CZK używany przez wszystkie urządzenia cenowe. Ustaw go ręcznie lub połącz z szablonem Kurs wymiany ČNB w celu automatycznych dziennych aktualizacji.
Gdy kurs wymiany jest ustawiony na 1, wszystkie urządzenia cenowe wyświetlają surowe wartości w EUR.
Atrybuty serwisowe
Szablon udostępnia 96 atrybutów serwisowych (Okres 1–Okres 96), z których każdy pokazuje surową cenę spot w EUR dla odpowiedniego slotu godzinowego. Obejmują one około 4 dni danych z rynku dnia następnego i są przydatne do diagnostyki lub tworzenia niestandardowych automatyzacji, które sprawdzają konkretne przyszłe okresy.
Połączenie z kursem ČNB
Aby zautomatyzować przeliczanie EUR na CZK:
- Zaimportuj szablon Kurs wymiany ČNB (Kurzy ČNB) do TapHome
- W szablonie OTE-CR utwórz formułę, która odczytuje kurs EUR/CZK z urządzenia ČNB i zapisuje go w urządzeniu Kurs wymiany walut
- Szablon ČNB aktualizuje kurs codziennie, więc wszystkie ceny OTE-CR automatycznie odzwierciedlają aktualny kurs wymiany
Przykłady automatyzacji
Ceny spot są najbardziej przydatne w połączeniu z TapHome smart rules:
- Grzanie wody w najtańszych godzinach — porównaj ranking bieżącego okresu z progiem (np. ranking <= 4) i włącz podgrzewacz wody tylko podczas 4 najtańszych godzin dnia
- Ładowanie baterii poza szczytem — użyj urządzenia Aktualna cena do uruchomienia ładowania baterii, gdy cena spadnie poniżej konfigurowalnego limitu
- Przesunięcie obciążenia urządzeń — użyj urządzenia Najtańszy pozostały okres do zaplanowania pralek, zmywarek lub ładowania EV na następny najtańszy slot
- Optymalizacja okna czasowego — ogranicz automatyzację do określonych godzin (np. 6:00–22:00) za pomocą urządzeń z oknem czasowym, aby okresy nocne zostały wykluczone z rankingu
Rozwiązywanie problemów
Wszystkie ceny pokazują zero lub NaN
- Sprawdź, czy TapHome CCU ma dostęp do internetu (szablon łączy się z
www.ote-cr.czprzez HTTPS) - Sprawdź urządzenie Liczba okresów — jeśli pokazuje 0, odpowiedź API jest pusta lub parsowanie nie powiodło się
- Upewnij się, że urządzenie Kurs wymiany walut jest ustawione na wartość różną od zera — kurs 0 pomnoży wszystkie ceny przez zero
Urządzenia z oknem czasowym zwracają NaN
- Sprawdź, czy parametry importu From i To są prawidłowo ustawione (From musi być mniejsze niż To)
- Jeśli bieżąca godzina jest poza zakresem From–To, urządzenie rankingu w oknie zwraca NaN zgodnie z projektem
Ceny wydają się nieaktualne
Szablon odpytuje API OTE-CR co godzinę (3600 sekund). Ceny rynku dnia następnego są publikowane przez OTE dzień wcześniej, zazwyczaj około 12:45 CET. Jeśli ceny nowego dnia nie są jeszcze widoczne, poczekaj do czasu publikacji.