OTE-CR (Operátor trhu s elektřinou) je český operátor trhu s elektrinou a plynom. Šablóna TapHome načítava spotové ceny z denného trhu z verejného API OTE-CR a sprístupňuje ich ako zariadenia — aktuálna cena, denné štatistiky, poradie a varianty časových okien. Ceny sú publikované v EUR za MWh a šablóna obsahuje vstavanú premennú pre konverziu meny na zobrazenie hodnôt v CZK.
Šablóna dopytuje API OTE-CR raz za hodinu a načítava až 96 hodinových cenových období (4 dni dát). Nie je potrebná žiadna autentifikácia — API endpoint je verejný.
Konfigurácia
Počas importu šablóny sa TapHome pripojí k www.ote-cr.cz cez HTTPS (port 443). Nie je potrebná žiadna IP adresa ani prihlasovacie údaje — endpoint je pevne daný.
Dva voliteľné parametre importu ovládajú zariadenia s časovým oknom:
- From — počiatočná hodina (0–23, predvolené: 9) pre filter časového okna
- To — koncová hodina (0–23, predvolené: 17) pre filter časového okna
Predvolené hodnoty (9–17) pokrývajú štandardné pracovné hodiny. Upravte ich podľa preferovaného analytického okna.
Po importe je premenná Výmenný kurz meny (kurz) predvolene nastavená na 1 — to znamená, že všetky cenové zariadenia zobrazujú surové hodnoty v EUR/MWh. Nastavte ju na aktuálny kurz EUR/CZK (napr. 25,2), aby všetky cenové zariadenia zobrazovali hodnoty v CZK. Kurz môžete nastaviť ručne v detaile zariadenia alebo ho prepojiť so šablónou Kurzy ČNB pre automatické denné aktualizácie (pozri nižšie).
Schopnosti zariadení
Aktuálna cena
Zariadenie Aktuálna cena číta spotovú cenu pre aktuálnu hodinu. Šablóna určí aktívne obdobie zo systémových hodín a vynásobí hodnotu v EUR kurzom, aby zobrazila cenu v CZK.
Poradie cien
- Poradie aktuálneho obdobia — poradie ceny aktuálnej hodiny medzi všetkými obdobiami dňa (1 = najlacnejšie, 24 = najdrahšie)
- Poradie aktuálneho obdobia v časovom okne — rovnaké poradie, ale obmedzené na používateľom definované časové okno (From–To). Vráti NaN, ak aktuálna hodina leží mimo okno.
Denné cenové štatistiky
- Najvyššia cena dňa — maximálna spotová cena zo všetkých období, konvertovaná na CZK
- Najnižšia cena dňa — minimálna spotová cena zo všetkých období, konvertovaná na CZK
- Priemerná cena dňa — aritmetický priemer zo všetkých období, konvertovaný na CZK
Cenové štatistiky časového okna
Každá denná štatistika má zodpovedajúci variant s časovým oknom, ktorý filtruje obdobia do rozsahu From–To:
- Najvyššia cena v časovom okne
- Najnižšia cena v časovom okne
- Priemerná cena v časovom okne
Všetky zariadenia s časovým oknom vrátia NaN, ak From >= To.
Navigácia po obdobiach
- Najlacnejšie obdobie dňa — číslo obdobia (od 1) najlacnejšej hodiny v danom dni
- Najlacnejšie zostávajúce obdobie — najlacnejšia hodina od aktuálneho času ďalej
- Počet období — celkový počet dostupných cenových období (zvyčajne 96)
- Počet období v časovom okne — počet období v rozsahu From–To
Výmenný kurz meny
Zariadenie Výmenný kurz meny je jediné zariadenie na čítanie aj zápis v šablóne. Uchováva konverzný kurz EUR na CZK, ktorý používajú všetky cenové zariadenia. Nastavte ho manuálne alebo ho prepojte so šablónou Kurzy ČNB pre automatické denné aktualizácie.
Keď je výmenný kurz nastavený na 1, všetky cenové zariadenia zobrazujú surové hodnoty v EUR.
Servisné atribúty
Šablóna sprístupňuje 96 servisných atribútov (Obdobie 1 až Obdobie 96), z ktorých každý zobrazuje surovú spotovú cenu v EUR pre príslušný hodinový slot. Pokrývajú približne 4 dni dát z denného trhu a sú užitočné na diagnostiku alebo na vytváranie vlastných automatizácií, ktoré kontrolujú konkrétne budúce obdobia.
Prepojenie s kurzom ČNB
Na automatizáciu konverzie EUR na CZK:
- Importujte šablónu Kurzy ČNB do TapHome
- V šablóne OTE-CR vytvorte vzorec, ktorý číta kurz EUR/CZK zo zariadenia ČNB a zapisuje ho do zariadenia Výmenný kurz meny
- Šablóna ČNB aktualizuje kurz denne, takže všetky ceny OTE-CR automaticky odrážajú aktuálny výmenný kurz
Príklady automatizácie
Spotové ceny sú najužitočnejšie v kombinácii s TapHome smart rules:
- Ohrievanie vody počas najlacnejších hodín — porovnajte poradie aktuálneho obdobia s prahovou hodnotou (napr. poradie <= 4) a zapnite ohrievač vody len počas 4 najlacnejších hodín dňa
- Nabíjanie batérií mimo špičku — použite zariadenie Aktuálna cena na spustenie nabíjania batérie, keď cena klesne pod nastaviteľný limit
- Presun záťaže spotrebičov — použite zariadenie Najlacnejšie zostávajúce obdobie na naplánovanie práčok, umývačiek riadu alebo nabíjania EV na ďalší najlacnejší slot
- Optimalizácia časového okna — obmedzte automatizáciu na konkrétne hodiny (napr. 6:00–22:00) pomocou zariadení s časovým oknom, aby boli nočné obdobia vylúčené z poradia
Riešenie problémov
Všetky ceny zobrazujú nulu alebo NaN
- Overte, či má TapHome CCU prístup na internet (šablóna sa pripája k
www.ote-cr.czcez HTTPS) - Skontrolujte zariadenie Počet období — ak zobrazuje 0, odpoveď API je prázdna alebo parsovanie zlyhalo
- Uistite sa, že zariadenie Výmenný kurz meny je nastavené na nenulovú hodnotu — kurz 0 vynásobí všetky ceny na nulu
Zariadenia s časovým oknom vracajú NaN
- Overte, či sú parametre importu From a To nastavené správne (From musí byť menšie ako To)
- Ak je aktuálna hodina mimo rozsah From–To, zariadenie poradia v okne vracia NaN zámerne
Ceny sa zdajú zastarané
Šablóna dopytuje API OTE-CR každú hodinu (3600 sekúnd). Ceny denného trhu sú publikované OTE deň vopred, zvyčajne okolo 12:45 CET. Ak ceny nového dňa ešte nie sú viditeľné, počkajte do času publikácie.