Plus VENDOR Checker

Nazwa wtyczki	Data utworzenia	Data ostatniej aktualizacji	Link do instalki	Krótki opis	Dział utrzymujący	Dokumentacja dla klienta	Typ licencji	Typ wtyczki	Id wtyczki
Plus VENDOR Checker	2019-10-06	2024-11-13	Link	Wtyczka posiada komponenty do weryfikacji podatników w bazie Ministerstwa Finansów (tzw. Biała lista).	Dev CUF		Płatna	Wtyczka	com.suncode.plugin-vendor.checker

Opis

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ń.

Opis

Wtyczka wymaga systemu PlusWorkflow od wersji 3.2.105

UWAGA

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

jce_policy-8.zip

Informacje z MF

"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

Logi

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.

Baza danych Oracle

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.

Konfiguracja

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

Produkcja: https://wl-api.mf.gov.pl/
Test: https://wl-test.mf.gov.pl/

Komponenty

Nazwa	Kategoria	Opis	Dostępne od wersji
Akcje
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.

Przykładowa mapa procesu

Plus VENDOR Checker.zip

Akcje

Weryfikacja Konta Bankowego

Weryfikacja Konta Bankowego(tabelka)

1.0.0

Zadania automatyczne/Settery

Weryfikacja Konta Bankowego

1.0.0

Walidatory

Weryfikacja Konta Bankowego

1.0.0

Zadania zaplanowane

Pobieranie Pliku Płaskiego

1.0.4

Pobieranie konkretnego Pliku Płaskiego

1.0.4

12 Child Pages

1 Comment

Dział Wdrożeń