--- title: "CNB CZK Tassi di cambio" description: "Tassi di cambio ufficiali della Banca Nazionale Ceca per 30 valute rispetto alla CZK." url: "https://taphome.com/it/compatibility/cnb-czk/" language: it lastmod: 2026-10-08 generator: hugo ai: topics: ["http","data-service","exchange-rates","currency","cloud-api","packet-parser"] questions: ["Come integrare i tassi di cambio CNB con TapHome?","Quali valute supporta il template CNB CZK?","Come automatizzare azioni basate sui tassi di cambio in TapHome?","Con quale frequenza vengono aggiornati i tassi CNB?","Come monitorare il tasso EUR/CZK o USD/CZK in TapHome?"] --- # CNB CZK Tassi di cambio Comunicazione: Packet Parser → HTTP - [Banca Nazionale Ceca](https://www.cnb.cz/en/) ## Guida all'integrazione 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. TapHome recupera i tassi una volta all'ora; la CNB pubblica nuovi tassi una volta per giorno lavorativo intorno alle 14:30. ## 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): ``` 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. > [!NOTE] > 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 Nove valute utilizzano tassi a unità multipla a causa del loro basso valore CZK per unità: | Valuta | Quantità | Significato | |--------|----------|-------------| | HUF (Fiorino ungherese) | 100 | Tasso per 100 HUF | | INR (Rupia indiana) | 100 | Tasso per 100 INR | | ISK (Corona islandese) | 100 | Tasso per 100 ISK | | JPY (Yen giapponese) | 100 | Tasso per 100 JPY | | KRW (Won sudcoreano) | 100 | Tasso per 100 KRW | | PHP (Peso filippino) | 100 | Tasso per 100 PHP | | THB (Baht thailandese) | 100 | Tasso per 100 THB | | TRY (Lira turca) | 100 | Tasso per 100 TRY | | IDR (Rupia indonesiana) | 1000 | Tasso 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 30 Questi dispositivi compaiono in TapHome dopo l'importazione. CNB CZK Tassi di Cambio Modulo Variabili personalizzate Lettura (modulo) ```taphome 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 Lettura ```taphome PARSEJSON(responsejson, "$.rates[0].rate"); ``` Real brasiliano (BRL) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[1].rate"); ``` Dollaro canadese (CAD) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[13].rate"); ``` Renminbi cinese (CNY) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[2].rate"); ``` Corona danese (DKK) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[3].rate"); ``` Euro (EUR) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[4].rate"); ``` Sterlina britannica (GBP) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[29].rate"); ``` Dollaro di Hong Kong (HKD) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[6].rate"); ``` Fiorino ungherese (HUF) Variabile Solo lettura Tasso per 100 HUF string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[15].rate"); ``` Franco svizzero (CHF) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[25].rate"); ``` Rupia indonesiana (IDR) Variabile Solo lettura Tasso per 1000 IDR string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[8].rate"); ``` Shekel israeliano (ILS) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[10].rate"); ``` Rupia indiana (INR) Variabile Solo lettura Tasso per 100 INR string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[7].rate"); ``` Corona islandese (ISK) Variabile Solo lettura Tasso per 100 ISK string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[9].rate"); ``` Yen giapponese (JPY) Variabile Solo lettura Tasso per 100 JPY string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[11].rate"); ``` Won sudcoreano (KRW) Variabile Solo lettura Tasso per 100 KRW string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[14].rate"); ``` Peso messicano (MXN) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[17].rate"); ``` Ringgit malese (MYR) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[16].rate"); ``` Corona norvegese (NOK) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[19].rate"); ``` Dollaro neozelandese (NZD) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[20].rate"); ``` Peso filippino (PHP) Variabile Solo lettura Tasso per 100 PHP string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[5].rate"); ``` Zloty polacco (PLN) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[21].rate"); ``` Leu rumeno (RON) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[22].rate"); ``` Corona svedese (SEK) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[24].rate"); ``` Dollaro di Singapore (SGD) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[23].rate"); ``` Baht thailandese (THB) Variabile Solo lettura Tasso per 100 THB string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[26].rate"); ``` Lira turca (TRY) Variabile Solo lettura Tasso per 100 TRY string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[27].rate"); ``` Dollaro USA (USD) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome 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 Lettura ```taphome PARSEJSON(responsejson, "$.rates[18].rate"); ``` Rand sudafricano (ZAR) Variabile Solo lettura string Unità: CZK json\_path Lettura ```taphome PARSEJSON(responsejson, "$.rates[12].rate"); ``` **Connessione:** Packet Parser → HTTP ## Fonti - CNB API — OpenAPI Specification [api.cnb.cz](https://api.cnb.cz/cnbapi/api-docs) 2026-03-28 - CNB Exchange Rate Format & Currency List [www.cnb.cz](https://www.cnb.cz/en/faq/Format-of-the-foreign-exchange-market-rates/) 2026-03-28 ## Documentazione correlata - [Integrazione Packet Parser](https://taphome.com/it/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/) - [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/) - [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/)