
OTE-CR (Operátor trhu s elektřinou) este operatorul pieței de energie electrică și gaze naturale din Cehia. Șablonul TapHome preia prețurile spot de pe piața pentru ziua următoare (Day-Ahead Market) din API-ul public OTE-CR și le pune la dispoziție ca dispozitive — prețul curent, statistici zilnice, clasamentul și variante pentru un interval de timp. Prețurile se publică în EUR pe MWh, iar șablonul include o variabilă încorporată pentru conversia valutară, pentru afișarea valorilor în CZK.
Șablonul interoghează API-ul OTE-CR o dată pe oră și preia prețurile pentru până la 96 de perioade orare (datele pentru 4 zile). Nu este necesară autentificarea — endpointul API este public.
Configurare
La importul șablonului, TapHome se conectează la www.ote-cr.cz prin HTTPS (portul 443). Nu sunt necesare adresa IP sau date de autentificare — endpointul este fix.
Doi parametri opționali de import controlează dispozitivele pentru intervalul de timp:
- From — ora de început (0–23, implicit: 9) pentru filtrul intervalului de timp
- To — ora de sfârșit (0–23, implicit: 17) pentru filtrul intervalului de timp
Valorile implicite (9–17) acoperă programul de lucru obișnuit. Ajustați-le după intervalul pe care doriți să îl analizați.
După import, variabila kurz (afișată și editabilă prin dispozitivul Curs de schimb valutar) are implicit valoarea 1 — adică toate dispozitivele de preț afișează valorile brute în EUR/MWh. Setați-o la cursul EUR/CZK curent (de ex. 25,2), astfel încât toate dispozitivele de preț să afișeze valorile în CZK. O puteți seta manual în detaliile dispozitivului sau o puteți lega de șablonul Cursuri de schimb CNB CZK pentru actualizarea automată zilnică (consultați mai jos).
Funcțiile dispozitivului
Prețul curent
Dispozitivul Preț curent citește prețul spot pentru ora curentă. Șablonul determină perioada activă după ceasul sistemului și înmulțește valoarea în EUR cu variabila cursului de schimb, pentru a returna prețul în CZK.
Clasamentul prețurilor
- Poziția perioadei curente — poziția prețului orei curente între toate perioadele zilei (1 = cea mai ieftină, 24 = cea mai scumpă)
- Poziția perioadei curente în intervalul de timp — același clasament, dar limitat la intervalul de timp definit de utilizator (From–To). Returnează NaN dacă ora curentă este în afara intervalului.
Statistici zilnice ale prețurilor
- Cel mai mare preț al zilei — prețul spot maxim din toate perioadele, convertit în CZK
- Cel mai mic preț al zilei — prețul spot minim din toate perioadele, convertit în CZK
- Prețul mediu al zilei — media aritmetică a prețurilor tuturor perioadelor, convertită în CZK
Statistici ale prețurilor în intervalul de timp
Fiecare statistică zilnică are un echivalent pentru intervalul de timp, care selectează doar perioadele din intervalul From–To:
- Cel mai mare preț în intervalul de timp
- Cel mai mic preț în intervalul de timp
- Prețul mediu în intervalul de timp
Toate dispozitivele pentru intervalul de timp returnează NaN dacă From >= To.
Navigarea între perioade
- Cea mai ieftină perioadă a zilei — numărul perioadei care corespunde celei mai ieftine ore din zi (numerotarea începe de la 1)
- Cea mai ieftină perioadă rămasă — cea mai ieftină oră începând de la momentul curent
- Număr de perioade — numărul total de perioade de preț disponibile (de obicei 96)
- Număr de perioade în intervalul de timp — numărul de perioade din intervalul From–To
Curs de schimb valutar
Dispozitivul Curs de schimb valutar este singurul dispozitiv cu citire/scriere din șablon. Stochează cursul de conversie EUR în CZK folosit de toate dispozitivele de preț. Setați-l manual sau legați-l de șablonul Cursuri de schimb CNB CZK pentru actualizarea automată zilnică.
Când cursul de schimb este setat la 1, toate dispozitivele de preț afișează valorile brute în EUR.
Atribute de service
Șablonul pune la dispoziție 96 de atribute de service (de la Perioada 1 până la Perioada 96), fiecare afișând prețul spot brut în EUR pentru intervalul orar corespunzător. Acestea acoperă aproximativ 4 zile de date de pe piața pentru ziua următoare și sunt utile pentru diagnosticare sau pentru crearea de automatizări personalizate care verifică anumite perioade viitoare.
Legarea cu cursul de schimb CNB
Pentru automatizarea conversiei din EUR în CZK:
- Importați în TapHome șablonul Cursuri de schimb CNB CZK (Kurzy ČNB)
- În șablonul OTE-CR, creați o formulă care citește cursul EUR/CZK din dispozitivul CNB și îl scrie în dispozitivul Curs de schimb valutar
- Șablonul CNB actualizează cursul zilnic, astfel că toate prețurile OTE-CR reflectă automat cursul de schimb curent
Exemple de automatizare
Prețurile spot sunt cele mai utile în combinație cu smart rules TapHome:
- Încălzirea apei în cele mai ieftine ore — comparați poziția perioadei curente cu un prag (de ex. poziția <= 4) și porniți boilerul doar în cele mai ieftine 4 ore din zi
- Încărcarea bateriilor în afara orelor de vârf — folosiți dispozitivul Preț curent pentru a porni încărcarea bateriilor când prețul scade sub o limită configurabilă
- Mutarea consumului aparatelor — folosiți dispozitivul Cea mai ieftină perioadă rămasă pentru a programa mașina de spălat rufe, mașina de spălat vase sau încărcarea vehiculului electric în următorul cel mai ieftin interval
- Optimizare pe interval de timp — limitați automatizarea la anumite ore (de ex. 6:00–22:00) cu ajutorul dispozitivelor pentru intervalul de timp, astfel încât perioadele de noapte să fie excluse din clasament
Rezolvarea problemelor
Toate prețurile arată zero sau NaN
- Verificați dacă unitatea centrală TapHome (CCU) are acces la internet (șablonul se conectează la
www.ote-cr.czprin HTTPS) - Verificați dispozitivul Număr de perioade — dacă arată 0, răspunsul API este gol sau procesarea a eșuat
- Asigurați-vă că dispozitivul Curs de schimb valutar are o valoare diferită de zero — la un curs de 0, toate prețurile devin zero după înmulțire
Dispozitivele pentru intervalul de timp returnează NaN
- Verificați dacă parametrii de import From și To sunt setați corect (From trebuie să fie mai mic decât To)
- Dacă ora curentă este în afara intervalului From–To, dispozitivul pentru poziția în interval returnează NaN în mod intenționat
Prețurile par neactualizate
Șablonul interoghează API-ul OTE-CR în fiecare oră (3600 de secunde). Prețurile de pe piața pentru ziua următoare sunt publicate de OTE cu o zi înainte, de obicei în jurul orei 12:45 CET. Dacă prețurile pentru ziua nouă nu sunt încă vizibile, așteptați până după ora publicării.