The viesapi-cli.exe Klijentska aplikacija omogućuje brzu i automatsku provjeru entiteta (izvođača) iz komandne linije (CLI / CMD) u pogledu njihovog trenutnog statusa u VIES sustavu. Aplikacija također omogućuje spremanje preuzetih podataka u datoteku u 3 formata:
- JSON
- PROP (popis svojstava u obliku ključ = vrijednost)
- XML
Aplikacija je uspješno testirana u sljedećim verzijama MS Windowsa: XP, 7, 10 i 11. 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 viesapi-cli.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 viesapi-cli.exe je preuzeto i raspakirano.
Pokretanje programa bez navođenja parametara prikazuje prozor pomoći.
Konfiguracija
Pokretanje viesapi-cli.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 viesapi-cli.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):
viesapi-cli.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -format xml
Sintaksa poziva
Sintaksa pozivanja viesapi-cli.exe program:
viesapi-cli.exe <action>
Dostupne radnje:
-help – opis parametara pozivanja programa
-vies – trenutno stanje VIES sustava
-account – stanje tekućeg računa
-data – preuzmite podatke o tvrtki iz VIES-a
-data-parsed – dobiti podatke o tvrtki iz VIES-a s parsiranim podacima
-batch-upload – prenesite seriju PDV brojeva i nabavite seriju tokena
-batch-download – provjerite rezultat serije i preuzmite podatke
Dostupne opcije:
-keyid string – API ključ identifikator
-key string – API ključ
-euvat number – EU PDV ID broj s prefiksom države
-token string – vrijednost tokena serije
-format type – vrsta izlaznog formata (json, prop, xml), zadano: json
-file-in path – putanja ulazne datoteke
-file-out path – put izlazne datoteke
-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. Provjerava trenutni status VIES sustava i prikazuje rezultat kao XML:
viesapi-cli.exe -vies -format xml
2. Provjerava trenutni status računa i sprema rezultat u JSON datoteku:
viesapi-cli.exe -account -file-out result.json.
3. Preuzima podatke tvrtke iz VIES-a i prikazuje rezultat kao PROP:
viesapi-cli.exe -data -euvat PL5213003700 -format prop
4. Preuzima podatke koje je tvrtka analizirala iz VIES-a i sprema rezultat u JSON datoteku:
viesapi-cli.exe -data-parsed -euvat PL5213003700 -file-out result.json
5. Prenosi batch datoteku (jedan broj po retku) i prima batch token za provjeru rezultata:
viesapi-cli.exe -batch-upload -file-in numbers.csv
6. Provjerava trenutni status serije i sprema rezultat u JSON datoteku:
viesapi-cli.exe -batch-download -token 1fd853a5-ac9e-490c-81a1-d4900a9c906c -file-out result.json