API Wykazu podatników VAT
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:
- We wszystkich rodzajach API dodano informację o dacie i godzinie zapytania z serwera.
- W metodzie API Check pozwalające na weryfikację rachunków wirtualnych.
- 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
Materiały
API Wykazu podmiotów zarejestrowanych, niezarejestrowanych oraz wykreślonych i przywróconych do rejestru VAT wersja z 08.02.2021 r.SwaggerAPI.yml 0.02MB Wykaz podatników VAT opis API v 1-5-0 wersja z 08.02.2021 r.
WykazPodatnikowOpisAPI_v1_5_0.pdf 0.16MB Komunikat błędów wykazu podatników VAT wersja z 08.02.2021 r.
KOD_Bledu.xls 0.03MB Dokumentacja API wersja z 08.02.2021 r.
DokumentacjaAPI.html 0.05MB API Wykazu podmiotów zarejestrowanych, niezarejestrowanych oraz wykreślonych i przywróconych do rejestru VAT wersja z 10.01.2020 r.r.
SwaggerAPI.yml 0.02MB Wykaz podatników VAT opis API v 1-4-0 wersja z 10.01.2020 r.
WykazPodatnikowOpisAPI_v1_4_0.pdf 0.16MB Komunikat błędów wykazu podatników VAT wersja z 10.01.2020 r.
KOD_Bledu.xls 0.02MB Dokumentacja API wersja z 10.01.2020 r.
DokumentacjaAPI.html 0.04MB API Wykazu podmiotów zarejestrowanych, niezarejestrowanych oraz wykreślonych i przywróconych do rejestru VAT wersja z 08.10.2019 r.
SwaggerAPI.yml 0.02MB Wykaz podatników VAT opis API v 1-3-0 wersja z 08.10.2019 r.
WykazPodatnikowOpisAPI_v1_3_0.pdf 0.16MB Komunikat błędów wykazu podatników VAT wersja z 08.10.2019 r.
KOD_Bledu.pdf 0.43MB Dane Testowe API wersja z 1.09.2019 r.
DaneTestowe-API-1.txt 0.04MB Dokumentacja API wersja z 08.10.2019 r.
DokumentacjaAPI.html 0.04MB
- Pierwsza publikacja:
- 09.08.2019 13:54 Małgorzata Rojek
- Wytwarzający/ Odpowiadający:
- Departament Poboru Podatków
Tytuł | Wersja | Dane zmiany / publikacji |
---|---|---|
API Wykazu podatników VAT | 17.0 | 15.07.2021 09:59 Małgorzata Rojek |
API Wykazu podatników VAT | 16.0 | 15.07.2021 09:58 Małgorzata Rojek |
API Wykazu podatników VAT | 15.0 | 09.02.2021 08:38 Małgorzata Rojek |
API Wykazu podatników VAT | 14.0 | 08.02.2021 14:33 Małgorzata Rojek |
API Wykazu podatników VAT | 13.0 | 21.12.2020 08:32 Małgorzata Rojek |
API Wykazu podatników VAT | 12.0 | 21.01.2020 15:28 Małgorzata Rojek |
API Wykazu podatników VAT | 11.0 | 10.01.2020 15:48 Małgorzata Rojek |
API Wykazu podatników VAT | 10.0 | 08.10.2019 11:29 Michał Modzelewski |
API Wykazu podatników VAT | 9.0 | 06.09.2019 15:33 Małgorzata Rojek |
API Wykazu podatników VAT | 8.0 | 04.09.2019 08:19 Małgorzata Rojek |
API Wykazu podatników VAT | 7.0 | 01.09.2019 00:10 Michał Dziwota |
API Wykazu podatników VAT | 6.0 | 26.08.2019 14:15 Małgorzata Rojek |
API Wykazu podatników VAT | 5.0 | 23.08.2019 17:50 Paulina Pawlik |
API Wykazu podatników VAT | 4.0 | 22.08.2019 17:51 Małgorzata Rojek |
API Wykazu podatników VAT | 3.0 | 09.08.2019 14:45 Paulina Pawlik |
API Wykazu podatników VAT | 2.0 | 09.08.2019 14:11 Małgorzata Rojek |
API Wykazu podatników VAT | 1.0 | 09.08.2019 13:54 Małgorzata Rojek |
Aby uzyskać archiwalną wersję należy skontaktować się z Redakcją BIP