Wtyczka posiada komponenty do weryfikacji podatników w bazie Ministerstwa Finansów (tzw. Biała lista). Komponenty służą do weryfikacji nr bankowego (NRB) z nr NIP. Wszystkie sprawdzenia w bazie, jak i pliku płaskim, zapisywane są w tabeli systemowej w celu weryfikacji lub ewentualnej kontroli. Dane już raz odpytane (i zwrócone poprawnie) są przechowywane w pamięci serwera przez 1 dzień.

 

Wtyczka wymaga systemu PlusWorkflow od wersji  3.2.105

W przypadku problemów z połączeniem i walidacją certyfikatu należy pobrać paczkę JCE ze strony https://www.oracle.com/technetwork/java/javase/downloads/jce-all-download-5170447.html.
Archiwum należy rozpakować, pliki *.jar skopiować do katalogu Javy :

  • <java-home>/lib/security dla [Unix]
  • <java-home>\lib\security dla [Windows]

Szczegóły instalacji znajdują się w pliku README.txt w pobranym archiwum.

Plik dla Java 8

"Skompresowany plik płaski wraz z jego sumą kontrolną będzie publikowany raz dziennie w okresie początkowym ok. godz. 7.00, docelowo ok. godziny 00:01. Plik będzie przechowywany w formie skompresowanej na zasobach Ministerstwa Finansów, jego szacowana wielkość to 200 MB. Ministerstwo będzie również przechowywać i udostępniać pliki z poprzednich dni." (Maksymalnie 30 dni wstecz)

Plik Płaski : https://www.podatki.gov.pl/vat/bezpieczna-transakcja/wykaz-podatnikow-vat/plik-plaski/

Dokumentacja webApi https://www.gov.pl/web/kas/api-wykazu-podatnikow-vat

Wtyczka zapisuję każdą próbę sprawdzenia NRB z numerem NIP w tabeli Tab_4. pm_vendor_log.

Pobrany plik płaski wykorzystywany jest do weryfikacji numerów kont na dzień pobrania tego pliku. Weryfikacja numeru konta z inną datą niż data pobrania pliku wykonywana jest z użyciem zewnętrznego API Ministerstwa Finansów. Wywołania tego API są limitowane. W przypadku przekroczenia limitu otrzymujemy komunikat błędu: "Za dużo wywołań" (429).

W przypadku aktualizacji systemu w wersji 4.1.X lub niższej na system w wersji 4.2.X, co bezpośrednio wiążę się ze zaktualizowaniem wersji wtyczki 1.0.14 lub niższej na wersję 1.0.15 lub wyższą, w trakcie instalacji wtyczki zachodzi operacja przeniesienia zawartości tabeli pm_vendor_flatfile_hashes do nowo utworzonej tabeli pm_vendor_flatfile_hash, a pierwotna tabela zostaje usunięta. Operacja może zająć ok. 30 minut, jeśli tabela tabela pm_vendor_flatfile_hashes nie była pusta.

 Na bazie danych Oracle, tak jak dla pozostałych wspieranych baz danych, powyższe czynności zakończą się również powodzeniem, ale pojawi się okienko informujące o błędzie przy instalacji wtyczki. W takim przypadku należy ponownie spróbować zainstalować wtyczkę, aby pozbyć się tego komunikatu.


 

 

Po zainstalowaniu wtyczki w Parametrach Systemowych pojawia się nowa sekcja w której trzeba podać adres serwera MF.

 

Akcje

Nazwa

KategoriaOpisDostępne od wersji

Weryfikacja Konta Bankowego

Plus Vendor Checker

Komponent do weryfikacji zmiennych nagłówkowych nr konta Bankowego z nr NIP.

SZCZEGÓŁY >Link<

1.0.0

Weryfikacja Konta Bankowego(tabelka)

Plus Vendor Checker

Komponent do weryfikacji zmiennych w tabeli dynamicznej nr konta Bankowego z nr NIP.

SZCZEGÓŁY >Link <

1.0.0

Zadania automatyczne/Settery

Weryfikacja Konta Bankowego

Plus Vendor Checker

Komponent do weryfikacji nr konta Bankowego z nr NIP.

SZCZEGÓŁY >Link <

1.0.0

Walidatory

Weryfikacja Konta Bankowego

Plus Vendor Checker

Komponent do weryfikacji nr konta Bankowego z nr NIP.

SZCZEGÓŁY >Link <

1.0.0

Zadania zaplanowane

Pobieranie Pliku Płaskiego

Plus Vendor Checker

Komponent do pobierania najnowszego pliku płaskiego

SZCZEGÓŁY >Link <

1.0.4

Pobieranie konkretnego Pliku Płaskiego

Plus Vendor Checker

Komponent do pobierania konkretnego pliku płaskiego

SZCZEGÓŁY >Link <

1.0.4

 

W przypadku gdy, w logach zadania automatycznego pobierającego plik płaski jest błąd połączenia:

Caused by: java.net.ConnectException: Connection timed out: connect

można sprawdzić pobieranie pliku płaskiego za pomocą polecenia curl

np. curl https://plikplaski.mf.gov.pl/pliki/20240920.7z  -o C:\20240920.7z

Może się tak zdarzyć, że w przeglądarce można pobrać plik za pomocą linku https://plikplaski.mf.gov.pl/pliki/20240920.7z , jednak poleceniem curl nie można już pobrać tego pliiku.