Imprimer un devis
Nom de l'outil
print_estimateÉcriture
Description
Génère le PDF d'un devis, comme le bouton « Imprimer » de l'application, et le classe dans les documents du dossier. Effets à annoncer avant l'appel : un devis à éditer passe au statut imprimé, et les automatisations des étapes du dossier se déclenchent (étape de création du devis). Rien n'est envoyé au client. Attendre l'accord de l'utilisateur. Renvoie le devis et le document PDF (get_document_download_link pour le télécharger).
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). |
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 |
|---|---|---|---|
estimate | object | Le devis, au statut imprimé s'il était à éditer. | |
estimate.customerVatNumber | string | peut être null | Numéro de TVA du client imprimé sur le devis. |
estimate.customerAddress | string | peut être null | Adresse du client imprimée sur le devis. |
estimate.dossierIndication | string | peut être null | Intitulé court du dossier. |
estimate.discountPercentage | number | peut être null | Remise globale en pourcents. |
estimate.discountAmount | number | peut être null | Montant de la remise globale (hors TVA). |
estimate.remark | string | peut être null | Remarque imprimée sur le devis. |
estimate.vatBreakdown | object[] | Montant de TVA par taux. | |
estimate.vatBreakdown[].rate | string | peut être null | Code du taux de TVA (ex. 21, 6, CO pour cocontractant). |
estimate.vatBreakdown[].percentage | number | peut être null | Pourcentage de TVA. |
estimate.vatBreakdown[].amount | number | peut être null | Montant de TVA à ce taux. |
estimate.lines | object | Lignes du devis. | |
estimate.lines.totalCount | integer | Nombre total de lignes du document. | |
estimate.lines.isTruncated | boolean | Vrai si le document compte plus de lignes que celles renvoyées. | |
estimate.lines.items | object[] | Lignes dans l'ordre du document. | |
estimate.lines.items[].id | integer | Identifiant de la ligne (lineId ou parentLineId des outils de modification d'un devis). | |
estimate.lines.items[].number | string | peut être null | Numéro de la ligne tel qu'imprimé (ex. 1.2). |
estimate.lines.items[].type | string | supertitle, title, subtitle, item (article) ou other. | |
estimate.lines.items[].isOption | boolean | Vrai pour une ligne en option (variante), non comprise dans les totaux. | |
estimate.lines.items[].name | string | peut être null | Libellé de la ligne. |
estimate.lines.items[].description | string | peut être null | Description détaillée. |
estimate.lines.items[].quantity | number | peut être null | Quantité (articles). |
estimate.lines.items[].unit | string | peut être null | Unité (articles). |
estimate.lines.items[].unitPrice | number | peut être null | Prix unitaire hors TVA (articles). |
estimate.lines.items[].vatRate | number | peut être null | Taux de TVA en pourcents (articles). |
estimate.lines.items[].discountAmount | number | peut être null | Remise accordée sur la ligne (articles). |
estimate.lines.items[].amountExcludingVat | number | peut être null | Montant hors TVA, net de la remise de la ligne (articles). |
estimate.lines.items[].remark | string | peut être null | Remarque imprimée sous la ligne (devis). |
estimate.lines.items[].depositInvoiceId | integer | peut être null | Facture d'acompte déduite par cette ligne (à passer à get_invoice). |
estimate.amendments | object[] | Avenants de ce devis. | |
estimate.amendments[].id | integer | Identifiant du document lié. | |
estimate.amendments[].reference | string | peut être null | Numéro du document lié. |
estimate.amendments[].type | string | peut être null | Type de facture (acompte, finale, avancement…). |
estimate.amendments[].status | string | peut être null | Statut du document lié. |
estimate.amendments[].date | string (date) | peut être null | Date du document lié. |
estimate.amendments[].amountIncludingVat | number | peut être null | Total TVA comprise. |
estimate.invoices | object[] | Factures émises pour ce devis et ses avenants (vide sans accès aux factures). | |
estimate.creditNotes | object[] | Notes de crédit liées à ce devis (vide sans accès aux notes de crédit). | |
estimate.billingBalance | object | peut être null | Avancement de la facturation d'un devis accepté (absent sinon, ou sans accès aux factures). |
estimate.billingBalance.acceptedAmountExcludingVat | number | peut être null | Montant accepté : devis principal et avenants acceptés, hors TVA. |
estimate.billingBalance.invoicedAmountExcludingVat | number | peut être null | Montant déjà facturé (factures non annulées), hors TVA. |
estimate.billingBalance.creditedAmountExcludingVat | number | peut être null | Montant des notes de crédit, hors TVA. |
estimate.billingBalance.remainingAmountExcludingVat | number | peut être null | Reste à facturer, hors TVA. |
estimate.title | string | peut être null | Intitulé du devis. |
estimate.type | string | peut être null | Type : devis ou contrat. |
estimate.validUntil | string (date) | peut être null | Date de fin de validité de l'offre. |
estimate.isAmendment | boolean | Vrai pour un avenant (travaux complémentaires d'un devis). | |
estimate.parentEstimateId | integer | peut être null | Pour un avenant : identifiant du devis principal. |
estimate.id | integer | Identifiant du document (à passer à l'outil de détail). | |
estimate.reference | string | peut être null | Numéro du document (vide pour un brouillon de facture ou de note de crédit). |
estimate.status | string | peut être null | Statut du document. |
estimate.date | string (date) | peut être null | Date du document. |
estimate.customer | string | peut être null | Client tel qu'imprimé sur le document. |
estimate.tiersId | integer | Identifiant du tiers client (à passer à get_tiers). | |
estimate.dossierId | integer | Identifiant du dossier (à passer à get_dossier). | |
estimate.dossierReference | string | peut être null | Référence du dossier. |
estimate.amountExcludingVat | number | peut être null | Total hors TVA, net de la remise globale. |
estimate.vatAmount | number | peut être null | Montant de TVA. |
estimate.amountIncludingVat | number | peut être null | Total TVA comprise. |
documentId | integer | peut être null | Document PDF du devis, classé dans le dossier (à passer à get_document_download_link). |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Imprimer un devis | 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": "print_estimate",
"title": "Imprimer un devis",
"description": "Génère le PDF d'un devis, comme le bouton « Imprimer » de l'application, et le classe dans les documents du dossier. Effets à annoncer avant l'appel : un devis à éditer passe au statut imprimé, et les automatisations des étapes du dossier se déclenchent (étape de création du devis). Rien n'est envoyé au client. Attendre l'accord de l'utilisateur. Renvoie le devis et le document PDF (get_document_download_link pour le télécharger).",
"inputSchema": {
"type": "object",
"properties": {
"estimateId": {
"description": "Devis (champ id de search_estimates).",
"type": "integer"
}
},
"required": [
"estimateId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"estimate": {
"description": "Le devis, au statut imprimé s'il était à éditer.",
"type": "object",
"properties": {
"customerVatNumber": {
"description": "Numéro de TVA du client imprimé sur le devis.",
"type": [
"string",
"null"
]
},
"customerAddress": {
"description": "Adresse du client imprimée sur le devis.",
"type": [
"string",
"null"
]
},
"dossierIndication": {
"description": "Intitulé court du dossier.",
"type": [
"string",
"null"
]
},
"discountPercentage": {
"description": "Remise globale en pourcents.",
"type": [
"number",
"null"
]
},
"discountAmount": {
"description": "Montant de la remise globale (hors TVA).",
"type": [
"number",
"null"
]
},
"remark": {
"description": "Remarque imprimée sur le devis.",
"type": [
"string",
"null"
]
},
"vatBreakdown": {
"description": "Montant de TVA par taux.",
"type": "array",
"items": {
"type": "object",
"properties": {
"rate": {
"description": "Code du taux de TVA (ex. 21, 6, CO pour cocontractant).",
"type": [
"string",
"null"
]
},
"percentage": {
"description": "Pourcentage de TVA.",
"type": [
"number",
"null"
]
},
"amount": {
"description": "Montant de TVA à ce taux.",
"type": [
"number",
"null"
]
}
}
}
},
"lines": {
"description": "Lignes du devis.",
"type": "object",
"properties": {
"totalCount": {
"description": "Nombre total de lignes du document.",
"type": "integer"
},
"isTruncated": {
"description": "Vrai si le document compte plus de lignes que celles renvoyées.",
"type": "boolean"
},
"items": {
"description": "Lignes dans l'ordre du document.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant de la ligne (lineId ou parentLineId des outils de modification d'un devis).",
"type": "integer"
},
"number": {
"description": "Numéro de la ligne tel qu'imprimé (ex. 1.2).",
"type": [
"string",
"null"
]
},
"type": {
"description": "supertitle, title, subtitle, item (article) ou other.",
"type": "string"
},
"isOption": {
"description": "Vrai pour une ligne en option (variante), non comprise dans les totaux.",
"type": "boolean"
},
"name": {
"description": "Libellé de la ligne.",
"type": [
"string",
"null"
]
},
"description": {
"description": "Description détaillée.",
"type": [
"string",
"null"
]
},
"quantity": {
"description": "Quantité (articles).",
"type": [
"number",
"null"
]
},
"unit": {
"description": "Unité (articles).",
"type": [
"string",
"null"
]
},
"unitPrice": {
"description": "Prix unitaire hors TVA (articles).",
"type": [
"number",
"null"
]
},
"vatRate": {
"description": "Taux de TVA en pourcents (articles).",
"type": [
"number",
"null"
]
},
"discountAmount": {
"description": "Remise accordée sur la ligne (articles).",
"type": [
"number",
"null"
]
},
"amountExcludingVat": {
"description": "Montant hors TVA, net de la remise de la ligne (articles).",
"type": [
"number",
"null"
]
},
"remark": {
"description": "Remarque imprimée sous la ligne (devis).",
"type": [
"string",
"null"
]
},
"depositInvoiceId": {
"description": "Facture d'acompte déduite par cette ligne (à passer à get_invoice).",
"type": [
"integer",
"null"
]
}
},
"required": [
"type"
]
}
}
},
"required": [
"totalCount",
"isTruncated",
"items"
]
},
"amendments": {
"description": "Avenants de ce devis.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant du document lié.",
"type": "integer"
},
"reference": {
"description": "Numéro du document lié.",
"type": [
"string",
"null"
]
},
"type": {
"description": "Type de facture (acompte, finale, avancement…).",
"type": [
"string",
"null"
]
},
"status": {
"description": "Statut du document lié.",
"type": [
"string",
"null"
]
},
"date": {
"description": "Date du document lié.",
"type": [
"string",
"null"
],
"format": "date"
},
"amountIncludingVat": {
"description": "Total TVA comprise.",
"type": [
"number",
"null"
]
}
},
"required": [
"id"
]
}
},
"invoices": {
"description": "Factures émises pour ce devis et ses avenants (vide sans accès aux factures).",
"type": "array",
"items": {
"$ref": "#/properties/estimate/properties/amendments/items"
}
},
"creditNotes": {
"description": "Notes de crédit liées à ce devis (vide sans accès aux notes de crédit).",
"type": "array",
"items": {
"$ref": "#/properties/estimate/properties/amendments/items"
}
},
"billingBalance": {
"description": "Avancement de la facturation d'un devis accepté (absent sinon, ou sans accès aux factures).",
"type": [
"object",
"null"
],
"properties": {
"acceptedAmountExcludingVat": {
"description": "Montant accepté : devis principal et avenants acceptés, hors TVA.",
"type": [
"number",
"null"
]
},
"invoicedAmountExcludingVat": {
"description": "Montant déjà facturé (factures non annulées), hors TVA.",
"type": [
"number",
"null"
]
},
"creditedAmountExcludingVat": {
"description": "Montant des notes de crédit, hors TVA.",
"type": [
"number",
"null"
]
},
"remainingAmountExcludingVat": {
"description": "Reste à facturer, hors TVA.",
"type": [
"number",
"null"
]
}
}
},
"title": {
"description": "Intitulé du devis.",
"type": [
"string",
"null"
]
},
"type": {
"description": "Type : devis ou contrat.",
"type": [
"string",
"null"
]
},
"validUntil": {
"description": "Date de fin de validité de l'offre.",
"type": [
"string",
"null"
],
"format": "date"
},
"isAmendment": {
"description": "Vrai pour un avenant (travaux complémentaires d'un devis).",
"type": "boolean"
},
"parentEstimateId": {
"description": "Pour un avenant : identifiant du devis principal.",
"type": [
"integer",
"null"
]
},
"id": {
"description": "Identifiant du document (à passer à l'outil de détail).",
"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 du document.",
"type": [
"string",
"null"
]
},
"date": {
"description": "Date du document.",
"type": [
"string",
"null"
],
"format": "date"
},
"customer": {
"description": "Client tel qu'imprimé sur le document.",
"type": [
"string",
"null"
]
},
"tiersId": {
"description": "Identifiant du tiers client (à passer à get_tiers).",
"type": "integer"
},
"dossierId": {
"description": "Identifiant du dossier (à passer à get_dossier).",
"type": "integer"
},
"dossierReference": {
"description": "Référence du dossier.",
"type": [
"string",
"null"
]
},
"amountExcludingVat": {
"description": "Total hors TVA, net de la remise globale.",
"type": [
"number",
"null"
]
},
"vatAmount": {
"description": "Montant de TVA.",
"type": [
"number",
"null"
]
},
"amountIncludingVat": {
"description": "Total TVA comprise.",
"type": [
"number",
"null"
]
}
},
"required": [
"lines",
"id",
"tiersId",
"dossierId"
]
},
"documentId": {
"description": "Document PDF du devis, classé dans le dossier (à passer à get_document_download_link).",
"type": [
"integer",
"null"
]
}
},
"required": [
"estimate"
]
},
"annotations": {
"title": "Imprimer un devis",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}