Úvod

Aplikace VIES Checker umožňuje načíst libovolný soubor CSV a zkontrolovat entity (dodavatele), které se v tomto souboru objevují, z hlediska jejich aktuálního stavu v systém VIES.

Vydaná aplikace byla úspěšně otestována ve verzích MS Windows: 7/8/8.1/10 a 11. Aplikaci je možné nainstalovat v 32bitové i 64bitové verzi operačního systému Windows.

Nejnovější verze aplikace VIES Checker je vždy k dispozici ke stažení z webu Stažení strana.

Abyste mohli aplikaci používat, musíte si vytvořit účet na viesapi.eu webové stránky a vygenerovat klíč a jeho identifikátor. Proces registrace a nastavení účtu a také generování klíčů byl popsán na Dokumentace webová stránka.

Aktivace

Po stažení aplikace a jejím uložení na lokální počítač rozbalte ZIP archiv. Přenosná verze aplikace (viesapi-app-portable.zip) nevyžaduje instalaci a lze jej spustit pomocí běžného uživatelského účtu (nevyžaduje oprávnění správce). Verze instalačního programu (viesapi-app-setup.exe) také nevyžaduje administrátorská oprávnění a pro jeho instalaci stačí spustit soubor EXE.

Konfigurace

Po spuštění aplikace je nutné nastavení jednou nakonfigurovat. Chcete-li to provést, klepněte na Settings tlačítko z hlavní nabídky.

V Identifier zadejte hodnotu, která byla vygenerována při vytváření účtu na viesapi.eu portál – API Keys karta, Identifier sloupec. Nicméně, v Key zadejte hodnotu, která byla vygenerována při vytváření účtu na viesapi.eu portál – API Keys karta, Key sloupec.

Karta Možnosti má tři výchozí možnosti:

• Check for updates when the application starts – Toto nastavení umožňuje automatickou kontrolu nových verzí při spuštění aplikace.
• Normalize the format of VAT numbers when loading data – Tato možnost umožňuje normalizaci identifikačních čísel DPH v EU v souboru CSV.
• Use batch checking when applicable – výběrem této možnosti se dávkový režim použije na záznamy, u kterých došlo k chybě „Byl dosažen maximální počet souběžných dotazů pro tento členský stát“ (MS_MAX_CONCURRENT_REQ)

Pokud se připojení k internetu provádí pomocí proxy serveru, přejděte na stránku Proxy HTTP vyberte kartu Connect via the proxy server option below a vyplňte pole příslušnými údaji.

Popis hlavního menu

Níže uvedený obrázek ukazuje tlačítka dostupná v hlavní nabídce programu:

Load file – umožňuje vybrat textový soubor v CSV formát. Formát řádku je vatEU [, název společnosti], kde:

• vatEU – DIČ EU, na základě kterého bude prováděno ověření subjektu,
• companyName – Název společnosti (volitelné)

V případě souboru CSV, vatEU pole je povinné a companyName pole je volitelné pole a nemusí být přítomno. Záznam může obsahovat pouze DIČ EU.

Podle formátu CSV musí být textová pole uzavřena v uvozovkách a oddělena čárkou, např.: “PL7171642051”, “SpolečnostXYZ”

Delete selected – Odstraní všechny vybrané řádky.

Delete all – Odstraní všechny načtené řádky ze souboru CSV.

Start checking – tlačítko spustí ověřování všech vybraných kontrol. Status poplatníka VIES lze ověřit u subjektů registrovaných v některém z členských států Evropské unie.

Save results – stisknutím tlačítka můžete uložit výsledky kontrol do XLS (Microsoft Excel) nebo textového CSV souboru.

Settings – vyvolá záložku pro zadání identifikátoru a klíče.

Manage your account – stisknutí tlačítka umožňuje rychlý přechod na přihlašovací stránku portálu viesapi.eu.

Documentation – kliknutím na odkaz budete přesměrováni na tuto dokumentaci.

Contact – stisknutím tlačítka můžete automaticky vytvořit e-mail.

Check for update – umožňuje zkontrolovat, zda je k dispozici nová verze aplikace. Tato možnost je k dispozici pouze v instalační verzi (setup.exe).

Kontrola entit uložených v souboru CSV

Chcete-li zkontrolovat entity zaznamenané v souboru CSV, proveďte:

1. Otevřete soubor CSV a načtěte jeho obsah pomocí Load file knoflík.
2. Chcete-li provést kontrolu, stiskněte Start checking knoflík.

Zobrazí se okno informující o průběhu procesu kontroly:

Jak můžete vidět na výše uvedeném snímku obrazovky, aplikace je velmi rychlá, protože ověřila přes 2000 záznamů ve VIES za méně než 20 minut. Což dává výkon 1,6 dotazu za sekundu. Musíte však vědět, že výkon aplikace závisí především na dostupnosti a stabilitě samotného systému VIES.

Důležité oznámení: Velmi důležitou funkcí je možnost automatického opětovného odesílání požadavků, pokud The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ) dojde k chybě. Toto je velmi častá chyba při ověřování dodavatelů z Německa, Francie, České republiky, Dánska a někdy i Belgie. Více se o tomto problému můžete dočíst v našem blogovém článku:  [VYŘEŠENO] CHYBA VIES: „Byl dosažen maximální počet souběžných požadavků“. Aby se tento problém vyřešil, aplikace implementuje mechanismus pro dávkové, asynchronní odesílání požadavků, které nebyly systémem VIES správně zpracovány poprvé kvůli výše popsané chybě. Po dokončení první iterace kontrol aplikace shromáždí všechna DIČ EU, pro která byla vrácena výše uvedená chyba, vygeneruje pro ně dávky a odešle je do systému VIES k dávkovému ověření stavu aktivity DPH.

Po dokončení kontroly se výběrem konkrétního řádku aktivuje náhled v pravém panelu programu (Details karta):

Získané výsledky lze filtrovat zadáním hledaného textu do pole pod názvem daného sloupce nebo uložit do textového souboru XLS (Microsoft Excel) nebo CSV stisknutím tlačítka Save results knoflík.

Můžete také jít do Account kartu kdykoli, kde najdete:

• Informace o aktivním plánu.
• Seznam funkcí dostupných v aktuálním plánu.
• Statistiky týkající se dotazů provedených od začátku měsíce.