TapHome

CNB CZK Exchange Rates

Packet Parser → HTTP
Trimis de
Ultima actualizare: 10. 2026
CNB CZK Exchange Rates

Banca Națională Cehă (CNB) publică zilnic cursurile de schimb oficiale ale coroanei cehe (CZK) pentru 30 de valute străine. Acestea sunt cursurile oficiale de fixing, folosite ca referință în întregul sistem financiar ceh.

Șablonul TapHome preia toate cele 30 de cursuri de schimb din API-ul REST public al CNB (api.cnb.cz) prin HTTP Packet Parser. Fiecare valută este disponibilă ca senzor separat, numai pentru citire, care afișează cursul său curent în CZK. API-ul este complet public — nu sunt necesare autentificare, cheie API sau înregistrare. TapHome preia cursurile o dată pe oră; CNB publică noi cursuri o dată pe zi lucrătoare, în jurul orei 14:30.

Configurare

Șablonul se conectează la api.cnb.cz prin HTTPS (portul 443). Nu sunt necesare adresă IP, date de autentificare sau cheie API — endpointul este un API guvernamental complet public.

Nu există variabile configurabile de utilizator. Singura variabilă personalizată (responsejson) este un cache intern pentru răspunsul HTTP, folosit de scripturile șablonului — nu este necesar să o modificați.

Cum funcționează

Modulul trimite o singură cerere HTTP GET o dată pe oră (interval de interogare de 3 600 000 ms):

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

Răspunsul este un obiect JSON care conține un tablou rates[] cu toate cele 30 de valute. Fiecare intrare include codul valutei, numele țării, cantitatea și cursul. Modulul stochează întregul răspuns JSON în variabila responsejson.

Fiecare senzor de valută își extrage apoi cursul din răspunsul stocat, cu PARSEJSON(responsejson, "$.rates[N].rate"), unde N este indexul fix din tablou pentru valuta respectivă. Intervalul de interogare al dispozitivelor este de 15 secunde, dar deoarece toate dispozitivele citesc din variabila responsejson stocată, între actualizările orare nu se fac apeluri API suplimentare.

Șablonul folosește lang=CZ în cererea API. Acest lucru este esențial, deoarece tabloul rates[] este sortat alfabetic după numele țării în limba selectată. Trecerea la lang=EN ar produce o altă ordine de sortare, iar indexurile fixe din tablou nu ar mai corespunde valutelor corecte.

Funcțiile dispozitivului

Șablonul oferă 30 de senzori numai pentru citire, câte unul pentru fiecare valută. Toate valorile sunt în CZK.

Valute principale

Cele mai urmărite cursuri sunt EUR (euro), USD (dolar american), GBP (liră sterlină), CHF (franc elvețian) și PLN (zlot polonez). Acestea sunt cotate pentru 1 unitate de valută străină — de exemplu, un curs USD de 21,315 înseamnă 1 USD = 21,315 CZK.

Valute cotate pentru mai multe unități

Nouă valute au cursul cotat pentru mai multe unități, din cauza valorii lor mici în CZK pe unitate:

ValutăCantitateSemnificație
HUF (forint maghiar)100Curs pentru 100 HUF
INR (rupie indiană)100Curs pentru 100 INR
ISK (coroană islandeză)100Curs pentru 100 ISK
JPY (yen japonez)100Curs pentru 100 JPY
KRW (won sud-coreean)100Curs pentru 100 KRW
PHP (peso filipinez)100Curs pentru 100 PHP
THB (baht thailandez)100Curs pentru 100 THB
TRY (liră turcească)100Curs pentru 100 TRY
IDR (rupie indoneziană)1000Curs pentru 1000 IDR

Șablonul citește valoarea brută rate din API fără să o împartă la amount. De exemplu, un curs JPY de 13,328 în TapHome înseamnă 100 JPY = 13,328 CZK, nu 1 JPY = 13,328 CZK.

Lista completă a valutelor

Toate cele 30 de 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 (drepturi speciale de tragere ale FMI), ZAR.

Exemple de automatizare

