Az viesapi-cli.exe
A kliensalkalmazás lehetővé teszi az entitások (vállalkozók) gyors és automatikus ellenőrzését parancssorból (CLI / CMD) a VIES rendszerben lévő aktuális állapotuk szempontjából. Az alkalmazás lehetővé teszi a letöltött adatok fájlba mentését 3 formátumban:
- JSON
- PROP (tulajdonságok listája kulcs = érték formában)
- XML
Az alkalmazást sikeresen tesztelték a következő MS Windows verziókban: XP, 7, 10 és 11. Az alkalmazás legújabb verziója mindig letölthető a következő címről: 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 viesapi-cli.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
a 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ó viesapi-cli.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 viesapi-cli.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 viesapi-cli.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
):
viesapi-cli.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -format xml
Szintaxis hívása
A hívás szintaxisa viesapi-cli.exe
program:
viesapi-cli.exe <action>
Elérhető műveletek:
-help
– programhívási paraméterek leírása
-vies
– a VIES rendszer aktuális állapota
-account
– folyószámla állapota
-data
– cégadatok lekérése a VIES rendszerből
-data-parsed
– vállalati adatok lekérése a VIES-ből elemzett adatokkal
-batch-upload
– adószámok kötegelt feltöltése és kötegelt tokenek beszerzése
-batch-download
– Ellenőrizze a kötegelt eredményt és töltse le az adatokat
Elérhető opciók:
-keyid string
– API kulcs azonosító
-key string
– API kulcs
-euvat number
– EU-s áfaazonosító szám ország előtaggal
-token string
– kötegelt token értéke
-format type
– kimeneti formátum típusa (json, prop, xml), alapértelmezett: json
-file-in path
– bemeneti fájl elérési útja
-file-out path
– kimeneti fájl elérési útja
-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. Ellenőrzi a VIES rendszer aktuális állapotát, és XML formátumban megjeleníti az eredményt:
viesapi-cli.exe -vies -format xml
2. Ellenőrzi a fiók aktuális állapotát, és az eredményt JSON fájlba menti:
viesapi-cli.exe -account -file-out result.json
.
3. Letölti a cégadatokat a VIES-ből, és az eredményt PROP-ként jeleníti meg:
viesapi-cli.exe -data -euvat PL5213003700 -format prop
4. Letölti a VIES rendszerből a cég által elemzett adatokat, és az eredményt JSON fájlba menti:
viesapi-cli.exe -data-parsed -euvat PL5213003700 -file-out result.json
5. Feltölt egy kötegelt fájlt (soronként egy szám), és kap egy kötegelt tokent az eredmény ellenőrzéséhez:
viesapi-cli.exe -batch-upload -file-in numbers.csv
6. Ellenőrzi a köteg aktuális állapotát, és az eredményt JSON fájlba menti:
viesapi-cli.exe -batch-download -token 1fd853a5-ac9e-490c-81a1-d4900a9c906c -file-out result.json