Cómo integrar la consulta de IVA de VIES en la incorporación de empresas
El viernes, al revisar los rechazos en su entidad de crédito para pequeñas empresas, encuentra varias solicitudes de Alemania registradas casi al mismo tiempo con el motivo «número de IVA no registrado». Una de esas empresas ya llamó. Su propietario dice que el número aparece en todas las facturas que emite y quiere saber por qué se detuvo la solicitud. El mes pasado agregó la consulta de IVA después de que un intermediario presentara una solicitud con el número de otra empresa. Ahora el mismo motivo aparece en negocios con historias muy distintas y el lunes llegarán más solicitudes. ¿Qué debería significar esa respuesta antes de que se convierta en una decisión?
VIES devuelve más que «válido» o «inválido»
Una respuesta de VIES puede indicar el estado del registro, incluir un nombre registrado o informar de un error del registro. El servicio VIES de la Comisión Europea confirma si un número de IVA está registrado, y la respuesta puede incluir el nombre registrado. En las consultas que hicimos desde nuestro equipo el 30 de octubre de 2026, vimos números registrados con nombre, números registrados con el nombre oculto, números no registrados y errores del registro.
Un número alemán figuró como válido con el nombre «---» y, dos minutos después, devolvió MS_UNAVAILABLE. Una regla que solo evalúe valid daría por buena la primera respuesta, aunque no hubiera un nombre para comparar. Si se trata la ausencia de valid como si fuera un resultado inválido, un problema temporal del registro puede terminar en un rechazo.
| respuesta | ejemplo | estado HTTP | valid | nombre registrado | Regla: solo valid |
|---|---|---|---|---|---|
| registrado, nombre disponible | IE6388047V | 200 | true | GOOGLE IRELAND LIMITED | pass |
| registrado, nombre no disponible | DE811569869, ESB82846825 | 200 | true | --- | pass, no hay nada que comparar |
| no registrado | IE1234567X | 200 | false | --- | decline |
| el registro no responde, REST | DE811569869 | 200 | ausente | ausente, error MS_UNAVAILABLE | no encuentra valid |
| el registro no responde, SOAP | DE811569869 | 200 | ausente | fallo MS_UNAVAILABLE | no encuentra valid |
| registro ocupado, endpoint del navegador | LV40003009497 | 200 | false | ---, error MS_MAX_CONCURRENT_REQ | decline |
El tipo de respuesta importa: el estado del registro indica si el número aparece en la base de datos nacional. El nombre puede servir para comprobar si quien solicita el crédito es la empresa registrada.
El estado del servicio no clasifica una respuesta individual
Clasifique cada consulta a partir de su respuesta y use la página de estado solo como contexto. En nuestras consultas, el endpoint del navegador devolvió isValid como false junto con MS_MAX_CONCURRENT_REQ cuando el registro estaba ocupado. Si se lee ese valor false por sí solo, un problema del registro parece indicar que el número no está registrado.
El endpoint del navegador es el que utiliza la página web de VIES. El contrato REST publicado documenta una interfaz distinta. La página de estado también dio información contradictoria frente a nuestras consultas: mostraba Alemania como disponible cuando las respuestas alemanas indicaban MS_UNAVAILABLE, y Letonia como no disponible cuando los números letones devolvían respuestas válidas con nombres.
La Comisión indica que VIES obtiene información de bases de datos de los Estados miembros que están fuera de su control. La disponibilidad puede variar según el registro y la consulta.
Enrute el error del servicio antes de decidir el estado de registro
Conecte el código de país y el número de IVA de la solicitud con un servicio VIES publicado y asigne un resultado propio a los errores del servicio. Las interfaces publicadas son REST y SOAP. REST ofrece POST /check-vat-number y SOAP ofrece checkVat. Ambas interfaces se pueden usar sin una clave ni una cuenta.
En una fuente de datos, tome del flujo de decisiones el código de país y el número de la solicitud. La fuente de datos incorpora la respuesta a los datos de la decisión, donde las reglas pueden clasificarla. Compruebe primero si hay un error y después lea valid: en nuestras consultas a Alemania, REST devolvió HTTP 200 con MS_UNAVAILABLE y sin el campo valid. La opción de reintento documentada para REST se aplica a problemas de conexión y a determinados estados HTTP. No cubre las respuestas HTTP 200 con MS_UNAVAILABLE, que debe gestionar el flujo de decisiones.
Por ejemplo, asigne una respuesta de error a un resultado de indisponibilidad, como refer o un nuevo intento posterior. Si valid es false, el número no está registrado. Si es true, está registrado. Antes de poner la integración en producción, compruebe que cada rama llegue a la decisión prevista.
Compruebe por separado el nombre registrado
Un número válido puede pertenecer a otra empresa. Compare el nombre registrado con la razón social indicada en la solicitud y use valores distintos para el estado del registro y la comprobación del nombre en la tabla de decisión.
En nuestras consultas a Alemania y España, los números válidos devolvieron el nombre y la dirección como «---». Los valores de coincidencia del comerciante fueron NOT_PROCESSED, así que no había un nombre que comparar. Clasifique «---» como nombre no informado.
Como ejemplo de regla, marque la comprobación del nombre como coincidencia cuando el nombre devuelto contenga la razón social indicada por quien solicita el crédito; como no informado, cuando el nombre esté vacío o sea «---»; y como discrepancia, cuando no coincida con la razón social de la solicitud. Una persona debería revisar las discrepancias. Si VIES no informa el nombre, búsquelo en el registro mercantil correspondiente. Para una solicitud del Reino Unido, la consulta de Companies House es un ejemplo de verificación en un registro.
| estado del IVA | comprobación del nombre | resultado | motivo |
|---|---|---|---|
| no disponible | cualquiera | refer | VAT_CHECK_UNAVAILABLE |
| inválido | cualquiera | decline | VAT_NOT_REGISTERED |
| válido | discrepancia | refer | VAT_NAME_MISMATCH |
| válido | no informado | refer | VAT_NAME_NOT_DISCLOSED |
| válido | coincidencia | pass | OK |
Una persona debería revisar las discrepancias y, si el nombre no está informado, consultar el registro mercantil correspondiente. VIES es un dato más junto con otras verificaciones en los préstamos para pymes.
Revise las condiciones antes de guardar respuestas en caché
Antes de activar una caché, pida al equipo legal que revise las condiciones de VIES para el uso previsto. Las condiciones restringen la retransmisión y otros usos, y prohíben expresamente copiar o reproducir el contenido. Pida al equipo legal que confirme si la integración y las opciones de almacenamiento previstas están permitidas.
También hay un riesgo técnico. La documentación sobre la caché de fuentes de datos explica que se puede guardar una respuesta procesable cuyo estado HTTP sea inferior a 400. Por eso, una respuesta REST con HTTP 200 y un cuerpo procesable puede guardar un error como MS_UNAVAILABLE igual que si fuera una respuesta normal.
Defina los resultados antes de que lleguen las solicitudes del lunes
Antes de que lleguen las solicitudes del lunes, defina los resultados de la consulta:
- Llame al contrato REST publicado o al servicio SOAP con el código de país y el número de IVA de la solicitud. La página web de VIES utiliza un endpoint distinto para el navegador.
- Compruebe primero si hay un error y después lea
valid. Asigne un resultado propio al error, como la derivación o un nuevo intento posterior. Reserve el rechazo para los números cuya falta de registro se haya confirmado. - Haga la consulta y lea la respuesta. Use la respuesta de cada consulta para determinar si funcionó. La página de estado aporta contexto sobre el servicio.
- Compare el nombre registrado con la razón social de la solicitud. Asigne un resultado propio al número válido registrado a nombre de otra empresa para que lo revise una persona.
- Clasifique «---» como nombre no informado. Compruebe el nombre en el registro mercantil correspondiente.
- Pida al equipo legal que revise las condiciones y apruebe el uso previsto antes de guardar respuestas de VIES en caché mediante REST. Tenga en cuenta que la caché podría guardar respuestas de error HTTP 200 como si fueran respuestas normales.
- Conserve la respuesta de validación junto con la decisión, en el formato que apruebe el equipo legal, de acuerdo con la recomendación de la Comisión para una inspección fiscal.
Preguntas sobre la consulta de IVA de VIES
¿Hay una API gratuita para validar números de IVA de la UE?
Nuestras consultas no requirieron una clave ni una cuenta. La Comisión no publica un precio para el servicio. Compruebe en las condiciones qué usos están permitidos.
¿Qué significa MS_UNAVAILABLE y qué resultado debería asignarle?
MS_UNAVAILABLE significa que la aplicación del Estado miembro no responde o no está disponible. Nuestras consultas a Alemania devolvieron este error con HTTP 200. Asígnele un resultado propio, como la derivación o un nuevo intento posterior, en lugar de rechazar la solicitud.
¿Un resultado válido de VIES demuestra que la empresa es quien dice ser?
No. Un número válido puede pertenecer a otra empresa. Compare el nombre registrado con la razón social de la solicitud y pida a una persona que revise las discrepancias.
¿VIES ofrece REST o SOAP y cuál conviene usar?
VIES publica interfaces REST y SOAP. Use el contrato publicado que admita su integración y compruebe cómo llegan sus errores al flujo de decisiones.
¿Puedo guardar las respuestas de VIES y volver a utilizarlas?
Solo después de que el equipo legal haya revisado las condiciones y aprobado el uso previsto. Las condiciones restringen la retransmisión y otros usos, y prohíben copiar o reproducir el contenido. Acuerde con el equipo legal qué registro de validación permite el uso previsto antes de guardar o reutilizar una respuesta.
¿Cuánto tarda una consulta a VIES?
En nuestras consultas del 30 de octubre de 2026, la mayoría de las respuestas tardaron de 0.4 a 0.8 segundos y algunas demoraron más. Son mediciones de una tarde, no una garantía del servicio. Asegúrese de que las consultas lentas o fallidas tengan un resultado propio.