Kod waluty – co to jest i jak sprawdzić oznaczenia walut?

Kod waluty to trzyliterowe oznaczenie pieniądza obowiązującego w danym kraju lub obszarze, ustalone według standardu ISO 4217. Taki zapis bywa niezbędny przy przelewach zagranicznych, fakturowaniu oraz integracji systemów księgowych. W dalszej części wyjaśniamy, jak sprawdzić oznaczenia walut i gdzie znaleźć wiarygodne dane o kursach.

Czym jest kod waluty i dlaczego jest potrzebny?

Kod waluty to skrót literowy, który jednoznacznie identyfikuje daną jednostkę monetarną na całym świecie. W większości przypadków składa się z trzech znaków, np. PLN dla polskiego złotego, EUR dla euro czy USD dla dolara amerykańskiego. Dzięki takiemu zapisowi nie trzeba używać pełnych nazw, które potrafią być naprawdę długie. Wystarczy porównać „manat azerbejdżański” z kodem AZN albo „funt południowosudański” z SSP.

Potrzeba ujednolicenia oznaczeń pojawiła się wraz z rozwojem międzynarodowego handlu i bankowości elektronicznej. Przelew zagraniczny, faktura dla kontrahenta z innego kraju czy wymiana walut w kantorze internetowym wymagają precyzyjnego wskazania waluty. Użycie samego symbolu graficznego bywa mylące, ponieważ znak $ oznacza nie tylko dolara amerykańskiego, lecz także australijskiego, kanadyjskiego, nowozelandzkiego czy singapurskiego.

Mylące potrafią być także skróty potoczne stosowane w różnych językach. Węgierski forint ma kod HUF, który wielu osobom niewiele mówi, dopóki nie skojarzą go z angielską nazwą Hungary. Dlatego w systemach informatycznych, dokumentach księgowych i na platformach transakcyjnych stosuje się ustandaryzowane kody zamiast nazw zwyczajowych.

Jak działa standard ISO 4217?

Za ujednolicenie oznaczeń walut odpowiada Międzynarodowa Organizacja Normalizacyjna. Standard ISO 4217 definiuje nie tylko kody literowe, ale również numeryczne. Na przykład euro ma oznaczenie literowe EUR i kod numeryczny 978, natomiast polski złoty to PLN z numerem 985. Numer bywa wykorzystywany w systemach płatniczych, które operują na danych cyfrowych i nie chcą polegać na literach o różnych alfabetach.

Trzyliterowa konstrukcja kodu zwykle nawiązuje do nazwy kraju lub samej waluty. Pierwsze dwie litery często pochodzą od kodu kraju według ISO 3166, a trzecia bywa pierwszą literą nazwy waluty. Dolar amerykański to połączenie US i D, stąd USD. Funt szterling ma kod GBP od Great Britain Pound, choć sama nazwa „pound” wywodzi się z rzymskiej jednostki masy libra. Do dziś funt jako jednostka masy to 0,453 kg, a symbol £ to stylizowana przekreślona litera L.

W standardzie ISO 4217 znajdziemy również oznaczenia, które nie są przypisane do konkretnego kraju. Dobrym przykładem jest XDR, czyli specjalne prawa ciągnienia Międzynarodowego Funduszu Walutowego. Zdarzają się też kody testowe, a w tabelach pojawia się oznaczenie braku uniwersalnej waluty dla terytoriów takich jak Antarktyda.

Kod literowy a kod numeryczny

Kod literowy sprawdza się w komunikacji między ludźmi, natomiast kod numeryczny ułatwia pracę systemom informatycznym. W pełnej tabeli ISO 4217 każda waluta ma oba warianty. Dla franka szwajcarskiego to odpowiednio CHF i 756, dla dolara kanadyjskiego CAD i 124, a dla hrywny ukraińskiej UAH i 980. Dzięki temu nawet systemy obsługujące wyłącznie cyfry mogą bez problemu zapisać i przetworzyć informację o walucie.

W praktyce kod numeryczny pojawia się rzadziej w codziennym użyciu, ale zna się na nim personel bankowy i programiści systemów ERP. Warto o nim pamiętać, gdy aplikacja księgowa pyta o dodatkowy identyfikator waluty obok kodu literowego.

Jak sprawdzić oznaczenia walut?

