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

Kod waluty to trzyliterowy skrót zgodny z normą ISO 4217, na przykład PLN dla polskiego złotego, EUR dla euro czy USD dla dolara amerykańskiego. Służy do jednoznacznej identyfikacji walut w systemach księgowych, bankowości elektronicznej i dokumentach. Można go sprawdzić w tabelach kursów NBP oraz przez publiczne API. W artykule wyjaśniamy, jak odczytywać te oznaczenia i skąd pobierać dane.

Czym jest kod waluty i dlaczego bywa mylący?

W codziennych płatnościach najczęściej posługujesz się symbolem graficznym, ale w dokumentach, przelewach zagranicznych i systemach ERP potrzebne jest jednoznaczne oznaczenie. Mowa o trzyliterowym kodzie, który opracowano po to, aby wykluczyć pomyłki między podobnymi nazwami walut. Przykładowo dolarów na świecie jest wiele, dlatego sam napis „dolar” nie wystarczy.

Standard ISO 4217 przypisuje taki kod każdej uznawanej jednostce monetarnej. W Polsce to PLN, w strefie euro EUR, a w Stanach Zjednoczonych USD. W praktyce ten sam skrót bywa wykorzystywany w fakturowaniu, integracjach z bankami i raportach finansowych.

Jak wygląda zapis zgodny z ISO 4217?

W standardzie każdy kod składa się z trzech dużych liter. Część z nich tworzy się z dwóch liter oznaczających kraj według ISO 3166 oraz jednej litery nawiązującej do nazwy waluty. Nie jest to jednak regułą – EUR dotyczy całej strefy euro, a XDR to specjalne prawa ciągnienia Międzynarodowego Funduszu Walutowego.

Co oznacza trzycyfrowy numer waluty?

Oprócz wersji literowej każda waluta ma również numer złożony z trzech cyfr. Dla polskiego złotego to 985, dla dolara amerykańskiego 840, a dla euro 978. Numer bywa używany w komunikatach SWIFT, systemach rezerwowych i dokumentach celnych. W tabelach NBP znajdziesz go w kolumnie „Num” obok kodu literowego.

Jak sprawdzić kod waluty w serwisie NBP?

Narodowy Bank Polski codziennie publikuje bieżące kursy walut obcych. Dane udostępnia w formie tabel kursowych oraz przez publiczny interfejs API, który pozwala pobierać informacje bezpośrednio do własnych aplikacji. Adres bazowy tego interfejsu to https://api.nbp.pl/api/.

W tabeli przygotowaliśmy zestawienie wybranych kodów literowych, numerów ISO oraz symboli graficznych:

Jak pobrać dane przez publiczne API?

Serwis api.nbp.pl udostępnia publiczne Web API, do którego wysyłasz żądanie HTTP GET. System zwraca dane o kursach, tabelach oraz cenie złota. Parametry opisują typ tabeli, kod waluty, liczbę rekordów oraz zakres dat.

Do najczęściej wykorzystywanych wzorców zapytań należą:

• pełna tabela kursów walut – /exchangerates/tables/{table}/,
• tabela z ostatnich kilku dni – /exchangerates/tables/{table}/last/{topCount}/,
• kurs konkretnej waluty – /exchangerates/rates/{table}/{code}/,
• notowania ceny złota – /cenyzlota/last/{topCount}.

Jaki format odpowiedzi wybrać?

Domyślnie serwis zwraca dane w formacie JSON. Jeśli potrzebujesz XML, możesz dodać parametr ?format=xml albo nagłówek Accept: application/xml. Nagłówek Accept: application/json oraz parametr ?format=json wymuszają z kolei JSON. Przy braku wskazania formatu pozostaje JSON, co jest wygodne przy integracji z aplikacjami księgowymi.

Daty przekazujesz zawsze w formacie RRRR-MM-DD, czyli według standardu ISO 8601. W przeciwnym razie serwis zgłosi błąd i nie zwróci danych.

Jakie komunikaty zwraca serwis przy błędach?

Gdy dla prawidłowo podanego zakresu nie ma danych, otrzymasz 404 Not Found. Nieprawidłowo zbudowane zapytanie lub przekroczenie dozwolonej liczby rekordów kończy się natomiast komunikatem 400 Bad Request z informacją „Przekroczony limit”. Warto też wiedzieć, że jedno zapytanie może obejmować maksymalnie 93 dni.

Możesz pytać o kompletne tabele A, B lub C, kurs pojedynczej waluty albo notowania złota. Przykładowe ścieżki to /exchangerates/rates/a/chf/, /exchangerates/rates/c/usd/today/ oraz /exchangerates/tables/a/last/5/.

Publiczne API NBP wymaga stosowania protokołu HTTPS od 1 sierpnia 2025 r. – wszystkie żądania muszą trafiać na adresy zaczynające się od https://.

Jak korzystać z kalkulatora walutowego?

Kalkulator online pozwala przeliczyć dowolną kwotę z jednej waluty na inną. Podstawą są dane publikowane codziennie przez Narodowy Bank Polski, z wyjątkiem weekendów i świąt. Archiwum obejmuje kursy od 1 stycznia 2002 r., więc sprawdzisz również starsze notowania.

Aby wykonać poprawne przeliczenie, wykonaj następujące kroki:

• wpisz kwotę, którą chcesz przeliczyć,
• wskaż walutę źródłową, na przykład EUR,
• wybierz walutę docelową, na przykład PLN,
• określ datę, dla której ma obowiązywać kurs.

Czy wynik kalkulatora jest wiążący?

Wyliczenia mają charakter poglądowy. Kalkulator opiera się na kursach średnich walut obcych wyrażonych w złotych z danego dnia. Dla dokumentów księgowych i faktur często konieczne jest użycie kursu z tabeli A lub tabeli B i odpowiedniego przeliczenia według przepisów. W przykładzie z 14 sierpnia 2026 r. kurs średni euro wynosił 4,3100 zł, a dolara amerykańskiego 3,7300 zł.

Do transakcji bankowych i dokumentów kupna-sprzedaży walut obcych stosuje się tabelę C, która zawiera kurs kupna i sprzedaży. W tabeli z 13 sierpnia 2026 r. dolar amerykański miał kurs kupna 3,6951, a sprzedaży 3,7697.

Kody literowe, numery i symbole – co jest potrzebne na fakturze?

W systemach fakturowych sam kod waluty bywa niewystarczający. Programy księgowe oczekują także kursu przeliczeniowego. Jeśli dokument ma wpisany kod EUR, ale kurs wynosi zero, może pojawić się komunikat podobny do „Dok. FVZ 0 – ujemny lub zerowy kurs waluty”. Wtedy należy uzupełnić wartość kursu z tabeli NBP obowiązującej na dany dzień.

Symbole graficzne są wygodne na metkach i paragonach, ale nie zawsze są jednoznaczne. Ten sam znak $ dotyczy dolara amerykańskiego, kanadyjskiego, australijskiego i nowozelandzkiego. Z kolei ¥ może oznaczać zarówno jena, jak i juana chińskiego. Dlatego w danych wymienianych między systemami lepiej stosować trzyliterowy skrót z ISO 4217.

Kod waluty i kurs przeliczeniowy to dwie osobne informacje – obie muszą się znaleźć w dokumencie księgowym, aby system poprawnie przyjął fakturę.