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

Kod waluty to trzyliterowe oznaczenie zgodne ze standardem ISO 4217, na przykład EUR dla euro, USD dla dolara amerykańskiego i PLN dla polskiego złotego. Sprawdzisz go w tabeli walut, dokumencie księgowym albo za pomocą API Narodowego Banku Polskiego. Różnica między kodem, symbolem i kursem ma znaczenie szczególnie przy fakturach oraz integracji z systemem finansowym. W dalszej części znajdziesz konkretne przykłady i adresy zapytań.

Kod waluty – co oznacza?

Kod waluty jest krótkim, jednoznacznym identyfikatorem jednostki pieniężnej. Tworzą go trzy litery. Pierwsze dwie często nawiązują do państwa lub obszaru, a ostatnia do nazwy waluty, choć nie zawsze da się odczytać go wprost. Polski złoty ma kod PLN, euro oznacza się jako EUR, a frank szwajcarski jako CHF.

Międzynarodowe oznaczenia określa ISO 4217. Standard zawiera także numeryczne kody walut, na przykład PLN ma numer 985, EUR – 978, a USD – 840. Trzyliterowy zapis jest używany w bankach, sklepach internetowych, systemach płatności, fakturach i programach księgowych.

Kod waluty wskazuje, jaka jednostka pieniężna występuje w dokumencie. Nie określa jednak jej kursu ani wartości przeliczenia.

Kod a symbol waluty

Symbol ma postać znaku graficznego, na przykład zł, €, £ albo $. Wygodnie prezentuje cenę na metce lub rachunku, lecz nie zawsze identyfikuje walutę bez ryzyka pomyłki. Znak $ może oznaczać dolara amerykańskiego, kanadyjskiego, australijskiego, hongkońskiego lub nowozelandzkiego.

W przypadku Chin symbol ¥ może odnosić się do juana, którego kod to CNY, ale taki sam znak stosuje się dla jena japońskiego – JPY. Z tego powodu systemy informatyczne korzystają przede wszystkim z kodów ISO, a nie z samych symboli.

Jak sprawdzić kod waluty?

Najprościej odczytać go z tabeli kursów, faktury, formularza płatniczego albo ustawień rachunku walutowego. Warto sprawdzić nie tylko nazwę kraju, lecz także konkretną jednostkę. Stany Zjednoczone posługują się kodem USD, Wielka Brytania GBP, Czechy CZK, a Węgry HUF.

Przy mniej znanych walutach pomocna jest baza ISO 4217. Zawiera ona również liczbę miejsc po przecinku używaną przy zapisie kwot. Dla jena japońskiego kod to JPY, numer 392, a liczba miejsc dziesiętnych wynosi 0. Dla dinara kuwejckiego – KWD, numer 414 – przewidziano 3 miejsca dziesiętne.

Sprawdzenie w API NBP

Publiczny serwis api.nbp.pl udostępnia dane o kursach walut. Adres bazowy zapytań to https://api.nbp.pl/api/. Aby pobrać kurs jednej waluty, użyj schematu:

https://api.nbp.pl/api/exchangerates/rates/{table}/{code}/

W miejsce {table} wpisuje się typ tabeli A, B lub C, a w miejscu {code} trzyliterowy kod ISO. Przykładowe zapytanie o franka szwajcarskiego z tabeli A wygląda tak:

https://api.nbp.pl/api/exchangerates/rates/a/chf/

API zwraca domyślnie dane w formacie JSON. Format można zmienić parametrem ?format=xml albo nagłówkiem HTTP Accept: application/xml. Od 1 sierpnia 2025 r. połączenie z serwisem wymaga protokołu HTTPS, więc stary adres zaczynający się od http nie powinien być używany.

Zapytania według daty

Możesz pobrać kurs z konkretnego dnia albo serię notowań. Przykład odczytu kursu dolara amerykańskiego z tabeli C w bieżącym dniu:

https://api.nbp.pl/api/exchangerates/rates/c/usd/today/

Dla wskazanej daty stosuje się format RRRR-MM-DD, zgodny z ISO 8601:

https://api.nbp.pl/api/exchangerates/rates/c/usd/2016-04-04/?format=json

Limit zapytań wynosi 93 dni dla jednego zakresu archiwalnego. Dłuższy okres trzeba podzielić na kilka żądań. Brak danych dla poprawnego zakresu powoduje odpowiedź 404 Not Found, a niepoprawna składnia zapytania zwraca 400 Bad Request.

Dlaczego sam kod nie wystarcza na fakturze?

Kod waluty i kurs waluty pełnią różne funkcje. Pole EUR informuje, że dokument wystawiono w euro, natomiast kurs mówi, ile złotych przypada na jedną jednostkę tej waluty. Program księgowy może poprawnie odczytać kod, ale bez liczby przeliczeniowej uznać wartość kursu za równą zero.

Taki problem pojawia się przy imporcie faktury do innego systemu, także gdy dokument przechodzi przez KSeF. Wystawca może przeliczyć kwoty na złote i umieścić kod EUR, lecz odbiorca potrzebuje jeszcze pola zawierającego kurs dokumentu. Sama adnotacja w uwagach często nie zasila mechanizmu obliczeniowego.

Komunikat o zerowym kursie nie oznacza błędnego kodu EUR. Oznacza brak liczbowej wartości kursu w polu, z którego program wykonuje przeliczenie.

Jakie dane przekazać?

Przy wymianie danych między programami powinny znaleźć się co najmniej:

• kod waluty zgodny z ISO 4217, na przykład EUR,
• kwota netto, VAT i brutto w walucie dokumentu,
• kurs zastosowany do przeliczenia na złote,
• data kursu oraz informacja, czy jest to kurs średni, kupna lub sprzedaży.

Trzeba też ustalić, czy system oczekuje kursu 1 EUR, czy odwrotnego przelicznika, na przykład wartości EUR za 1 PLN. Błędny kierunek kursu może dać wynik formalnie poprawny, lecz finansowo nieprawidłowy.

Jak odczytywać kurs waluty z tabel NBP?

NBP publikuje tabele A i B ze średnimi kursami walut oraz tabelę C z bieżącymi kursami kupna i sprzedaży. W tabeli kurs może dotyczyć nie jednej, lecz 100 albo 10 000 jednostek. Dla przykładu kurs jena podaje się zwykle za 100 JPY, a kurs rupii indonezyjskiej za 10 000 IDR.

W tabeli C nr 159/C/NBP/2026, obowiązującej od 18 sierpnia 2026 r., euro miało kurs kupna 4,2642 zł i sprzedaży 4,3504 zł. Sposób wyliczania tych wartości określa Uchwała Nr 44/2025 Zarządu NBP z 18 grudnia 2025 r.

Jeżeli pobierasz dane programistycznie, sprawdź jednocześnie kod waluty, datę notowania, typ tabeli i mnożnik jednostki. Dopiero taki komplet pozwala prawidłowo zapisać kurs na fakturze i uniknąć komunikatu o ujemnej lub zerowej wartości.