Najprostszym źródłem pozostaje pełna tabela standardu ISO 4217. Zawiera ona nazwę waluty, kod literowy, kod numeryczny oraz miejsce jej używania. Znajdziemy tam m.in. BGN dla lewa bułgarskiego, RON dla leja rumuńskiego, CZK dla korony czeskiej, DKK dla korony duńskiej, NOK dla korony norweskiej i SEK dla korony szwedzkiej. Tabela porządkuje nawet tak egzotyczne waluty jak VUV vatu z Vanuatu, TOP paʻanga z Tonga czy MRU ugija z Mauretanii.

Pomocne są również witryny banków centralnych i serwisy kantorów online. Zazwyczaj pokazują one aktualne kursy razem z kodami walut, dzięki czemu łatwo zweryfikować poprawność oznaczenia. W razie wątpliwości warto wyszukać zapytanie o konkretny kraj i nazwę waluty – bankowe bazy danych zwykle odnoszą się do aktualnej wersji standardu ISO.

Kursy walut można też sprawdzić w tabelach publikowanych przez Narodowy Bank Polski. Codziennie ukazują się dane o średnich kursach, a w tabeli C dodatkowo o kursach kupna i sprzedaży. Oznaczenia w tabelach NBP również są zgodne z ISO 4217, dlatego nie ma rozbieżności między zapisem w banku a oznaczeniem w systemie fakturowym.

Jakie dane znajdziesz w tabeli symboli?

Symbol waluty to znak graficzny lub krótki skrót, który ułatwia codzienny zapis cen. W wielu przypadkach symbol bywa wygodniejszy niż kod trzyliterowy, ale bywa także źródłem pomyłek. Tabela symboli pozwala zestawić kraj, nazwę waluty, kod oraz jej graficzne przedstawienie.

Symbol euro € nawiązuje do greckiej litery epsilon i pierwszej litery słowa „Europa”. Dwie równoległe linie przecinające znak miały w zamierzeniu twórców symbolizować stabilność. Symbol dolara $ to z kolei przekształcone przekreślone S, które ma swoją genezę w zapisie hiszpańskiego peso z czasów kolonialnych.

Gdzie sprawdzić aktualny kurs waluty?

Kursy walut można odczytać z oficjalnych tabel Narodowego Banku Polskiego. W 2026 roku NBP udostępnia dane o kursach średnich oraz o kursach kupna i sprzedaży określonych w uchwale nr 44/2025 Zarządu NBP z 18 grudnia 2025 r. Tabela nr 156/C/NBP/2026 z 12 sierpnia 2026 roku, obowiązująca od 13 sierpnia 2026 roku, podaje przykładowo kurs kupna euro na poziomie 4,2599, a sprzedaży 4,3459. Z kolei dolar amerykański ma kurs kupna 3,6874 i sprzedaży 3,7618.

Średnie kursy z tabeli A z 13 sierpnia 2026 roku pokazują nieco inne wartości. Euro kosztowało 4,3058 zł, dolar amerykański 3,7362 zł, frank szwajcarski 4,5963 zł, a funt szterling 5,0363 zł. Różnice między tabelą średnią a tabelą kupna i sprzedaży wynikają z marży oraz przeznaczenia poszczególnych notowań.

Warto pamiętać, że tabela kursów średnich ma charakter poglądowy. Wyliczenia na jej podstawie nie mogą stanowić podstawy roszczeń wobec Ministerstwa Finansów. Do rzeczywistych transakcji kantorowych stosuje się zwykle kursy kupna i sprzedaży z tabeli C albo ceny oferowane przez konkretny kantor internetowy lub bank.

Kalkulator walutowy online

Narzędzie do przeliczania walut opiera się na danych publikowanych codziennie przez Narodowy Bank Polski. Kalkulator zawiera kursy walut od 1.01.2002 r. i pozwala sprawdzić wartość dowolnej kwoty w innej walucie dla wybranej daty. Wystarczy wskazać kwotę, walutę źródłową, walutę docelową oraz datę, dla której ma zostać wykonane przeliczenie.

Trzeba jednak pamiętać, że w weekendy i święta nowe kursy zwykle nie są ogłaszane. Wtedy kalkulator może korzystać z ostatniej dostępnej tabeli. To samo dotyczy dni, w których bank centralny nie publikuje notowań.

Przykładowe kursy średnie z 13 sierpnia 2026 roku wyglądają następująco:

W przypadku kwot przeliczanych w kantorach nie należy sugerować się wyłącznie kursem średnim. Znaczenie ma też spread, czyli różnica między ceną kupna i sprzedaży. Im mniejsza różnica, tym korzystniejsza transakcja dla klienta.

