Valida Número de IVA Europeo

Valida un número de identificación IVA frente a reglas estructurales específicas de cada país. Selecciona el Estado miembro o el esquema, pega el número y recibe un mensaje de aprobado/rechazado que describe qué restricciones se comprobaron.

Qué cubre la validación

Cada manejador de país comprueba letras de prefijo, longitud permitida, segmentos solo numéricos cuando corresponde y algoritmos de suma de comprobación si aplica (por ejemplo Luhn en números italianos y españoles, esquemas módulo 11 en otros). La herramienta informa OK cuando todas las reglas implementadas pasan y KO cuando alguna falla.

Esto refleja comprobaciones de formato sin conexión previas a llamar al servicio en línea VIES de la UE: no consulta VIES en sí.

Cuándo usarlo

Detectar errores tipográficos al introducir facturas, acotar el envío de formularios en portales B2B, o comprobar por lotes columnas de hojas de cálculo antes de una exportación contable.

Limitaciones

La validación de formato no puede confirmar que el número esté activo, asignado a la empresa indicada o autorizado para suministros transfronterizos. Números suspendidos, fusionados u obtenidos de forma fraudulenta pueden seguir pasando comprobaciones sintácticas. Las reglas nacionales cambian; el conjunto estático puede retrasarse respecto a actualizaciones regulatorias.

Ejemplo

Una cadena de ejemplo con forma de NIF-IVA italiano se comprueba por longitud y suma de control; un dígito de control alterado falla la comprobación.

Esta skill está disponible por A2A JSON-RPC y REST. Si ya conoce el skillId y el export, llame a execute directamente—sin descubrimiento.

Ejemplo REST

curl -sS -X POST https://toolplaza.app/api/helpers/execute \
  -H 'Content-Type: application/json' \
  -d '{"skillId":"vat-number__validate","export":"validateVatNumber","args":["sample"]}'

Ejemplo A2A JSON-RPC

Send POST https://toolplaza.app/api/a2a with:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "message": {
      "messageId": "uuid",
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "ignored"
        }
      ]
    },
    "metadata": {
      "toolplaza": {
        "skillId": "vat-number__validate",
        "export": "validateVatNumber",
        "args": [
          "sample"
        ]
      }
    }
  }
}

Guía completa de la API de agentes · Esquema de la skill