
OKTE (Organizátor krátkodobého trhu s elektrinou, operatorul pieței de energie electrică pe termen scurt) este operatorul pieței de energie electrică din Slovacia. Publică prețurile spot ale pieței pentru ziua următoare (DAM) — prețul angro orar al energiei electrice în EUR/MWh, stabilit prin licitația din ziua precedentă.
Șablonul TapHome preia aceste prețuri din API-ul public OKTE (isot.okte.sk) prin HTTP Packet Parser. Oferă prețul orei curente, clasamentele prețurilor, calculul minimului/maximului/mediei și analiza unui interval orar — toate actualizate automat în fiecare oră. Nu este necesară autentificarea.
Configurare
Șablonul se conectează la isot.okte.sk prin HTTPS (portul 443). Nu sunt necesare adresa IP sau date de autentificare — endpointul este un API public.
La importul șablonului se pot seta două variabile personalizate opționale:
- From — ora de început a unui interval orar personalizat (0–23, implicit: 9)
- To — ora de sfârșit a unui interval orar personalizat (0–23, implicit: 17)
Aceste variabile controlează variantele de dispozitive „în intervalul orar”. Valorile implicite (9–17) acoperă programul de lucru obișnuit. Dacă nu aveți nevoie de ele, lăsați valorile implicite — dispozitivele pentru întreaga zi funcționează independent.
Cum funcționează
Modulul interoghează API-ul OKTE DAM o dată pe oră (interval de 3600 s). Cererea API folosește data de azi:
| |
Răspunsul conține un tablou de obiecte de preț, fiecare cu un număr period și un price în EUR/MWh. În funcție de ora din zi și de programul de publicare OKTE, răspunsul poate include prețuri doar pentru ziua de azi (24 de perioade) sau pentru până la 3 zile (72 de perioade).
Scriptul fiecărui dispozitiv analizează acest tablou JSON cu PARSEJSON(output, "$..price") și aplică funcții de sortare, filtrare sau agregare pentru a obține valoarea sa.
Funcțiile dispozitivului
Șablonul expune 13 dispozitive de tip senzor. Toate sunt doar pentru citire — își obțin valorile din același răspuns API.
Prețul curent și clasamentul
- Preț curent — prețul spot pentru perioada orară curentă, în EUR/MWh. Scriptul determină indexul perioadei curente din
NOW()și returnează prețul corespunzător din tablou. - Poziția perioadei curente — locul prețului orei curente între toate perioadele disponibile (1 = cea mai ieftină). Util pentru smart rules de tipul „pompa de căldură funcționează doar când ora curentă este între cele mai ieftine 8”.
- Poziția perioadei curente în intervalul orar — la fel ca mai sus, dar limitat la intervalul From–To definit de utilizator. Returnează NaN dacă ora curentă este în afara intervalului sau dacă From >= To.
Prețurile extreme
- Cel mai mare preț al zilei — prețul spot maxim din toate perioadele disponibile
- Cel mai mic preț al zilei — prețul spot minim din toate perioadele disponibile
- Cel mai mare preț în intervalul orar — prețul maxim din intervalul From–To
- Cel mai mic preț în intervalul orar — prețul minim din intervalul From–To
Mediile
- Prețul mediu al zilei — media aritmetică a prețurilor tuturor perioadelor disponibile
- Prețul mediu în intervalul orar — media aritmetică în intervalul From–To
Identificarea perioadelor
- Cea mai ieftină perioadă a zilei — numărul perioadei (numerotat de la 1) al celei mai ieftine ore (de ex. 3 înseamnă 02:00–03:00)
- Cea mai ieftină perioadă rămasă — cea mai ieftină oră începând cu ora curentă. Se actualizează dinamic pe parcursul zilei.
Numărul de perioade
- Număr de perioade — numărul total de perioade de preț din răspunsul API (de obicei 24 sau 72)
- Număr de perioade în intervalul orar — numărul perioadelor din intervalul From–To
Atribute de service
Modulul expune până la 96 de atribute de service (de la Perioada 1 la Perioada 96), fiecare afișând prețul spot pentru perioada de 15 minute respectivă, ca text cu sufixul „EUR”. De când OKTE a trecut piața pentru ziua următoare la perioade de 15 minute, pentru o singură zi sunt completate toate cele 96 de atribute.
Aceste atribute oferă programul complet al prețurilor, vizibil în detaliul modulului din TapHome.
Variabile personalizate (From / To)
Mai multe dispozitive au variante „în intervalul orar”, care filtrează datele de preț la un subset de ore. Intervalul este definit de două variabile personalizate setate la importul șablonului:
- From — ora de început (inclusiv), valoare 0–23
- To — ora de sfârșit (exclusiv), valoare 0–23
De exemplu, setarea From=8 și To=16 analizează prețurile doar între 08:00 și 16:00. Este util când doriți să optimizați consumul de energie în anumite ore — de exemplu, să porniți aparatele doar în cele mai ieftine ore ale zilei de lucru.
Dacă From >= To, toate dispozitivele pentru interval returnează NaN.
Exemple de automatizare
Pornirea dispozitivelor în cele mai ieftine ore
Folosiți dispozitivul Poziția perioadei curente într-o condiție a unui smart rule. De exemplu, pentru a porni pompa piscinei doar în cele mai ieftine 6 ore ale zilei:
- Condiție: Poziția perioadei curente <= 6
- Acțiune: pornirea pompei piscinei
Evitarea prețurilor de vârf
Folosiți dispozitivul Preț curent cu un prag:
- Condiție: Preț curent > 150 (EUR/MWh)
- Acțiune: oprirea consumatorilor neesențiali
Optimizarea pe interval orar
Setați From=0, To=6 pentru a defini un interval de noapte (de la miezul nopții până la 06:00), apoi folosiți Cel mai mic preț în intervalul orar sau Poziția perioadei curente în intervalul orar pentru a programa încărcarea bateriei sau funcționarea boilerului în cele mai ieftine ore din timpul nopții. Intervalele care trec peste miezul nopții (From >= To) nu sunt acceptate.
Rezolvarea problemelor
Toate dispozitivele afișează zero sau nu au date
- Verificați conexiunea la internet a TapHome Core — șablonul necesită acces HTTPS de ieșire la
isot.okte.sk - Verificați dacă API-ul răspunde — deschideți în browser
https://isot.okte.sk/api/v1/dam/results?deliveryDayFrom=2026-03-28&deliveryDayTo=2026-03-28 - Prețurile DAM pentru ziua următoare se publică de obicei după ora 12:45 CET. Înainte de publicare, cererile pentru data de mâine returnează rezultate goale.
Dispozitivele pentru interval returnează NaN
- Verificați că From < To în parametrii de import ai șablonului
- Verificați dacă ora curentă se încadrează în intervalul From–To (pentru Poziția perioadei curente în intervalul orar)
- Rețineți că From și To folosesc formatul de 24 de ore (0–23)
Valorile prețurilor par incorecte
OKTE publică prețurile în EUR/MWh. Pentru conversia în EUR/kWh (unitatea uzuală la consumul casnic), împărțiți la 1000. Șablonul afișează valorile brute din API, fără conversie.