Jak sprawdzić kurs i kod waluty przez API NBP?

Narodowy Bank Polski prowadzi serwis api.nbp.pl, który udostępnia publiczne Web API. Dzięki niemu klienci HTTP mogą pobierać dane publikowane na stronach NBP bez ręcznego przeglądania tabel. To wygodne rozwiązanie dla programistów tworzących systemy fakturowania, księgowości lub analiz finansowych. Komunikacja polega na wysłaniu odpowiednio sparametryzowanego żądania HTTP GET na adres bazowy https://api.nbp.pl/api/.

Od 1 sierpnia 2025 r. cała komunikacja z API NBP musi odbywać się wyłącznie za pomocą protokołu HTTPS. Starszy protokół HTTP nie jest już wspierany. To ważna informacja dla firm, które mają własne integracje z serwisem NBP – bez aktualizacji punktów końcowych aplikacja może przestać pobierać dane.

Odpowiedź z serwisu może zostać zwrócona w formacie JSON lub XML. Domyślnie serwis zwraca JSON, jeśli użytkownik nie wskaże formatu. Można go określić na dwa sposoby – przez parametr zapytania ?format=json albo przez nagłówek HTTP Accept: application/json. W przypadku XML-a używa się odpowiednio ?format=xml lub Accept: application/xml.

Pojedyncze zapytanie nie może obejmować przedziału dłuższego niż 93 dni. To ograniczenie wymusza dzielenie dłuższych okresów na mniejsze części. Daty podaje się w formacie RRRR-MM-DD, zgodnie ze standardem ISO 8601.

Parametry zapytań o kursy

Budując adres URL zapytania, można posługiwać się parametrami oznaczanymi w dokumentacji nawiasami klamrowymi. Każdy z nich ma jasno określone znaczenie:

• {table} – typ tabeli: A, B lub C,
• {code} – trzyliterowy kod waluty według ISO 4217,
• {topCount} – maksymalna liczba zwracanych danych,
• {date}, {startDate}, {endDate} – data lub zakres dat w formacie RRRR-MM-DD.

Tabele typu A zawierają kursy średnie, tabela B kursy średnie walut mniej popularnych, a tabela C kursy kupna i sprzedaży. W praktyce najczęściej używa się tabeli A do poglądowych przeliczeń i tabeli C do transakcji wymiany.

Przykłady zapytań o waluty

Serwis NBP pozwala pobrać zarówno kompletne tabele kursów, jak i dane pojedynczej waluty. Poniższe wzorce pokazują najważniejsze rodzaje zapytań:

Zapytanie o konkretną datę zwróci dane tylko wtedy, gdy w tym dniu opublikowano tabelę. Jeśli danych nie ma, serwis odpowie kodem 404 Not Found. Nieprawidłowo sformułowane zapytanie kończy się komunikatem 400 Bad Request. Przekroczenie limitu zwracanych danych również skutkuje błędem 400 z informacją o przekroczonym limicie.

Serwis obsługuje też notowania ceny złota. Adres bazowy https://api.nbp.pl/api/cenyzlota zwraca bieżące notowanie, a wariant https://api.nbp.pl/api/cenyzlota/last/30/?format=json udostępnia 30 ostatnich wartości. Notowania z pojedynczego dnia pobierze się przez adres z datą, np. https://api.nbp.pl/api/cenyzlota/2013-01-02/.

Jak pobrać dane o konkretnej walucie?

Gdy potrzebujesz kursu pojedynczej waluty, w ścieżce zapytania umieszcza się jej kod trzyliterowy. Na przykład adres https://api.nbp.pl/api/exchangerates/rates/a/chf/ zwróci dane franka szwajcarskiego z tabeli A. W ten sam sposób pobierzesz kursy dolara kanadyjskiego, funta szterlinga czy jena japońskiego.

W zapytaniach o kilka dni stosuje się zakres dat. Przykład od 2026-01-01 do 2026-01-31 musi mieścić się w limicie 93 dni. Zmiana formatu odpowiedzi na XML odbywa się przez parametr ?format=xml. Wtedy odpowiedź ma strukturę drzewiastą, co bywa wygodne przy integracji z systemami opartymi na XML-u.

Kod waluty w API NBP zawsze podaje się małymi literami w adresie URL, mimo że standard ISO 4217 zapisuje go wielkimi literami. Przykładowo dla euro będzie to „eur”, a dla dolara amerykańskiego „usd”.

