Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Added

Powrót do spisu komponentów: Plus NIP Checker

Przeznaczenie:

Info

Jeśli masz problem ze zrozumieniem jak działa akcja, sprawdź opisy: Akcja, Wykonanie warunkowe, Parametry komponentów

Panel
bgColorwhite
titleBGColorlight
titlePodstawowe informacje

Kategoria: Plus NipChecker

Umiejscowienie akcji: Przycisk, Zmienna

Aktualna wersja: 1.0.7

Panel
bgColorwhite
titleBGColorlight
titleOpis

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:

Image Removed

"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

...

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

 

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

 

 

 

 

Panel
bgColorwhite
titleBGColorligth
titleParametry konfiguracyjne
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaUwagi i ograniczenia
NIP*1.0.0Wartość przechowująca nr NIP Tekst Usuwane są inne znaki niż cyfry dla polskich nr NIP.
Status1.0.0Zmienna do zapisu statusuTekst Gdy parametr nieustawiony, informacja o statusie pojawi się w formie chmurki na formularzu.
Zmienna sterująca1.0.16Zmienna do zapisu statusu sterującegoTekst 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.0Włączenie komentarzaLogicznyNie 
1.0.18Identyfikator żądania zwrócony z interfejsu API.Tekst Uwaga! W przypadku systemu VIES zwracana wartość zawsze jest pusta.
1.0.18Data i godzina żądania zwrócona z interfejsu API.Data i czas  

Parametr*- pole wymagane

 

Panel
bgColorwhite
titleBGColorlight
titlePrzykładowa konfiguracja

Image Added

Panel
bgColorwhite
titleBGColorlight
titleChange log

1.0.0

  • Utworzenie komponentu

1.0.16

  • Dodanie parametru "Zmienna sterująca"

1.0.18

  • Dodanie parametru ""
  • Dodanie parametru ""