Accepter un devis
Nom de l'outil
accept_estimateÉcritureDestructifExige un jeton de confirmation
Description
Enregistre l'acceptation d'un devis par le client, préparée par prepare_estimate_decision (decision accept) : le devis passe au statut Accepté et les automatisations du dossier se déclenchent (étapes, tâches, fiche de travail). Exige le jeton de l'outil de préparation, après l'accord explicite de l'utilisateur sur ce qu'il a montré ; un jeton expiré, déjà utilisé ou d'un document modifié depuis est refusé. Ne jamais rappeler l'outil après un succès.
Accès requis
- Permission :
estimate.list.view - 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 |
|---|---|---|---|
estimateId | integer | obligatoire | Devis (champ id de search_estimates). |
confirmationToken | string | obligatoire | Jeton renvoyé par prepare_estimate_decision pour ce devis. |
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 |
|---|---|---|---|
document | object | Le document après l'action, relu. | |
document.kind | string | estimate (devis), invoice (facture) ou credit_note (note de crédit). | |
document.id | integer | Identifiant du document. | |
document.reference | string | peut être null | Numéro du document (vide pour un brouillon de facture ou de note de crédit). |
document.status | string | peut être null | Statut actuel. |
document.date | string (date) | peut être null | Date du document. |
document.customer | string | peut être null | Client facturé. |
document.dossierId | integer | peut être null | Dossier du document. |
document.amountExcludingVat | number | peut être null | Total hors TVA, en euros. |
document.amountIncludingVat | number | peut être null | Total TVA comprise, en euros. |
pdfDocumentId | integer | peut être null | Document PDF du document de facturation, quand il en a un (get_document_download_link pour le télécharger). |
message | string | Ce qui a été fait, et ce qui se passe ensuite. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Accepter un devis | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | oui | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | non | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | 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": "accept_estimate",
"title": "Accepter un devis",
"description": "Enregistre l'acceptation d'un devis par le client, préparée par prepare_estimate_decision (decision accept) : le devis passe au statut Accepté et les automatisations du dossier se déclenchent (étapes, tâches, fiche de travail). Exige le jeton de l'outil de préparation, après l'accord explicite de l'utilisateur sur ce qu'il a montré ; un jeton expiré, déjà utilisé ou d'un document modifié depuis est refusé. Ne jamais rappeler l'outil après un succès.",
"inputSchema": {
"type": "object",
"properties": {
"estimateId": {
"description": "Devis (champ id de search_estimates).",
"type": "integer"
},
"confirmationToken": {
"description": "Jeton renvoyé par prepare_estimate_decision pour ce devis.",
"type": "string"
}
},
"required": [
"estimateId",
"confirmationToken"
]
},
"outputSchema": {
"type": "object",
"properties": {
"document": {
"description": "Le document après l'action, relu.",
"type": "object",
"properties": {
"kind": {
"description": "estimate (devis), invoice (facture) ou credit_note (note de crédit).",
"type": "string"
},
"id": {
"description": "Identifiant du document.",
"type": "integer"
},
"reference": {
"description": "Numéro du document (vide pour un brouillon de facture ou de note de crédit).",
"type": [
"string",
"null"
]
},
"status": {
"description": "Statut actuel.",
"type": [
"string",
"null"
]
},
"date": {
"description": "Date du document.",
"type": [
"string",
"null"
],
"format": "date"
},
"customer": {
"description": "Client facturé.",
"type": [
"string",
"null"
]
},
"dossierId": {
"description": "Dossier du document.",
"type": [
"integer",
"null"
]
},
"amountExcludingVat": {
"description": "Total hors TVA, en euros.",
"type": [
"number",
"null"
]
},
"amountIncludingVat": {
"description": "Total TVA comprise, en euros.",
"type": [
"number",
"null"
]
}
},
"required": [
"kind",
"id"
]
},
"pdfDocumentId": {
"description": "Document PDF du document de facturation, quand il en a un (get_document_download_link pour le télécharger).",
"type": [
"integer",
"null"
]
},
"message": {
"description": "Ce qui a été fait, et ce qui se passe ensuite.",
"type": "string"
}
},
"required": [
"document",
"message"
]
},
"annotations": {
"title": "Accepter un devis",
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}