OTE-CR (Operátor trhu s elektřinou) je český operátor trhu s elektřinou a plynem. Šablona TapHome stahuje spotové ceny z denního trhu z veřejného API OTE-CR a zpřístupňuje je jako zařízení — aktuální cena, denní statistiky, pořadí a varianty časových oken. Ceny jsou publikovány v EUR za MWh a šablona obsahuje vestavěnou proměnnou pro konverzi měny k zobrazení hodnot v CZK.
Šablona dotazuje API OTE-CR jednou za hodinu a načítá až 96 hodinových cenových období (4 dny dat). Není potřeba žádná autentizace — API endpoint je veřejný.
Konfigurace
Během importu šablony se TapHome připojí k www.ote-cr.cz přes HTTPS (port 443). Není potřeba žádná IP adresa ani přihlašovací údaje — endpoint je pevně daný.
Dva volitelné parametry importu ovládají zařízení s časovým oknem:
- From — počáteční hodina (0–23, výchozí: 9) pro filtr časového okna
- To — koncová hodina (0–23, výchozí: 17) pro filtr časového okna
Výchozí hodnoty (9–17) pokrývají standardní pracovní hodiny. Upravte je podle vašeho preferovaného analytického okna.
Po importu je proměnná Směnný kurz měny (kurz) ve výchozím stavu nastavena na 1 — to znamená, že všechna cenová zařízení zobrazují surové hodnoty v EUR/MWh. Nastavte ji na aktuální kurz EUR/CZK (např. 25,2), aby všechna cenová zařízení zobrazovala hodnoty v CZK. Kurz můžete nastavit ručně v detailu zařízení nebo jej propojit se šablonou Kurzy ČNB pro automatické denní aktualizace (viz níže).
Schopnosti zařízení
Aktuální cena
Zařízení Aktuální cena čte spotovou cenu pro aktuální hodinu. Šablona určí aktivní období ze systémových hodin a vynásobí hodnotu v EUR směnným kurzem, aby zobrazila cenu v CZK.
Pořadí cen
- Pořadí aktuálního období — pořadí ceny aktuální hodiny mezi všemi obdobími dne (1 = nejlevnější, 24 = nejdražší)
- Pořadí aktuálního období v časovém okně — stejné pořadí, ale omezené na uživatelem definované časové okno (From–To). Vrátí NaN, pokud aktuální hodina leží mimo okno.
Denní cenové statistiky
- Nejvyšší cena dne — maximální spotová cena ze všech období, převedená na CZK
- Nejnižší cena dne — minimální spotová cena ze všech období, převedená na CZK
- Průměrná cena dne — aritmetický průměr ze všech období, převedený na CZK
Cenové statistiky časového okna
Každá denní statistika má odpovídající variantu s časovým oknem, která filtruje období do rozsahu From–To:
- Nejvyšší cena v časovém okně
- Nejnižší cena v časovém okně
- Průměrná cena v časovém okně
Všechna zařízení s časovým oknem vrátí NaN, pokud From >= To.
Navigace po obdobích
- Nejlevnější období dne — číslo období (od 1) nejlevnější hodiny v daném dni
- Nejlevnější zbývající období — nejlevnější hodina od aktuálního času dále
- Počet období — celkový počet dostupných cenových období (obvykle 96)
- Počet období v časovém okně — počet období v rozsahu From–To
Směnný kurz měny
Zařízení Směnný kurz měny je jediné zařízení pro čtení i zápis v šabloně. Uchovává konverzní kurz EUR na CZK, který používají všechna cenová zařízení. Nastavte jej ručně nebo jej propojte se šablonou Kurzy ČNB pro automatické denní aktualizace.
Pokud je směnný kurz nastaven na 1, všechna cenová zařízení zobrazují surové hodnoty v EUR.
Servisní atributy
Šablona zpřístupňuje 96 servisních atributů (Období 1 až Období 96), z nichž každý zobrazuje surovou spotovou cenu v EUR pro odpovídající hodinový slot. Pokrývají přibližně 4 dny dat z denního trhu a jsou užitečné pro diagnostiku nebo pro tvorbu vlastních automatizací, které kontrolují konkrétní budoucí období.
Propojení s kurzem ČNB
Pro automatizaci konverze EUR na CZK:
- Importujte šablonu Kurzy ČNB do TapHome
- V šabloně OTE-CR vytvořte vzorec, který čte kurz EUR/CZK ze zařízení ČNB a zapisuje jej do zařízení Směnný kurz měny
- Šablona ČNB aktualizuje kurz denně, takže všechny ceny OTE-CR automaticky odrážejí aktuální směnný kurz
Příklady automatizace
Spotové ceny jsou nejužitečnější v kombinaci s TapHome smart rules:
- Ohřev vody během nejlevnějších hodin — porovnejte pořadí aktuálního období s prahovou hodnotou (např. pořadí <= 4) a zapněte ohřívač vody pouze během 4 nejlevnějších hodin dne
- Nabíjení baterií mimo špičku — použijte zařízení Aktuální cena ke spuštění nabíjení baterie, když cena klesne pod nastavitelný limit
- Přesun zátěže spotřebičů — použijte zařízení Nejlevnější zbývající období k naplánování praček, myček nádobí nebo nabíjení EV na další nejlevnější slot
- Optimalizace časového okna — omezte automatizaci na konkrétní hodiny (např. 6:00–22:00) pomocí zařízení s časovým oknem, aby byla noční období vyloučena z pořadí
Řešení problémů
Všechny ceny zobrazují nulu nebo NaN
- Ověřte, že TapHome CCU má přístup k internetu (šablona se připojuje k
www.ote-cr.czpřes HTTPS) - Zkontrolujte zařízení Počet období — pokud zobrazuje 0, odpověď API je prázdná nebo parsování selhalo
- Ujistěte se, že zařízení Směnný kurz měny je nastaveno na nenulovou hodnotu — kurz 0 vynásobí všechny ceny na nulu
Zařízení s časovým oknem vracejí NaN
- Ověřte, že parametry importu From a To jsou nastaveny správně (From musí být menší než To)
- Pokud je aktuální hodina mimo rozsah From–To, zařízení pořadí v okně vrací NaN záměrně
Ceny se zdají zastaralé
Šablona dotazuje API OTE-CR každou hodinu (3600 sekund). Ceny denního trhu jsou publikovány OTE den předem, obvykle kolem 12:45 CET. Pokud ceny nového dne ještě nejsou viditelné, počkejte do doby publikace.