Sissejuhatus

Rakendus VIES Checker võimaldab laadida mis tahes CSV-faile ja kontrollida selles failis kuvatavaid üksusi (töövõtjaid) nende hetkeoleku järgi VIES süsteem.

Välja lastud rakendust on edukalt testitud järgmistes MS Windowsi versioonides: 7/8/8.1/10 ja 11. Rakendust saab installida nii 32-bitistesse kui ka 64-bitistesse Windowsi operatsioonisüsteemi versioonidesse.

Rakenduse VIES Checker uusim versioon on alati allalaadimiseks saadaval saidilt Lae alla lehel.

Rakenduse kasutamiseks peate looma konto viesapi.eu veebisaiti ning genereerida võti ja selle identifikaator. Konto registreerimise ja seadistamise ning võtmete genereerimise protsessi on kirjeldatud lehel Dokumentatsioon veebisait.

Aktiveerimine

Pärast rakenduse allalaadimist ja kohalikku arvutisse salvestamist pakkige ZIP-arhiiv lahti. Rakenduse kaasaskantav versioon (viesapi-app-portable.zip) ei vaja installimist ja seda saab käivitada tavalise kasutajakontoga (see ei vaja administraatori õigusi). Installeri versioon (viesapi-app-setup.exe) ei vaja ka administraatoriõigusi ja selle installimiseks käivitage lihtsalt EXE-fail.

Seadistamine

Pärast rakenduse käivitamist on vaja seaded üks kord konfigureerida. Selleks klõpsake nuppu Settings nuppu peamenüüst.

Aastal Identifier väljale sisestage väärtus, mis loodi konto loomisel viesapi.eu portaal – API Keys vahekaart, Identifier veerg. Kuid aastal Key väljale sisestage väärtus, mis loodi konto loomisel viesapi.eu portaal – API Keys vahekaart, Key veerg.

Valikud vahekaardil on kolm vaikevalikut:

• Check for updates when the application starts – See säte lubab rakenduse käivitamisel automaatselt uute versioonide kontrollimise.
• Normalize the format of VAT numbers when loading data – See valik võimaldab CSV-failis EL-i käibemaksukohustuslase numbreid normaliseerida.
• Use batch checking when applicable – selle valiku valimisel rakendatakse partiirežiimi kirjetele, mille puhul ilmnes tõrge „Selle liikmesriigi samaaegsete päringute maksimaalne arv on saavutatud” (MS_MAX_CONCURRENT_REQ).

Kui Interneti-ühendus luuakse puhverserveri abil, minge lehele Proxy HTTP vahekaardil valige Connect via the proxy server option below ja täitke väljad vastavate andmetega.

Peamenüü kirjeldus

Alloleval joonisel on näidatud programmi peamenüüs saadaolevad nupud:

Load file – võimaldab valida failis tekstifaili CSV vormingus. Mille reavorming on vatEU [, companyName], kus:

• vatEU – ELi käibemaksukohustuslase number, mille alusel üksuse kontrollimine läbi viiakse,
• companyName - Firma nimi (valikuline)

CSV-faili puhul vatEU väli on kohustuslik ja companyName väli on valikuline ja ei pea olema. Kirje võib sisaldada ainult EL-i KMKR numbrit.

Vastavalt CSV-vormingule peavad tekstiväljad olema jutumärkides ja eraldatud komaga, nt .: “PL7171642051”, “CompanyXYZ”

Delete selected – Kustutab kõik valitud read.

Delete all – Kustutab CSV-failist kõik laaditud read.

Start checking – nupp alustab kõigi valitud tšekkide kontrollimist. Maksumaksja VIES-staatust saab kontrollida ühes Euroopa Liidu liikmesriigis registreeritud üksuste puhul.

Save results – nupule vajutades saate salvestada kontrollide tulemused XLS-i (Microsoft Excel) või teksti-CSV-faili.

Settings – avab identifikaatori ja võtme sisestamise vahekaardi.

Manage your account – nupule vajutamine võimaldab kiiresti minna viesapi.eu portaali sisselogimislehele.

Documentation – lingil klõpsamine suunab teid sellesse dokumentatsiooni.

Contact – nuppu vajutades saate automaatselt e-kirja luua.

Check for update – võimaldab teil kontrollida, kas rakendusest on saadaval uus versioon. See valik on saadaval ainult installiversioonis (setup.exe).

CSV-faili salvestatud olemite kontrollimine

CSV-faili salvestatud olemite kontrollimiseks toimige järgmiselt.

1. Avage CSV-fail ja laadige selle sisu, kasutades Load file nuppu.
2. Kontrolli teostamiseks vajutage nuppu Start checking nuppu.

Kuvatakse aken, mis annab teavet kontrolliprotsessi käigu kohta:

Nagu näete ülaloleval ekraanipildil, on rakendus väga kiire, kuna see kontrollis VIESis vähem kui 20 minutiga üle 2000 kirje. Mis annab jõudluse 1,6 päringut sekundis. Siiski peate teadma, et rakenduse jõudlus sõltub peamiselt VIES-süsteemi enda saadavusest ja stabiilsusest.

Tähtis teade: Väga oluline funktsioon on võimalus taotlusi automaatselt uuesti esitada, kui The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ) ilmneb viga. See on väga levinud viga Saksamaa, Prantsusmaa, Tšehhi Vabariigi, Taani ja mõnikord ka Belgia töövõtjate kontrollimisel. Selle probleemi kohta saate lähemalt lugeda meie ajaveebiartiklist:  [LAHENDATUD] VIES-I VIGA: „Samaaegsete päringute maksimaalne arv on saavutatud”. Selle probleemi lahendamiseks rakendab rakendus mehhanismi partiipõhiseks ja asünkroonseks esitamiseks päringutele, mida VIES eespool kirjeldatud vea tõttu esimesel korral õigesti ei käsitlenud. Pärast esimese kontrollide iteratsiooni lõpetamist kogub rakendus kõik ELi käibemaksukohustuslase numbrid, mille puhul tagastati ülaltoodud viga, genereerib nende jaoks partiid ja saadab need VIES-i käibemaksutegevuse staatuse partiikontrolliks.

Kui kontroll on lõpetatud, võimaldab konkreetse rea valimine programmi parempoolsel paneelil eelvaate (Details vahekaart):

Saadud tulemusi saab filtreerida sisestades otsinguteksti antud veeru nime all olevale väljale või salvestada XLS (Microsoft Excel) või CSV tekstifaili vajutades Save results nuppu.

Võite minna ka aadressile Account vahekaart igal ajal, kust leiate:

• Teave aktiivse plaani kohta.
• Praeguses plaanis saadaolevate funktsioonide loend.
• Alates kuu algusest tehtud päringutega seotud statistika.