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: Tabelka, przycisk na tabelce
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 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.7 | Wartość przechowująca nr NIP | Zmienna tabelaryczna | Usuwane są inne znaki niż cyfry dla polskich nr NIP | |
| Status* | 1.0.7 | Zmienna do zapisu statusu | Zmienna tabelaryczna | ||
| Zmienna sterująca | 1.0.16 | Zmienna do zapisu statusu sterującego | Zmienna tabelaryczna | Zmienna tabelaryczna może przyjąć wartości: CZYNNY, ZWOLNIONY, NIEZAREJESTROWANY, NIEPOPRAWNY, NIEZNANY, VIES_AKTYWNY, VIES_NIEAKTYWNY, STRONA_NIEDOSTEPNA, POZA_UE, NIE_FIGURUJE. | |
| Inicjalizacja* | 1.0.7 | Sprawdzanie całej tabeli nastąpi podczas wczytywania formularza | Logiczny | Nie | Parametr widoczny tylko dla tabeli |
| Aktualizacja danych w tabeli* | 1.0.7 | Sprawdzanie w wierszu na zmianę wartość w kolumnie NIP | Logiczny | Nie | Parametr widoczny tylko dla tabeli |
| Pomiń pustą wartość* | 1.0.X | Pomijanie pustych wartości w tabeli | Logiczny | Nie | |
| 1.0.18 | Identyfikator żądania zwrócony z interfejsu API. | Zmienna tabelaryczna | Uwaga! W przypadku systemu VIES zwracana wartość zawsze jest pusta. | ||
| 1.0.18 | Data i godzina żądania zwrócona z interfejsu API. | Zmienna tabelaryczna | Wartość tekstowa lub typu data. W przypadku pola(kolumny) typu data, ucinana jest godzina żądania. |
Parametr*- pole wymagane
Przykładowa konfiguracja
Change log
1.0.7
- Utworzenie komponentu
1.0.16
- Dodanie parametru "Zmienna sterująca"
1.0.18
- Dodanie parametru ""
- Dodanie parametru ""
Add Comment