Valider un numéro de TVA européen

Validez un numéro d’identification TVA selon des règles structurelles propres à chaque pays. Sélectionnez l’État membre ou le schéma, collez le numéro et recevez un message succès/échec décrivant les contraintes contrôlées.

Ce que couvre la validation

Chaque gestionnaire pays teste les lettres de préfixe, la longueur autorisée, les segments purement numériques le cas échéant, et les algorithmes de somme de contrôle lorsqu’ils s’appliquent (par exemple Luhn pour les numéros italiens et espagnols, schémas modulo 11 pour d’autres). L’outil indique OK lorsque toutes les règles implémentées réussissent et KO lorsqu’une règle échoue.

Cela reflète les contrôles de format hors ligne avant d’appeler le service en ligne VIES de l’UE — il n’interroge pas VIES lui-même.

Quand l’utiliser

Détecter des fautes de frappe à la saisie de factures, filtrer l’envoi de formulaires dans des portails B2B, ou contrôler par lots des colonnes de tableur avant un export comptable.

Limites

La validation de format ne peut pas confirmer que le numéro est actif, attribué à l’entreprise indiquée ou autorisé pour des livraisons transfrontalières. Des numéros suspendus, fusionnés ou obtenus frauduleusement peuvent encore passer des contrôles syntaxiques. Les règles nationales évoluent ; le jeu de règles statique peut prendre du retard sur les mises à jour réglementaires.

Exemple

Une chaîne exemple au format TVA italienne est vérifiée pour la longueur et la somme de contrôle ; une clé altérée échoue au contrôle.

Cette skill est disponible via A2A JSON-RPC et REST. Si vous connaissez déjà le skillId et l’export, appelez execute directement—sans découverte.

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

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

Guide complet de l’API agents · Schéma de la skill