Polecamy: Najnowsze zmiany w VAT. Sprawdź!
Polecamy: Praktyczny przewodnik po zmianach w VAT. Sprawdź!
W kolejnym etapie (termin zostanie podany do 31 sierpnia 2019 r.) planowana jest publikacja pliku tekstowego do pobierania przez użytkowników, który zawiera pełną listę par NIP-rachunek, pozwalającą na masową weryfikację transakcji w systemach finansowo-księgowych.
Polecamy: Biuletyn VAT
Polecamy: VAT 2019. Komentarz
Ministerstwo Finansów informuje, że API będzie zawierało 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)
Korzystanie z API będzie limitowane. Można złożyć 10 zapytań o maksymalnie 30 podmiotów jednocześnie. Po wyczerpaniu tego limitu dostęp do API będzie zablokowany do godziny 0:00.
W kolejnym etapie (termin zostanie podany do 31 sierpnia 2019 r.) planowana jest publikacja pliku tekstowego do pobierania przez użytkowników, który zawiera pełną listę par NIP-rachunek, pozwalającą 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ła 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 będą 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 opisany będzie na stronie internetowej Wykazu.
Materiały:
API Wykazu podmiotów zarejestrowanych, niezarejestrowanych oraz wykreślonych i przywróconych do rejestru VAT
SwaggerAPI.yml 0.01MBWykaz podatników VAT opis API v 1-0
WykazPodatnikowOpisAPI_v1_0_0.pdf 0.59MBKomunikat błędów wykazu podatników VAT
KomunikatyBłędówWL1_.pdf 0.42MB
Opis techniczny łączenia się do API znajduje się na stronie Krajowej Administracji Skarbowej