API de validación del número de IVA: verifique los números de identificación fiscal de la UE en una POST
Valide los números de IVA de los 27 estados miembros de la UE con una llamada API. Devuelve validez, código de país y número formateado. Nivel gratuito, sin SOAP XML.
Vendes software a empresas en Europa. La legislación fiscal de la UE exige validar el IVA del comprador DNI antes de aplicar la inversión del sujeto pasivo (0% IVA). El servicio oficial VIES tiene un tiempo de actividad poco confiable y devuelve SOAP XML. Necesita una alternativa RESTful más rápida.
La botoi /v1/validate/vat El punto final valida los números de IVA de los 27 miembros de la UE.
estados y el Reino Unido. Envíe un POST, obtenga una respuesta JSON con validez, código de país y el
número formateado. Sin análisis XML. Sin archivos WSDL. No hay tiempos de espera por parte de un gobierno sobrecargado
servidores.
La llamada API
Envíe un número de IVA con el prefijo de país de dos letras:
Respuesta:
La valid el campo es true cuando el número coincide con el formato esperado
para su país. El country_code y country los campos te lo dicen
a qué jurisdicción pertenece el número.
Cuando un número no pasa la validación
Si el número no coincide con el patrón esperado, valid regresa
false. La respuesta todavía incluye el país detectado:
Los números de IVA alemanes requieren exactamente 9 dígitos después del DE prefijo. Éste tiene 5.
Su interfaz puede mostrar el nombre del país y el formato esperado para ayudar al usuario a corregir su
entrada.
Integración de pago con Stripe
Antes de crear una sesión de pago de Stripe, valide el ID de IVA del comprador. Si es válido, establezca
el cliente a tax_exempt: "reverse" entonces Stripe cobra 0% de IVA. si es
no válido, rechace el formulario y solicite al comprador que lo corrija.
Esto evita dos problemas comunes: cobrar el IVA a una empresa que debería estar exenta (creando un dolor de cabeza en materia de reembolsos) y concediendo una exención de impuestos a alguien con un número de IVA falso (creando un problema de auditoría).
Generación de facturas con IVA condicional
Al generar una factura, debe decidir el tipo de IVA. Las reglas:
- Venta B2B en el mismo país: cargue su tasa de IVA nacional.
- Venta B2B transfronteriza con un NIF válido: aplicar inversión de cargo (0%).
- ID de IVA no válido o faltante: cobra la tarifa local del comprador.
La country_code de la respuesta de la API impulsa esta lógica:
Validación del formulario de registro SaaS B2B
Agregue un campo de número de IVA a su formulario de registro y valídelo al enviarlo. Si es válido, complete automáticamente el menú desplegable de países. Si no es válido, muestra un error antes de que el formulario llegue a tu backend.
Esto mantiene los datos incorrectos fuera de su sistema de facturación. También evita que su equipo de finanzas tenga que realizar tareas manualmente. verificar los números de IVA después de que el cliente ya se haya registrado y haya comenzado a utilizar el producto.
Formato de IVA por país
Cada país de la UE tiene un formato diferente para los números de identificación del IVA. La API valida contra todos estos patrones:
La lista completa cubre los 27 estados miembros de la UE más el Reino Unido. Los formatos van desde 8 dígitos. (Dinamarca, Luxemburgo) a 12 dígitos (Suecia). Algunos países incluyen letras en el cuerpo del número (Francia, España, Irlanda).
Validación de formato frente a búsqueda de VIES
Esta API valida la estructura de un número de IVA. Confirma el prefijo, longitud, y el patrón de caracteres coinciden con las reglas de ese país. No cuestiona la opinión de la Comisión de la UE Base de datos VIES para confirmar que el número está registrado activamente.
Para la mayoría de los flujos de pago, la validación del formato es el primer paso correcto. Detecta errores tipográficos, faltantes prefijos y números inventados al instante, sin depender de un servicio externo que frecuentemente hacia abajo. Si también necesita el estado de registro, llame a VIES después de que pase la verificación de formato. Este enfoque de dos pasos reduce las llamadas VIES entre un 15% y un 30% (todos los formatos no válidos nunca llegan al servicio lento).
Puntos clave
El nivel gratuito cubre el desarrollo y el uso de producción de bajo volumen. Para pagos con mucho tráfico
flujos, agregue su clave API en el Authorization: Bearer encabezamiento. Compruebe el
Documentos API
para obtener la referencia completa del punto final y el
parque infantil interactivo para probar los números de IVA en su navegador.
FAQ
- ¿Qué países admite la API de validación del IVA?
- Los 27 estados miembros de la UE, más el Reino Unido (prefijo GB). Cada país tiene su propio patrón de formato. La API detecta el país a partir del prefijo de dos letras y lo valida con la expresión regular correcta para esa jurisdicción.
- ¿Sustituye esto al servicio VIES SOAP?
- Reemplaza la parte de validación de formato. VIES confirma si un número específico está registrado ante una autoridad fiscal nacional. Esta API valida la estructura y el formato al instante, sin depender del tiempo de actividad de VIES. Use ambos juntos: primero verifique el formato, luego busque en VIES el estado registrado.
- ¿Se almacena el número de IVA después de la validación?
- No. El número se procesa en la memoria y se descarta después de la respuesta. No se escribe nada en el disco ni en ningún sistema externo.
- ¿Puedo validar los números de IVA del Reino Unido después del Brexit?
- Los números de IVA del Reino Unido (prefijo GB) siguen un patrón conocido y pueden validarse estructuralmente. Ya no forman parte del sistema VIES de la UE, pero la verificación de formato todavía funciona.
- ¿Qué pasa si omito el prefijo del país?
- La API requiere el prefijo de país de dos letras (por ejemplo, "DE", "FR", "NL"). Sin él, el punto final devuelve un error explicando que falta el código de país o que no es compatible.
Empieza a construir con botoi
150+ endpoints de API para consultas, procesamiento de texto, generacion de imagenes y utilidades para desarrolladores. Plan gratuito, sin tarjeta de credito.