| 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 NIP Checker | 2017-07-14 | 2024-11-12 | Link | Wtyczka zawierająca komponenty do sprawdzenia statusu podatnika VAT w bazach "Ministerstwa Finansów" | Dev CUF | Płatna | Wtyczka | com.suncode.plugin-nipchecker |
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.
UWAGA
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
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
Możliwe komunikaty blędów systemu VIES
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:
- Niepoprawny nr NIP: NIEPOPRAWNY
- NIP spoza PL i UE – nie podlega weryfikacji: POZA_EU
- inne zwrócone bezpośrednio ze strony usługodawcy
- Niepoprawny nr NIP: NIEPOPRAWNY
dla MF:
- Podmiot o podanym identyfikatorze podatkowym NIP nie jest zarejestrowany jako podatnik VAT: NIEZAREJESTROWANY
- Podmiot o podanym identyfikatorze podatkowym NIP jest zarejestrowany jako podatnik VAT czynny: CZYNNY
- Podmiot o podanym identyfikatorze podatkowym NIP jest zarejestrowany jako podatnik VAT zwolniony: ZWOLNIONY
- Podmiot o podanym identyfikatorze podatkowym NIP nie figuruje w rejestrze VAT: NIE_FIGURUJE
- Brak połączenia z Internetem – kontrahent nie został zweryfikowany w bazie MF: STRONA_NIEDOSTEPNA
dla VIES:
- Brak połączenia z Internetem – kontrahent europejski nie został zweryfikowany w systemie VIES: STRONA_NIEDOSTEPNA
- Tak, numer VAT aktywny: VIES_AKTYWNY
- Nie, numer VAT nieaktywny: VIES_NIEAKTYWNY
- (błędy systemu VIES): NIEZNANY
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:
- PL7792312568 - Podmiot o podanym identyfikatorze podatkowym NIP jest zarejestrowany jako podatnik VAT czynny Dodatkowo informujemy, iż w celu potwierdzenia czy podmiot jest zarejestrowany jako podatnik VAT czynny, podatnik i osoba trzecia mająca interes prawny, mogą złożyć do właściwego naczelnika urzędu skarbowego wniosek o wydanie zaświadczenia.
- 5250007313 - Podmiot o podanym identyfikatorze podatkowym NIP jest zarejestrowany jako podatnik VAT czynny Dodatkowo informujemy, iż w celu potwierdzenia czy podmiot jest zarejestrowany jako podatnik VAT czynny, podatnik i osoba trzecia mająca interes prawny, mogą złożyć do właściwego naczelnika urzędu skarbowego wniosek o wydanie zaświadczenia.
- 5250007310 - Niepoprawny nr NIP
- atu3693 4001 - Tak, numer VAT aktywny
- ATU36934002 - Nie, numer VAT nieaktywny
- 9512293636 - Podmiot o podanym identyfikatorze podatkowym NIP nie jest zarejestrowany jako podatnik VAT
- USA9512293636 - NIP spoza PL i UE – nie podlega weryfikacji
- 521-30-03-700 - Podmiot o podanym identyfikatorze podatkowym NIP jest zarejestrowany jako podatnik VAT zwolniony
UWAGA
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:
- Akcje:
- Settery/Zadania automatyczne
- Walidatory:
Add Comment