| 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-09-23 | 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
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/
Komponenty
Akcje | ||||
Nazwa | Kategoria | Opis | Dostę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: connectmoż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