Notificare la depășirea unui prag de curs

Folosiți un senzor de valută în condiția unui smart rule pentru a primi notificări când un curs depășește un prag:

  • Condiție: valoarea EUR crește peste 25,00
  • Acțiune: trimiterea unei notificări push
Comutare în funcție de curs

Declanșați acțiuni în funcție de evoluția cursului de schimb — de exemplu, schimbați starea unor indicatoare de pe afișaj sau controlați ieșiri când o valută urmărită ajunge într-un interval țintă.

Rezolvarea problemelor

Toate dispozitivele arată zero sau nu au date
  1. Verificați conexiunea la internet a TapHome Core — șablonul necesită acces HTTPS de ieșire la api.cnb.cz
  2. Verificați dacă API-ul răspunde — deschideți https://api.cnb.cz/cnbapi/exrates/daily?date=2026-03-28&lang=CZ într-un browser
  3. Cursurile de schimb noi se publică în fiecare zi lucrătoare în jurul orei 14:30 CET. În weekend și în zilele de sărbătoare, API-ul returnează ultimele cursuri valabile
Valorile par incorecte pentru unele valute

Consultați tabelul de mai sus cu valutele cotate pentru mai multe unități. Valute precum JPY, HUF, KRW și IDR sunt cotate pentru 100 sau 1000 de unități, nu pentru 1 unitate. Aceasta este convenția standard a CNB, nu o eroare a șablonului.

Datele nu se mai actualizează

Șablonul interoghează API-ul o dată pe oră. Dacă cursurile par învechite, verificați dacă TapHome Core are acces la internet și dacă API-ul CNB este accesibil. API-ul nu are limite de cereri documentate, dar problemele de conectivitate prelungite împiedică actualizarea.

Dispozitive disponibile

Cursuri de schimb CNB CZK Modul
Variabile personalizate

Kurzy ČNB

Citire (modul)
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
Dolar australian (AUD) Variabilă Doar citire
string Unitate: CZK json_path

Dolar australian (AUD)

Citire
PARSEJSON(responsejson, "$.rates[0].rate");
Real brazilian (BRL) Variabilă Doar citire
string Unitate: CZK json_path

Real brazilian (BRL)

Citire
PARSEJSON(responsejson, "$.rates[1].rate");
Dolar canadian (CAD) Variabilă Doar citire
string Unitate: CZK json_path

Dolar canadian (CAD)

Citire
PARSEJSON(responsejson, "$.rates[13].rate");
Renminbi chinezesc (CNY) Variabilă Doar citire
string Unitate: CZK json_path

Renminbi chinezesc (CNY)

Citire
PARSEJSON(responsejson, "$.rates[2].rate");
Coroană daneză (DKK) Variabilă Doar citire
string Unitate: CZK json_path

Coroană daneză (DKK)

Citire
PARSEJSON(responsejson, "$.rates[3].rate");
Euro (EUR) Variabilă Doar citire
string Unitate: CZK json_path

Euro (EUR)

Citire
PARSEJSON(responsejson, "$.rates[4].rate");
Liră sterlină (GBP) Variabilă Doar citire
string Unitate: CZK json_path

Liră sterlină (GBP)

Citire
PARSEJSON(responsejson, "$.rates[29].rate");
Dolar Hong Kong (HKD) Variabilă Doar citire
string Unitate: CZK json_path

Dolar Hong Kong (HKD)

Citire
PARSEJSON(responsejson, "$.rates[6].rate");
Forint maghiar (HUF) Variabilă Doar citire

Curs pentru 100 HUF

string Unitate: CZK json_path

Forint maghiar (HUF)

Citire
PARSEJSON(responsejson, "$.rates[15].rate");
Franc elvețian (CHF) Variabilă Doar citire
string Unitate: CZK json_path

Franc elvețian (CHF)

Citire
PARSEJSON(responsejson, "$.rates[25].rate");
Rupie indoneziană (IDR) Variabilă Doar citire

Curs pentru 1000 IDR

string Unitate: CZK json_path

Rupie indoneziană (IDR)

