OKTE (Organizátor krátkodobého trhu s elektrinou) è l’operatore del mercato elettrico slovacco. Pubblica i prezzi spot del mercato day-ahead (DAM) — il prezzo all’ingrosso orario dell’elettricità in EUR/MWh determinato dall’asta del giorno precedente.
Il template TapHome recupera questi prezzi dall’API pubblica OKTE (isot.okte.sk) tramite HTTP Packet Parser. Fornisce il prezzo dell’ora corrente, le classifiche dei prezzi, i calcoli min/max/media e l’analisi della finestra temporale — tutto aggiornato automaticamente ogni ora. Non è richiesta alcuna autenticazione.
Configurazione
Il template si connette a isot.okte.sk tramite HTTPS (porta 443). Non servono indirizzo IP o credenziali — l’endpoint è un’API pubblica.
Durante l’importazione del template, è possibile impostare due variabili personalizzate opzionali:
- Da — ora di inizio di una finestra temporale personalizzata (0–23, predefinito: 9)
- A — ora di fine di una finestra temporale personalizzata (0–23, predefinito: 17)
Queste variabili controllano le varianti dei dispositivi “nella finestra temporale”. I valori predefiniti (9–17) coprono l’orario lavorativo standard. Se non necessarie, lascia i valori predefiniti — i dispositivi per l’intera giornata funzionano indipendentemente.
Come funziona
Il modulo interroga l’API OKTE DAM una volta all’ora (intervallo di 3600 s). La richiesta API utilizza la data odierna:
| |
La risposta contiene un array di oggetti prezzo, ciascuno con un numero period e un price in EUR/MWh. A seconda dell’ora del giorno e del programma di pubblicazione OKTE, la risposta può includere prezzi solo per oggi (24 periodi) o per un massimo di 3 giorni (72 periodi).
Ogni script dispositivo analizza questo array JSON usando PARSEJSON(output, "$..price") e applica funzioni di ordinamento, filtraggio o aggregazione per derivare il proprio valore.
Capacità dei dispositivi
Il template espone 13 dispositivi sensore. Tutti sono in sola lettura — derivano i valori dalla stessa risposta API.
Prezzo attuale e classifica
- Prezzo attuale — il prezzo spot per il periodo orario corrente in EUR/MWh. Lo script determina l’indice del periodo corrente da
NOW()e restituisce il prezzo corrispondente dall’array. - Classifica del periodo attuale — la posizione del prezzo dell’ora corrente tra tutti i periodi disponibili (1 = più economico). Utile per regole di automazione come “attiva la pompa di calore solo quando l’ora corrente è tra le 8 più economiche.”
- Classifica del periodo attuale nella finestra temporale — come sopra, ma limitata alla finestra Da–A definita dall’utente. Restituisce NaN se l’ora corrente è fuori dalla finestra o se Da >= A.
Estremi di prezzo
- Prezzo più alto del giorno — prezzo spot massimo su tutti i periodi disponibili
- Prezzo più basso del giorno — prezzo spot minimo su tutti i periodi disponibili
- Prezzo più alto nella finestra temporale — prezzo massimo all’interno della finestra Da–A
- Prezzo più basso nella finestra temporale — prezzo minimo all’interno della finestra Da–A
Medie
- Prezzo medio del giorno — media aritmetica di tutti i prezzi dei periodi disponibili
- Prezzo medio nella finestra temporale — media aritmetica all’interno della finestra Da–A
Identificazione dei periodi
- Periodo più economico del giorno — il numero di periodo basato su 1 dell’ora più economica (es. 3 significa 02:00–03:00)
- Periodo rimanente più economico — l’ora più economica dall’ora corrente in poi. Si aggiorna dinamicamente durante la giornata.
Conteggi
- Conteggio periodi — numero totale di periodi di prezzo nella risposta API (tipicamente 24 o 72)
- Conteggio periodi nella finestra temporale — numero di periodi all’interno della finestra Da–A
Attributi del servizio
Il modulo espone fino a 96 attributi del servizio (Periodo 1 fino a Periodo 96), ciascuno mostra il prezzo spot per quello specifico periodo orario come stringa con suffisso “EUR”. In pratica, 24 attributi sono compilati per un singolo giorno o 72 per tre giorni.
Questi attributi forniscono un programma completo dei prezzi visibile nella vista dettagliata del modulo TapHome.
Variabili personalizzate (Da / A)
Diversi dispositivi hanno varianti “nella finestra temporale” che filtrano i dati dei prezzi su un sottoinsieme di ore. La finestra è definita da due variabili personalizzate impostate durante l’importazione del template:
- Da — l’ora di inizio (inclusa), valore 0–23
- A — l’ora di fine (esclusa), valore 0–23
Ad esempio, impostando Da=8 e A=16 si analizzano i prezzi solo tra le 08:00 e le 16:00. Questo è utile quando vuoi ottimizzare il consumo energetico durante ore specifiche — come far funzionare gli elettrodomestici solo durante le ore più economiche della tua giornata lavorativa.
Se Da >= A, tutti i dispositivi con finestra restituiscono NaN.
Esempi di automazione
Eseguire dispositivi durante le ore più economiche
Usa il dispositivo Classifica del periodo attuale in una condizione smart rule. Ad esempio, per far funzionare una pompa per piscina solo durante le 6 ore più economiche del giorno:
- Condizione: Classifica del periodo attuale <= 6
- Azione: Accendi pompa piscina
Evitare i prezzi di punta
Usa il dispositivo Prezzo attuale con una soglia:
- Condizione: Prezzo attuale > 150 (EUR/MWh)
- Azione: Spegni carichi non essenziali
Ottimizzazione della finestra temporale
Imposta Da=22, A=6 per definire una finestra notturna, poi usa Prezzo più basso nella finestra temporale o Classifica del periodo attuale nella finestra temporale per programmare la ricarica della batteria o il funzionamento dello scaldacqua durante le ore notturne più economiche.
Risoluzione dei problemi
Tutti i dispositivi mostrano zero o nessun dato
- Controlla la connettività internet su TapHome Core — il template richiede accesso HTTPS in uscita verso
isot.okte.sk - Verifica che l’API risponda — apri
https://isot.okte.sk/api/v1/dam/results?deliveryDayFrom=2026-03-28&deliveryDayTo=2026-03-28nel browser - I prezzi DAM per il giorno successivo vengono tipicamente pubblicati dopo le 12:45 CET. Prima della pubblicazione, le richieste per la data di domani restituiscono risultati vuoti.
I dispositivi con finestra restituiscono NaN
- Verifica che Da < A nei parametri di importazione del template
- Controlla che l’ora corrente rientri nell’intervallo Da–A (per la Classifica del periodo attuale nella finestra temporale)
- Ricorda che Da e A utilizzano il formato 24 ore (0–23)
I valori dei prezzi sembrano errati
OKTE pubblica i prezzi in EUR/MWh. Per convertire in EUR/kWh (scala domestica), dividi per 1000. Il template visualizza i valori grezzi dall’API senza conversione.