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: Erittäin tärkeä ominaisuus on mahdollisuus lähettää pyyntöjä uudelleen automaattisesti, jos The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ) virhe ilmenee. Tämä on hyvin yleinen virhe varmennettaessa urakoitsijoita Saksasta, Ranskasta, Tšekin tasavallasta, Tanskasta ja joskus myös Belgiasta. Voit lukea lisää tästä ongelmasta blogikirjoituksestamme:  [RATKAISTU] VIES-VIRHE: ”Samanaikaisten pyyntöjen enimmäismäärä on saavutettu”. Tämän ongelman kiertämiseksi sovellus ottaa käyttöön mekanismin eräpohjaiselle, asynkroniselle sellaisten pyyntöjen lähettämiselle, joita VIES ei käsitellyt oikein ensimmäisellä kerralla edellä kuvatun virheen vuoksi. Ensimmäisen tarkistuskierroksen suorittamisen jälkeen sovellus kerää kaikki EU:n ALV-numerot, joille yllä oleva virhe palautettiin, luo niistä erät ja lähettää ne VIES-järjestelmään ALV-toiminnan tilan erätarkistusta varten.

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.