Ministerstwo Finansów - Krajowa Administracja Skarbowa

Ministerstwo Finansów udostępniło opis interfejsu programistycznego API Wykazu podatników VAT, tj. wykazu podmiotów zarejestrowanych, niezarejestrowanych oraz wykreślonych i przywróconych do rejestru VAT.

API zawiera dwie metody odpytywania o dane z wykazu:

• metodę pełną „search” – aby z niej skorzystać, wybierz jeden z parametrów: NIP, REGON lub numer rachunku bankowego oraz dzień, na jaki mają być wyświetlone informacje o podmiocie i uzyskasz:
  • cały zakres danych z wykazu o podmiotach, o które pytasz,
  • unikalny identyfikator – klucz elektroniczny, który jest potwierdzeniem wykonania zapytania (o jaki identyfikator podmiotu pytano, datę na jaki dzień została udzielona odpowiedź i datę zapytania);

• metodę uproszczoną „check”, która poprzez API skrócone będzie łączyła cię z wykazem po wprowadzeniu parametrów zapytania:
  • NIP lub REGON
  • NUMER RACHUNKU
  • DATA na jaki dzień ma być udzielona odpowiedź.

W odpowiedzi API zwróci następujące informacje:

• TAK lub NIE – informacje, które oznaczają, że dany rachunek przypisany jest (lub nie jest) do wyspecyfikowanego numeru podmiotu (w dniu DATA),
• elektroniczny klucz, który potwierdza wykonanie zapytania (o jaki identyfikator podmiotu pytano, datę na jaki dzień została udzielona odpowiedź i datę składania zapytania).

Uwaga

Korzystanie z API jest limitowane. Przy wykorzystaniu metody „search” możesz złożyć 10 zapytań o maksymalnie 30 podmiotów jednocześnie, natomiast przy wykorzystaniu metody „check” możesz zapytać o 1 podmiot. Po wyczerpaniu tego limitu dostęp do API jest blokowany do godziny 0:00.

W listopadzie 2019 r. został opublikowany plik tekstowy do pobierania przez użytkowników, który zawiera pełną listę par NIP-rachunek, co pozwala na masową weryfikację transakcji w systemach finansowo-księgowych. Dane te są zabezpieczone kryptograficznie (z wykorzystaniem jednokierunkowych funkcji skrótu) w taki sposób, aby jedynie posiadacz poprawnych danych z pary NIP-rachunek mógł zweryfikować istnienie tej pary w wykazie. Lista uwzględnia możliwość weryfikacji rachunków powiązanych z rachunkami rozliczeniowymi w połączeniu z identyfikatorem podatkowym podmiotu.

Dane do pobrania są publikowane codziennie i aktualizowane raz na dobę w dni robocze. Każdy plik zawiera wszystkie aktualne dane z wykazu.

Informacje są szyfrowane parami NIP-Numer Rachunku. Możesz weryfikować status podatnika na podstawie udostępnionego algorytmu. Opis algorytmu i sposobu korzystania z zaszyfrowanej listy jest opisany na stronie internetowej wykazu.

Adres testowy API: https://wl-test.mf.gov.pl/

Adres produkcyjnego API: https://wl-api.mf.gov.pl