VatChecker - hurtowa weryfikacja NIP i VAT UE
VatChecker służy do hurtowej weryfikacji poprawności numerów VAT na podstawie
sprawdzenia formatu numeru, sumy kontrolnej (dla 27 krajów EU, brak Słowacji)
oraz online w serwisie VIES (czy numer VAT-UE jest czynny).
Numery do weryfikacji mogą być wpisane ręcznie w formularzu lub wczytane z
pliku: txt, csv, excel, Open Office Calc (ods).
Zobacz wersję demonstracyjną programu VatChecker Standard
.
Uwaga: Program NIE umożliwia weryfikacji statusu podatnika VAT w serwisie Ministerstwa Finansów
Wersje programu
Program dostępny jest w dwóch wersjach funkcjonalnych:
- Standard - działa w oparciu
o graficzny interfejs użytkownika - stronę WWW, wyniki weryfikacji numerów są wyświetlane na stronie + jest możliwość eksportu ich w pliku CSV
- CLI - program wywoływany z linii komend, wyniki weryfikacji zapisywane są
w wybranym pliku: txt, csv, xls, xlsx (Excel 2007) lub w tabeli bazy danych.
Przy zakupie licencji CLI, klient otrzymuje prawo użytkowania wersji standardowej.
Możliwości wersji Standard
- numery VAT można wpisywać bezpośrednio w polu formularza, jeden numer pod drugim lub wgrać je z pliku tekstowego (txt), csv, xls (Excel), xlsx (Excel 2007) lub
ods (Open Office Calc).
- jeśli numer zawiera prefiks kraju (np. PL, DE) zostanie potraktowany jako europejski numer
VAT i sprawdzony w VIES. Numery bez prefiksu będą potraktowane jako polski NIP.
Numer może być umieszczony w jednej kolumnie lub w dwóch (oddzielnie prefiks kraju i numer)
- dla każdego wprowadzonego numeru wykonywana jest weryfikacja poprawności formatu numeru
- następnie obliczana jest suma kontrolna numeru w oparciu o oddzielny algorytm dla każdego kraju Unii Europejskiej
(z wyjątkiem Słowacji dla którego ten krok nie jest testowany) jeśli numer wygląda na prawidłowy to
- zostaje wysłane zapytanie do strony VIES z którego pobierany jest status danego numeru (aktywny, nie aktywny)
oraz dane właściciela numeru, a także datę zapytania oraz ID kontrolny zapytania (jesli podano NIP pytającego)
- w przypadku polskich NIPów pobierana jest informacja o Urzędzie Skarbowym odpowiedzialnym za dany numer
- wyniki weryfikacji wyświetlane są dynamicznie (po ukończeniu sprawdzania kolejnego numeru) w postaci graficznej strony WWW
- możliwe jest wskazanie w których kolumnach znajduje się prefix oraz badany numer ma to znaczenie np. jeśli analizowany jest plik Excela z dużą liczbą informacji nie tylko numerami.
- program ma szerokie możliwości konfiguracyjne m.in.:
- lista dozwolonych adresów IP, lista zablokowanych (nie mogących korzystać z programu) adresów IP
- możliwość ustawienia limitu liczby wykorzystania programu z danego IP w ciągu 60
ostatnich dni. Ustawienie listy IP zwolnionych z tego limitu
- limit sprawdzania liczby numerów (pozycji) w przesłanym pliku z numerami VAT
|
|
Możliwości wersji CLI
Wersja CLI posiada większość cech i możliwości wersji Standardowej, główne różnice stanowi:
- tekstowy interfejs użytkownika, program wywoływany jest z linii komend za pomocą odpowiednich
parametrów dzięki czemu można go wywoływać we własnych skryptach np. uruchamianych automatycznie w cronie
- wyniki weryfikacji nie są wyświetlane na ekranie, zamiast tego są zapisywane w pliku txt, csv, xls lub xlsx
wybór formatu zależny jest od odpowiedniego parametru
- program potrafi także pobierać numery VAT do weryfikacji z bazy danych (MySQL lub PostgreSQL) oraz
do niej zapisywać wyniki weryfikacji
Przykładowe wywołanie programu:
vatchecker_cli.php -i plik_z_numerami.txt -o rezultat.csv
vatchecker_cli.php -i plik_z_numerami.blabla -I txt -o rezultat.xls
vatchecker_cli.php -i table_name.db -o table_name_out.db
vatchecker_cli.php -i table_name.db -o table_name_out.db
vatchecker_cli.php -i table.db -o table_out.db -p db_prefix_column_name
Dostępne parametry wywołania programu:
- wywołanie bez parametrów lub
-v
lub -h
lub
--help
- spowoduje wyświetlenie pomocy (patrz screen niżej)
-i
lub --input
(obowiązkowy) - nazwa pliku
źródłowego lub tabeli bazy danych
Program czyta pliki: .txt, .csv, .xls, .xlsx (Excel 2007), .ods (Open Office Calc),
jeśli dane sa w tablicy to nalezy użyć: nazwa_tabeli.db
-o
lub --output
(obowiązkowy) - nazwa pliku docelowego lub tabeli w bazie danych.
Obsługiwane formaty jak wyżej oprócz .ods
-I
(--informat
) i -O
(--outformat
)
- wskazanie (wymuszenie) typu pliku źródłowego lub docelowego niezależnie od
rozszerzenia podanego w komendach -i
lub -o
-p
lub --prefix
- podanie nietypowej kolumny, gdzie znajdują się
prefiksy krajów, domyślnie są szukane w kolumnie 1 (pliki txt, csv) A (xls, xlsx, ods)
lub vat_prefix (dla .db)
-n
lub --number
- podanie nietypowej kolumny, gdzie znajdują się
numery VAT, domyślnie są szukane w kolumnie 2 (pliki txt, csv) B (xls, xlsx, ods)
lub vat_number (dla .db)
Plik wynikowy posiada następujące kolumny:
- Sprawdzany numer VAT np. PL7740001454
- Czy numer jest nieprawidłowy: 0 - PRAWIDŁOWY, 1 nieprawidłowy np. 0
- Format numeru: 0 nieprawidłowy, 1 prawidłowy, np. 1
- Suma kontrolna: 0 nieprawidłowa, 1 prawidłowa, 2 nie sprawdzana np. 1
- Sprawdzanie w VIES: 0 nieprawidłowy, 1 prawidłowy, 2 nie sprawdzane, 3 błąd z połączeniem do VIES np. 1
- Nazwa polskiego Urzędu Skarbowego, tylko dla NIP
- Informacje o właścicielu numeru VAT pobrane z VIES
- Datę zapytania do serwera VIES
- ID kontrolne zapytania VIES