Ministerstwo Finansów - Krajowa Administracja Skarbowa

Komunikat
Zweryfikuj na środowisku testowym, czy twoje API jest właściwie skonfigurowane 

Od 01.03.2021 r. obowiązuje nowa wersja API Wykazu Podatników VAT. 
Zbadaj wpływ modyfikacji na aplikacje korzystające automatycznie z API Wykazu Podatników VAT.
Nowa wersja API znajduje się już na środowisku testowym.
Od 01.03.2021 r. odpowiedzi zwracane przez API są poprzedzone treścią zapytania do Wykazu Podatników VAT.  
 

Ministerstwo Finansów udostępniło 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, 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