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: A very important feature is the ability to resubmit requests automatically if the The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ) error occurs. This is a very common error when verifying contractors from Germany, France, the Czech Republic, Denmark, and sometimes Belgium. You can read more about this issue in our blog article:  [SOLVED] VIES ERROR: “The maximum number of concurrent requests has been reached”. To work around this issue, the application implements a mechanism for batch-based, asynchronous submission of requests that were not correctly handled by VIES the first time due to the error described above. After completing the first iteration of checks, the application collects all EU VAT numbers for which the above error was returned, generates batches for them, and sends them to VIES for batch verification of VAT activity status.

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.