The viesapi-cli.exe Aplicația client permite verificarea rapidă și automată a entităților (contractorilor) de la nivelul liniei de comandă (CLI / CMD) în ceea ce privește starea lor curentă în sistemul VIES. Aplicația vă permite, de asemenea, să salvați datele descărcate într-un fișier în 3 formate:
- JSON
- PROP (listă de proprietăți sub forma cheie = valoare)
- XML
Aplicația a fost testată cu succes pe următoarele versiuni de MS Windows: XP, 7, 10 și 11. Cea mai recentă versiune a aplicației este întotdeauna disponibilă pentru descărcare de pe Descarca pagină.
Funcționalitatea completă a aplicației poate fi verificată – fără a fi nevoie să creați un cont – folosind aplicația furnizată Testați API-ul
Pentru a utiliza suplimentul în API-ul de producție, trebuie să vă configurați un cont pe site-ul viesapi.eu, să cumpărați un minim din planul de afaceri și să generați o cheie API și un identificator cheie API.
Procesul de înregistrare și creare a unui cont, precum și de generare a cheilor a fost descris pe Documentație site-ul web.
Activare
Programul executabil partajat viesapi-cli.exe nu necesită instalare și nu trebuie să fie rulat sub un cont cu privilegii administrative. Pentru a rula programul, selectați Command Prompt cerere de la Start meniu sau tip cmd în Search programs and files câmp și apăsați Enter:
După ce porniți consola, mergeți la directorul în care se află fișierul zip viesapi-cli.exe a fost descărcat și despachetat.
Pornirea programului fără specificarea parametrilor afișează fereastra de ajutor.
Configurare
Lansarea viesapi-cli.exe aplicație fără a specifica API key ID și API key vă permite să interogați mediul de testare (mai multe detalii despre Testați API-ul VIES pagină).
Pentru a vă conecta la mediul de producție, este necesar să apelați viesapi-cli.exe aplicație cu parametrii de autentificare, care sunt:
keyid– parametrul trebuie să conțină identificatorul cheii API (ID) generat în contul de pe site-ul viesapi.eu,key– parametrul trebuie să conțină cheia API (Key) generată în contul de pe site-ul viesapi.eu.
Detaliile despre generarea identificatorului și a cheii sunt descrise în Documentație pagină. Mai jos este un exemplu de apelare a aplicației cu parametri de autentificare (keyid și key):
viesapi-cli.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -format xml
Sintaxa de apelare
Sintaxa apelării viesapi-cli.exe program:
viesapi-cli.exe <action>
Acțiuni disponibile:
-help – descrierea parametrilor de apelare program
-vies – starea actuală a sistemului VIES
-account – situația contului curent
-data – obțineți date despre companie de la VIES
-data-parsed – obține date despre companie din VIES cu date analizate
-batch-upload – încărcarea unui lot de numere de TVA și obținerea unui token de lot
-batch-download – verificați rezultatul lotului și descărcați datele
Opțiuni disponibile:
-keyid string – identificatorul cheii API
-key string – cheie API
-euvat number – Cod de TVA UE cu prefix de țară
-token string – valoarea tokenului de lot
-format type – tipul formatului de ieșire (json, prop, xml), implicit: json
-file-in path – calea fișierului de intrare
-file-out path – calea fișierului de ieșire
-proxy url – Configurare proxy HTTP (ca URL http://user:password@hostname:port)
Exemple
ATENŢIE! Următoarele exemple sunt adaptate la datele colectate în mediul de testare. Pentru a efectua verificări asupra mediului de producție, adăugați –keyid și –key parametrii cu valorile adecvate fiecărei interogări.
1. Verifică starea curentă a sistemului VIES și afișează rezultatul ca XML:
viesapi-cli.exe -vies -format xml
2. Verifică starea curentă a contului și salvează rezultatul într-un fișier JSON:
viesapi-cli.exe -account -file-out result.json.
3. Descarcă datele companiei din VIES și afișează rezultatul ca PROP:
viesapi-cli.exe -data -euvat PL5213003700 -format prop
4. Descarcă datele analizate de companie din VIES și salvează rezultatul într-un fișier JSON:
viesapi-cli.exe -data-parsed -euvat PL5213003700 -file-out result.json
5. Încarcă un fișier batch (un număr pe linie) și primește un token batch pentru verificarea rezultatelor:
viesapi-cli.exe -batch-upload -file-in numbers.csv
6. Verifică starea curentă a lotului și salvează rezultatul într-un fișier JSON:
viesapi-cli.exe -batch-download -token 1fd853a5-ac9e-490c-81a1-d4900a9c906c -file-out result.json