Citire
PARSEJSON(responsejson, "$.rates[8].rate");
Shekel israelian (ILS) Variabilă Doar citire
string Unitate: CZK json_path

Shekel israelian (ILS)

Citire
PARSEJSON(responsejson, "$.rates[10].rate");
Rupie indiană (INR) Variabilă Doar citire

Curs pentru 100 INR

string Unitate: CZK json_path

Rupie indiană (INR)

Citire
PARSEJSON(responsejson, "$.rates[7].rate");
Coroană islandeză (ISK) Variabilă Doar citire

Curs pentru 100 ISK

string Unitate: CZK json_path

Coroană islandeză (ISK)

Citire
PARSEJSON(responsejson, "$.rates[9].rate");
Yen japonez (JPY) Variabilă Doar citire

Curs pentru 100 JPY

string Unitate: CZK json_path

Yen japonez (JPY)

Citire
PARSEJSON(responsejson, "$.rates[11].rate");
Won sud-coreean (KRW) Variabilă Doar citire

Curs pentru 100 KRW

string Unitate: CZK json_path

Won sud-coreean (KRW)

Citire
PARSEJSON(responsejson, "$.rates[14].rate");
Peso mexican (MXN) Variabilă Doar citire
string Unitate: CZK json_path

Peso mexican (MXN)

Citire
PARSEJSON(responsejson, "$.rates[17].rate");
Ringgit malaiezian (MYR) Variabilă Doar citire
string Unitate: CZK json_path

Ringgit malaiezian (MYR)

Citire
PARSEJSON(responsejson, "$.rates[16].rate");
Coroană norvegiană (NOK) Variabilă Doar citire
string Unitate: CZK json_path

Coroană norvegiană (NOK)

Citire
PARSEJSON(responsejson, "$.rates[19].rate");
Dolar neozeelandez (NZD) Variabilă Doar citire
string Unitate: CZK json_path

Dolar neozeelandez (NZD)

Citire
PARSEJSON(responsejson, "$.rates[20].rate");
Peso filipinez (PHP) Variabilă Doar citire

Curs pentru 100 PHP

string Unitate: CZK json_path

Peso filipinez (PHP)

Citire
PARSEJSON(responsejson, "$.rates[5].rate");
Zlot polonez (PLN) Variabilă Doar citire
string Unitate: CZK json_path

Zlot polonez (PLN)

Citire
PARSEJSON(responsejson, "$.rates[21].rate");
Leu românesc (RON) Variabilă Doar citire
string Unitate: CZK json_path

Leu românesc (RON)

Citire
PARSEJSON(responsejson, "$.rates[22].rate");
Coroană suedeză (SEK) Variabilă Doar citire
string Unitate: CZK json_path

Coroană suedeză (SEK)

Citire
PARSEJSON(responsejson, "$.rates[24].rate");
Dolar singaporez (SGD) Variabilă Doar citire
string Unitate: CZK json_path

Dolar singaporez (SGD)

Citire
PARSEJSON(responsejson, "$.rates[23].rate");
Baht thailandez (THB) Variabilă Doar citire

Curs pentru 100 THB

string Unitate: CZK json_path

Baht thailandez (THB)

Citire
PARSEJSON(responsejson, "$.rates[26].rate");
Liră turcească (TRY) Variabilă Doar citire

Curs pentru 100 TRY

string Unitate: CZK json_path

Liră turcească (TRY)

Citire
PARSEJSON(responsejson, "$.rates[27].rate");
Dolar american (USD) Variabilă Doar citire
string Unitate: CZK json_path

Dolar american (USD)

Citire
PARSEJSON(responsejson, "$.rates[28].rate");
DST FMI (XDR) Variabilă Doar citire

Drepturi speciale de tragere ale FMI — activ de rezervă compozit

string Unitate: CZK json_path

DST FMI (XDR)

Citire
PARSEJSON(responsejson, "$.rates[18].rate");
Rand sud-african (ZAR) Variabilă Doar citire
string Unitate: CZK json_path

Rand sud-african (ZAR)

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

Surse

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

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal