Introducción

El servicio Viesapi.eu proporciona datos de empresarios seleccionados utilizando, entre otros, servicios web, bibliotecas de programación y aplicaciones dedicadas. Mediante el uso del software disponible (bibliotecas, aplicaciones y complemento de Excel), sus clientes podrán:

  • verificar el estado del número de IVA de la UE de los contratistas en el sistema VIES,
  • descargar datos de la empresa del sistema VIES,
  • rellenar automáticamente los formularios de factura,

de la manera más rápida posible.

Este documento describe en detalle qué pasos se deben seguir para integrarse correctamente con el servicio viesapi.eu.


¡Atención! La funcionalidad completa se puede verificar utilizando proporcionado Pruebe la API de VIES. Mediante el uso de la API TEST es posible comprobar todas las funciones que se ofrecen en los planes de pago sin necesidad de crear una cuenta.


Siga los pasos a continuación para acceder a la interfaz API de producción.

El primer paso es registrarse en el sistema y crear una cuenta. Gracias a lo cual será posible descargar el software y configurarlo para una correcta comunicación con los servicios web proporcionados por el servicio viesapi.eu.

Registro

Se requiere el registro de una entidad dispuesta a utilizar la funcionalidad del servicio viesapi.eu. Para ello, acceda a la Registro página y complete el formulario correspondiente. El requisito previo para utilizar el servicio viesapi.eu es la aceptación de las normas. Rellenando correctamente el formulario y haciendo clic en el Inscribirse botón creará una cuenta en el servicio viesapi.eu y su activación automática.

Acceso

Es posible iniciar sesión en una cuenta activada después de ingresar al Pestaña de inicio de sesión y la presentación en la dirección de correo electrónico y la contraseña definidas durante el registro. Después de la autenticación correcta, es posible administrar la cuenta. El usuario puede generar identificadores y claves de acceso en su cuenta, que se utilizan para autenticarse ante el sistema.

Generación de un identificador (identifier) y una clave de acceso (key)

Al iniciar sesión por primera vez, aparece un identifier se genera automáticamente junto con el correspondiente key. los identifier es público y no requiere protección, mientras que el key es privado y no debe estar disponible para terceros. Adicionalmente, con el fin de aumentar la seguridad, el usuario podrá ingresar al IP address de donde pueden surgir consultas. Esta podría ser, por ejemplo, la dirección IP de una tienda en línea. No hay límite para el número de pares de claves e identificadores generados. En caso de que el usuario no quiera utilizar ningún par identificador-clave, puede desactivarlo cambiando su estado.

Claves API

Métodos de acceso a la API VIES actualmente disponibles

A continuación presentamos los posibles métodos de acceso a la API VIES. Haga clic en el título o enlace a la documentación para obtener más detalles.

1. Bibliotecas de programación: PHP, .NET (C#, Visual Basic, SQL Server, Access, Dynamics, FoxPro), Python, Java, C/C++, JavaScript

Documentación técnica y descripción detallada de cómo utilizar las bibliotecas disponibles en el Documentación pestaña.

Los archivos de bibliotecas se pueden descargar desde el sitio web vinculado Descargar.

2. Complemento de API VIES de Microsoft Excel

Para las personas que usan la aplicación Excel a diario, preparamos un complemento fácil de usar. Le permite verificar de manera efectiva (sin conocimientos de programación) el estado de una entidad en la lista blanca, el registro de IVA y el sistema VIES, así como buscar y descargar datos de entidades y verificar su estado de actividad comercial actual.

Detalles de instalación, configuración y uso en el Complemento MS Excel VIES API página.

3. Comprobador de aplicaciones de IVA de la UE (GUI)

La aplicación VIES Checker le permite cargar cualquier archivo CSV para verificar entidades (contratistas), cuyos números de IVA de la UE se guardan en el archivo CSV en términos de su estado en el sistema VIES.

Detalles de instalación, configuración y uso descritos directamente en la Aplicación Verificador VIES página.

La aplicación no requiere instalación ni derechos de administrador para ejecutarse. Puedes descargarlo desde el Descargar página.

4. Comprobador CLI/CMD del IVA de la UE

El VIES CLI/CMD Checker es una aplicación cliente que permite la 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.

Detalles de instalación, configuración y uso descritos directamente en la Comprobador VIES CLI/CMD página.

La aplicación no requiere instalación ni derechos de administrador para ejecutarse. Puedes descargarlo desde el Descargar página.

5. API REST

Si está interesado en conectarse directamente a nuestra API REST, lea la información disponible en el API REST página.

6. Supervisión automática del estado de los proveedores de IVA de la UE

El servicio de verificación automática de los números de IVA de la UE permite un seguimiento completamente libre de mantenimiento del estado de la entidad en el sistema VIES. Leer más información sobre el Supervisión página.