La aplicación cliente viesClient.exe permite una verificación rápida y automática de entidades (contratistas) desde el nivel de línea de comando (CLI / CMD) en términos de su estado actual en el sistema VIES. La aplicación también le permite guardar los datos descargados en un archivo en 3 formatos:

• JSON (formato de visualización predeterminado a stdout)
• XML
• MAP (clave de mapa de atributos = valor)

La aplicación ha sido probada con éxito en las siguientes versiones de MS Windows: XP, 7 y 10.

La última versión de la aplicación está siempre disponible para su descarga desde el Descargar página.

La funcionalidad completa de la aplicación se puede verificar, sin necesidad de crear una cuenta, utilizando el API de prueba

Para usar el complemento en la API de producción, debe configurar una cuenta en el sitio web viesapi.eu, comprar un mínimo del plan Business y generar una clave de API y un identificador de clave de API.

El proceso de registro y configuración de una cuenta, así como la generación de claves, se ha descrito en el Documentación sitio web.

Activación

El programa ejecutable compartido viesClient.exe no requiere instalación y no tiene que ejecutarse con una cuenta con privilegios administrativos. Para ejecutar el programa, seleccione el Command Prompt aplicación de la Start menú o tipo cmd en el "Search programs and files“ campo y presione Entrar:

Después de iniciar la consola, vaya al directorio donde se encuentra el archivo zip con viesClient.exe fue descargado y descomprimido.

Iniciar el programa sin especificar parámetros muestra la ventana de ayuda.

Configuración

Lanzando el viesClient.exe aplicación sin especificar el API key ID y API key le permite consultar el entorno de prueba (más detalles en el Pruebe la API de VIES página).

Para conectarse al entorno de producción, es necesario llamar al viesClient.exe aplicación con los parámetros de autenticación, que son:

• keyid – el parámetro debe contener el identificador de clave API (ID) generado en la cuenta en el sitio web viesapi.eu,
• key – el parámetro debe contener la clave API (Clave) generada en la cuenta en el sitio web viesapi.eu.

Los detalles sobre la generación del identificador y la clave se describen en la Documentación página. A continuación se muestra un ejemplo de cómo llamar a la aplicación con parámetros de autenticación. (keyid y key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.

Sintaxis de llamada

Sintaxis para llamar al programa viesClient.exe:
viesClient.exe <action> [options].

Acciones disponibles :
-help – descripción de los parámetros de llamada del programa
-account – devuelve información sobre el saldo de la cuenta corriente de viesapi.eu
-vies – obtener datos de la empresa de VIES.

Opciones disponibles [opciones]:

-keyid string – Identificador de clave API
-key string - Clave API
-euvat number – Número de identificación de IVA de la UE con prefijo de país
-format type – formato de los datos devueltos (JSON, MAP, XML), por defecto: JSON
-file path – nombre y ruta al archivo de resultados, por defecto: directorio de ejecución viesClient.exe
-proxy url – Configuración del proxy HTTP (como URL http://user:password@hostname:port).

Ejemplos

ATENCIÓN! Los siguientes ejemplos están adaptados a los datos recopilados en el entorno de prueba. Para realizar comprobaciones en el entorno de producción, agregue el –keyid y –key parámetros con los valores adecuados a cada consulta.

1. Descarga de datos de la empresa desde VIES y visualización del resultado en la consola en formato MAP:

viesClient.exe -vies -euvat PL5213003700 -map format

2. Mostrar información sobre el estado actual de la cuenta:

viesClient.exe -account.

3. Configuración del proxy HTTP:

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