Kod waluty a symbol graficzny – czym się różnią?

Kod waluty to ustandaryzowane oznaczenie systemowe, natomiast symbol graficzny służy głównie do prezentacji wizualnej. Symbol € dla euro, ¥ dla jena i juana oraz ₪ dla nowego szekla izraelskiego pojawia się na metkach cenowych, w reklamach i w menu restauracji. Kod lepiej sprawdza się w przelewach, fakturowaniu i analizie danych.

Symbole nie zawsze są jednoznaczne. Znak ¥ bywa używany dla jena japońskiego i juana chińskiego. Znak kr oznacza koronę duńską, norweską i szwedzką. Nawet symbol R dla randa południowoafrykańskiego jest prostszy od kodu ZAR, ale w dokumentach księgowych lepiej podawać oznaczenie trzyliterowe. Pomyłka na styku systemów fianansowych bywa kosztowna.

Dlaczego sam kod waluty nie wystarczy w KSeF?

W e-fakturach sam zapis kodu waluty, np. EUR, może okazać się niewystarczający. Część programów księgowych wymaga podania również kursu, po jakim faktura została przeliczona na złote. Problem pojawia się, gdy odbiorca faktury importuje dokument i widzi komunikat Dok. FVZ 0 – ujemny lub zerowy kurs waluty. Oznacza to, że w pliku brakuje poprawnej wartości kursu dokumentu.

Takie błędy wynikają zwykle z niekompletnej integracji między systemem fakturowym a KSeF. Aplikacja wystawiająca fakturę w euro może poprawnie przeliczyć kwotę na złotówki, ale nie zapisze kursu jako odrębnego pola wymaganego przez odbiorcę. Ręczne wpisywanie kursu w uwagach nie rozwiązuje problemu, bo program po drugiej stronie nadal nie znajdzie go we właściwym elemencie struktury XML.

Dlatego przy wdrażaniu fakturowania walutowego trzeba sprawdzić, czy system udostępnia pole kursu wymiany oraz czy kod waluty jest eksportowany zgodnie ze standardem ISO 4217. W dokumentach ustrukturyzowanych KSeF ważne są obie informacje – waluta i jej kurs. W przeciwnym razie dokument może zostać przyjęty przez KSeF, ale odbiorca zobaczy błąd w swoim programie.

Jak wygląda pełna lista kodów walut?

Pełna tabela ISO 4217 obejmuje kilkaset pozycji, w tym waluty historyczne, testowe i specjalne jednostki rozrachunkowe. Znajdziemy tam m.in. AFN afgani z Afganistanu, ALL leka z Albanii, DZD dinara algierskiego, AMD drama z Armenii i AOA kwanzę z Angoli. Sporo pozycji dotyczy terytoriów zamorskich stosujących walutę innego państwa.

Wiele krajów korzysta z dolara amerykańskiego jako waluty lokalnej. Należą do nich Ekwador, Panama, Timor Wschodni, Mikronezja, Palau i Wyspy Marshalla. Z kolei euro obowiązuje poza Unią Europejską m.in. w Monako, San Marino, Watykanie, Andorze, Czarnogórze oraz we francuskich terytoriach zależnych. Poprawne określenie kodu waluty wymaga więc znajomości nie tyle kraju, co faktycznego środka płatniczego.

Do ciekawostek można zaliczyć XAU, kod oznaczający jedną uncję trojańską złota, oraz XAG dla srebra. Nie są to waluty obiegowe, lecz metale szlachetne jako aktywa. Kody z grupy X zarezerwowano właśnie dla jednostek nieprzypisanych do jednego państwa. Należą do nich też XDR specjalne prawa ciągnienia, XOF i XAF dla franka CFA oraz XPF dla franka CFP na terytoriach pacyficznych.

Najczęściej spotykane kody walut

W polskich firmach najczęściej pojawiają się kody walut sąsiadów i głównych partnerów handlowych. Należą do nich:

• EUR – euro w strefie euro,
• USD – dolar amerykański,
• GBP – funt szterling,
• CHF – frank szwajcarski,
• CZK – korona czeska,
• DKK – korona duńska,
• HUF – forint węgierski,
• SEK – korona szwedzka,
• NOK – korona norweska,
• UAH – hrywna ukraińska.

