TapHome

CNB CZK Tassi di cambio

Packet Parser → HTTP
Inviato da
Ultimo aggiornamento: 03. 2026

La Banca Nazionale Ceca (ČNB) pubblica quotidianamente i tassi di cambio ufficiali CZK per 30 valute estere. Questi tassi sono i tassi di fixing ufficiali utilizzati come riferimento nell’intero sistema finanziario ceco.

Il template TapHome recupera tutti i 30 tassi di cambio dall’API REST pubblica CNB (api.cnb.cz) tramite HTTP Packet Parser. Ogni valuta è esposta come sensore separato in sola lettura che mostra il tasso CZK corrente. L’API è completamente pubblica — non è richiesta autenticazione, chiave API o registrazione. I tassi vengono aggiornati ogni ora.

Configurazione

Il template si connette a api.cnb.cz tramite HTTPS (porta 443). Non sono necessari indirizzo IP, credenziali o chiave API — l’endpoint è un’API governativa completamente pubblica.

Non ci sono variabili configurabili dall’utente. L’unica variabile personalizzata (responsejson) è una cache interna della risposta HTTP utilizzata dagli script del template — non necessita di modifiche.

Come funziona

Il modulo invia una singola richiesta HTTP GET una volta all’ora (intervallo di polling 3.600.000 ms):

1

GET /cnbapi/exrates/daily?date={today}&lang=CZ

La risposta è un oggetto JSON contenente un array rates[] con tutte le 30 voci valutarie. Ogni voce include il codice valuta, il nome del paese, la quantità e il tasso. Il modulo memorizza l’intera risposta JSON nella variabile responsejson.

Ogni dispositivo valutario analizza il proprio tasso dalla risposta memorizzata utilizzando PARSEJSON(responsejson, "$.rates[N].rate"), dove N è l’indice fisso dell’array per quella valuta. L’intervallo di polling del dispositivo è 15 secondi, ma poiché tutti i dispositivi leggono dal responsejson memorizzato, non vengono effettuate chiamate API aggiuntive tra gli aggiornamenti orari.

Il template utilizza lang=CZ nella richiesta API. Questo è fondamentale perché l’array rates[] è ordinato alfabeticamente per nome del paese nella lingua selezionata. Cambiare a lang=EN produrrebbe un ordine diverso e invaliderebbe tutte le mappature degli indici dell’array.

Funzionalità dei dispositivi

Il template fornisce 30 dispositivi sensore in sola lettura, uno per ogni valuta. Tutti i valori sono in CZK.

Valute principali

I tassi più comunemente monitorati includono EUR (Euro), USD (Dollaro USA), GBP (Sterlina britannica), CHF (Franco svizzero) e PLN (Zloty polacco). Questi sono quotati per 1 unità di valuta estera — ad esempio, un tasso USD di 21,315 significa 1 USD = 21,315 CZK.

Valute a unità multipla

Otto valute utilizzano tassi a unità multipla a causa del loro basso valore CZK per unità:

ValutaQuantitàSignificato
HUF (Fiorino ungherese)100Tasso per 100 HUF
INR (Rupia indiana)100Tasso per 100 INR
ISK (Corona islandese)100Tasso per 100 ISK
JPY (Yen giapponese)100Tasso per 100 JPY
KRW (Won sudcoreano)100Tasso per 100 KRW
PHP (Peso filippino)100Tasso per 100 PHP
THB (Baht thailandese)100Tasso per 100 THB
TRY (Lira turca)100Tasso per 100 TRY
IDR (Rupia indonesiana)1000Tasso per 1000 IDR

Il template legge il valore rate grezzo dall’API senza dividere per la amount. Ad esempio, un tasso JPY di 13,328 in TapHome significa 100 JPY = 13,328 CZK, non 1 JPY = 13,328 CZK.

Lista completa delle valute

Tutte le 30 valute: AUD, BRL, CAD, CHF, CNY, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, XDR (Diritti Speciali di Prelievo FMI), ZAR.

Esempi di automazione

Notifica al superamento di una soglia

Utilizza un sensore valutario in una condizione di smart rule per ricevere notifiche quando un tasso supera una soglia:

  • Condizione: il valore EUR supera 25,00
  • Azione: invio notifica push
