Kod waluty – co to jest i jak go sprawdzić?

Kod waluty to trzyliterowe oznaczenie zgodne ze standardem ISO 4217, np. PLN dla złotego, EUR dla euro czy USD dla dolara amerykańskiego. Możesz go odczytać z tabel Narodowego Banku Polskiego lub przez publiczne API NBP. Zapraszamy do lektury.

Czym jest kod waluty?

Za trzyliterowymi oznaczeniami stoi międzynarodowy standard ISO 4217. Przyjęła go Międzynarodowa Organizacja Normalizacyjna, aby ujednolicić zapis jednostek monetarnych na całym świecie. Dzięki temu banki, urzędy i programy księgowe mogą jednoznacznie rozróżniać waluty o podobnych nazwach lub symbolach.

Kod waluty to trzyliterowe oznaczenie zdefiniowane w standardzie ISO 4217, przypisane do konkretnej jednostki monetarnej, np. PLN dla złotego, EUR dla euro albo USD dla dolara amerykańskiego.

Pełne oznaczenie obejmuje trzyliterowy kod oraz trzycyfrowy numer. Polski złoty ma kod PLN i numer 985, euro EUR i 978, a dolar amerykański USD i 840. W zestawieniach technicznych warto zwrócić też uwagę na wykładnik E, który mówi o liczbie cyfr po przecinku danej waluty.

Przykładowo japoński jen (JPY) ma E równe 0, bo w notowaniach podaje się go zwykle w setkach za 100 jednostek. Dinar bahrajński (BHD) ma natomiast E równe 3, co oznacza zapis z trzema miejscami po przecinku. Taka informacja pomaga w poprawnym przeliczaniu kwot w systemach finansowych.

W codziennym korzystaniu z tabel kursowych pomocne bywa zestawienie podstawowych kodów:

Jak sprawdzić kod waluty?

Najprostszym źródłem są tabele publikowane przez Narodowy Bank Polski. Bank codziennie ogłasza kursy średnie, a w tabeli C także kursy kupna i sprzedaży. Każdy wiersz zawiera nazwę waluty, kod oraz wartość kursu.

W tabeli kursów średnich z 13.08.2026 kurs euro wynosił 4,3058 zł, a dolara amerykańskiego 3,7362 zł. Z kolei w tabeli nr 156/C/NBP/2026 z 12.08.2026, obowiązującej od 13.08.2026, kurs kupna euro to 4,2599 zł, a sprzedaży 4,3459 zł.

Tabele i kalkulatory walut

Dla użytkowników niewymagających danych w formie surowej wygodne są serwisy i kalkulatory oparte na publikacjach NBP. Pozwalają one wybrać walutę z listy, wpisać kwotę i od razu zobaczyć trzyliterowy zapis oraz przeliczenie. Dość często wystarczy wpisać fragment nazwy państwa lub nazwę waluty, aby narzędzie podpowiedziało właściwy kod.

Publiczne API NBP

Dla programistów i firm integrujących systemy z kursami przeznaczony jest serwis api.nbp.pl. Komunikacja polega na wysłaniu zapytania HTTP GET, a odpowiedź najczęściej wraca w formacie JSON. Cała wymiana danych od 1 sierpnia 2025 r. wymaga protokołu HTTPS.

Do pobierania kursów i tabel przydają się następujące wzorce zapytań:

• kompletne tabele kursów walut – /exchangerates/tables/{table}/,
• kurs pojedynczej waluty – /exchangerates/rates/{table}/{code}/,
• ostatnie notowania – /exchangerates/rates/{table}/{code}/last/{topCount}/,
• notowania cen złota – /cenyzlota/.

W parametrach najczęściej stosuje się {table} jako typ tabeli A, B lub C, a {code} jako trzyliterowy kod ISO 4217. Daty zapisuje się w formacie RRRR-MM-DD zgodnie z ISO 8601. Pojedyncze zapytanie nie może obejmować przedziału dłuższego niż 93 dni. Jeśli nie wskażesz formatu, serwis zwróci dane w JSON, ale możesz też zażądać XML przez parametr ?format=xml.

Brak danych dla poprawnego zakresu zwraca błąd 404 Not Found. Nieprawidłowe zapytanie kończy się komunikatem 400 Bad Request, a przekroczenie limitu danych także zwraca błąd 400.

Dlaczego symbol waluty nie wystarczy?

Symbole graficzne są powszechne, ale nie zawsze jednoznaczne. Znak $ oznacza nie tylko dolara amerykańskiego, lecz także dolara kanadyjskiego, australijskiego, nowozelandzkiego i singapurskiego. Trzyliterowy kod pokazuje dokładnie, o którą jednostkę chodzi.

Podobny problem dotyczy znaku ¥, który w zależności od kontekstu może oznaczać chińskiego jena lub japońskiego jena. Symbol kr bywa używany dla korony norweskiej, szwedzkiej i duńskiej. Dopiero zapis CNY, JPY, NOK, SEK czy DKK usuwa wątpliwości.

Symbole sprawdzają się tam, gdzie miejsce jest ograniczone, na przykład na metkach cenowych. W dokumentach, przelewach i integracjach między programami lepiej trzymać się kodu ISO 4217, bo on jest jednoznaczny.

Przydatne zestawienie najczęściej mylonych symboli wygląda następująco:

Dlaczego kod waluty w KSeF bywa problemem?

W fakturach ustrukturyzowanych Krajowy System e-Faktur (KSeF) kod waluty jest jednym z pól technicznych. Gdy wystawiasz fakturę w euro, program zwykle przelicza kwotę na złote, ale kontrahent może zobaczyć tylko kod waluty bez wartości kursu. To prowadzi do komunikatu Dok. FVZ 0 – ujemny lub zerowy kurs waluty.

Taki błąd oznacza, że kurs dokumentu ma w systemie wartość zero. Sam trzyliterowy kod, np. EUR, informuje o walucie, ale nie wystarcza do rozliczenia kwoty w złotych. W KSeF obok kodu musi widnieć również właściwy kurs przeliczenia, który program zaciągnie lub zapisze w danych dokumentu.

Sam kod waluty nie wystarczy do rozliczenia faktury w obcej walucie – w KSeF musi znaleźć się również kurs dokumentu.

Dlatego przy wdrożeniu e-faktur warto zweryfikować, czy używane oprogramowanie przesyła oba pola – kod i kurs. Jeśli w podglądzie faktury brakuje kursu, dokument może zostać odrzucony albo błędnie zaksięgowany. Ręczne dopisywanie kursu w polu uwag nie rozwiązuje problemu, bo systemy nie traktują takiego tekstu jako danych walutowych.