POST AI agent ready /v1/validate/vat

API de validación de número de IVA: verificación gratuita del IVA en la UE

Envíe un número de IVA y reciba información si coincide con el formato esperado para su país. Apoya a todos los estados miembros de la UE. Útil para facturación B2B, flujos de pago exentos de impuestos y comprobaciones de cumplimiento. El número de IVA se procesa en el servidor y nunca se almacena.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/validate/vat \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"DE123456789"}'

When to use this API

Verificar los ID de IVA del cliente durante el pago B2B

Antes de aplicar una exención de IVA de tipo cero al finalizar la compra, valide el número de identificación fiscal del comprador. Esto le protege de la emisión de facturas incorrectas y de posibles sanciones durante las auditorías fiscales.

Completar automáticamente las reglas fiscales y de país a partir de un número de IVA

Extraiga el código de país del ID de IVA para aplicar automáticamente la tasa de IVA, el idioma de la factura y los requisitos de presentación de informes correctos para cada estado miembro de la UE.

Valide por lotes los números de IVA en su CRM

Ejecute su base de datos de clientes a través del punto final periódicamente. Marque las cuentas con ID de IVA no válidos o vencidos para que su equipo de finanzas pueda solicitar documentos actualizados antes del siguiente ciclo de facturación.

Frequently asked questions

¿Qué países son compatibles?

Los 27 estados miembros de la UE. Cada país tiene su propio formato de número de IVA (por ejemplo, DE + 9 dígitos para Alemania, FR + 11 caracteres para Francia). La API valida según el patrón correcto para el país detectado.

¿Esta API verifica el número de IVA con la base de datos VIES?

Este punto final valida el formato y la estructura del número de IVA. Para realizar una búsqueda de VIES (Comisión de la UE) en tiempo real para confirmar el estado del registro, vincúlelo con el servicio oficial VIES SOAP.

¿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 escriben datos en el disco ni en ningún sistema externo.

¿Puedo validar los números de IVA del Reino Unido?

Los números de IVA del Reino Unido (prefijo GB) siguen un formato conocido y pueden validarse estructuralmente. Desde que el Reino Unido abandonó la UE, ya no forma parte de VIES, pero la verificación de formato aún funciona.

¿Qué pasa si envío un número sin el prefijo de país?

La API requiere el prefijo de país de dos letras (por ejemplo, "DE", "FR", "NL"). Sin él, la respuesta devuelve válido: falso con un motivo que explica que falta el código de país.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.