Johdanto

VIES Checker -sovelluksen avulla voit ladata minkä tahansa CSV-tiedoston ja tarkistaa tässä tiedostossa näkyvät entiteetit (urakoitsijat) niiden nykyisen tilan suhteen VIES-järjestelmä.

Julkaistu sovellus on testattu onnistuneesti seuraavissa MS Windows -versioissa: 7/8/8.1/10 ja 11. Sovellus voidaan asentaa sekä 32-bittisiin että 64-bittisiin Windows-käyttöjärjestelmän versioihin.

VIES Checker -sovelluksen uusin versio on aina ladattavissa osoitteesta ladata sivu.

Jotta voit käyttää sovellusta, sinun on luotava tili osoitteessa viesapi.eu verkkosivustolle ja luoda avaimen ja sen tunnisteen. Tilin rekisteröinti- ja perustamisprosessi sekä avainten luonti on kuvattu sivulla Dokumentaatio verkkosivusto.

Aktivointi

Kun olet ladannut sovelluksen ja tallentanut sen paikalliselle tietokoneellesi, pura ZIP-arkisto. Sovelluksen kannettava versio (viesapi-app-portable.zip) ei vaadi asennusta ja sitä voidaan käyttää tavallisella käyttäjätilillä (se ei vaadi järjestelmänvalvojan oikeuksia). Asennusohjelman versio (viesapi-app-setup.exe) ei myöskään vaadi järjestelmänvalvojan oikeuksia, ja sen asentamiseksi sinun tarvitsee vain suorittaa EXE-tiedosto.

Kokoonpano

Sovelluksen käynnistämisen jälkeen asetukset on määritettävä kerran. Voit tehdä tämän napsauttamalla Settings -painiketta päävalikosta.

Vuonna Identifier -kenttään, kirjoita arvo, joka luotiin luotaessa tiliä viesapi.eu portaali - API Keys välilehti, Identifier sarakkeessa. Kuitenkin vuonna Key -kenttään, kirjoita arvo, joka luotiin luotaessa tiliä viesapi.eu portaali - API Keys välilehti, Key sarakkeessa.

Asetukset-välilehdellä on kolme oletusasetusta:

• Check for updates when the application starts – Tämä asetus ottaa käyttöön uusien versioiden automaattisen tarkistuksen sovelluksen käynnistyksen yhteydessä.
• Normalize the format of VAT numbers when loading data – Tämä vaihtoehto mahdollistaa EU:n ALV-numeroiden normalisoinnin CSV-tiedostossa.
• Use batch checking when applicable – Tämän vaihtoehdon valitseminen ottaa eräajotilan käyttöön tietueissa, joissa on tapahtunut virhe ”Tämän jäsenvaltion samanaikaisten kyselyiden enimmäismäärä on saavutettu” (MS_MAX_CONCURRENT_REQ)

Jos Internet-yhteys muodostetaan välityspalvelimen avulla, siirry kohtaan Proxy HTTP -välilehti, valitse Connect via the proxy server option below ja täytä kentät tarvittavilla tiedoilla.

Päävalikon kuvaus

Alla olevassa kuvassa näkyvät ohjelman päävalikon painikkeet:

Load file – voit valita tekstitiedoston CSV muoto. Jonka rivimuoto on vatEU [, companyName], jossa:

• vatEU – EU:n arvonlisäveronumero, jonka perusteella yksikön tarkastus tehdään,
• companyName - Yrityksen nimi (vapaaehtoinen)

CSV-tiedoston tapauksessa vatEU kenttä on pakollinen, ja companyName -kenttä on valinnainen kenttä, eikä sen tarvitse olla läsnä. Tietue voi sisältää vain EU:n ALV-numeron.

CSV-muodon mukaan tekstikentät on suljettava lainausmerkein ja erotettava toisistaan pilkulla, esim.: “PL7171642051”, “YritysXYZ”

Delete selected – Poistaa kaikki valitut rivit.

Delete all – Poistaa kaikki ladatut rivit CSV-tiedostosta.

Start checking – painike käynnistää kaikkien valittujen shekkien tarkistuksen. Veronmaksajan VIES-status voidaan tarkistaa jossakin Euroopan unionin jäsenvaltiossa rekisteröidyistä yhteisöistä.

Save results – nappia painamalla voit tallentaa tarkistusten tulokset XLS- (Microsoft Excel) tai teksti-CSV-tiedostoon.

Settings – avaa välilehden tunnuksen ja avaimen syöttämiseksi.

Manage your account – nappia painamalla pääset nopeasti viesapi.eu-portaalin kirjautumissivulle.

Documentation – linkin napsauttaminen ohjaa sinut tähän dokumentaatioon.

Contact – painamalla -painiketta voit luoda sähköpostin automaattisesti.

Check for update – voit tarkistaa, onko sovelluksesta saatavilla uutta versiota. Tämä vaihtoehto on käytettävissä vain asennusversiossa (setup.exe).

CSV-tiedostoon tallennettujen entiteettien tarkistaminen

Voit tarkistaa CSV-tiedostoon tallennetut entiteetit seuraavasti:

1. Avaa CSV-tiedosto ja lataa sen sisältö käyttämällä Load file -painiketta.
2. Suorita tarkistus painamalla Start checking -painiketta.

Näyttöön tulee ikkuna, joka kertoo tarkastusprosessin etenemisestä:

Kuten yllä olevasta kuvakaappauksesta näet, sovellus on erittäin nopea, koska se vahvisti yli 2000 tietuetta VIES:ssä alle 20 minuutissa. Se tuottaa 1,6 kyselyä sekunnissa. Sinun on kuitenkin tiedettävä, että sovelluksen suorituskyky riippuu lähinnä itse VIES-järjestelmän saatavuudesta ja vakaudesta.

Tärkeä ilmoitus: 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.

Kun tarkistus on suoritettu, tietyn rivin valitseminen mahdollistaa esikatselun ohjelman oikeanpuoleisessa paneelissa (Details välilehti):

Saadut tulokset voidaan suodattaa kirjoittamalla hakuteksti kenttään tietyn sarakkeen nimen alle tai tallentaa XLS (Microsoft Excel) tai CSV-tekstitiedostoon painamalla Save results -painiketta.

Voit myös mennä osoitteeseen Account -välilehti milloin tahansa, josta löydät:

• Tietoja aktiivisesta suunnitelmasta.
• Luettelo nykyisen suunnitelman toiminnoista.
• Tilastot liittyvät kuun alusta tehtyihin kyselyihin.