Kliento programa viesClient.exe leidžia greitai ir automatiškai patikrinti subjektus (rangovus) komandų eilutės lygiu (CLI / CMD) atsižvelgiant į jų esamą būseną VIES sistemoje. Programa taip pat leidžia įrašyti atsisiųstus duomenis į failą 3 formatais:
- JSON (numatytasis rodymo formatas į stdout)
- XML
- ŽEMĖLAPIS (atributo žemėlapio raktas = vertė)
Programa buvo sėkmingai išbandyta šiose MS Windows versijose: XP, 7 ir 10.
Naujausią programos versiją visada galima atsisiųsti iš parsisiųsti puslapį.
Visą aplikacijos funkcionalumą galima patikrinti – nereikia susikurti paskyros – naudojant pateiktą Bandomasis API
Norėdami naudoti priedą gamybinėje API, turite susikurti paskyrą viesapi.eu svetainėje, įsigyti minimalų Verslo planą ir sugeneruoti API raktą bei API rakto identifikatorių.
Paskyros registravimo ir nustatymo bei raktų generavimo procesas aprašytas Dokumentacija Interneto svetainė.
Aktyvinimas
Bendrinama vykdomoji programa viesClient.exe nereikia įdiegti ir nebūtina paleisti naudojant administratoriaus teises turinčią paskyrą. Norėdami paleisti programą, pasirinkite Command Prompt paraiška iš Start meniu arba tipą cmd viduje "Search programs and files“ laukelį ir paspauskite Enter:
Paleidę konsolę, eikite į katalogą, kuriame yra ZIP failas viesClient.exe buvo atsisiųstas ir išpakuotas.
Paleidus programą nenurodant parametrų, parodomas pagalbos langas.
Konfigūracija
Paleidžiant viesClient.exe paraiška nenurodant API key ID ir API key leidžia pateikti užklausą bandymo aplinkoje (daugiau informacijos apie Išbandykite VIES API puslapis).
Norint prisijungti prie gamybinės aplinkos, būtina iškviesti viesClient.exe programa su autentifikavimo parametrais, kurie yra:
keyid– parametre turi būti API rakto identifikatorius (ID), sugeneruotas paskyroje viesapi.eu svetainėje,key– parametre turi būti API raktas (Key), sugeneruotas paskyroje viesapi.eu svetainėje.
Išsami informacija apie identifikatoriaus ir rakto generavimą aprašyta Dokumentacija puslapį. Žemiau pateikiamas programos iškvietimo su autentifikavimo parametrais pavyzdys (keyid ir key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.
Skambinimo sintaksė
Programos viesClient.exe iškvietimo sintaksė:
viesClient.exe <action> .
Galimi veiksmai :
-help – programos iškvietimo parametrų aprašymas
-account – grąžina informaciją apie einamosios sąskaitos likutį viesapi.eu
-vies – gauti įmonės duomenis iš VIES.
Galimos parinktys [parinktys]:
-keyid string – API rakto identifikatorius
-key string - API raktas
-euvat number – ES PVM mokėtojo kodas su šalies prefiksu
-format type
-file path
-proxy urlhttp://user:password@hostname:port).
Pavyzdžiai
DĖMESIO! Šie pavyzdžiai yra pritaikyti duomenims, surinktiems bandymo aplinkoje. Norėdami patikrinti gamybos aplinką, pridėkite –keyid ir –key parametrus su atitinkamomis reikšmėmis kiekvienai užklausai.
1. Įmonės duomenų atsisiuntimas iš VIES ir rezultato rodymas konsolėje MAP formatu:
viesClient.exe -vies -euvat PL5213003700 -map format
2. Rodyti informaciją apie dabartinę sąskaitos būseną:
viesClient.exe -account.
3. HTTP tarpinio serverio nustatymas:
viesClient.exe -vies -euvat PL7272445205 -proxy http://user:password@10.0.0.1:8080