API stawek VAT: JSON, pola i przykłady
API udostępnia statyczny plik JSON z danymi referencyjnymi dla 174 krajów. Nie wymaga konta ani klucza. Odpowiedź i nazwy pól zachowują angielski kontrakt techniczny.
Zalecany endpoint
GET https://vatestimator.com/api/v1/rates.jsonStarszy endpoint /api/rates.json pozostaje dostępny. Dla nowych integracji wybierz wersję v1.
Przykład JavaScript
const response = await fetch('https://vatestimator.com/api/v1/rates.json');
const data = await response.json();
const poland = data.rates.find(row => row.code === 'PL');
console.log(poland.standard_rate);Najważniejsze pola
code- Kod ISO kraju, np. PL.
currency_code- Kod ISO waluty; currency jest tylko symbolem.
standard_rate- Stawka podstawowa albo null, gdy nie jest porównywalna.
rates[].rate_percent- Procent; rate jest starszym aliasem.
calculation_method / tax_model- Metoda obliczania i zakres składników.
official_source_url / last_verified- Oficjalne źródło i data weryfikacji danego kraju.
meta.schema_version- Wersja schematu: obecnie 1.2 w endpoincie v1.
Szczególne modele
Wartość null w stawce podstawowej oznacza brak jednej porównywalnej stawki krajowej. Przeczytaj tax_model, kontekst stawki i metodę obliczeń. Dla tax_inclusive_base: brutto = kwota bez składnika ÷ (1 − stawka/100). Taka kwota wyłącza tylko wybrany składnik podatku.
Daty, waluty i oznaczenie źródła
W logice używaj currency_code; symbol może oznaczać różne waluty. meta.last_verified nie oznacza sprawdzenia wszystkich krajów tego dnia: odczytaj rates[].last_verified. Zbiór jest bezpłatny z podaniem VATEstimator jako źródła. Przed wystawieniem faktury sprawdź źródła oficjalne.
Ograniczenia obliczenia
Stawki i zasady mogą się zmieniać. Przed wystawieniem faktury sprawdź warunki w oficjalnym źródle kraju. Kalkulator wykonuje działanie matematyczne, ale nie ustala klasyfikacji podatkowej.