El complemento de Excel le permite verificar de forma rápida y automática las entidades (contratistas) utilizando la hoja de cálculo de Excel en términos de su estado actual en el sistema VIES.

Este capítulo contiene instrucciones sobre cómo integrar la aplicación Microsoft Excel con el sistema nip24.pl. El complemento proporcionado se probó con éxito en las siguientes versiones de MS Excel: 2007, 2010, 2013, 2016, 2019 (en los sistemas operativos Windows y MacOS) y 2021 (en los sistemas operativos Windows y MacOS) y la versión web de Excel365.

La última versión del complemento para Excel 2007, 2010, 2013, 2016 y 2019 siempre está disponible para descargar desde el Página de descarga. El complemento se puede instalar en versiones de Excel de 32 y 64 bits. Atención! Seleccione la versión (32 o 64 bits) que coincide con la versión de Excel, no el sistema operativo.

Para descargar e instalar el complemento para MacOS y Excel 2021 para Windows y Excel365, visite la tienda oficial de Microsoft: https://appsource.microsoft.com.

Se puede verificar la funcionalidad completa del complemento de Excel: sin necesidad de crear una cuenta – utilizando el proporcionado API de prueba. La página también describe cómo configurar un complemento de Excel para usarlo en la API proporcionada para la prueba.

El uso del complemento en la API de producción requiere configurar una cuenta en el sitio web viesapi.eu, comprar un mínimo del plan Business y generar una clave y su identificador. 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.

Instalación y configuración para MS Excel 2021 y Excel 365 desde Microsoft Store (Fuente de la aplicación)

Instalación

Después de ingresar al sitio web de la tienda oficial de Microsoft https://appsource.microsoft.com, haga clic en el Get it now botón.

Se mostrará una ventana de inicio de sesión en la que deberá introducir la dirección de correo electrónico para la que ha creado una cuenta con Microsoft (privada o corporativa). Si no tiene esa cuenta, puede crear una y continuar con el proceso de instalación o detener la instalación y usar la opción para instalar el complemento de una de las formas descritas anteriormente.

Para descargar e instalar el complemento desde Excel 2021 o Excel 365 (web), vaya a la Insert [1], busque la sección Complementos y haga clic en el OfficeAdd-ins botón [2]. Luego, en la ventana abierta, ingrese la palabra 'viesapi ′ [3] en el campo de búsqueda y presiona el icono de la lupa. Un complemento llamado “VIES API - EU VAT Validation” debe ser encontrado, que debe ser instalado haciendo clic en el Add botón [4]. Todos los pasos anteriores se ilustran en la siguiente captura de pantalla:

Después de hacer clic en el Add , debería aparecer una pantalla donde puede leer los términos de la licencia y las reglas de protección de la privacidad.

Para comenzar a instalar el complemento, presione Continue botón.

Configuración

Después de instalar correctamente el complemento, debería ver una pantalla similar a la que se presenta a continuación. En el Home menu [1], busque el icono que representa el VIES API Panel [2] y haga clic en él para mostrar el panel lateral. Inmediatamente después de la instalación, el complemento se configura para funcionar en un entorno de prueba: detalles sobre el Página de prueba de la API. El uso del complemento en el modo de prueba no requiere crear una cuenta en el viesapi.eu sitio web.

Para cambiar el complemento al entorno de producción, haga clic en el ID and key [3] pestaña e ingrese el Key y llave ID, que puede encontrar después de iniciar sesión en su cuenta en el sitio web viesapi.eu en el “API Keys" pestaña. Después de ingresar ambos valores, presione la tecla Save botón.

Si aún no tiene una cuenta en nuestro sitio web, haga clic en el enlace en viesapi.eu [4] y siga el proceso de registro, que se describe en detalle en la Documentación página.

Instalación y configuración para Excel: 2007, 2010, 2013, 2016 y 2019

Instalación

Obtenga la última versión del complemento para Excel 2007, 2010, 2013, 2016 y 2019 de la Página de descarga. Inicie MS Excel y vaya a File> Options, luego seleccione Add-ins [1] del menú.

En la parte inferior de la configuración, seleccione Excel Add-ins [2] y haga clic en el Go botón [3].

Los usuarios avanzados pueden agregar un complemento desde el Developer pestaña [1], luego haga clic en Excel Add-ins [2] y haga clic en el Browse [3] botón:

En el Add-ins ventana, haga clic en el Browse , vaya al directorio donde se encuentra el viesapi-ms-excel-addin-version-number.zip el archivo fue desempaquetado y seleccione:

• viesapiExcel.xll – para la versión de 32 bits de Excel,
• viesapiExcel64.xll – para la versión de 64 bits de Excel.

La carga correcta del complemento se muestra en la siguiente figura [1].

Basta con hacer clic en el OK [2] para que las funciones implementadas en el complemento estén disponibles en Excel.

