Accepter un devis

Tool nameaccept_estimate
WriteDestructiveRequires a confirmation token

Records the customer's acceptance prepared by prepare_estimate_decision; project automations (steps, tasks, work sheet) run.

Description

Exact text sent to the model by tools/list (French, the language of the data):

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.

Required access

Parameters

NameTypePresenceDescription
estimateIdintegerrequiredDevis (champ id de search_estimates).
confirmationTokenstringrequiredJeton renvoyé par prepare_estimate_decision pour ce devis.

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
NameTypePresenceDescription
documentobjectLe document après l'action, relu.
document.kindstringestimate (devis), invoice (facture) ou credit_note (note de crédit).
document.idintegerIdentifiant du document.
document.referencestringnullableNuméro du document (vide pour un brouillon de facture ou de note de crédit).
document.statusstringnullableStatut actuel.
document.datestring (date)nullableDate du document.
document.customerstringnullableClient facturé.
document.dossierIdintegernullableDossier du document.
document.amountExcludingVatnumbernullableTotal hors TVA, en euros.
document.amountIncludingVatnumbernullableTotal TVA comprise, en euros.
pdfDocumentIdintegernullableDocument PDF du document de facturation, quand il en a un (get_document_download_link pour le télécharger).
messagestringCe qui a été fait, et ce qui se passe ensuite.

MCP annotations

AnnotationValueMeaning
titleAccepter un devisHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintyesThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling it again with the same arguments has no further effect.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "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
  }
}