Opis:

Wtyczka zawierająca komponenty do sprawdzenia statusu podatnika VAT w bazach "Ministerstwa Finansów"  (strona: https://ppuslugi.mf.gov.pl/_/)  oraz w systemie VIES na stronie "Komisji Europejskiej"  (strona http://ec.europa.eu/taxation_customs/vies ) za pomocą podanego nr NIP

Mapa procesu do testowania komponentu Check Status Vat 2017-09-29.zip

UWAGA: Pamiętaj o zainstalowaniu certyfikatu (http://ec.europa.eu/taxation_customs/vies ) na serwerze PlusWorkflow  

W zakładce certyfikaty należy podać adres ec.europa.eu.


Od wersji 1.0.6 Wtyczka korzysta z nowego API dla bazy "Ministerstwa Finansów"  (strona: https://wl-api.mf.gov.pl/)


Aby zweryfikować dany nip wystarczy wywołać poniższy link:
https://wl-api.mf.gov.pl/api/search/nip/<nip>?date=<current date>

np.

w przeglądarce:

https://wl-api.mf.gov.pl/api/search/nip/5250007313?date=2022-05-05

 

 

lub w konsoli na linuxie wywołać polecenie:

curl https://wl-api.mf.gov.pl/api/search/nip/5250007313?date=2022-05-10



 

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

    In case of problems, the returned FaultString can take the following specific values:
    - INVALID_INPUT: The provided CountryCode is invalid or the VAT number is empty;
    - GLOBAL_MAX_CONCURRENT_REQ: Your Request for VAT validation has not been processed; the maximum number of concurrent requests has been reached. Please re-submit your request later or contact TAXUD-VIESWEB@ec.europa.eu for further information": Your request cannot be processed due to high traffic on the web application. Please try again later;
    - MS_MAX_CONCURRENT_REQ: Your Request for VAT validation has not been processed; the maximum number of concurrent requests for this Member State has been reached. Please re-submit your request later or contact TAXUD-VIESWEB@ec.europa.eu for further information": Your request cannot be processed due to high traffic towards the Member State you are trying to reach. Please try again later.
    - SERVICE_UNAVAILABLE: an error was encountered either at the network level or the Web application level, try again later;
    - MS_UNAVAILABLE: The application at the Member State is not replying or not available. Please refer to the Technical Information page to check the status of the requested Member State, try again later;
    - TIMEOUT: The application did not receive a reply within the allocated time period, try again later.

Opis pobrany z WSDL: https://ec.europa.eu/taxation_customs/vies/checkVatService.wsdl


Przed połączeniem do bazy MF jest sprawdzany nr NIP (długość znaków oraz suma kontrolna).

Może zostać zwrócony jeden z poniższych statusów

Ogólne:

dla MF:

dla VIES:

 

W celu przyspieszenia działania, wtyczka przechowuje w pamięci ostatnie 8000 statusów  przez maksymalnie 12 godzin,

Przykładowe nipy i ich statusy  do testowania:

Wtyczka sprawdzą wstępnie nipy.
Nipy Polskie rozpoznaje po przedrostku PL lub długości 10 cyfr (Sprawdza tez sume kontrolną).
Dla UE nipy musza posiadać przedrostek kraju należącego do UE np AT, GB, DE.
Reszta numerów jest traktowana jako poza UE


Dostępne komponenty:

  1. Akcje:
    1. Status podatnika VAT
    2. Status podatnika VAT w tabeli
  2. Settery/Zadania automatyczne
    1. Status podatnika VAT 
    2. Status podatnika VAT w tabeli 
  3. Walidatory:
    1. Walidator sprawdzający status podatnika VAT
    2. Walidator sprawdzający status podatnika VAT w tabeli