Úvod

Aplikácia VIES Checker vám umožňuje načítať akýkoľvek súbor CSV a skontrolovať entity (dodávateľov), ktoré sa v tomto súbore vyskytujú, z hľadiska ich aktuálneho stavu v systém VIES.

Vydaná aplikácia bola úspešne otestovaná vo verziách MS Windows: 7/8/8.1/10 a 11. Aplikáciu je možné nainštalovať v 32-bitovej aj 64-bitovej verzii operačného systému Windows.

Najnovšia verzia aplikácie VIES Checker je vždy k dispozícii na stiahnutie z Stiahnuť ▼ stránku.

Ak chcete používať aplikáciu, musíte si vytvoriť účet na viesapi.eu a vygenerovať kľúč a jeho identifikátor. Proces registrácie a nastavenia účtu, ako aj generovanie kľúčov je popísaný na stránke Dokumentácia webovej stránky.

Aktivácia

Po stiahnutí aplikácie a jej uložení na lokálny počítač rozbaľte ZIP archív. Prenosná verzia aplikácie (viesapi-app-portable.zip) nevyžaduje inštaláciu a možno ho spustiť pomocou bežného používateľského účtu (nevyžaduje si práva správcu). Verzia inštalačného programu (viesapi-app-setup.exe) tiež nevyžaduje administrátorské oprávnenia a na jeho inštaláciu stačí spustiť súbor EXE.

Konfigurácia

Po spustení aplikácie je potrebné konfigurovať nastavenia raz. Ak to chcete urobiť, kliknite na Settings tlačidlo z hlavnej ponuky.

V Identifier zadajte hodnotu, ktorá bola vygenerovaná pri vytváraní účtu na viesapi.eu portál – API Keys karta, Identifier stĺpec. Avšak v Key zadajte hodnotu, ktorá bola vygenerovaná pri vytváraní účtu na viesapi.eu portál – API Keys karta, Key stĺpec.

Karta Možnosti má tri predvolené možnosti:

• Check for updates when the application starts – Toto nastavenie umožňuje automatickú kontrolu nových verzií pri spustení aplikácie.
• Normalize the format of VAT numbers when loading data – Táto možnosť umožňuje normalizáciu IČ DPH EÚ v súbore CSV.
• Use batch checking when applicable – výberom tejto možnosti sa dávkový režim použije na záznamy, pre ktoré sa vyskytla chyba „Dosiahol sa maximálny počet súbežných dopytov pre tento členský štát“ (MS_MAX_CONCURRENT_REQ)

Ak sa pripojenie k internetu vykonáva pomocou proxy servera, prejdite na stránku Proxy HTTP vyberte kartu Connect via the proxy server option below a vyplňte polia príslušnými údajmi.

Popis hlavného menu

Na obrázku nižšie sú zobrazené tlačidlá dostupné v hlavnom menu programu:

Load file – umožňuje vybrať textový súbor v CSV formát. Formát riadku je vatEU [, názov spoločnosti], kde:

• vatEU – IČ DPH EÚ, na základe ktorého sa bude vykonávať overenie subjektu,
• companyName - Názov spoločnosti (voliteľné)

V prípade súboru CSV, vatEU pole je povinné a companyName pole je voliteľné pole a nemusí byť prítomné. Záznam môže obsahovať iba IČ DPH EÚ.

Podľa formátu CSV musia byť textové polia uvedené v úvodzovkách a oddelené čiarkou, napr.: “PL7171642051”, “SpoločnosťXYZ”

Delete selected – Vymaže všetky vybraté riadky.

Delete all – Vymaže všetky načítané riadky zo súboru CSV.

Start checking – tlačidlo spustí overovanie všetkých vybraných kontrol. Status daňovníka VIES je možné overiť pre subjekty registrované v niektorom z členských štátov Európskej únie.

Save results – stlačením tlačidla môžete uložiť výsledky kontrol do XLS (Microsoft Excel) alebo textového CSV súboru.

Settings – vyvolá záložku pre zadanie identifikátora a kľúča.

Manage your account – stlačením tlačidla sa rýchlo dostanete na prihlasovaciu stránku portálu viesapi.eu.

Documentation – kliknutím na odkaz budete presmerovaní na túto dokumentáciu.

Contact – stlačením tlačidla môžete automaticky vytvoriť e-mail.

Check for update – umožňuje skontrolovať, či je k dispozícii nová verzia aplikácie. Táto možnosť je dostupná iba v inštalačnej verzii (setup.exe).

Kontrola entít uložených v súbore CSV

Ak chcete skontrolovať entity zaznamenané v súbore CSV, vykonajte:

1. Otvorte súbor CSV a načítajte jeho obsah pomocou Load file tlačidlo.
2. Ak chcete vykonať kontrolu, stlačte tlačidlo Start checking tlačidlo.

Zobrazí sa okno informujúce o priebehu procesu kontroly:

Ako môžete vidieť na vyššie uvedenom screenshote, aplikácia je veľmi rýchla, pretože overila viac ako 2000 záznamov vo VIES za menej ako 20 minút. Čo dáva výkon 1,6 dotazov za sekundu. Musíte však vedieť, že výkon aplikácie závisí predovšetkým od dostupnosti a stability samotného systému VIES.

Dôležitá poznámka: Veľmi dôležitou funkciou je možnosť automatického opätovného odoslania žiadostí, ak The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ) vyskytne sa chyba. Toto je veľmi častá chyba pri overovaní dodávateľov z Nemecka, Francúzska, Českej republiky, Dánska a niekedy aj Belgicka. Viac o tejto problematike si môžete prečítať v našom blogovom článku:  [VYRIEŠENÉ] CHYBA VIES: „Dosiahol sa maximálny počet súbežných požiadaviek“. Na obídenie tohto problému aplikácia implementuje mechanizmus pre dávkové, asynchrónne odosielanie žiadostí, ktoré systém VIES pri prvom použití správne nespracoval z dôvodu vyššie opísanej chyby. Po dokončení prvej iterácie kontrol aplikácia zhromaždí všetky IČ DPH v EÚ, pre ktoré bola vrátená vyššie uvedená chyba, vygeneruje pre ne dávky a odošle ich do systému VIES na dávkové overenie stavu aktivity DPH.

Po dokončení kontroly sa výberom konkrétneho riadku sprístupní náhľad v pravom paneli programu (Details karta):

Získané výsledky je možné filtrovať zadaním hľadaného textu do poľa pod názvom daného stĺpca alebo uložiť do textového súboru XLS (Microsoft Excel) alebo CSV stlačením tlačidla Save results tlačidlo.

Môžete tiež ísť do Account kartu kedykoľvek, kde nájdete:

• Informácie o aktívnom pláne.
• Zoznam funkcií dostupných v aktuálnom pláne.
• Štatistiky týkajúce sa dopytov vykonaných od začiatku mesiaca.