Powrót do spisu komponentów: Plus NIP Checker
Jeśli masz problem ze zrozumieniem jak działa akcja, sprawdź opisy: Akcja, Wykonanie warunkowe, Parametry komponentów
Podstawowe informacje
Kategoria: Plus NipChecker
Umiejscowienie akcji: Przycisk, Zmienna
Aktualna wersja: 1.0.7
Opis
Akcja służy do pobrania statusu podatnika VAT z bazy "Ministerstwa Finansów" lub z systemu VIES (ze strony "Komisji Europejskiej") dla podmiotów z unii europejskiej.
Najpierw jest wstępna weryfikacja nr NIP. Odczytywane są dwa pierwsze znaki, jeżeli określają one kraj europejski to dalej sprawdzany jest numer podatnika w systemie VIES. Wyjątek stanowi symbol "PL". Gdy jest PL lub numer podatnika składa się z samych cyfr (10 cyfr) to sprawdzana jest suma kontrolna polskiego numeru NIP. Dalej podatnik jest sprawdzany w bazie "Ministerstwa Finansów". Zanim numer jest przesyłany usuwane są wszystkie inne znaki niż cyfry (spacje, '-' , itp) Tak więc nip "779-231-25-68" , "779-23-12-568", "PL77792312568" będą konwertowane do postaci "7792312568" (Taka forma zapisu jest wymagana przez "Ministerstwo Finansów"). Wszystkie inne kombinacje będą traktowane jako numer poza unii europejskiej.
Po niepoprawnej weryfikacji jest zwracany komunikat "Niepoprawny nr NIP" i zapisywany w zmiennej ustawionej w parametrze "Status" (lub wyświetlana w formie okna powiadomień na formularzu), oraz w komentarzu jeżeli została taka opcja włączona.
Po przejściu pozytywnej weryfikacji sprawdzana jest pamięć cache serwera. Jeśli w ciągu 12h wtyczka już wykonała zapytanie (za pomocą dowolnego komponentu z tej wtyczki) do bazy "Ministerstwa Finansów" lub do systemu VIES (strona Komisji Europejskiej) to zwracany jest ostatni status z pamięci serwera. Jeżeli natomiast nie było w pamięci lub minęło 12h to jest wywoływane nowe zapytanie do zewnętrznego systemu
Parametry konfiguracyjne
| Nazwa parametru | Od wersji | Opis | Typ parametru | Wartość domyślna | Uwagi i ograniczenia |
|---|---|---|---|---|---|
| NIP* | 1.0.0 | Wartość przechowująca nr NIP | Tekst | Usuwane są inne znaki niż cyfry dla polskich nr NIP. | |
| Status | 1.0.0 | Zmienna do zapisu statusu | Tekst | Gdy parametr nieustawiony, informacja o statusie pojawi się w formie chmurki na formularzu. | |
| Zmienna sterująca | 1.0.16 | Zmienna do zapisu statusu sterującego | Tekst | Zmienna sterująca może przyjąć jeden z poniższych wartości: CZYNNY, ZWOLNIONY, NIEZAREJESTROWANY, NIEPOPRAWNY, NIEZNANY, VIES_AKTYWNY, VIES_NIEAKTYWNY, STRONA_NIEDOSTEPNA, POZA_UE. | |
| Komentarz* | 1.0.0 | Włączenie komentarza | Logiczny | Nie | |
| 1.0.18 | Identyfikator żądania zwrócony z interfejsu API. | Tekst | Uwaga! W przypadku systemu VIES zwracana wartość zawsze jest pusta. | ||
| 1.0.18 | Data i godzina żądania zwrócona z interfejsu API. | Data i czas |
Parametr*- pole wymagane
Przykładowa konfiguracja
Change log
1.0.0
- Utworzenie komponentu
1.0.16
- Dodanie parametru "Zmienna sterująca"
1.0.18
- Dodanie parametru ""
- Dodanie parametru ""
0 Comments