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ć 100 zapytań dziennie o maksymalnie 30 podmiotów jednocześnie, natomiast przy wykorzystaniu metody „check” możecie zapytać o 5000 podmiotów. Po wyczerpaniu jednego z limitów dostęp do API może być zablokowany do godziny 0:00. Blokada obejmie dostęp do wyszukiwania metodą "search", "check" oraz za pomocą wyszukiwarki na stronie https://www.podatki.gov.pl/wykaz-podatnikow-vat-wyszukiwarka/.

Wdrożone limity pobierania danych mają na celu ochronę dostępności API dla wszystkich użytkowników. Blokowanie jest fakultatywne, ale aby być pewnym braku blokady Państwa systemu należy stosować się do limitów określonych powyżej. Systemy zabezpieczeń uniemożliwiają również szkodliwe działanie poprzez zbyt szybkie odpytywanie API przez systemy zewnętrzne, co może spowodować spadek wydajności systemu. Szczegóły techniczne wprowadzonych zabezpieczeń oraz sposób zakładania blokad nie będzie publikowany ze względów bezpieczeństwa.

Jednocześnie informujemy, że do integracji z systemami weryfikującymi bardzo dużą ilość podatników VAT został przygotowany plik płaski, który jest publikowany codziennie o północy i zawiera wszystkie dane niezbędne do bieżącej weryfikacji (https://www.podatki.gov.pl/vat/bezpieczna-transakcja/wykaz-podatnikow-vat/plik-plaski/).

Plik płaski, który został opublikowany w listopadzie 2019 r. jest plikiem tekstowym do pobierania przez użytkowników, 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