Ministerstwo Finansów - Krajowa Administracja Skarbowa

Ministerstwo Finansów udostępnia opis interfejsu programistycznego API nowego 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, fragment nazwy, 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 będzie zablokowany do godziny 0:00.

W listopadzie 2019 r. planowana jest publikacja pliku tekstowego 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 będą 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 będzie także uwzględniać możliwość weryfikacji rachunków powiązanych z rachunkami rozliczeniowymi w połączeniu z identyfikatorem podatkowym podmiotu.

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

Informacje będą szyfrowane parami NIP-Numer Rachunku. Będziesz mógł weryfikować status podatnika na podstawie udostępnionego algorytmu. Opis algorytmu i sposobu korzystania z zaszyfrowanej listy będzie opisany na stronie internetowej wykazu.

Ministerstwo Finansów informuje o z zmianie wersji API

W dniu 10 stycznia 2020 r. została opublikowana nowa testowa wersja API wraz z dokumentacją. Zmiany dotyczą następujących danych:

1. We wszystkich rodzajach API dodano informację o dacie i godzinie zapytania z serwera.
2. W metodzie API Check pozwalające na weryfikację rachunków wirtualnych.
3. W metodzie API Check pozwalające na weryfikację podatników zwolnionych.

Nowe API zostanie wdrożone na produkcji w dniu 28 stycznia 2020 r.

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

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