Valida partita IVA europea

Valida un numero di partita IVA rispetto a regole strutturali specifiche per paese. Seleziona lo Stato membro o lo schema, incolla il numero e ricevi un messaggio di esito positivo/negativo che descrive i vincoli controllati.

Cosa copre la validazione

Ogni gestore paese verifica lettere di prefisso, lunghezza consentita, segmenti solo numerici dove richiesto e algoritmi di checksum se applicabili (ad esempio Luhn su numeri italiani e spagnoli, schemi modulo 11 su altri). Lo strumento riporta OK quando tutte le regole implementate riescono e KO quando una regola fallisce.

Ciò rispecchia i controlli di formato offline eseguiti prima di chiamare il servizio online VIES dell’UE — non interroga VIES stesso.

Quando usarlo

Intercettare refusi in fase di inserimento fatture, controllare l’invio di form in portali B2B, o verificare a batch colonne di fogli di calcolo prima di un export contabile.

Limitazioni

La validazione di formato non può confermare che il numero sia attivo, assegnato all’azienda indicata o autorizzato per forniture transfrontaliere. Numeri sospesi, fusi o ottenuti fraudolentemente possono comunque superare i controlli sintattici. Le regole nazionali cambiano; l’insieme statico può restare indietro rispetto agli aggiornamenti normativi.

Esempio

Una stringa di esempio in formato partita IVA italiana viene controllata per lunghezza e checksum; una cifra di controllo alterata non supera il controllo.

Questa skill è disponibile via A2A JSON-RPC e REST. Se conosci già skillId ed export, chiama execute direttamente—senza discovery.

Esempio 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"]}'

Esempio 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"
        ]
      }
    }
  }
}

Guida completa Agent API · Schema della skill