The viesapi-cli.exe Odjemalska aplikacija omogoča hitro in samodejno preverjanje entitet (izvajalcev) iz ukazne vrstice (CLI/CMD) glede na njihov trenutni status v sistemu VIES. Aplikacija omogoča tudi shranjevanje prenesenih podatkov v datoteko v 3 formatih:
- JSON
- PROP (seznam lastnosti v obliki ključ = vrednost)
- XML
Aplikacija je bila uspešno preizkušena v naslednjih različicah sistema MS Windows: XP, 7, 10 in 11. Najnovejša različica aplikacije je vedno na voljo za prenos s spletne strani. Prenesi strani.
Celotno funkcionalnost aplikacije lahko preverite – brez potrebe po ustvarjanju računa – z uporabo priloženega Test API
Za uporabo dodatka v produkcijskem API-ju morate ustvariti račun na spletnem mestu viesapi.eu, kupiti najmanj poslovni načrt in ustvariti ključ API in identifikator ključa API.
Postopek registracije in nastavitve računa ter generiranja ključev je opisan na Dokumentacija Spletna stran.
Aktivacija
Izvedljivi program v skupni rabi viesapi-cli.exe ne zahteva namestitve in ga ni treba izvajati pod računom s skrbniškimi pravicami. Če želite zagnati program, izberite Command Prompt aplikacija iz Start meni ali vrsto cmd v Search programs and files in pritisnite Enter:
Po zagonu konzole pojdite v imenik, v katerem je datoteka zip viesapi-cli.exe je bil prenesen in razpakiran.
Če program zaženete brez podajanja parametrov, se prikaže okno s pomočjo.
Konfiguracija
Zagon viesapi-cli.exe aplikacija brez navedbe API key ID in API key omogoča povpraševanje po testnem okolju (več podrobnosti o Test VIES API stran).
Za povezavo s proizvodnim okoljem je potrebno priklicati viesapi-cli.exe aplikacijo z avtentikacijskimi parametri, ki so:
keyid– parameter mora vsebovati identifikator (ID) ključa API, generiran na računu na spletni strani viesapi.eu,key– parameter mora vsebovati API ključ (Key), generiran na računu na spletni strani viesapi.eu.
Podrobnosti o generiranju identifikatorja in ključa so opisane na Dokumentacija strani. Spodaj je primer klica aplikacije z avtentikacijskimi parametri (keyid in key):
viesapi-cli.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -format xml
Klicna sintaksa
Sintaksa klicanja viesapi-cli.exe program:
viesapi-cli.exe <action>
Razpoložljiva dejanja:
-help – opis parametrov klica programa
-vies – trenutno stanje sistema VIES
-account – stanje tekočega računa
-data – pridobite podatke o podjetju iz sistema VIES
-data-parsed – pridobivanje podatkov o podjetju iz VIES z razčlenjenimi podatki
-batch-upload – naložite paket številk za DDV in pridobite paketni žeton
-batch-download – preverite rezultat serije in prenesite podatke
Razpoložljive možnosti:
-keyid string – identifikator ključa API
-key string – API ključ
-euvat number – ID številka za DDV EU s predpono države
-token string – vrednost žetona serije
-format type – vrsta izhodne oblike (json, prop, xml), privzeto: json
-file-in path – pot vhodne datoteke
-file-out path – pot izhodne datoteke
-proxy url – Konfiguracija strežnika proxy HTTP (kot URL http://user:password@hostname:port)
Primeri
POZOR! Naslednji primeri so prilagojeni podatkom, zbranim v testnem okolju. Če želite izvesti preverjanja produkcijskega okolja, dodajte –keyid in –key parametre z ustreznimi vrednostmi za vsako poizvedbo.
1. Preveri trenutno stanje sistema VIES in prikaže rezultat kot XML:
viesapi-cli.exe -vies -format xml
2. Preveri trenutno stanje računa in rezultat shrani v datoteko JSON:
viesapi-cli.exe -account -file-out result.json.
3. Prenese podatke podjetja iz sistema VIES in prikaže rezultat kot PROP:
viesapi-cli.exe -data -euvat PL5213003700 -format prop
4. Prenese podatke, ki jih je podjetje razčlenilo iz sistema VIES, in rezultat shrani v datoteko JSON:
viesapi-cli.exe -data-parsed -euvat PL5213003700 -file-out result.json
5. Naloži paketno datoteko (ena številka na vrstico) in prejme paketni žeton za preverjanje rezultata:
viesapi-cli.exe -batch-upload -file-in numbers.csv
6. Preveri trenutno stanje serije in shrani rezultat v datoteko JSON:
viesapi-cli.exe -batch-download -token 1fd853a5-ac9e-490c-81a1-d4900a9c906c -file-out result.json