L'application client viesClient.exe permet une vérification rapide et automatique des entités (entrepreneurs) à partir du niveau de la ligne de commande (CLI / CMD) en fonction de leur statut actuel dans le système VIES. L'application permet également d'enregistrer les données téléchargées dans un fichier sous 3 formats :

• JSON (format d'affichage par défaut sur stdout)
• XML
• MAP (clé de mappage d'attributs = valeur)

L'application a été testée avec succès dans les versions suivantes de MS Windows : XP, 7 et 10.

La dernière version de l'application est toujours disponible en téléchargement sur le Télécharger page.

La fonctionnalité complète de l'application peut être vérifiée - sans avoir besoin de créer un compte - en utilisant le Tester l'API

Pour utiliser le complément dans l'API de production, vous devez créer un compte sur le site viesapi.eu, acheter au minimum le plan Business et générer une clé API et un identifiant de clé API.

Le processus d'enregistrement et de création d'un compte ainsi que la génération de clés ont été décrits sur le Documentation site Internet.

Activation

Le programme exécutable partagé viesClient.exe ne nécessite pas d'installation et n'a pas besoin d'être exécuté sous un compte avec des privilèges d'administration. Pour exécuter le programme, sélectionnez le Command Prompt candidature de la Start menu ou type cmd dans le "Search programs and files“ champ et appuyez sur Entrée :

Après avoir démarré la console, allez dans le répertoire où se trouve le fichier zip avec viesClient.exe a été téléchargé et décompressé.

Le démarrage du programme sans spécifier de paramètres affiche la fenêtre d'aide.

Configuration

Lancer le viesClient.exe demande sans préciser le API key ID et API key permet d'interroger l'environnement de test (plus de détails sur le Tester l'API VIES page).

Pour se connecter à l'environnement de production, il est nécessaire d'appeler le viesClient.exe application avec les paramètres d'authentification, qui sont :

• keyid – le paramètre doit contenir l'identifiant (ID) de la clé API générée sur le compte sur le site viesapi.eu,
• key – le paramètre doit contenir la clé API (Key) générée sur le compte sur le site viesapi.eu.

Les détails sur la génération de l'identifiant et de la clé sont décrits sur le Documentation page. Ci-dessous un exemple d'appel de l'application avec des paramètres d'authentification (keyid et key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.

Syntaxe d'appel

Syntaxe d'appel du programme viesClient.exe :
viesClient.exe <action> [options].

Actions disponibles :
-help – description des paramètres d'appel du programme
-account – renvoie des informations sur le solde du compte courant de viesapi.eu
-vies – obtenir les données de l'entreprise auprès de VIES.

Options disponibles [options] :

-keyid string – Identifiant de clé API
-key string - Clé API
-euvat number – Numéro d'identification à la TVA de l'UE avec le préfixe du pays
-format type – format des données retournées (JSON, MAP, XML), par défaut : JSON
-file path – nom et chemin d'accès au fichier de résultat, par défaut : répertoire d'exécution de viesClient.exe
-proxy url – Configuration du proxy HTTP (comme URL http://user:password@hostname:port).

Exemples

ATTENTION! Les exemples suivants sont adaptés aux données collectées dans l'environnement de test. Pour effectuer des vérifications sur l'environnement de production, ajoutez le –keyid et –key paramètres avec les valeurs appropriées à chaque requête.

1. Téléchargement des données de l'entreprise depuis VIES et affichage du résultat sur la console au format MAP :

viesClient.exe -vies -euvat PL5213003700 -map format

2. Afficher des informations sur l'état actuel du compte :

viesClient.exe -account.

3. Paramètre proxy HTTP :

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