Configuración

Después de la instalación, el complemento se establece en el entorno de prueba de forma predeterminada (más detalles en API de prueba página). Para poder llamar funciones en el entorno de producción, es necesario configurar el acceso al sitio web viesapi.eu una vez. Para hacer esto, vaya a cualquier hoja de cálculo de Excel y realice la función:

=VIESAPI.CONNECT.PRODUCTION("identifier";"key")

donde los parámetros de la función son:

• identifier – el parámetro debe contener el identificador (ID) generado en la cuenta en el sitio web viesapi.eu,
• key – el parámetro debe contener la 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 sitio web.

Para verificar la corrección de la conexión con una determinada API (prueba o producción), se debe realizar la siguiente función:

=VIESAPI.CONNECT.STATUS()

Que puede devolver valores:

• SUCCESS: Production – si el complemento está configurado correctamente para funcionar con el entorno de producción,
• SUCCESS: Test – si el complemento está configurado correctamente para funcionar con el entorno de prueba,

• ERROR: Connection requires configuration – en caso de una configuración incorrecta.

De forma predeterminada, cada documento de Excel está configurado para calcular automáticamente la hoja de cálculo. Establecer esta opción implica que todas las fórmulas se llaman cuando se realizan cambios que afectan la fórmula. Un ejemplo de esto es eliminar una fila en una hoja de cálculo.

Para evitar la invocación automática de todas las funciones definidas en una hoja determinada, que está relacionada con el envío automático de consultas a la API del sitio web veisapi.eu, cambie la opción de cálculo del libro de trabajo a Manual:

1. Desde el File menú, Seleccione Options
2. Resaltar el Formulas pestaña
3. En la sección Opciones de cálculo, seleccione la configuración: Manual y desmarcar la opción adicional: Recalculate the workbook before saving.
4. Es necesario guardar los cambios realizados en la hoja.

Con la hoja de cálculo de Excel configurada de tal manera, para forzar la actualización de todas las fórmulas definidas, presione la combinación de teclas:

CTRL + ALT + SHIFT + F9

Actualice el complemento a la última versión

Atención!El siguiente procedimiento para actualizar el complemento de Excel funciona correctamente para las versiones de MS Excel 2019, 2021 y Excel 365, donde el complemento se puede instalar desde Microsoft Store.

Atención!Luego de instalar la última versión, deberás reconfigurar el complemento, es decir ingresar y guardar el ID y la clave.

Para instalar la última versión del complemento de Excel, siga estos pasos:

1. Verifique la versión del complemento instalado llamando a la fórmula =VIESAPI.VERSION()La última versión del complemento es 1.2.8

2. Borrar la memoria caché de MS Excel, según el procedimiento descrito en la página de documentación oficial: https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache

3. Después de completar todos los pasos del punto 2, reinicie la aplicación MS Excel.

4. Durante el reinicio, la aplicación MS Excel descargará la última versión del complemento desde Microsoft Store.

5. Configure el complemento ingresando el ID y la clave descargados después de iniciar sesión en su cuenta en nuestro sitio web – Pestaña “Claves API”.

Uso

Vea cómo verificar de forma automática y masiva el estado del IVA de la UE de las empresas en el sistema VIES utilizando nuestro complemento de Excel:

Antes de usar el complemento, debe familiarizarse con los detalles de su funcionamiento:

• Todas las llamadas a funciones se ejecutan en modo asíncrono, lo que no provoca el efecto de congelación (sin respuesta) de la aplicación de Excel.
• Agregar (insertar) una fila o columna no actualiza todas las llamadas a funciones definidas.
• Copiar o mover celdas que contienen funciones no actualiza las llamadas a funciones definidas.
• Eliminar una fila o columna actualizará todas las llamadas a funciones definidas y enviará consultas a viesApi.eu (solo en el caso de la configuración predeterminada de Excel). La descripción de cómo cambiar la configuración predeterminada se incluye en el capítulo Configuración.
• ¡Atención! No se recomienda ejecutar más de 500 consultas en paralelo porque Excel tiene problemas para manejar una gran cantidad de llamadas asincrónicas.

Obtener datos de la empresa de VIES

VIESAPI.VIES.DATA() – La función recupera todos los datos de la empresa disponibles directamente del sistema VIES. Los parámetros deben ser:

• Número de identificación fiscal europeo (IVA UE),
• (opcional) FORMAT de los datos devueltos (ver: Etiquetas que se pueden utilizar como FORMAT parámetro).

=VIESAPI.VIES.DATA("PL7171642051")

Si solo necesita el estado de la empresa en VIES, utilice la siguiente consulta:

=VIESAPI.VIES.DATA("PL7171642051";"$(Valid)")

Si el estado devuelto es Sí, significa que la empresa tiene un número de IVA de la UE válido.

