Vérifier un numéro de TVA
Nom de l'outil
check_vatÉcritureIdempotentMonde ouvert
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.
Accès requis
- Au moins une de ces permissions :
tiers.new-tiers.createoutiers.tiers.edit - Société ouverte aux outils d'écriture (Paramètres → Intégration IA).
- Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
vatNumber | string | obligatoire | Numé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
| Nom | Type | Présence | Description |
|---|---|---|---|
valid | boolean | Vrai si VIES reconnaît le numéro (un numéro invalide est une erreur). | |
vatNumber | string | Numéro vérifié, précédé du code pays. | |
name | string | peut être null | Nom enregistré pour ce numéro, tel que le donne VIES. |
address | string | peut être null | Adresse enregistrée pour ce numéro, telle que la donne VIES (une seule chaîne). |
checkedOn | string (date) | peut être null | Date de la vérification (AAAA-MM-JJ). |
existingTiers | object[] | 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[].id | integer | Identifiant technique du tiers (à passer à get_tiers). | |
existingTiers[].reference | string | peut être null | Référence du tiers. |
existingTiers[].name | string | Dénomination : société, sinon nom et prénom. | |
existingTiers[].kind | string | company (société renseignée) ou individual (personne). | |
existingTiers[].isSupplier | boolean | Vrai pour un fournisseur. | |
existingTiers[].isActive | boolean | Faux si le tiers est en sommeil. | |
existingTiers[].email | string | peut être null | Courriel principal. |
existingTiers[].phone | string | peut être null | Téléphone principal. |
existingTiers[].city | string | peut être null | Code postal et localité. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Vérifier un numéro de TVA | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | oui | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | oui | L'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
}
}