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