A viesClient.exe kliens alkalmazás lehetővé teszi az entitások (vállalkozók) gyors és automatikus ellenőrzését parancssori szintről (CLI / CMD) aktuális állapotuk szempontjából a VIES rendszerben. Az alkalmazás azt is lehetővé teszi, hogy a letöltött adatokat fájlba mentse 3 formátumban:

• JSON (alapértelmezett megjelenítési formátum: stdout)
• XML
• TÉRKÉP (attribútumleképezés kulcsa = érték)

Az alkalmazást sikeresen tesztelték az MS Windows következő verzióiban: XP, 7 és 10.

Az alkalmazás legújabb verziója mindig letölthető a Letöltés oldalon.

Az alkalmazás teljes funkcionalitása ellenőrizhető – fiók létrehozása nélkül – a megadott segítségével Teszt API

A bővítmény éles API-ban való használatához létre kell hoznia egy fiókot a viesapi.eu webhelyen, meg kell vásárolnia legalább az Üzleti tervet, és létre kell hoznia egy API kulcsot és API kulcs azonosítót.

A fiók regisztrációjának és beállításának, valamint a kulcsok generálásának folyamatát a Dokumentáció weboldal.

Aktiválás

A megosztott végrehajtható program viesClient.exe nem igényel telepítést, és nem kell rendszergazdai jogosultságokkal rendelkező fiók alatt futtatni. A program futtatásához válassza ki a Command Prompt alkalmazás a Start menü vagy típus cmd ban,-ben "Search programs and files“ mezőbe, és nyomja meg az Enter billentyűt:

A konzol elindítása után lépjen abba a könyvtárba, ahol a zip fájl található viesClient.exe letöltve és kicsomagolva.

A program elindításakor a paraméterek megadása nélkül megjelenik a súgóablak.

Konfiguráció

Elindítva a viesClient.exe alkalmazás megadása nélkül API key ID és API key lehetővé teszi a tesztkörnyezet lekérdezését (további részletek a Tesztelje a VIES API-t oldal).

A termelési környezethez való csatlakozáshoz ki kell hívni a viesClient.exe alkalmazás hitelesítési paramétereivel, amelyek a következők:

• keyid – a paraméternek tartalmaznia kell a viesapi.eu webhelyen található fiókban generált API kulcs azonosítót (ID),
• key – a paraméternek tartalmaznia kell a viesapi.eu weboldalon lévő fiókon generált API kulcsot (Key).

Az azonosító és a kulcs létrehozásának részletei a következő oldalon találhatók: Dokumentáció oldalon. Az alábbiakban egy példa látható az alkalmazás hitelesítési paraméterekkel történő meghívására (keyid és key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.

Szintaxis hívása

A viesClient.exe program meghívásának szintaxisa:
viesClient.exe <action> [options].

Elérhető műveletek :
-help – programhívási paraméterek leírása
-account – információkat ad vissza a viesapi.eu folyószámla egyenlegéről
-vies – szerezze be a cégadatokat a VIES-től.

Rendelkezésre álló opciók [opciók]:

-keyid string – API kulcs azonosító
-key string – API kulcs
-euvat number – EU-s áfaazonosító szám ország előtaggal
-format type – a visszaküldött adatok formátuma (JSON, MAP, XML), alapértelmezett: JSON
-file path – az eredményfájl neve és elérési útja, alapértelmezés: viesClient.exe futtatási könyvtár
-proxy url – HTTP-proxy konfiguráció (URL-ként http://user:password@hostname:port).

Példák

FIGYELEM! A következő példák a tesztkörnyezetben gyűjtött adatokhoz igazodnak. Az éles környezet ellenőrzéséhez adja hozzá a –keyid és –key paramétereket a megfelelő értékekkel minden lekérdezéshez.

1. Céges adatok letöltése a VIES-ről és az eredmény megjelenítése a konzolon MAP formátumban:

viesClient.exe -vies -euvat PL5213003700 -map format

2. Információk megjelenítése az aktuális számla állapotáról:

viesClient.exe -account.

3. HTTP-proxy beállítása:

viesClient.exe -vies -euvat PL7272445205 -proxy http://user:password@10.0.0.1:8080