L'applicazione client viesClient.exe consente un controllo rapido e automatico delle entità (appaltatori) dal livello della riga di comando (CLI / CMD) in base al loro stato attuale nel sistema VIES. L'applicazione consente inoltre di salvare i dati scaricati in un file in 3 formati:
- JSON (formato di visualizzazione predefinito su stdout)
- XML
- MAP (chiave mappa attributo = valore)
L'applicazione è stata testata con successo nelle seguenti versioni di MS Windows: XP, 7 e 10.
L'ultima versione dell'applicazione è sempre disponibile per il download da Scarica pagina.
La piena funzionalità dell'applicazione può essere verificata – senza la necessità di creare un account – utilizzando l'apposito API di prova
Per utilizzare l'add-in nell'API di produzione, è necessario creare un account sul sito viesapi.eu, acquistare un minimo del piano Business e generare una chiave API e un identificatore di chiave API.
Il processo di registrazione e creazione di un account, nonché la generazione di chiavi è stato descritto in Documentazione sito web.
Attivazione
Il programma eseguibile condiviso viesClient.exe non richiede installazione e non deve essere eseguito con un account con privilegi di amministratore. Per eseguire il programma, selezionare il Command Prompt domanda dal Start menu o tipo cmd nel "Search programs and files“ campo e premere Invio:
Dopo aver avviato la console, vai alla directory in cui è contenuto il file zip viesClient.exe è stato scaricato e decompresso.
Avviando il programma senza specificare i parametri viene visualizzata la finestra della guida.
Configurazione
Lanciando il viesClient.exe domanda senza specificare il API key ID e API key consente di interrogare l'ambiente di test (maggiori dettagli sul file Prova l'API VIES pagina).
Per connettersi all'ambiente di produzione, è necessario richiamare il viesClient.exe applicazione con i parametri di autenticazione, che sono:
keyid– il parametro deve contenere l'identificatore della chiave API (ID) generato sull'account sul sito viesapi.eu,key– il parametro deve contenere la chiave API (Key) generata sull'account sul sito viesapi.eu.
I dettagli sulla generazione dell'identificatore e della chiave sono descritti in Documentazione pagina. Di seguito è riportato un esempio di chiamata dell'applicazione con parametri di autenticazione (keyid e key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.
Sintassi di chiamata
Sintassi di chiamata del programma viesClient.exe:
viesClient.exe <action> .
Azioni Disponibili :
-help – descrizione dei parametri di chiamata del programma
-account – restituisce informazioni sul saldo del conto corrente di viesapi.eu
-vies – ottenere i dati aziendali da VIES.
Opzioni disponibili [opzioni]:
-keyid string – Identificatore chiave API
-key string – Chiave API
-euvat number – Numero di partita IVA UE con prefisso del paese
-format type
-file path
-proxy urlhttp://user:password@hostname:port).
Esempi
ATTENZIONE! Gli esempi seguenti sono adattati ai dati raccolti nell'ambiente di test. Per eseguire i controlli sull'ambiente di produzione, aggiungere il –keyid e –key parametri con i valori appropriati per ciascuna query.
1. Scaricare i dati aziendali da VIES e visualizzare il risultato sulla console in formato MAP:
viesClient.exe -vies -euvat PL5213003700 -map format
2. Visualizza le informazioni sullo stato del conto corrente:
viesClient.exe -account.
3. Impostazione proxy HTTP:
viesClient.exe -vies -euvat PL7272445205 -proxy http://user:password@10.0.0.1:8080