Przeznaczenie:

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.

Parametry:

"NIP"

Typ pola STRING. NIP dla którego ma być pobrany status.

"Status [opcjonalnie]"

Typ pola VARIABLE. Zmienna do której ma trafić informacja o statusie. Gdy pole zostawi się puste, informacja będzie wyświetlana w oknie powiadomienia na formularzu (MessangeBox). Czas wyświetlania powiadomienia ustawiony na 15 sek.

"Czy włączyć komentarz"

Typ pola BOOLEAN. Jeżeli parametr będzie ustawiony wartością "true". To po wykonaniu akcji status dopisze się do komentarza, tak żeby był widoczny w historii procesu

Szczegółowy opis działania:

Akcje można podpiąć pod przycisk (działanie za każdym wciśnięciem przycisku) lub na zmienną na formularzu (działanie za każdym razem zmiany wartości pola).

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

statusy zwracane są opisane na stronie głównej wtyczki

Status podatnika Vat