Vérifier un numéro de TVA

Nom de l'outilcheck_vat
ÉcritureIdempotentMonde ouvert

Description

Texte exact envoyé au modèle par tools/list :

Vérifie un numéro de TVA européen auprès de VIES (service de la Commission européenne), comme le formulaire de tiers de l'application : renvoie le nom et l'adresse enregistrés pour ce numéro, et les tiers d'Oxygenius qui l'ont déjà. L'application note la date de vérification sur ces tiers. Un numéro invalide est renvoyé comme une erreur.

Accès requis

Paramètres

NomTypePrésenceDescription
vatNumberstringobligatoireNuméro de TVA précédé du code pays, ex. BE0123456789 (espaces et points acceptés).

Résultat

Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.

Champs du résultat
NomTypePrésenceDescription
validbooleanVrai si VIES reconnaît le numéro (un numéro invalide est une erreur).
vatNumberstringNuméro vérifié, précédé du code pays.
namestringpeut être nullNom enregistré pour ce numéro, tel que le donne VIES.
addressstringpeut être nullAdresse enregistrée pour ce numéro, telle que la donne VIES (une seule chaîne).
checkedOnstring (date)peut être nullDate de la vérification (AAAA-MM-JJ).
existingTiersobject[]Tiers déjà enregistrés avec ce numéro de TVA : vérifier s'il ne s'agit pas du tiers recherché avant d'en créer un.
existingTiers[].idintegerIdentifiant technique du tiers (à passer à get_tiers).
existingTiers[].referencestringpeut être nullRéférence du tiers.
existingTiers[].namestringDénomination : société, sinon nom et prénom.
existingTiers[].kindstringcompany (société renseignée) ou individual (personne).
existingTiers[].isSupplierbooleanVrai pour un fournisseur.
existingTiers[].isActivebooleanFaux si le tiers est en sommeil.
existingTiers[].emailstringpeut être nullCourriel principal.
existingTiers[].phonestringpeut être nullTéléphone principal.
existingTiers[].citystringpeut être nullCode postal et localité.

Annotations MCP

AnnotationValeurSignification
titleVérifier un numéro de TVANom lisible affiché par le client MCP.
readOnlyHintnonL'outil ne modifie rien.
destructiveHintnonL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintouiRappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire.
openWorldHintouiL'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur.

Définition JSON

Entrée exacte de tools/list
{
  "name": "check_vat",
  "title": "Vérifier un numéro de TVA",
  "description": "Vérifie un numéro de TVA européen auprès de VIES (service de la Commission européenne), comme le formulaire de tiers de l'application : renvoie le nom et l'adresse enregistrés pour ce numéro, et les tiers d'Oxygenius qui l'ont déjà. L'application note la date de vérification sur ces tiers. Un numéro invalide est renvoyé comme une erreur.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "vatNumber": {
        "description": "Numéro de TVA précédé du code pays, ex. BE0123456789 (espaces et points acceptés).",
        "type": "string"
      }
    },
    "required": [
      "vatNumber"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "valid": {
        "description": "Vrai si VIES reconnaît le numéro (un numéro invalide est une erreur).",
        "type": "boolean"
      },
      "vatNumber": {
        "description": "Numéro vérifié, précédé du code pays.",
        "type": "string"
      },
      "name": {
        "description": "Nom enregistré pour ce numéro, tel que le donne VIES.",
        "type": [
          "string",
          "null"
        ]
      },
      "address": {
        "description": "Adresse enregistrée pour ce numéro, telle que la donne VIES (une seule chaîne).",
        "type": [
          "string",
          "null"
        ]
      },
      "checkedOn": {
        "description": "Date de la vérification (AAAA-MM-JJ).",
        "type": [
          "string",
          "null"
        ],
        "format": "date"
      },
      "existingTiers": {
        "description": "Tiers déjà enregistrés avec ce numéro de TVA : vérifier s'il ne s'agit pas du tiers recherché avant d'en créer un.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant technique du tiers (à passer à get_tiers).",
              "type": "integer"
            },
            "reference": {
              "description": "Référence du tiers.",
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "description": "Dénomination : société, sinon nom et prénom.",
              "type": "string"
            },
            "kind": {
              "description": "company (société renseignée) ou individual (personne).",
              "type": "string"
            },
            "isSupplier": {
              "description": "Vrai pour un fournisseur.",
              "type": "boolean"
            },
            "isActive": {
              "description": "Faux si le tiers est en sommeil.",
              "type": "boolean"
            },
            "email": {
              "description": "Courriel principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "phone": {
              "description": "Téléphone principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "city": {
              "description": "Code postal et localité.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "kind",
            "isSupplier",
            "isActive"
          ]
        }
      }
    },
    "required": [
      "valid",
      "vatNumber"
    ]
  },
  "annotations": {
    "title": "Vérifier un numéro de TVA",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": false
  }
}