Etiquetas disponibles en el VIESAPI.VIES.DATA función que se puede utilizar como FORMAT parámetro:

• $(UID) – Identificador único generado por el servicio viesApi.eu
• $(CountryCode) - Código de país
• $(VATNumber) – Número de IVA europeo
• $(Valid) – Estado válido Número de IVA de la UE (Yes/No)
  
• $(TraderName) – Nombre del contratista/proveedor
• $(TraderCompanyType) - Tipo de negocio
• $(TraderAddress) – Dirección de la contraparte
• $(ID) – Identificador único generado por el sistema VIES
• $(Date) – La fecha en que se generó la respuesta.
• $(Source) – La fuente de los datos.

Formato predeterminado: "$(TraderName), $(TraderAddress)"

si la cuerda "JSON" se da como el FORMAT parámetro, la función devolverá el resultado completo en forma de una cadena JSON, que se puede analizar y procesar libremente:

=VIESAPI.VIES.DATA("PL7171642051";"JSON")

Verificación del estado de la cuenta de usuario (sin cargo)

VIESAPI.STATUS.ACCOUNT() – La función devuelve información básica sobre el plan utilizado actualmente por el usuario. Los parámetros deben ser:

• (opcional) FORMAT de los datos devueltos (ver: Etiquetas que se pueden utilizar como FORMAT parámetro)

=VIESAPI.STATUS.ACCOUNT()

Atención! Llamar a la función no aumenta el número de consultas realizadas.

Las etiquetas disponibles en el VIESAPI.STATUS.ACCOUNT La función se puede utilizar como FORMAT parámetro:

• $(BillingPlanName) – Nombre del plan tarifario vigente
• $(SubscriptionPrice) – Precio neto de la suscripción mensual
• $(ItemPrice) – Costo neto de consulta única fuera del plan en el plan estándar
• $(ItemPriceStatus) – Costo neto de una sola consulta – VIES / Situación empresarial de la entidad en un plan individual
• $(Limit) – El número máximo de consultas en el plan
• $(RequestDelay) – El intervalo de tiempo mínimo entre solicitudes
• $(DomainLimit) – Número máximo de dominios (claves API)
• $(OverPlanAllowed) – Posibilidad de superar el número máximo de consultas en el plan
• $(ExcelAddIn) – Acceso mediante el complemento de MS Excel
• $(Stats) – Acceso a estadísticas de consultas realizadas
• $(NIPMonitor) – Acceso al seguimiento del estado VIES
• $(SearchByNIP) – Búsqueda por número de identificación fiscal del IVA de la UE
• $(FuncGetVIESData) – Acceso a funciones que consultan el estado de la entidad en el sistema VIES
• $(VIESStatusCount) – Número de consultas realizadas sobre el estado de la entidad en el sistema VIES
• $(TotalCount) – Número total de consultas ejecutadas en el mes actual

FORMATO predeterminado: "Name of the current tariff plan: $(BillingPlanName), Monthly subscription net price: $(SubscriptionPrice), Maximum number of inquiries in the plan: $(Limit), Total number of queries made in the current month: $(TotalCount)"

si la cuerda "JSON" se da como el FORMAT parámetro, la función devolverá el resultado completo en forma de una cadena JSON, que se puede analizar y procesar libremente.

Otras funciones útiles (gratuitas)

VIESAPI.ACCOUNT.STATUS.TOTAL() – La función devuelve información sobre el número total de consultas realizadas en el mes de facturación actual para una cuenta determinada (todas las claves API). Devuelve exactamente el mismo número que el $(TotalCount) etiqueta en el VIESAPI.STATUS.ACCOUNT() función.

VIESAPI.ACCOUNT.STATUS.LIMIT() – La función devuelve información sobre el número máximo de consultas disponibles en el plan seleccionado por el usuario. Devuelve exactamente el mismo número que el $(Limit) etiqueta en VIES.STATUS.ACCOUNT() función

VIESAPI.EUVAT.NORM() – Esta característica corrige y formatea el número de IVA de la UE (elimina espacios y guiones, etc.) fuera de línea y no recupera ningún dato de VIES:

=VIESAPI.EUVAT.NORM("PL 717-164-20-51")

VIESAPI.EUVAT.VALID() – La función solo verifica la corrección (sintaxis, suma de verificación) del número de IVA de la UE fuera de línea y no recupera ningún dato del sistema VIES. Devoluciones TRUE si el número es válido o FALSE si no es valido:

=VIESAPI.EUVAT.VALID("PL7171642051")

VIESAPI.CONNECTION.STATE() – La función devuelve el estado actual de la configuración del complemento.

Si la función devuelve el siguiente valor, significa, entre otros, que la ID y API key no se salvaron:

ERROR: Connection requires configuration

Después de guardar el API ID y key, la función debería devolver el siguiente mensaje:

SUCCESS: Production