Commutazione basata sul tasso

Attiva azioni in base ai movimenti dei tassi di cambio — ad esempio, commuta indicatori di visualizzazione o controlla uscite quando una valuta monitorata raggiunge un intervallo target.

Risoluzione dei problemi

Tutti i dispositivi mostrano zero o nessun dato
  1. Verifica la connettività Internet del TapHome Core — il template richiede accesso HTTPS in uscita verso api.cnb.cz
  2. Verifica che l’API risponda — apri https://api.cnb.cz/cnbapi/exrates/daily?date=2026-03-28&lang=CZ nel browser
  3. I nuovi tassi di cambio vengono pubblicati ogni giorno lavorativo intorno alle 14:30 CET. Nei fine settimana e nei giorni festivi, l’API restituisce gli ultimi tassi validi
I valori sembrano errati per alcune valute

Controlla la tabella dei tassi a unità multipla sopra. Valute come JPY, HUF, KRW e IDR sono quotate per 100 o 1000 unità, non per 1 unità. Questa è la convenzione standard della ČNB, non un errore del template.

I dati smettono di aggiornarsi

Il template interroga l’API una volta all’ora. Se i tassi sembrano obsoleti, verifica che il TapHome Core abbia accesso a Internet e che l’API CNB sia raggiungibile. L’API non ha limiti di richieste documentati, ma problemi di connettività prolungati impediranno gli aggiornamenti.

Dispositivi disponibili

CNB CZK Tassi di Cambio Modulo
Variabili personalizzate

Kurzy ČNB

Lettura (modulo)
VAR today := tostring(NOW(), "yyyy-MM-dd");
VAR response := SENDHTTPREQUEST("/cnbapi/exrates/daily?date=" + today + "&lang=CZ");
IF response.IsSuccess
    responsejson := response.Content;
ELSE
    ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Dollaro australiano (AUD) Variabile Solo lettura
string Unità: CZK json_path

Dollaro australiano (AUD)

Lettura
PARSEJSON(responsejson, "$.rates[0].rate");
Real brasiliano (BRL) Variabile Solo lettura
string Unità: CZK json_path

Real brasiliano (BRL)

Lettura
PARSEJSON(responsejson, "$.rates[1].rate");
Dollaro canadese (CAD) Variabile Solo lettura
string Unità: CZK json_path

Dollaro canadese (CAD)

Lettura
PARSEJSON(responsejson, "$.rates[13].rate");
Renminbi cinese (CNY) Variabile Solo lettura
string Unità: CZK json_path

Renminbi cinese (CNY)

Lettura
PARSEJSON(responsejson, "$.rates[2].rate");
Corona danese (DKK) Variabile Solo lettura
string Unità: CZK json_path

Corona danese (DKK)

Lettura
PARSEJSON(responsejson, "$.rates[3].rate");
Euro (EUR) Variabile Solo lettura
string Unità: CZK json_path

Euro (EUR)

Lettura
PARSEJSON(responsejson, "$.rates[4].rate");
Sterlina britannica (GBP) Variabile Solo lettura
string Unità: CZK json_path

Sterlina britannica (GBP)

Lettura
PARSEJSON(responsejson, "$.rates[29].rate");
Dollaro di Hong Kong (HKD) Variabile Solo lettura
string Unità: CZK json_path

Dollaro di Hong Kong (HKD)

Lettura
PARSEJSON(responsejson, "$.rates[6].rate");
Fiorino ungherese (HUF) Variabile Solo lettura

Tasso per 100 HUF

string Unità: CZK json_path

Fiorino ungherese (HUF)

Lettura
PARSEJSON(responsejson, "$.rates[15].rate");
Franco svizzero (CHF) Variabile Solo lettura
string Unità: CZK json_path

Franco svizzero (CHF)

Lettura
PARSEJSON(responsejson, "$.rates[25].rate");
Rupia indonesiana (IDR) Variabile Solo lettura

Tasso per 1000 IDR

string Unità: CZK json_path

Rupia indonesiana (IDR)

Lettura
PARSEJSON(responsejson, "$.rates[8].rate");
Shekel israeliano (ILS) Variabile Solo lettura
string Unità: CZK json_path

