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

Kod waluty to zwykle trzyliterowe oznaczenie zgodne ze standardem ISO 4217, na przykład USD dla dolara amerykańskiego, EUR dla euro i PLN dla polskiego złotego. Sprawdzisz go w tabeli walut NBP, dokumentacji systemu finansowego albo przez API NBP. Poniżej znajdziesz także wyjaśnienie, dlaczego sam kod nie zawsze wystarcza na fakturze.

Kod waluty – co oznacza?

Kod waluty jednoznacznie identyfikuje jednostkę pieniężną w systemach bankowych, księgowych, płatniczych i handlowych. Najczęściej ma trzy litery. Pierwsze dwie odnoszą się do państwa lub obszaru, a ostatnia wskazuje walutę. Przykładowo USD oznacza dolara amerykańskiego, a CHF franka szwajcarskiego.

Takie oznaczenia definiuje ISO 4217. Standard obejmuje również trzycyfrowy numer waluty oraz informację o liczbie miejsc po przecinku. Dla PLN numerem jest 985, dla EUR 978, a dla USD 840. Kod numeryczny przydaje się wtedy, gdy system nie obsługuje liter albo musi rozróżnić podobne oznaczenia.

Nie należy mylić kodu z symbolem. Znak $ może oznaczać dolara amerykańskiego, kanadyjskiego, australijskiego lub nowozelandzkiego. Kod USD jest jednoznaczny, natomiast symbol graficzny wymaga wskazania kraju i rodzaju waluty.

Jak sprawdzić kod waluty?

Najprościej wyszukać pełną nazwę waluty w tabeli ISO 4217 lub w tabeli kursów Narodowego Banku Polskiego. Przy każdej pozycji znajdują się nazwa, kod oraz jednostka, dla której podawany jest kurs. W przypadku jena i forinta trzeba zwrócić uwagę na przelicznik – NBP publikuje odpowiednio kurs za 100 JPY i 100 HUF.

Przykładowe oznaczenia często używane w Polsce to: USD – dolar amerykański, EUR – euro, GBP – funt szterling, CHF – frank szwajcarski, CZK – korona czeska, NOK – korona norweska, SEK – korona szwedzka, DKK – korona duńska oraz UAH – hrywna ukraińska.

Kod a symbol waluty

Symbol zajmuje mało miejsca, dlatego pojawia się na metkach, rachunkach i stronach internetowych. Nie zapewnia jednak takiej precyzji jak kod. Znak ¥ odnosi się zarówno do jena japońskiego, jak i chińskiego renminbi, którego kodem jest CNY. Podobny problem dotyczy kilku dolarów oznaczanych wspólnym symbolem $.

Przykłady mniej oczywiste

Węgierski forint ma kod HUF i symbol Ft, a rand południowoafrykański jest oznaczany jako ZAR oraz R. Chiny stosują kod CNY, choć sama waluta bywa nazywana renminbi, natomiast yuan jest jej podstawową jednostką. W dokumentach elektronicznych najlepiej stosować kod ISO, nie sam znak graficzny.

Jeśli system ma zapisać walutę bez ryzyka pomyłki, użyj trzyliterowego kodu ISO 4217, a nie symbolu typu $, ¥ lub kr.

Jak sprawdzić kurs waluty w API NBP?

Serwis api.nbp.pl udostępnia publiczne Web API. Zapytania wysyła się metodą HTTP GET na adres bazowy https://api.nbp.pl/api/. Od 1 sierpnia 2025 r. połączenie musi korzystać z protokołu HTTPS. Zwykły adres HTTP nie jest już wspierany.

Domyślnym formatem odpowiedzi jest JSON. Format XML można wskazać parametrem ?format=xml albo nagłówkiem Accept: application/xml. Dla JSON stosuje się ?format=json lub nagłówek Accept: application/json.

Do wyszukania kursu pojedynczej waluty służy ścieżka /exchangerates/rates/{table}/{code}/. W miejsce {table} wpisuje się A, B albo C, a w miejsce {code} – kod ISO, na przykład USD.

Zakres dat zapisuje się według formatu RRRR-MM-DD. Jedno zapytanie nie może obejmować okresu dłuższego niż 93 dni. Przy braku danych dla poprawnego przedziału API zwraca kod 404 Not Found. Błędna składnia zapytania albo przekroczenie limitu danych powoduje odpowiedź 400 Bad Request.

Czym różnią się tabele kursów NBP?

Tabela A prezentuje średnie kursy walut obcych. To właśnie ona jest często wykorzystywana przy przeliczeniach księgowych i informacyjnych. Tabela B obejmuje wybrane waluty, natomiast Tabela C zawiera kursy kupna i sprzedaży walut obcych.

Przykładowo tabela C nr 159/C/NBP/2026 z 17 sierpnia 2026 r., obowiązująca od 18 sierpnia, podawała dla USD kurs kupna 3,6777 oraz kurs sprzedaży 3,7519. Dla EUR wartości wynosiły odpowiednio 4,2642 i 4,3504. Nie są to te same dane co średni kurs publikowany w tabeli A.

Kod waluty na fakturze

Na fakturze w euro powinny znaleźć się co najmniej kwota, kod EUR oraz kurs zastosowany do przeliczenia na złote, jeśli dokument wymaga wartości w PLN. Samo wpisanie kodu waluty nie przekazuje odbiorcy wartości kursu. To właśnie wtedy program księgowy może zgłosić komunikat o ujemnym lub zerowym kursie waluty.

Problem pojawia się zwłaszcza podczas importu faktury do innego systemu. Program może poprawnie odczytać pole Kod waluty, ale nie pobrać pola Kurs dokumentu. Wpisanie kursu wyłącznie w uwagach nie zawsze rozwiązuje sprawę, ponieważ uwagi są tekstem opisowym, a nie wartością liczbową przeznaczoną do obliczeń.

Kod EUR identyfikuje walutę, lecz nie określa kursu przeliczeniowego. W systemie księgowym kurs musi trafić do pola liczbowego dokumentu.

Jak uniknąć błędów przy sprawdzaniu kodu?

Przed zapisaniem danych sprawdź trzy elementy: kod literowy, numer ISO oraz datę kursu. Sam symbol może prowadzić do pomyłki, szczególnie przy dolarach i jenie. Trzeba też ustalić, czy dokument korzysta ze średniego kursu NBP, czy z kursu kupna albo sprzedaży z tabeli C.

W integracji informatycznej używaj adresów HTTPS i kontroluj format odpowiedzi. Dla automatycznego przetwarzania JSON jest ustawieniem domyślnym, ale system odbiorcy może wymagać XML. Walidacja kodu USD, EUR lub PLN przed wysłaniem faktury ogranicza ryzyko odrzucenia dokumentu.

Kalkulator walutowy NBP może posłużyć do orientacyjnego przeliczenia kwoty według danych publikowanych w dniach roboczych, z pominięciem weekendów i świąt. Notowania są dostępne od 1 stycznia 2002 r., lecz wynik takiego kalkulatora nie zastępuje kursu zapisanego w dokumencie księgowym.