--- title: "CNB CZK Kursy walut" description: "Oficjalne kursy wymiany CZK Czeskiego Banku Narodowego dla 30 walut. Śledź dzienne kursy fixingowe CNB w TapHome przez publiczne API CNB — bez." url: "https://taphome.com/pl/compatibility/cnb-czk/" language: pl lastmod: 2026-10-08 generator: hugo ai: topics: ["http","data-service","exchange-rates","currency","cloud-api","packet-parser"] questions: ["Jak zintegrować kursy CNB z TapHome?","Jakie waluty obsługuje szablon kursów CNB CZK?","Jak automatyzować akcje na podstawie kursów walut w TapHome?","Jak często aktualizowane są kursy CNB?","Jak śledzić kurs EUR/CZK lub USD/CZK w TapHome?"] --- # CNB CZK Kursy walut Komunikacja: Packet Parser → HTTP - [Czeski Bank Narodowy](https://www.cnb.cz/en/) ## Poradnik integracji Czeski Bank Narodowy (ČNB) codziennie publikuje oficjalne kursy wymiany CZK dla 30 walut obcych. Kursy te są oficjalnymi kursami fixingowymi używanymi jako referencja w całym czeskim systemie finansowym. Szablon TapHome pobiera wszystkie 30 kursów wymiany z publicznego API REST CNB (`api.cnb.cz`) przez HTTP Packet Parser. Każda waluta jest wyświetlana jako osobny czujnik tylko do odczytu pokazujący aktualny kurs CZK. API jest całkowicie publiczne — nie wymaga uwierzytelniania, klucza API ani rejestracji. TapHome pobiera kursy raz na godzinę; CNB publikuje nowe kursy raz na dzień roboczy około 14:30. ## Konfiguracja Szablon łączy się z `api.cnb.cz` przez HTTPS (port 443). Nie jest potrzebny adres IP, dane uwierzytelniające ani klucz API — endpoint jest w pełni publicznym rządowym API. Nie ma zmiennych konfigurowalnych przez użytkownika. Jedyna zmienna niestandardowa (`responsejson`) to wewnętrzna pamięć podręczna odpowiedzi HTTP używana przez skrypty szablonu — nie wymaga modyfikacji. ## Zasada działania Moduł wysyła pojedyncze żądanie HTTP GET raz na godzinę (interwał odpytywania 3 600 000 ms): ``` GET /cnbapi/exrates/daily?date={today}&lang=CZ ``` Odpowiedź to obiekt JSON zawierający tablicę `rates[]` ze wszystkimi 30 wpisami walutowymi. Każdy wpis zawiera kod waluty, nazwę kraju, ilość i kurs. Moduł przechowuje pełną odpowiedź JSON w zmiennej `responsejson`. Każde urządzenie walutowe następnie parsuje swój kurs z buforowanej odpowiedzi za pomocą `PARSEJSON(responsejson, "$.rates[N].rate")`, gdzie N jest stałym indeksem tablicy dla danej waluty. Interwał odpytywania urządzenia wynosi 15 sekund, ale ponieważ wszystkie urządzenia czytają z buforowanego `responsejson`, między godzinnymi odświeżeniami nie są wykonywane dodatkowe wywołania API. > [!NOTE] > Szablon używa `lang=CZ` w żądaniu API. Jest to krytyczne, ponieważ tablica `rates[]` jest sortowana alfabetycznie według nazwy kraju w wybranym języku. Zmiana na `lang=EN` spowodowałaby inną kolejność sortowania i zepsuła wszystkie mapowania indeksów tablicy. ## Funkcje urządzeń Szablon udostępnia 30 czujników tylko do odczytu, po jednym dla każdej waluty. Wszystkie wartości podane są w CZK. ### Główne waluty Najczęściej śledzone kursy to EUR (euro), USD (dolar amerykański), GBP (funt brytyjski), CHF (frank szwajcarski) i PLN (złoty polski). Są one podawane na 1 jednostkę waluty obcej — na przykład kurs USD 21,315 oznacza 1 USD = 21,315 CZK. ### Waluty wielojednostkowe Dziewięć walut używa kursów wielojednostkowych ze względu na ich niską wartość CZK na jednostkę: | Waluta | Ilość | Znaczenie | |--------|-------|-----------| | HUF (forint węgierski) | 100 | Kurs za 100 HUF | | INR (rupia indyjska) | 100 | Kurs za 100 INR | | ISK (korona islandzka) | 100 | Kurs za 100 ISK | | JPY (jen japoński) | 100 | Kurs za 100 JPY | | KRW (won południowokoreański) | 100 | Kurs za 100 KRW | | PHP (peso filipińskie) | 100 | Kurs za 100 PHP | | THB (baht tajski) | 100 | Kurs za 100 THB | | TRY (lira turecka) | 100 | Kurs za 100 TRY | | IDR (rupia indonezyjska) | 1000 | Kurs za 1000 IDR | Szablon odczytuje surową wartość `rate` z API bez dzielenia przez `amount`. Na przykład kurs JPY 13,328 w TapHome oznacza 100 JPY = 13,328 CZK, a nie 1 JPY = 13,328 CZK. ### Pełna lista walut Wszystkie 30 walut: 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 (Specjalne Prawa Ciągnienia MFW), ZAR. ## Przykłady automatyzacji ### Powiadomienie o przekroczeniu progu kursu Użyj czujnika walutowego w warunku reguły inteligentnej, aby otrzymywać powiadomienia, gdy kurs przekroczy próg: - Warunek: wartość EUR przekracza 25,00 - Akcja: wyślij powiadomienie push ### Przełączanie na podstawie kursu Wyzwalaj akcje na podstawie ruchów kursów walut — na przykład przełączaj wskaźniki wyświetlacza lub steruj wyjściami, gdy monitorowana waluta osiągnie docelowy zakres. ## Rozwiązywanie problemów ### Wszystkie urządzenia pokazują zero lub brak danych 1. Sprawdź połączenie internetowe TapHome Core — szablon wymaga wychodzącego dostępu HTTPS do `api.cnb.cz` 2. Sprawdź, czy API odpowiada — otwórz `https://api.cnb.cz/cnbapi/exrates/daily?date=2026-03-28&lang=CZ` w przeglądarce 3. Nowe kursy wymiany publikowane są w każdy dzień roboczy około 14:30 CET. W weekendy i święta API zwraca ostatnie ważne kursy ### Wartości wydają się nieprawidłowe dla niektórych walut Sprawdź powyższą tabelę kursów wielojednostkowych. Waluty takie jak JPY, HUF, KRW i IDR są podawane za 100 lub 1000 jednostek, nie za 1 jednostkę. Jest to standardowa konwencja ČNB, a nie błąd szablonu. ### Dane przestają się aktualizować Szablon odpytuje API raz na godzinę. Jeśli kursy wydają się nieaktualne, sprawdź, czy TapHome Core ma dostęp do internetu i czy API CNB jest osiągalne. API nie ma udokumentowanych limitów żądań, ale długotrwałe problemy z łącznością uniemożliwią aktualizacje. ## Dostępne urządzenia 30 Te urządzenia pojawią się w TapHome po imporcie. CNB CZK Kursy Walut Moduł Zmienne niestandardowe Odczyt (moduł) ```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 australijski (AUD) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[0].rate"); ``` Real brazylijski (BRL) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[1].rate"); ``` Dolar kanadyjski (CAD) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[13].rate"); ``` Juan chiński (CNY) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[2].rate"); ``` Korona duńska (DKK) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[3].rate"); ``` Euro (EUR) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[4].rate"); ``` Funt brytyjski (GBP) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[29].rate"); ``` Dolar hongkoński (HKD) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[6].rate"); ``` Forint węgierski (HUF) Zmienna Tylko do odczytu Kurs za 100 HUF string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[15].rate"); ``` Frank szwajcarski (CHF) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[25].rate"); ``` Rupia indonezyjska (IDR) Zmienna Tylko do odczytu Kurs za 1000 IDR string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[8].rate"); ``` Szekel izraelski (ILS) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[10].rate"); ``` Rupia indyjska (INR) Zmienna Tylko do odczytu Kurs za 100 INR string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[7].rate"); ``` Korona islandzka (ISK) Zmienna Tylko do odczytu Kurs za 100 ISK string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[9].rate"); ``` Jen japoński (JPY) Zmienna Tylko do odczytu Kurs za 100 JPY string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[11].rate"); ``` Won południowokoreański (KRW) Zmienna Tylko do odczytu Kurs za 100 KRW string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[14].rate"); ``` Peso meksykańskie (MXN) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[17].rate"); ``` Ringgit malezyjski (MYR) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[16].rate"); ``` Korona norweska (NOK) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[19].rate"); ``` Dolar nowozelandzki (NZD) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[20].rate"); ``` Peso filipińskie (PHP) Zmienna Tylko do odczytu Kurs za 100 PHP string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[5].rate"); ``` Złoty polski (PLN) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[21].rate"); ``` Lej rumuński (RON) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[22].rate"); ``` Korona szwedzka (SEK) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[24].rate"); ``` Dolar singapurski (SGD) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[23].rate"); ``` Baht tajski (THB) Zmienna Tylko do odczytu Kurs za 100 THB string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[26].rate"); ``` Lira turecka (TRY) Zmienna Tylko do odczytu Kurs za 100 TRY string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[27].rate"); ``` Dolar amerykański (USD) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[28].rate"); ``` MFW SDR (XDR) Zmienna Tylko do odczytu Specjalne Prawa Ciągnienia MFW — złożony aktyw rezerwowy string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[18].rate"); ``` Rand południowoafrykański (ZAR) Zmienna Tylko do odczytu string Jednostka: CZK json\_path Odczyt ```taphome PARSEJSON(responsejson, "$.rates[12].rate"); ``` **Połączenie:** Packet Parser → HTTP ## Źródła - 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 ## Powiązana dokumentacja - [Integracja Packet Parser](https://taphome.com/pl/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/) - [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/) - [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)