Shekel israeliano (ILS)

Lettura
PARSEJSON(responsejson, "$.rates[10].rate");
Rupia indiana (INR) Variabile Solo lettura

Tasso per 100 INR

string Unità: CZK json_path

Rupia indiana (INR)

Lettura
PARSEJSON(responsejson, "$.rates[7].rate");
Corona islandese (ISK) Variabile Solo lettura

Tasso per 100 ISK

string Unità: CZK json_path

Corona islandese (ISK)

Lettura
PARSEJSON(responsejson, "$.rates[9].rate");
Yen giapponese (JPY) Variabile Solo lettura

Tasso per 100 JPY

string Unità: CZK json_path

Yen giapponese (JPY)

Lettura
PARSEJSON(responsejson, "$.rates[11].rate");
Won sudcoreano (KRW) Variabile Solo lettura

Tasso per 100 KRW

string Unità: CZK json_path

Won sudcoreano (KRW)

Lettura
PARSEJSON(responsejson, "$.rates[14].rate");
Peso messicano (MXN) Variabile Solo lettura
string Unità: CZK json_path

Peso messicano (MXN)

Lettura
PARSEJSON(responsejson, "$.rates[17].rate");
Ringgit malese (MYR) Variabile Solo lettura
string Unità: CZK json_path

Ringgit malese (MYR)

Lettura
PARSEJSON(responsejson, "$.rates[16].rate");
Corona norvegese (NOK) Variabile Solo lettura
string Unità: CZK json_path

Corona norvegese (NOK)

Lettura
PARSEJSON(responsejson, "$.rates[19].rate");
Dollaro neozelandese (NZD) Variabile Solo lettura
string Unità: CZK json_path

Dollaro neozelandese (NZD)

Lettura
PARSEJSON(responsejson, "$.rates[20].rate");
Peso filippino (PHP) Variabile Solo lettura

Tasso per 100 PHP

string Unità: CZK json_path

Peso filippino (PHP)

Lettura
PARSEJSON(responsejson, "$.rates[5].rate");
Zloty polacco (PLN) Variabile Solo lettura
string Unità: CZK json_path

Zloty polacco (PLN)

Lettura
PARSEJSON(responsejson, "$.rates[21].rate");
Leu rumeno (RON) Variabile Solo lettura
string Unità: CZK json_path

Leu rumeno (RON)

Lettura
PARSEJSON(responsejson, "$.rates[22].rate");
Corona svedese (SEK) Variabile Solo lettura
string Unità: CZK json_path

Corona svedese (SEK)

Lettura
PARSEJSON(responsejson, "$.rates[24].rate");
Dollaro di Singapore (SGD) Variabile Solo lettura
string Unità: CZK json_path

Dollaro di Singapore (SGD)

Lettura
PARSEJSON(responsejson, "$.rates[23].rate");
Baht thailandese (THB) Variabile Solo lettura

Tasso per 100 THB

string Unità: CZK json_path

Baht thailandese (THB)

Lettura
PARSEJSON(responsejson, "$.rates[26].rate");
Lira turca (TRY) Variabile Solo lettura

Tasso per 100 TRY

string Unità: CZK json_path

Lira turca (TRY)

Lettura
PARSEJSON(responsejson, "$.rates[27].rate");
Dollaro USA (USD) Variabile Solo lettura
string Unità: CZK json_path

Dollaro USA (USD)

Lettura
PARSEJSON(responsejson, "$.rates[28].rate");
DSP FMI (XDR) Variabile Solo lettura

Diritti Speciali di Prelievo FMI — attività di riserva composita

string Unità: CZK json_path

DSP FMI (XDR)

Lettura
PARSEJSON(responsejson, "$.rates[18].rate");
Rand sudafricano (ZAR) Variabile Solo lettura
string Unità: CZK json_path

Rand sudafricano (ZAR)

Lettura
PARSEJSON(responsejson, "$.rates[12].rate");
Connessione: Packet Parser → HTTP

Fonti

  • CNB API — OpenAPI Specification
    api.cnb.cz 2026-03-28
  • CNB Exchange Rate Format & Currency List
    www.cnb.cz 2026-03-28