Validador VIES del complemento de Hojas de cálculo de Google™

Validador VIES del complemento de Hojas de cálculo de Google™

API de VIES Hojas de cálculo de GoogleEl complemento de Google Sheets™ le permite comprobar de forma rápida y automática el estado actual de las entidades (contratistas) que utilizan la hoja de cálculo de Google Sheets™. sistema VIES.

Esta documentación contiene instrucciones sobre cómo integrar la aplicación Google Sheets™ con el sistema API de VIES.

 

 

Instalación y configuración

Instalación

Tras acceder al sitio web de Google Workspace Marketplace https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, haga clic en el Install botón.

Instalación del complemento de Google Sheets de la API de VIES

Seleccionar la cuenta de Google para la que se debe instalar y tener disponible el complemento VIES Validator de Google Sheets:

Instalación de la cuenta del complemento de Google Sheets de la API de Vies

En la siguiente pantalla podrá leer el Política de privacidad y el aplicable Términos de servicio, así como el alcance de los datos que procesaremos. Para continuar con el siguiente paso de la instalación, pulse el Continue botón.

permisos de instalación del complemento de Google Sheets de la API de VIES

Confirma que has concedido los permisos necesarios para que el complemento funcione correctamente y pulsa el botón Allow botón:

Permisos de instalación del complemento de Google Sheets de la API de Vies

El complemento de validación VIES se ha instalado correctamente en su cuenta y estará disponible después de abrir Hojas de cálculo de Google en la pestaña Extensiones. Para continuar, haga clic aquí. Next:

Instalación de la extensión del complemento de Google Sheets de la API de Vies

La pantalla final del instalador le pedirá que configure el complemento. Haga clic en el botón “Complete additional setup nowEl enlace abrirá una nueva ventana del navegador con la página de documentación actual. Haga clic en Done botón y comience a configurar el complemento como se describe en la sección de Configuración.

Complemento de Google Sheets con la API de Vies instalado

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 Para poder ejecutar funciones en el entorno de producción, es necesario configurar el acceso al sitio web viesapi.eu. Para ello, acceda a cualquier hoja de cálculo de Google Sheets™ y ejecute 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.

Si prefiere una configuración de barra lateral, haga clic en el Extensions pestaña, luego seleccione VIES API - EU VAT Validation y finalmente haz clic Show sidebar Para habilitar la barra lateral:

barra lateral de configuración del complemento de Google Sheets de la API de Vies

Luego ve a ID and Key pestaña para entrar en ID y Key en los campos de texto correspondientes, que estarán disponibles después de iniciar sesión en su cuenta de la API de VIES: https://viesapi.eu/sign-in/

ID y clave de configuración del complemento de Google Sheets de la API de VIES

