OTE-CR (Operátor trhu s elektřinou) è l’operatore del mercato elettrico e del gas ceco. Il template TapHome recupera i prezzi spot del mercato del giorno prima dall’API pubblica OTE-CR e li espone come dispositivi — prezzo corrente, statistiche giornaliere, classifiche e varianti con finestra temporale. I prezzi sono pubblicati in EUR per MWh e il template include una variabile integrata per la conversione valutaria per visualizzare i valori in CZK.
Il template interroga l’API OTE-CR una volta all’ora e recupera fino a 96 periodi di prezzo orari (4 giorni di dati). Non è richiesta alcuna autenticazione — l’endpoint API è pubblico.
Configurazione
Durante l’importazione del template, TapHome si connette a www.ote-cr.cz tramite HTTPS (porta 443). Non sono necessari indirizzo IP né credenziali — l’endpoint è fisso.
Due parametri di importazione opzionali controllano i dispositivi con finestra temporale:
- From — ora di inizio (0–23, predefinito: 9) per il filtro della finestra temporale
- To — ora di fine (0–23, predefinito: 17) per il filtro della finestra temporale
I valori predefiniti (9–17) coprono l’orario lavorativo standard. Regolali in base alla finestra di analisi preferita.
Dopo l’importazione, la variabile Tasso di cambio (kurz) è impostata di default su 1 — il che significa che tutti i dispositivi di prezzo visualizzano i valori grezzi in EUR/MWh. Impostala sul tasso EUR/CZK corrente (es. 25,2) in modo che tutti i dispositivi di prezzo visualizzino i valori in CZK. Puoi impostarla manualmente nel dettaglio del dispositivo oppure collegarla al template Tasso di cambio ČNB per aggiornamenti giornalieri automatici (vedi sotto).
Funzionalità dei dispositivi
Prezzo corrente
Il dispositivo Prezzo corrente legge il prezzo spot per l’ora corrente. Il template determina il periodo attivo dall’orologio di sistema e moltiplica il valore in EUR per il tasso di cambio per visualizzare il prezzo in CZK.
Classifica dei prezzi
- Classifica del periodo corrente — la posizione del prezzo dell’ora corrente tra tutti i periodi del giorno (1 = più economico, 24 = più costoso)
- Classifica del periodo corrente nella finestra temporale — la stessa classifica ma limitata alla finestra temporale definita dall’utente (From–To). Restituisce NaN se l’ora corrente è fuori dalla finestra.
Statistiche di prezzo giornaliere
- Prezzo più alto del giorno — prezzo spot massimo su tutti i periodi, convertito in CZK
- Prezzo più basso del giorno — prezzo spot minimo su tutti i periodi, convertito in CZK
- Prezzo medio del giorno — media aritmetica di tutti i periodi, convertita in CZK
Statistiche di prezzo nella finestra temporale
Ogni statistica giornaliera ha una controparte con finestra temporale che filtra i periodi nell’intervallo From–To:
- Prezzo più alto nella finestra temporale
- Prezzo più basso nella finestra temporale
- Prezzo medio nella finestra temporale
Tutti i dispositivi con finestra temporale restituiscono NaN se From >= To.
Navigazione dei periodi
- Periodo più economico del giorno — il numero di periodo (base 1) dell’ora più economica del giorno
- Periodo rimanente più economico — l’ora più economica dal momento corrente in poi
- Conteggio periodi — numero totale di periodi di prezzo disponibili (tipicamente 96)
- Conteggio periodi nella finestra temporale — numero di periodi nell’intervallo From–To
Tasso di cambio
Il dispositivo Tasso di cambio è l’unico dispositivo in lettura/scrittura nel template. Memorizza il tasso di conversione EUR-CZK utilizzato da tutti i dispositivi di prezzo. Impostalo manualmente o collegalo al template Tasso di cambio ČNB per aggiornamenti giornalieri automatici.
Quando il tasso di cambio è impostato su 1, tutti i dispositivi di prezzo visualizzano i valori grezzi in EUR.
Attributi di servizio
Il template espone 96 attributi di servizio (Periodo 1–Periodo 96), ciascuno mostrante il prezzo spot grezzo in EUR per il corrispondente slot orario. Questi coprono circa 4 giorni di dati del mercato del giorno prima e sono utili per la diagnostica o per la creazione di automazioni personalizzate che ispezionano periodi futuri specifici.
Collegamento con il tasso di cambio ČNB
Per automatizzare la conversione EUR-CZK:
- Importa il template Tasso di cambio ČNB (Kurzy ČNB) in TapHome
- Nel template OTE-CR, crea una formula che legge il tasso EUR/CZK dal dispositivo ČNB e lo scrive nel dispositivo Tasso di cambio
- Il template ČNB aggiorna il tasso giornalmente, così tutti i prezzi OTE-CR riflettono automaticamente il tasso di cambio corrente
Esempi di automazione
I prezzi spot sono più utili quando combinati con le smart rules di TapHome:
- Riscaldare l’acqua nelle ore più economiche — confronta la classifica del periodo corrente con una soglia (es. classifica <= 4) e accendi lo scaldacqua solo durante le 4 ore più economiche del giorno
- Caricare le batterie fuori picco — usa il dispositivo Prezzo corrente per attivare la carica della batteria quando il prezzo scende sotto un limite configurabile
- Spostare il carico degli elettrodomestici — usa il dispositivo Periodo rimanente più economico per programmare lavatrici, lavastoviglie o ricarica EV per il prossimo slot più economico
- Ottimizzazione della finestra temporale — limita l’automazione a ore specifiche (es. 6:00–22:00) utilizzando i dispositivi con finestra temporale, così i periodi notturni vengono esclusi dalla classifica
Risoluzione dei problemi
Tutti i prezzi mostrano zero o NaN
- Verifica che la TapHome CCU abbia accesso a internet (il template si connette a
www.ote-cr.cztramite HTTPS) - Controlla il dispositivo Conteggio periodi — se mostra 0, la risposta API è vuota o il parsing è fallito
- Assicurati che il dispositivo Tasso di cambio sia impostato su un valore diverso da zero — un tasso di 0 moltiplica tutti i prezzi a zero
I dispositivi con finestra temporale restituiscono NaN
- Verifica che i parametri di importazione From e To siano impostati correttamente (From deve essere minore di To)
- Se l’ora corrente è fuori dall’intervallo From–To, il dispositivo di classifica nella finestra restituisce NaN per design
I prezzi sembrano obsoleti
Il template interroga l’API OTE-CR ogni ora (3600 secondi). I prezzi del mercato del giorno prima vengono pubblicati da OTE il giorno precedente, tipicamente intorno alle 12:45 CET. Se i prezzi del nuovo giorno non sono ancora visibili, attendi il momento della pubblicazione.