Uvod

Aplikacija VIES Checker omogućuje vam učitavanje bilo koje CSV datoteke i provjeru entiteta (izvođača) koji se pojavljuju u ovoj datoteci u smislu njihovog trenutnog statusa u VIES sustav.

Puštena aplikacija je uspješno testirana u sljedećim verzijama MS Windows: 7/8/8.1/10 i 11. Aplikaciju je moguće instalirati u 32-bitnu i 64-bitnu verziju Windows operativnog sustava.

Najnovija verzija aplikacije VIES Checker uvijek je dostupna za preuzimanje s preuzimanje datoteka stranica.

Za korištenje aplikacije potrebno je kreirati račun na viesapi.eu web mjesto i generirajte ključ i njegov identifikator. Proces registracije i postavljanja računa kao i generiranja ključeva opisan je na Dokumentacija web stranica.

Aktivacija

Nakon preuzimanja aplikacije i spremanja na lokalno računalo, raspakirajte ZIP arhivu. Prijenosna verzija aplikacije (viesapi-app-portable.zip) ne zahtijeva instalaciju i može se pokrenuti pomoću običnog korisničkog računa (ne zahtijeva administratorska prava). Verzija instalacijskog programa (viesapi-app-setup.exe) također ne zahtijeva administratorske privilegije, a za instalaciju jednostavno pokrenite EXE datoteku.

Konfiguracija

Nakon pokretanja aplikacije, potrebno je jednom konfigurirati postavke. Da biste to učinili, kliknite na Settings gumb iz glavnog izbornika.

u Identifier polje unesite vrijednost koja je generirana prilikom kreiranja računa na viesapi.eu portal - API Keys kartica, Identifier stupac. Međutim, u Key polje unesite vrijednost koja je generirana prilikom kreiranja računa na viesapi.eu portal - API Keys kartica, Key stupac.

Kartica Opcije ima tri zadane opcije:

• Check for updates when the application starts – Ova postavka omogućuje automatsku provjeru novih verzija prilikom pokretanja aplikacije.
• Normalize the format of VAT numbers when loading data – Ova opcija omogućuje normalizaciju PDV brojeva EU u CSV datoteci.
• Use batch checking when applicable – odabirom ove opcije primjenjuje se skupni način rada na zapise za koje se pojavila pogreška „Dostignut je maksimalni broj istodobnih upita za ovu državu članicu“ (MS_MAX_CONCURRENT_REQ)

Ako se veza s internetom provodi pomoću proxy poslužitelja, idite na Proxy HTTP karticu, odaberite Connect via the proxy server option below i popunite polja odgovarajućim podacima.

Opis glavnog izbornika

Donja slika prikazuje gumbe dostupne u glavnom izborniku programa:

Load file – omogućuje odabir tekstualne datoteke u CSV format. Format retka je vatEU [, naziv tvrtke], gdje je:

• vatEU – EU PDV broj na temelju kojeg će se provesti provjera subjekta,
• companyName – Naziv tvrtke (neobavezno)

U slučaju CSV datoteke, vatEU polje je obavezno, a companyName polje je izborno polje i ne mora biti prisutno. Evidencija može sadržavati samo EU PDV broj.

Prema CSV formatu, tekstualna polja moraju biti u navodnicima i odvojena zarezom, npr.: “PL7171642051”, “TvrtkaXYZ”

Delete selected – Briše sve odabrane retke.

Delete all – Briše sve učitane retke iz CSV datoteke.

Start checking – gumb pokreće provjeru svih odabranih čekova. VIES status poreznog obveznika moguće je provjeriti za subjekte registrirane u jednoj od država članica Europske unije.

Save results – pritiskom na gumb možete spremiti rezultate provjera u XLS (Microsoft Excel) ili tekstualnu CSV datoteku.

Settings – poziva karticu za unos identifikatora i ključa.

Manage your account – pritiskom na gumb možete brzo otići na stranicu za prijavu na portal viesapi.eu.

Documentation – klikom na poveznicu preusmjerit ćete se na ovu dokumentaciju.

Contact – pritiskom na gumb možete automatski kreirati e-mail.

Check for update – omogućuje vam provjeru je li dostupna nova verzija aplikacije. Ova je opcija dostupna samo u instalacijskoj verziji (setup.exe).

Provjera entiteta spremljenih u CSV datoteci

Kako biste provjerili entitete zabilježene u CSV datoteci, izvedite:

1. Otvorite CSV datoteku i učitajte njezin sadržaj pomoću Load file dugme.
2. Za provjeru pritisnite Start checking dugme.

Prikazat će se prozor s informacijama o napredovanju procesa provjere:

Kao što možete vidjeti na gornjoj snimci zaslona, aplikacija je vrlo brza jer je provjerila više od 2000 zapisa u VIES-u za manje od 20 minuta. Što daje izvedbu od 1,6 upita u sekundi. Međutim, morate znati da rad aplikacije najviše ovisi o dostupnosti i stabilnosti samog VIES sustava.

Važna obavijest: Vrlo važna značajka je mogućnost automatskog ponovnog slanja zahtjeva ako The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ) dolazi do greške. Ovo je vrlo česta pogreška prilikom provjere izvođača radova iz Njemačke, Francuske, Češke, Danske, a ponekad i Belgije. Više o ovom problemu možete pročitati u našem blog članku:  [RIJEŠENO] VIES GREŠKA: „Dostignut je maksimalan broj istovremenih zahtjeva“. Kako bi se riješio ovaj problem, aplikacija implementira mehanizam za grupno, asinhrono slanje zahtjeva koje VIES nije ispravno obradio prvi put zbog gore opisane pogreške. Nakon završetka prve iteracije provjera, aplikacija prikuplja sve EU PDV brojeve za koje je vraćena gore navedena greška, generira za njih serije i šalje ih VIES-u za serijsku provjeru statusa aktivnosti PDV-a.

Nakon što je provjera završena, odabir određenog retka omogućuje pregled u desnom panelu programa (Details kartica):

Dobivene rezultate moguće je filtrirati unosom traženog teksta u polje ispod naziva zadanog stupca ili spremiti u XLS (Microsoft Excel) ili CSV tekstualnu datoteku pritiskom na tipku Save results dugme.

Također možete otići na Account karticu u bilo koje vrijeme, gdje ćete pronaći:

• Podaci o aktivnom planu.
• Popis funkcionalnosti dostupnih u trenutnom planu.
• Statistika vezana uz upite izvršene od početka mjeseca.