Envoyer par Peppol
send_peppolDescription
Transmet au client par Peppol (ou Mercurius) une facture ou une note de crédit préparée par prepare_peppol_send : envoi officiel de la facture électronique, irréversible. Le nombre d'envois par jour est plafonné. 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. Renvoie le résultat de la transmission.
Accès requis
- Permission :
peppol.all.send - 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 | invoice (facture) ou credit_note (note de crédit). |
documentId | integer | obligatoire | Document (champ id de search_invoices ou search_credit_notes). |
confirmationToken | string | obligatoire | Jeton renvoyé par prepare_peppol_send pour ce document. |
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 | Envoyer par Peppol | 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 | oui | 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": "send_peppol",
"title": "Envoyer par Peppol",
"description": "Transmet au client par Peppol (ou Mercurius) une facture ou une note de crédit préparée par prepare_peppol_send : envoi officiel de la facture électronique, irréversible. Le nombre d'envois par jour est plafonné. 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. Renvoie le résultat de la transmission.",
"inputSchema": {
"type": "object",
"properties": {
"kind": {
"description": "invoice (facture) ou credit_note (note de crédit).",
"type": "string"
},
"documentId": {
"description": "Document (champ id de search_invoices ou search_credit_notes).",
"type": "integer"
},
"confirmationToken": {
"description": "Jeton renvoyé par prepare_peppol_send pour ce document.",
"type": "string"
}
},
"required": [
"kind",
"documentId",
"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": "Envoyer par Peppol",
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true,
"readOnlyHint": false
}
}