Préparer l'envoi d'un document par courriel

Tool namecreate_document_email
Write

Creates the draft that sends a printed estimate or a numbered invoice or credit note to its customer, with the PDF attached. Nothing is sent.

Description

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

Crée le brouillon qui envoie un devis, une facture ou une note de crédit à son client, comme le bouton « Envoyer » du document : destinataire du client (ou contact du dossier), objet, texte de la société, PDF joint (et fichier UBL, conditions générales). Seulement un document fini : devis imprimé (print_estimate), facture ou note de crédit numérotée (finalize_invoice, finalize_credit_note), non annulés ; jamais par le portail. Le brouillon se relit et s'ajuste avec update_email_draft, puis s'envoie avec prepare_email_send et send_email ; à l'envoi, le document passe au statut Envoyé si c'est une facture ou une note de crédit (sauf facture déjà payée ; un devis garde le sien). Aucun envoi Peppol n'est fait. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Ne pas rappeler l'outil après un succès : chaque appel crée un brouillon. Renvoie le brouillon.

Required access

Parameters

NameTypePresenceDescription
kindstringrequiredestimate (devis), invoice (facture) ou credit_note (note de crédit).
documentIdintegerrequiredDocument (champ id de search_estimates, search_invoices ou search_credit_notes).

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
idintegerIdentifiant du brouillon (emailId des autres outils).
fromstringnullableBoîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.
tostringnullableDestinataires.
ccstringnullableDestinataires en copie.
bccstringnullableDestinataires en copie cachée.
subjectstringnullableObjet.
typestringnullableType de courriel (obligatoire pour l'envoi).
dossierIdintegernullableDossier lié.
bodystringnullableCorps du courriel en texte (signature et message cité compris), tronqué s'il est long.
attachmentsobject[]Pièces jointes.
attachments[].documentIdintegerIdentifiant du document (à passer à read_document ou get_document_download_link).
attachments[].namestringnullableNom du fichier.
attachments[].contentTypestringnullableType MIME.
attachments[].sizeBytesintegerTaille en octets.
attachments[].isInlinebooleanVrai pour une image intégrée au corps (logo, signature).
sendsDocumentstringnullableDevis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide.
availableTypesstring[]Types de courriel proposés (paramètre type), hors commandes fournisseur.

MCP annotations

AnnotationValueMeaning
titlePréparer l'envoi d'un document par courrielHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintnoThe 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": "create_document_email",
  "title": "Préparer l'envoi d'un document par courriel",
  "description": "Crée le brouillon qui envoie un devis, une facture ou une note de crédit à son client, comme le bouton « Envoyer » du document : destinataire du client (ou contact du dossier), objet, texte de la société, PDF joint (et fichier UBL, conditions générales). Seulement un document fini : devis imprimé (print_estimate), facture ou note de crédit numérotée (finalize_invoice, finalize_credit_note), non annulés ; jamais par le portail. Le brouillon se relit et s'ajuste avec update_email_draft, puis s'envoie avec prepare_email_send et send_email ; à l'envoi, le document passe au statut Envoyé si c'est une facture ou une note de crédit (sauf facture déjà payée ; un devis garde le sien). Aucun envoi Peppol n'est fait. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Ne pas rappeler l'outil après un succès : chaque appel crée un brouillon. Renvoie le brouillon.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "kind": {
        "description": "estimate (devis), invoice (facture) ou credit_note (note de crédit).",
        "type": "string"
      },
      "documentId": {
        "description": "Document (champ id de search_estimates, search_invoices ou search_credit_notes).",
        "type": "integer"
      }
    },
    "required": [
      "kind",
      "documentId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "description": "Identifiant du brouillon (emailId des autres outils).",
        "type": "integer"
      },
      "from": {
        "description": "Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.",
        "type": [
          "string",
          "null"
        ]
      },
      "to": {
        "description": "Destinataires.",
        "type": [
          "string",
          "null"
        ]
      },
      "cc": {
        "description": "Destinataires en copie.",
        "type": [
          "string",
          "null"
        ]
      },
      "bcc": {
        "description": "Destinataires en copie cachée.",
        "type": [
          "string",
          "null"
        ]
      },
      "subject": {
        "description": "Objet.",
        "type": [
          "string",
          "null"
        ]
      },
      "type": {
        "description": "Type de courriel (obligatoire pour l'envoi).",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierId": {
        "description": "Dossier lié.",
        "type": [
          "integer",
          "null"
        ]
      },
      "body": {
        "description": "Corps du courriel en texte (signature et message cité compris), tronqué s'il est long.",
        "type": [
          "string",
          "null"
        ]
      },
      "attachments": {
        "description": "Pièces jointes.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "documentId": {
              "description": "Identifiant du document (à passer à read_document ou get_document_download_link).",
              "type": "integer"
            },
            "name": {
              "description": "Nom du fichier.",
              "type": [
                "string",
                "null"
              ]
            },
            "contentType": {
              "description": "Type MIME.",
              "type": [
                "string",
                "null"
              ]
            },
            "sizeBytes": {
              "description": "Taille en octets.",
              "type": "integer"
            },
            "isInline": {
              "description": "Vrai pour une image intégrée au corps (logo, signature).",
              "type": "boolean"
            }
          },
          "required": [
            "documentId",
            "sizeBytes",
            "isInline"
          ]
        }
      },
      "sendsDocument": {
        "description": "Devis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide.",
        "type": [
          "string",
          "null"
        ]
      },
      "availableTypes": {
        "description": "Types de courriel proposés (paramètre type), hors commandes fournisseur.",
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "id"
    ]
  },
  "annotations": {
    "title": "Préparer l'envoi d'un document par courriel",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}