---
title: "CNB CZK Exchange Rates"
description: "Cursurile de schimb oficiale ale Băncii Naționale Cehe față de CZK pentru 30 de valute. Urmăriți-le în TapHome prin API-ul public CNB, fără autentificare."
url: "https://taphome.com/ro/compatibility/cnb-czk/"
language: ro
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","data-service","exchange-rates","currency","cloud-api","packet-parser"]
  questions: ["Cum integrez cursurile de schimb CNB cu TapHome?","Ce valute acceptă șablonul TapHome pentru cursurile de schimb CNB CZK?","Cum automatizez acțiuni în funcție de cursurile de schimb în TapHome?","Cât de des se actualizează cursurile de schimb CNB?","Cum urmăresc cursul EUR/CZK sau USD/CZK în TapHome?"]
---

# CNB CZK Exchange Rates

Comunicație: Packet Parser → HTTP

- [Banca Națională Cehă](https://www.cnb.cz/en/)

## Ghid de integrare

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):

```
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.

> [!NOTE]
> Ș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ă | Cantitate | Semnificație |
|----------|--------|---------|
| HUF (forint maghiar) | 100 | Curs pentru 100 HUF |
| INR (rupie indiană) | 100 | Curs pentru 100 INR |
| ISK (coroană islandeză) | 100 | Curs pentru 100 ISK |
| JPY (yen japonez) | 100 | Curs pentru 100 JPY |
| KRW (won sud-coreean) | 100 | Curs pentru 100 KRW |
| PHP (peso filipinez) | 100 | Curs pentru 100 PHP |
| THB (baht thailandez) | 100 | Curs pentru 100 THB |
| TRY (liră turcească) | 100 | Curs pentru 100 TRY |
| IDR (rupie indoneziană) | 1000 | Curs 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 30

Aceste dispozitive apar în TapHome după import.

Cursuri de schimb CNB CZK Modul

Variabile personalizate

Citire (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
```

Dolar australian (AUD) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[0].rate");
```

Real brazilian (BRL) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[1].rate");
```

Dolar canadian (CAD) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[13].rate");
```

Renminbi chinezesc (CNY) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[2].rate");
```

Coroană daneză (DKK) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[3].rate");
```

Euro (EUR) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[4].rate");
```

Liră sterlină (GBP) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[29].rate");
```

Dolar Hong Kong (HKD) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[6].rate");
```

Forint maghiar (HUF) Variabilă Doar citire

Curs pentru 100 HUF

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[15].rate");
```

Franc elvețian (CHF) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[25].rate");
```

Rupie indoneziană (IDR) Variabilă Doar citire

Curs pentru 1000 IDR

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[8].rate");
```

Shekel israelian (ILS) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[10].rate");
```

Rupie indiană (INR) Variabilă Doar citire

Curs pentru 100 INR

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[7].rate");
```

Coroană islandeză (ISK) Variabilă Doar citire

Curs pentru 100 ISK

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[9].rate");
```

Yen japonez (JPY) Variabilă Doar citire

Curs pentru 100 JPY

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[11].rate");
```

Won sud-coreean (KRW) Variabilă Doar citire

Curs pentru 100 KRW

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[14].rate");
```

Peso mexican (MXN) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[17].rate");
```

Ringgit malaiezian (MYR) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[16].rate");
```

Coroană norvegiană (NOK) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[19].rate");
```

Dolar neozeelandez (NZD) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[20].rate");
```

Peso filipinez (PHP) Variabilă Doar citire

Curs pentru 100 PHP

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[5].rate");
```

Zlot polonez (PLN) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[21].rate");
```

Leu românesc (RON) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[22].rate");
```

Coroană suedeză (SEK) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[24].rate");
```

Dolar singaporez (SGD) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[23].rate");
```

Baht thailandez (THB) Variabilă Doar citire

Curs pentru 100 THB

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[26].rate");
```

Liră turcească (TRY) Variabilă Doar citire

Curs pentru 100 TRY

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[27].rate");
```

Dolar american (USD) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
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

Citire

```taphome
PARSEJSON(responsejson, "$.rates[18].rate");
```

Rand sud-african (ZAR) Variabilă Doar citire

string Unitate: CZK json\_path

Citire

```taphome
PARSEJSON(responsejson, "$.rates[12].rate");
```

**Conexiune:** Packet Parser → HTTP

## Surse

- 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

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)

