Vérifier un numéro de TVA
check_vatChecks a European VAT number with the European Commission's VIES service and returns the registered name and address, and the third parties that already use it.
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.
Required access
- At least one of these permissions:
tiers.new-tiers.createortiers.tiers.edit - Company that has enabled write tools (Settings → AI integration).
- Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
vatNumber | string | required | Numéro de TVA précédé du code pays, ex. BE0123456789 (espaces et points acceptés). |
Result
The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.
Result fields
| Name | Type | Presence | 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 | nullable | Nom enregistré pour ce numéro, tel que le donne VIES. |
address | string | nullable | Adresse enregistrée pour ce numéro, telle que la donne VIES (une seule chaîne). |
checkedOn | string (date) | nullable | 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 | nullable | 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 | nullable | Courriel principal. |
existingTiers[].phone | string | nullable | Téléphone principal. |
existingTiers[].city | string | nullable | Code postal et localité. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Vérifier un numéro de TVA | Human-readable name shown by the MCP client. |
readOnlyHint | no | The tool changes nothing. |
destructiveHint | no | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | yes | Calling it again with the same arguments has no further effect. |
openWorldHint | yes | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"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
}
}