Détail d'un tiers
Tool name
get_tiersRead-onlyIdempotent
Returns a third party's contact details, address, VAT and company numbers, VAT regime, payment term and recent projects. Bank details are never returned.
Description
Renvoie le détail d'un tiers Oxygenius : coordonnées, adresse, TVA, numéro d'entreprise, régime de TVA, condition de paiement et dossiers récents où il intervient. Les données bancaires ne sont pas renvoyées.
Required access
- Permission:
tiers.list.view - Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
tiersId | integer | required | Identifiant technique du tiers (champ id de search_tiers). |
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 |
|---|---|---|---|
id | integer | Identifiant technique du tiers. | |
reference | string | nullable | Référence du tiers. |
name | string | Dénomination : société, sinon nom et prénom. | |
companyName | string | nullable | Raison sociale. |
lastName | string | nullable | Nom de la personne. |
firstName | string | nullable | Prénom de la personne. |
kind | string | company ou individual. | |
isSupplier | boolean | Vrai pour un fournisseur. | |
isActive | boolean | Faux si le tiers est en sommeil. | |
isDefaultContact | boolean | Vrai si le tiers est un contact par défaut. | |
email | string | nullable | Courriel principal. |
billingEmail | string | nullable | Courriel de facturation. |
phone1 | string | nullable | Téléphone principal. |
phone2 | string | nullable | Second téléphone. |
website | string | nullable | Site web. |
address | string | nullable | Adresse postale. |
vatNumber | string | nullable | Numéro de TVA, précédé du code pays. |
companyNumber | string | nullable | Numéro d'entreprise (BCE). |
vatRegime | string | nullable | Régime de TVA appliqué au tiers. |
paymentTerm | string | nullable | Condition de paiement. |
peppolIds | string[] | Identifiants Peppol (facturation électronique). | |
dossierCount | integer | nullable | Nombre de dossiers visibles où le tiers intervient (null sans accès aux dossiers). |
recentDossiers | object[] | Dossiers les plus récents où le tiers intervient, avec son rôle (vide sans accès aux dossiers). | |
recentDossiers[].dossierId | integer | Identifiant technique du dossier (à passer à get_dossier). | |
recentDossiers[].reference | string | nullable | Référence du dossier. |
recentDossiers[].indication | string | nullable | Intitulé court du dossier. |
recentDossiers[].role | string | nullable | Rôle du tiers dans le dossier (propriétaire, locataire, contact…). |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Détail d'un tiers | Human-readable name shown by the MCP client. |
readOnlyHint | yes | 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 | no | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"name": "get_tiers",
"title": "Détail d'un tiers",
"description": "Renvoie le détail d'un tiers Oxygenius : coordonnées, adresse, TVA, numéro d'entreprise, régime de TVA, condition de paiement et dossiers récents où il intervient. Les données bancaires ne sont pas renvoyées.",
"inputSchema": {
"type": "object",
"properties": {
"tiersId": {
"description": "Identifiant technique du tiers (champ id de search_tiers).",
"type": "integer"
}
},
"required": [
"tiersId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant technique du 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"
},
"companyName": {
"description": "Raison sociale.",
"type": [
"string",
"null"
]
},
"lastName": {
"description": "Nom de la personne.",
"type": [
"string",
"null"
]
},
"firstName": {
"description": "Prénom de la personne.",
"type": [
"string",
"null"
]
},
"kind": {
"description": "company ou individual.",
"type": "string"
},
"isSupplier": {
"description": "Vrai pour un fournisseur.",
"type": "boolean"
},
"isActive": {
"description": "Faux si le tiers est en sommeil.",
"type": "boolean"
},
"isDefaultContact": {
"description": "Vrai si le tiers est un contact par défaut.",
"type": "boolean"
},
"email": {
"description": "Courriel principal.",
"type": [
"string",
"null"
]
},
"billingEmail": {
"description": "Courriel de facturation.",
"type": [
"string",
"null"
]
},
"phone1": {
"description": "Téléphone principal.",
"type": [
"string",
"null"
]
},
"phone2": {
"description": "Second téléphone.",
"type": [
"string",
"null"
]
},
"website": {
"description": "Site web.",
"type": [
"string",
"null"
]
},
"address": {
"description": "Adresse postale.",
"type": [
"string",
"null"
]
},
"vatNumber": {
"description": "Numéro de TVA, précédé du code pays.",
"type": [
"string",
"null"
]
},
"companyNumber": {
"description": "Numéro d'entreprise (BCE).",
"type": [
"string",
"null"
]
},
"vatRegime": {
"description": "Régime de TVA appliqué au tiers.",
"type": [
"string",
"null"
]
},
"paymentTerm": {
"description": "Condition de paiement.",
"type": [
"string",
"null"
]
},
"peppolIds": {
"description": "Identifiants Peppol (facturation électronique).",
"type": "array",
"items": {
"type": "string"
}
},
"dossierCount": {
"description": "Nombre de dossiers visibles où le tiers intervient (null sans accès aux dossiers).",
"type": [
"integer",
"null"
]
},
"recentDossiers": {
"description": "Dossiers les plus récents où le tiers intervient, avec son rôle (vide sans accès aux dossiers).",
"type": "array",
"items": {
"type": "object",
"properties": {
"dossierId": {
"description": "Identifiant technique du dossier (à passer à get_dossier).",
"type": "integer"
},
"reference": {
"description": "Référence du dossier.",
"type": [
"string",
"null"
]
},
"indication": {
"description": "Intitulé court du dossier.",
"type": [
"string",
"null"
]
},
"role": {
"description": "Rôle du tiers dans le dossier (propriétaire, locataire, contact…).",
"type": [
"string",
"null"
]
}
},
"required": [
"dossierId"
]
}
}
},
"required": [
"id",
"name",
"kind",
"isSupplier",
"isActive",
"isDefaultContact"
]
},
"annotations": {
"title": "Détail d'un tiers",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}