Uso

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

  • Todas las llamadas de función se ejecutan en modo asincrónico, lo que no provoca el efecto de congelamiento (sin respuesta) de la aplicación Google Sheets™.
  • 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.
  • Al eliminar una fila o columna, se actualizarán todas las llamadas a funciones definidas y se enviarán consultas a viesApi.eu (solo con la configuración predeterminada de Hojas de Cálculo de Google™). 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 paralelas, ya que Hojas de Cálculo de Google™ tiene problemas para gestionar un gran número 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) – respuesta del servicio VIES, informando sobre el estado actual del IVA UE de la empresa comprobada (Yes/No)
  • $(TraderName) – nombre de registro de la empresa
  • $(TraderCompanyType) – tipo de negocio
  • $(TraderAddress) – dirección del comerciante donde está registrada la empresa
  • $(ID) – identificador único generado por el sistema VIES (número de consulta)
  • $(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")

Obtenga datos analizados de la empresa desde VIES

VIESAPI_VIES_DATA_PARSED() La función recupera todos los datos disponibles de la empresa directamente del sistema VIES. Además, el nombre y la dirección de la empresa se devuelven como datos analizados, divididos en atributos independientes. 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_PARSED("PL7171642051")

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

=VIESAPI_VIES_DATA_PARSED("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_PARSED 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) – respuesta del servicio VIES, informando sobre el estado actual del IVA UE de la empresa comprobada (Yes/No)
  • $(TraderName) – nombre de registro de la empresa
  • $(TraderNameComponents.Name) – nombre de la empresa de traderName (sin forma jurídica)
  • $(TraderNameComponents.LegalForm) – nombre de la forma jurídica extraído de traderName (sin nombre de la empresa)
  • $(TraderNameComponents.LegalFormCanonicalId) – identificador de diccionario de forma jurídica
  • $(TraderNameComponents.LegalFormCanonicalName) – nombre del diccionario de la forma jurídica
  • $(TraderCompanyType) – tipo de negocio
  • $(TraderAddress) – dirección del comerciante donde está registrada la empresa
  • $(TraderAddressComponents.Country) – nombre del país del comerciante en su idioma nacional
  • $(TraderAddressComponents.PostalCode) – código postal de la dirección del comerciante
  • $(TraderAddressComponents.City) – ciudad del domicilio del comerciante
  • $(TraderAddressComponents.Street) – calle del domicilio del comerciante
  • $(TraderAddressComponents.StreetNumber) – número de calle del edificio donde se encuentra la dirección del comerciante
  • $(TraderAddressComponents.HouseNumber) – número de apartamento/oficina de la dirección del comerciante
  • $(TraderAddressComponents.Other) – otros detalles de la dirección (nombre del área, nombre del edificio, número de piso, etc.)
  • $(ID) – identificador único generado por el sistema VIES (número de consulta)
  • $(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_PARSED("PL7171642051";"JSON")

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

VIESAPI_ACCOUNT_STATUS() – 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_ACCOUNT_STATUS()

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

Las etiquetas disponibles en el VIESAPI_ACCOUNT_STATUS La función se puede utilizar como FORMAT parámetro:

  • $(UID) – identificador único generado por el servicio viesApi.eu
  • $(BillingPlanName) – nombre del plan actual
  • $(SubscriptionPrice) – cuota de suscripción mensual
  • $(ItemPrice) – coste de una sola consulta fuera del plan
  • $(ItemPriceStatus) – coste por consulta – Estado de IVA/VIES/Actividad de la empresa
  • $(ItemPriceParsed) – coste por consulta – Estado de IVA/VIES/actividad de la empresa con datos analizados
  • $(Limit) – número máximo de consultas en el plan
  • $(RequestDelay) – intervalo de tiempo mínimo entre consultas
  • $(DomainLimit) – número máximo de dominios (claves API)
  • $(OverPlanAllowed) – capacidad de superar el número máximo de consultas en el plan
  • $(ExcelAddIn) – acceso al complemento Google Sheets™ y Microsoft Excel™
  • $(Stats) – acceso a las estadísticas de consultas
  • $(NIPMonitor) – acceso al seguimiento del estado de las empresas: Estado IVA/VIES/Actividad
  • $(FuncGetVIESData) – acceso a funciones que verifican el estado de la empresa en el sistema VIES
  • $(FuncGetVIESDataParsed) – acceso a funciones que verifican el estado de la empresa en el sistema VIES y analizan el nombre y la dirección del comerciante
  • $(VIESDataCount) – número de consultas VIES realizadas este mes
  • $(VIESDataParsedCount) – número de consultas VIES con datos analizados realizadas este mes
  • $(TotalCount) – número total de consultas realizadas este mes

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.

Comprobación del estado del sistema VIES (gratuita)

VIESAPI_VIES_STATUS() Esta función permite verificar el estado actual del sistema VIES. Muestra un estado general que indica la disponibilidad, así como una lista de los países miembros individuales junto con el estado de disponibilidad actual de sus sistemas nacionales. Los parámetros deben ser:

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

=VIESAPI_VIES_STATUS()

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

Las etiquetas disponibles en el VIESAPI_VIES_STATUS La función se puede utilizar como FORMAT parámetro:

  • $(UID) – identificador único generado por el servicio viesApi.eu
  • $(Available) – disponibilidad actual del sistema VIES (Disponible, Parcialmente disponible, No disponible)
  • $(Countries) – lista de estados de cada país miembro (Disponible, No disponible)
  • $(AT), $(FR), $(PL), etc. – estado de disponibilidad de un país miembro específico (use el código de país de 2 letras mayúsculas como valor de etiqueta)

FORMATO predeterminado: "$(Available)"

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

Google Sheets™ es una marca comercial de Google LLC.