Co to jest kod waluty i jak go sprawdzić?

Kod waluty to trzyliterowe oznaczenie jednostki pieniężnej według standardu ISO 4217 – dla polskiego złotego jest to PLN, dla euro EUR, a dla dolara amerykańskiego USD. Taki skrót pozwala jednoznacznie zidentyfikować walutę w systemach księgowych, tabelach kursów czy fakturach. Warto znać kilka sposobów jego weryfikacji.

Czym jest kod waluty w standardzie ISO 4217?

Standard ISO 4217 został opracowany przez Międzynarodową Organizację Normalizacyjną. W jego ramach każda waluta otrzymuje trzyliterowy kod oraz trzycyfrowy numer. Dzięki temu nie trzeba polegać wyłącznie na symbolach graficznych, które bywają niejednoznaczne – na przykład znak $ dotyczy zarówno dolara amerykańskiego, kanadyjskiego, australijskiego, jak i nowozelandzkiego.

Trzyliterowy kod składa się zwykle z dwuliterowego oznaczenia kraju oraz litery odpowiadającej nazwie waluty. Dla polskiego złotego kod to PLN, a numer to 985. W strefie euro kod EUR ma numer 978, natomiast dolar amerykański USD ma numer 840. To rozróżnienie jest ważne, ponieważ sam symbol dolara nie wystarcza do poprawnego zaksięgowania transakcji.

Kod ISO 4217 to trzyliterowe oznaczenie, a numer waluty to osobny trzycyfrowy identyfikator – dla polskiego złotego są to PLN i 985.

Jak sprawdzić kod waluty?

Najszybszym sposobem jest skorzystanie z oficjalnej tabeli kodów ISO 4217 albo publicznego interfejsu NBP. Wiele programów finansowo-księgowych ma wbudowaną listę walut, ale w razie wątpliwości warto zweryfikować dane w wiarygodnym źródle. Dzięki temu unikniesz pomyłek przy wystawianiu dokumentów lub importowaniu kursów.

W serwisie API NBP

Serwis api.nbp.pl udostępnia publiczne Web API. Wystarczy wysłać żądanie HTTP GET na adres bazowy https://api.nbp.pl/api/. Dane można pobrać w formacie JSON lub XML, wskazując format parametrem ?format albo nagłówkiem HTTP Accept. Od 1 sierpnia 2025 r. komunikacja musi odbywać się wyłącznie przez protokół HTTPS, co zwiększa bezpieczeństwo przesyłanych danych.

W tabelach kursów i kalkulatorze walutowym

Kody walut znajdziesz też w tabeli kursów średnich NBP, publikowanej w dni robocze. Przykładowo w tabeli z 14.08.2026 euro ma kod EUR i kurs 4,3100 zł, frank szwajcarski CHF ma 4,5849 zł, a funt szterling GBP 5,0436 zł. W tabeli nr 157/C/NBP/2026 z dnia 2026-08-13, obowiązującej od 2026-08-14, kurs kupna dolara amerykańskiego wynosił 3,6951 zł, a sprzedaży 3,7697 zł.

Kod waluty a symbol graficzny – na co uważać?

Symbole graficzne bywają mylące. Znak ¥ używany jest zarówno przez chińskiego juana, jak i japońskiego jena. Podobnie $ występuje przy dolarze australijskim, kanadyjskim, amerykańskim i nowozelandzkim. W dokumentach finansowych ten sam symbol może prowadzić do poważnych pomyłek, dlatego bezpieczniej posługiwać się kodem ISO 4217.

Czasem symbol waluty bywa też bardziej intuicyjny niż oficjalny kod. Węgierski forint ma kod HUF, ale symbol Ft; rand południowoafrykański ma kod ZAR, a symbol R. W systemach informatycznych i elektronicznym obiegu dokumentów to jednak trzyliterowe skróty są standardem, który eliminuje wątpliwości interpretacyjne.

Jak pobrać kody i kursy z API NBP?

Publiczne Web API NBP pozwala pobierać kompletne tabele kursów oraz kurs pojedynczej waluty. W adresie ścieżki wykorzystuje się parametry takie jak {table}, {code}, {topCount} oraz daty w formacie RRRR-MM-DD zapisane zgodnie ze standardem ISO 8601. Tabela A zawiera kursy średnie, tabela B również średnie, a tabela C kursy kupna i sprzedaży.

Najważniejsze parametry zapytań

Do pobrania kursu konkretnej waluty służy endpoint /exchangerates/rates/{table}/{code}/. W miejscu {code} wpisuje się trzyliterowy kod, na przykład dla franka szwajcarskiego: https://api.nbp.pl/api/exchangerates/rates/a/chf/. W zapytaniu można podać pojedynczą datę lub zakres dat, a także ograniczyć liczbę wyników parametrem {topCount}.

W praktyce najczęściej używane są następujące wzory zapytań:

• https://api.nbp.pl/api/exchangerates/tables/a/
• https://api.nbp.pl/api/exchangerates/rates/a/eur/
• https://api.nbp.pl/api/exchangerates/rates/c/usd/today/
• https://api.nbp.pl/api/cenyzlota/last/30/?format=json

Format odpowiedzi i ograniczenia

Domyślnym formatem odpowiedzi jest JSON. Można go zmienić na XML przez parametr ?format=xml lub nagłówek Accept: application/xml. Pojedyncze zapytanie nie może obejmować przedziału dłuższego niż 93 dni. Gdy dla wskazanego zakresu nie ma danych, serwis zwraca błąd 404 Not Found. Z kolei nieprawidłowo sformułowane zapytanie kończy się komunikatem 400 Bad Request.

Przekroczenie limitu zwracanych danych również powoduje błąd 400 Bad Request z informacją „Przekroczony limit”. W adresie należy stosować wyłącznie HTTPS, ponieważ protokół HTTP nie jest już wspierany. Dzięki temu przesyłane dane pozostają chronione podczas całej transmisji.

Przykłady zapytań o kurs i złoto

Do pobrania kursów kupna i sprzedaży z tabeli C może służyć adres https://api.nbp.pl/api/exchangerates/rates/c/usd/2016-04-04/?format=json. Notowania cen złota dostępne są pod ścieżką /cenyzlota, na przykład https://api.nbp.pl/api/cenyzlota/last/30/?format=json. W ten sposób w jednym zapytaniu można pobrać do 30 ostatnich notowań.

Do czego wykorzystuje się kody walut w praktyce?

Kody ISO 4217 są niezbędne w handlu zagranicznym, e-commerce, bankowości i programach do fakturowania. Umożliwiają jednoznaczne wskazanie waluty transakcji bez względu na język interfejsu czy lokalne nazwy. Polski złoty ma kod PLN i numer 985, co często pojawia się w przelewach zagranicznych oraz dokumentach celnych.

Poważne znaczenie ma też poprawny kurs waluty. Zdarzają się przypadki, gdy faktura w EUR ma wpisany kod waluty, ale dokument nie zawiera kursu. W systemach takich jak Krajowy System e-Faktur może to powodować komunikaty o zerowym kursie dokumentu. Dlatego oprócz samego kodu konieczne jest uzupełnienie pełnych danych kursowych z dnia poprzedzającego wystawienie dokumentu.