MF udostępniło API Wykazu podatników VAT

Polecamy: Najnowsze zmiany w VAT. Sprawdź!

Polecamy: Praktyczny przewodnik po zmianach w VAT. Sprawdź!

Polecamy: AKADEMIA VAT z Radosławem Kowalskim (od 30 sierpnia do 10 września) – Cykl 3 webinariów: 8 wybranych zmian w VAT - praktyczny przegląd dla księgowych, Split payment, Biała lista podatników VAT

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