Préparer l'envoi d'un document par courriel
create_document_emailDescription
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.
Accès requis
- Au moins une de ces permissions :
mail-inbox.list.viewoumail-outbox.list.viewoumail-sendbox.list.viewoumail-trashbox.list.viewouall-mail.list.viewoudossier-detail.tab.mailbox - 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 |
|---|---|---|---|
kind | string | obligatoire | estimate (devis), invoice (facture) ou credit_note (note de crédit). |
documentId | integer | obligatoire | Document (champ id de search_estimates, search_invoices ou search_credit_notes). |
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 |
|---|---|---|---|
id | integer | Identifiant du brouillon (emailId des autres outils). | |
from | string | peut être null | Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société. |
to | string | peut être null | Destinataires. |
cc | string | peut être null | Destinataires en copie. |
bcc | string | peut être null | Destinataires en copie cachée. |
subject | string | peut être null | Objet. |
type | string | peut être null | Type de courriel (obligatoire pour l'envoi). |
dossierId | integer | peut être null | Dossier lié. |
body | string | peut être null | Corps du courriel en texte (signature et message cité compris), tronqué s'il est long. |
attachments | object[] | Pièces jointes. | |
attachments[].documentId | integer | Identifiant du document (à passer à read_document ou get_document_download_link). | |
attachments[].name | string | peut être null | Nom du fichier. |
attachments[].contentType | string | peut être null | Type MIME. |
attachments[].sizeBytes | integer | Taille en octets. | |
attachments[].isInline | boolean | Vrai pour une image intégrée au corps (logo, signature). | |
sendsDocument | string | peut être null | 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. |
availableTypes | string[] | Types de courriel proposés (paramètre type), hors commandes fournisseur. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Préparer l'envoi d'un document par courriel | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | non | 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": "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
}
}