W handlu z Azją przydatne bywają CNY juan renminbi, JPY jen, KRW won południowokoreański, THB bat tajlandzki i INR rupia indyjska. W ekspansji na rynki afrykańskie pojawiają się natomiast ZAR rand południowoafrykański, NGN naira nigeryjska i EGP funt egipski.

Kody popularne w transakcjach internetowych

Przy płatnościach kartą lub portfelem internetowym kod waluty pojawia się zwykle obok kwoty. W zestawieniach bankowych transakcje bywają zapisywane w walucie rozliczeniowej, a potem przeliczane na walutę karty. Właściwe rozpoznanie kodu pomaga uniknąć nieporozumień przy reklamacji lub zwrocie płatności.

W praktyce e-commerce często pojawiają się kody USD, EUR i PLN, ale sprzedawcy obsługujący rynki wschodzące spotykają się też z BRL realem brazylijskim, MXN peso meksykańskim czy TRY lirą turecką. Właściwe oznaczenie w pliku produktowym i bramce płatniczej decyduje o poprawności księgowania transakcji.

Nie warto improwizować z zapisem skrótów. „EU” zamiast EUR, „USD” pomyłkowo użyte dla dolara kanadyjskiego albo „CHF” zapisane jako „FR” to prosta droga do odrzucenia przelewu lub korekty faktury. Jeśli system nie podpowiada kodu automatycznie, najbezpieczniej jest zajrzeć do aktualnej tabeli ISO 4217.

Jak poprawnie oznaczyć walutę na fakturze?

Na fakturze walutowej obok kwoty należy podać trzyliterowy kod waluty zgodny z ISO 4217. Polskie programy księgowe zwykle oferują słownik walut, w którym wybiera się odpowiednią pozycję. System sam wstawia kod do dokumentu i pilnuje przeliczenia na złote według przyjętego kursu. Podobnie dzieje się przy eksporcie do KSeF – ważne jest, aby waluta i kurs znalazły się w polach ustrukturyzowanych, a nie tylko w opisie lub uwagach.

Kurs przeliczenia może pochodzić z tabeli NBP, z banku obsługującego transakcję lub z innego uzgodnionego źródła. W dokumentach podatkowych stosuje się reguły wynikające z przepisów o podatku dochodowym i VAT. Sam zapis kodu waluty nie budzi wątpliwości, jeśli używa się oficjalnej listy. Dla euro przyjmuje się EUR, dla funta GBP, dla dolara amerykańskiego USD, a dla franka szwajcarskiego CHF.

Problem zerowego kursu w fakturze walutowej zwykle dotyczy dokumentów z tabeli C albo błędnej konfiguracji modułu walutowego. W systemach ERP ustawia się domyślne źródło kursu oraz datę jego pobrania. Gdy źródło jest nieaktywne, program może wstawić wartość zero. Stąd komunikaty typu Dok. FVZ 0 – ujemny lub zerowy kurs waluty u odbiorcy.

Gdzie zgłosić błąd w oznaczeniu waluty?

Gdy w systemie księgowym pojawia się nietypowy kod lub symbol, pierwszym krokiem jest weryfikacja w aktualnej tabeli ISO 4217. Jeśli kod okazuje się poprawny, problem może leżeć po stronie integracji z bankiem, kantorem lub KSeF. Wtedy należy sprawdzić logi aplikacji oraz konfigurację słownika walut.

W razie błędu w danych publikowanych przez NBP lub wątpliwości co do działania API, pomocne są informacje dostępne na stronach banku centralnego. Serwis api.nbp.pl zwraca komunikaty, które zwykle wskazują przyczynę problemu. Dla braku danych będzie to 404 Not Found, a dla niepoprawnego zapytania 400 Bad Request.

Warto też pamiętać, że poglądy i dane z serwisów informacyjnych nie stanowią rekomendacji inwestycyjnej w rozumieniu ustawy z dnia 29 lipca 2005 r. o obrocie instrumentami finansowymi. Decyzje dotyczące wymiany walut podejmuje użytkownik na własną odpowiedzialność. Dotyczy to zwłaszcza transakcji o charakterze spekulacyjnym, a nie zwykłego przeliczania faktur.

Znajomość kodów walut przydaje się także poza księgowością. Podróże służbowe, zakupy zagraniczne, wypłaty dla kontrahentów i rozliczenia delegacji wymagają precyzyjnego zapisu waluty. Dzięki ustandaryzowanym oznaczeniom te same dane mogą być odczytywane przez różne systemy bez konieczności ręcznych poprawek.