VIES Checker CLI/CMD

Klijentska aplikacija viesClient.exe omogućuje brzu i automatsku provjeru subjekata (izvođača) iz razine naredbenog retka (CLI / CMD) u pogledu njihovog trenutnog statusa u VIES sustavu. Aplikacija također omogućuje spremanje preuzetih podataka u datoteku u 3 formata:

  • JSON (zadani format prikaza za stdout)
  • XML
  • MAP (ključ karte atributa = vrijednost)

Aplikacija je uspješno testirana u sljedećim verzijama MS Windows: XP, 7 i 10.

Najnovija verzija aplikacije uvijek je dostupna za preuzimanje s preuzimanje datoteka stranica.

Potpuna funkcionalnost aplikacije može se provjeriti – bez potrebe za stvaranjem računa – pomoću priloženog Test API

Da biste koristili dodatak u produkcijskom API-ju, trebate postaviti račun na web stranici viesapi.eu, kupiti minimalno Poslovni plan i generirati API ključ i identifikator API ključa.

Proces registracije i postavljanja računa kao i generiranja ključeva opisan je na Dokumentacija web stranica.

Aktivacija

Zajednički izvršni program viesClient.exe ne zahtijeva instalaciju i ne mora se pokretati pod računom s administrativnim ovlastima. Za pokretanje programa odaberite Command Prompt prijava od Start meni ili vrsta cmd u "Search programs and files“ polje i pritisnite Enter:

Nakon pokretanja konzole idite u direktorij u kojem se nalazi zip datoteka viesClient.exe je preuzeto i raspakirano.

Pokretanje programa bez navođenja parametara prikazuje prozor pomoći.

Konfiguracija

Pokretanje viesClient.exe prijava bez navođenja API key ID i API key omogućuje vam postavljanje upita testnom okruženju (više detalja o Testirajte VIES API stranica).

Za povezivanje s produkcijskim okruženjem potrebno je pozvati viesClient.exe aplikaciju s parametrima provjere autentičnosti, a to su:

  • keyid – parametar treba sadržavati API ključ identifikator (ID) generiran na računu na web stranici viesapi.eu,
  • key – parametar treba sadržavati API ključ (Key) generiran na računu na web stranici viesapi.eu.

Pojedinosti o generiranju identifikatora i ključa opisane su na Dokumentacija stranica. Ispod je primjer pozivanja aplikacije s parametrima provjere autentičnosti (keyid i key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.

Sintaksa poziva

Sintaksa pozivanja programa viesClient.exe:
viesClient.exe <action> [options].

Dostupne akcije :
-help – opis parametara pozivanja programa
-account – vraća informacije o trenutnom stanju računa viesapi.eu
-vies – dobiti podatke o tvrtki iz VIES-a.

Dostupne opcije [opcije]:

-keyid string – API ključ identifikator
-key string – API ključ
-euvat number – EU PDV ID broj s prefiksom države
-format type – format vraćenih podataka (JSON, MAP, XML), zadano: JSON
-file path – naziv i put do datoteke rezultata, zadano: direktorij za pokretanje viesClient.exe
-proxy url – HTTP proxy konfiguracija (kao URL http://user:password@hostname:port).

Primjeri

PAŽNJA! Sljedeći primjeri prilagođeni su podacima prikupljenim u testnom okruženju. Da biste izvršili provjere proizvodnog okruženja, dodajte –keyid i –key parametre s odgovarajućim vrijednostima za svaki upit.

1. Preuzimanje podataka tvrtke s VIES-a i prikaz rezultata na konzoli u MAP formatu:

viesClient.exe -vies -euvat PL5213003700 -map format

2. Prikaz informacija o trenutnom statusu računa:

viesClient.exe -account.

3. HTTP proxy postavka:

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