Jak działa kalkulator walutowy NBP?
Po załadowaniu strony kalkulator wykonuje zapytanie do oficjalnego API NBP:
- Fetch:
https://api.nbp.pl/api/exchangerates/tables/A/?format=json - Odpowiedź zawiera tablicę A z ok. 35 walutami i ich kursami średnimi na aktualny dzień roboczy.
- Przeliczenie:
wynik = kwota × kurs_źródłowy / kurs_docelowy. Dla PLN kurs = 1. - Kurs krzyżowy (np. EUR/USD bez PLN):
EUR/USD = EUR/PLN ÷ USD/PLN.
Jeżeli API NBP jest niedostępne, kalkulator zatrzymuje przeliczenia i wyświetla komunikat. Nie używa zapisanych na stałe kursów zastępczych, które mogłyby wprowadzić użytkownika w błąd.
Przykłady przeliczeń — bez udawania bieżącego kursu
Poniższe wartości są scenariuszem edukacyjnym, a nie notowaniem z konkretnego dnia. Bieżący wynik znajduje się wyżej i zawiera datę tabeli NBP zwróconą przez API.
| Kwota | Założony kurs | Działanie | Wynik |
|---|---|---|---|
| 1 000 EUR | 4,30 PLN/EUR | 1 000 × 4,30 | 4 300 zł |
| 2 500 USD | 4,00 PLN/USD | 2 500 × 4,00 | 10 000 zł |
| 10 000 zł | 4,00 PLN/USD | 10 000 ÷ 4,00 | 2 500 USD |
Przykład do rozliczenia — najpierw ustal właściwy dzień
Przy fakturze 5 000 EUR nie należy automatycznie używać kursu widocznego dziś. Najpierw ustal datę właściwą według przepisów dotyczących danego podatku i zdarzenia, a następnie pobierz historyczny kurs NBP z ostatniego właściwego dnia roboczego. Dla kursu 4,2850 zł przykładowa wartość wynosi 21 425 zł.
Jak interpretować kursy walut NBP
Kurs średni (Tabela A) — to kurs referencyjny NBP, nie transakcyjny. Nie kupujesz ani nie sprzedajesz walut po tym kursie w banku. Służy do wyceny bilansów, rozliczeń podatkowych i faktur w walutach obcych.
Spread i opłaty — spread to różnica między kursem kupna i sprzedaży. Sam procent spreadu nie pokazuje całego kosztu, jeżeli oferta zawiera prowizję lub opłatę za przelew. Porównuj końcową kwotę transakcji.
Kurs JPY i CZK — w Tabeli A NBP notowane są jako kurs za 100 jednostek (nie 1). Kurs 2,64 zł dla JPY oznacza 100 JPY = 2,64 zł, czyli 1 JPY = 0,0264 zł.
Kurs waluty w rozliczeniu podatkowym
Właściwy kurs zależy od rodzaju podatku, momentu powstania przychodu lub kosztu, obowiązku podatkowego oraz terminu wystawienia faktury. Dlatego bieżący kurs z kalkulatora nie powinien być automatycznie używany do księgowania dokumentu.
| Krok | Co sprawdzić | Dlaczego |
|---|---|---|
| 1 | Rodzaj rozliczenia: VAT, PIT albo CIT | Przepisy wskazują różne momenty powstania obowiązku |
| 2 | Datę zdarzenia i wystawienia dokumentu | Od niej może zależeć właściwy dzień kursu |
| 3 | Czy wystąpił kurs faktycznie zastosowany | W niektórych rozliczeniach może mieć znaczenie kurs transakcyjny |
| 4 | Pobierz właściwą tabelę historyczną NBP | Zachowaj numer i datę tabeli w dokumentacji |
To zestawienie ma charakter organizacyjny. Przy konkretnym dokumencie należy sprawdzić aktualne wyjaśnienia Ministerstwa Finansów albo skonsultować rozliczenie z księgowością.
Najczęstsze błędy przy przeliczaniu walut
- Użycie dzisiejszego kursu do starego dokumentu — do rozliczenia może być potrzebna tabela historyczna z dnia wynikającego z przepisów.
- Mylenie kursu średniego z ofertą wymiany — kurs Tabeli A nie gwarantuje kwoty, którą wypłaci bank lub kantor.
- Porównywanie tylko kursu, bez prowizji — liczy się końcowa kwota po wszystkich opłatach.
- Brak zapisu źródła — przy rozliczeniu warto zachować datę i numer tabeli lub potwierdzenie kursu faktycznie zastosowanego.
Najczęściej zadawane pytania
Kalkulator wyświetla kurs średni NBP z Tabeli A — kurs referencyjny, nie transakcyjny. Bank lub kantor stosuje własny kurs kupna albo sprzedaży i może naliczać dodatkowe opłaty.
NBP aktualizuje Tabelę A w dni robocze między 11:45 a 12:15. Kalkulator zawsze pokazuje datę tabeli zwróconą przez API, dlatego rano może prawidłowo wskazywać poprzedni dzień roboczy.
NBP nie publikuje tabel kursów kryptowalut, więc ten kalkulator ich nie obsługuje. Sposób udokumentowania wartości transakcji krypto zależy od rodzaju operacji i rozliczenia podatkowego; należy korzystać z danych transakcyjnych platformy oraz aktualnych objaśnień podatkowych.