--- title: "CNB CZK Výmenné kurzy" description: "Oficiálne denné kurzy ČNB pre 30 mien voči CZK z verejného API v TapHome, bez kľúča a registrácie. Každá mena ako senzor, aktualizácia raz za hodinu." url: "https://taphome.com/sk/compatibility/cnb-czk/" language: sk lastmod: 2026-10-08 generator: hugo ai: topics: ["http","data-service","exchange-rates","currency","cloud-api","packet-parser"] questions: ["Ako integrovať výmenné kurzy ČNB s TapHome?","Aké meny podporuje šablóna výmenných kurzov CNB CZK?","Ako automatizovať akcie na základe výmenných kurzov v TapHome?","Ako často sa aktualizujú kurzy ČNB?","Ako sledovať kurz EUR/CZK alebo USD/CZK v TapHome?"] --- # CNB CZK Výmenné kurzy Komunikácia: Packet Parser → HTTP - [Česká národná banka](https://www.cnb.cz/en/) ## Návod na integráciu Česká národná banka (ČNB) publikuje oficiálne výmenné kurzy CZK denne pre 30 zahraničných mien. Tieto kurzy sú oficiálne fixingové kurzy používané ako referencia v celom českom finančnom systéme. Šablóna TapHome načítava všetkých 30 výmenných kurzov z verejného REST API ČNB (`api.cnb.cz`) cez HTTP Packet Parser. Každá mena je vystavená ako samostatný senzor na čítanie, ktorý zobrazuje aktuálny kurz CZK. API je úplne verejné — nevyžaduje autentifikáciu, API kľúč ani registráciu. TapHome načítava kurzy raz za hodinu; ČNB vyhlasuje nové kurzy raz za pracovný deň okolo 14:30. ## Konfigurácia Šablóna sa pripája k `api.cnb.cz` cez HTTPS (port 443). Nie je potrebná žiadna IP adresa, prihlasovacie údaje ani API kľúč — koncový bod je plne verejné štátne API. Neexistujú žiadne používateľsky konfigurovateľné premenné. Jediná vlastná premenná (`responsejson`) je interná vyrovnávacia pamäť HTTP odpovede používaná skriptmi šablóny — nie je potrebné ju upravovať. ## Ako to funguje Modul odosiela jeden HTTP GET požiadavok raz za hodinu (interval dotazovania 3 600 000 ms): ``` GET /cnbapi/exrates/daily?date={today}&lang=CZ ``` Odpoveď je objekt JSON obsahujúci pole `rates[]` so všetkými 30 položkami mien. Každá položka obsahuje kód meny, názov krajiny, množstvo a kurz. Modul uloží celú JSON odpoveď do premennej `responsejson`. Každé zariadenie meny potom analyzuje svoj kurz z uloženej odpovede pomocou `PARSEJSON(responsejson, "$.rates[N].rate")`, kde N je fixný index poľa pre danú menu. Interval dotazovania zariadenia je 15 sekúnd, ale keďže všetky zariadenia čítajú z uloženej `responsejson`, medzi hodinovými obnoveniami sa nevykonávajú žiadne ďalšie volania API. > [!NOTE] > Šablóna používa `lang=CZ` v požiadavke na API. Je to kritické, pretože pole `rates[]` je zoradené abecedne podľa názvu krajiny vo vybranom jazyku. Zmena na `lang=EN` by vytvorila iné poradie a narušila všetky mapovania indexov poľa. ## Schopnosti zariadení Šablóna poskytuje 30 senzorov na čítanie, jeden pre každú menu. Všetky hodnoty sú v CZK. ### Hlavné meny Najčastejšie sledované kurzy zahŕňajú EUR (Euro), USD (Americký dolár), GBP (Britská libra), CHF (Švajčiarsky frank) a PLN (Poľský zlotý). Tieto sú kotované za 1 jednotku cudzej meny — napríklad kurz USD 21,315 znamená 1 USD = 21,315 CZK. ### Meny s viacnásobnou jednotkou Deväť mien používa kurzy za viacnásobné jednotky kvôli nízkej hodnote za jednotku CZK: | Mena | Množstvo | Význam | |------|----------|--------| | HUF (Maďarský forint) | 100 | Kurz za 100 HUF | | INR (Indická rupia) | 100 | Kurz za 100 INR | | ISK (Islandská koruna) | 100 | Kurz za 100 ISK | | JPY (Japonský jen) | 100 | Kurz za 100 JPY | | KRW (Juhokórejský won) | 100 | Kurz za 100 KRW | | PHP (Filipínske peso) | 100 | Kurz za 100 PHP | | THB (Thajský baht) | 100 | Kurz za 100 THB | | TRY (Turecká líra) | 100 | Kurz za 100 TRY | | IDR (Indonézska rupia) | 1000 | Kurz za 1000 IDR | Šablóna číta surovú hodnotu `rate` z API bez delenia hodnotou `amount`. Napríklad kurz JPY 13,328 v TapHome znamená 100 JPY = 13,328 CZK, nie 1 JPY = 13,328 CZK. ### Kompletný zoznam mien Všetkých 30 mien: 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 (Zvláštne práva čerpania MMF), ZAR. ## Príklady automatizácie ### Upozornenie pri prekročení prahu kurzu Použite senzor meny v podmienke smart rule na prijímanie upozornení, keď kurz prekročí prah: - Podmienka: Hodnota EUR prekročí 25,00 - Akcia: Odoslať push notifikáciu ### Prepínanie na základe kurzu Spustite akcie na základe pohybov výmenných kurzov — napríklad prepnite indikátory displeja alebo ovládajte výstupy, keď sledovaná mena dosiahne cieľový rozsah. ## Riešenie problémov ### Všetky zariadenia zobrazujú nulu alebo žiadne dáta 1. Skontrolujte internetové pripojenie TapHome Core — šablóna vyžaduje odchádzajúci prístup HTTPS na `api.cnb.cz` 2. Overte, že API odpovedá — otvorte `https://api.cnb.cz/cnbapi/exrates/daily?date=2026-03-28&lang=CZ` v prehliadači 3. Nové výmenné kurzy sa publikujú každý pracovný deň okolo 14:30 CET. Počas víkendov a sviatkov API vracia posledné platné kurzy ### Hodnoty sa zdajú nesprávne pre niektoré meny Skontrolujte tabuľku kurzov s viacnásobnou jednotkou vyššie. Meny ako JPY, HUF, KRW a IDR sú kotované za 100 alebo 1000 jednotiek, nie za 1 jednotku. Toto je štandardná konvencia ČNB, nie chyba šablóny. ### Dáta sa prestanú aktualizovať Šablóna dotazuje API raz za hodinu. Ak sa kurzy zdajú zastarané, overte, že TapHome Core má prístup na internet a že API ČNB je dostupné. API nemá zdokumentované limity požiadaviek, ale dlhodobé problémy s pripojením zabránia aktualizáciám. ## Dostupné zariadenia 30 Tieto zariadenia sa po importe zobrazia v TapHome. CNB CZK Výmenné kurzy Modul Vlastné premenné Čítanie (modul) ```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 ``` Austrálsky dolár (AUD) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[0].rate"); ``` Brazílsky real (BRL) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[1].rate"); ``` Kanadský dolár (CAD) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[13].rate"); ``` Čínsky jüan (CNY) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[2].rate"); ``` Dánska koruna (DKK) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[3].rate"); ``` Euro (EUR) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[4].rate"); ``` Britská libra (GBP) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[29].rate"); ``` Hongkonský dolár (HKD) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[6].rate"); ``` Maďarský forint (HUF) Premenná Len na čítanie Kurz za 100 HUF string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[15].rate"); ``` Švajčiarsky frank (CHF) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[25].rate"); ``` Indonézska rupia (IDR) Premenná Len na čítanie Kurz za 1000 IDR string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[8].rate"); ``` Izraelský šekel (ILS) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[10].rate"); ``` Indická rupia (INR) Premenná Len na čítanie Kurz za 100 INR string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[7].rate"); ``` Islandská koruna (ISK) Premenná Len na čítanie Kurz za 100 ISK string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[9].rate"); ``` Japonský jen (JPY) Premenná Len na čítanie Kurz za 100 JPY string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[11].rate"); ``` Juhokórejský won (KRW) Premenná Len na čítanie Kurz za 100 KRW string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[14].rate"); ``` Mexické peso (MXN) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[17].rate"); ``` Malajzijský ringgit (MYR) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[16].rate"); ``` Nórska koruna (NOK) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[19].rate"); ``` Novozélandský dolár (NZD) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[20].rate"); ``` Filipínske peso (PHP) Premenná Len na čítanie Kurz za 100 PHP string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[5].rate"); ``` Poľský zlotý (PLN) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[21].rate"); ``` Rumunský leu (RON) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[22].rate"); ``` Švédska koruna (SEK) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[24].rate"); ``` Singapurský dolár (SGD) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[23].rate"); ``` Thajský baht (THB) Premenná Len na čítanie Kurz za 100 THB string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[26].rate"); ``` Turecká líra (TRY) Premenná Len na čítanie Kurz za 100 TRY string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[27].rate"); ``` Americký dolár (USD) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[28].rate"); ``` MMF SDR (XDR) Premenná Len na čítanie Zvláštne práva čerpania MMF — kompozitné rezervné aktívum string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[18].rate"); ``` Juhoafrický rand (ZAR) Premenná Len na čítanie string Jednotka: CZK json\_path Čítanie ```taphome PARSEJSON(responsejson, "$.rates[12].rate"); ``` **Pripojenie:** Packet Parser → HTTP ## Zdroje - 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 ## Súvisiaca dokumentácia - [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)