Créer un devis
Nom de l'outil
create_estimateÉcriture
Description
Crée un devis vide, à éditer, pour un dossier : client et adresse de facturation sont ceux du tiers facturé du dossier, qui doit avoir une adresse complète. Ajouter ensuite les lignes avec add_estimate_lines. 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 nouveau devis. Renvoie le devis créé.
Accès requis
- Permission :
dossier-detail.estimate.create - En plus :
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 |
|---|---|---|---|
dossierId | integer | obligatoire | Dossier (champ id de search_dossiers). |
name | string | facultatif | Nom du devis (ex. Rénovation de la toiture), précédé du préfixe éventuel de la société. |
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 |
|---|---|---|---|
customerVatNumber | string | peut être null | Numéro de TVA du client imprimé sur le devis. |
customerAddress | string | peut être null | Adresse du client imprimée sur le devis. |
dossierIndication | string | peut être null | Intitulé court du dossier. |
discountPercentage | number | peut être null | Remise globale en pourcents. |
discountAmount | number | peut être null | Montant de la remise globale (hors TVA). |
remark | string | peut être null | Remarque imprimée sur le devis. |
vatBreakdown | object[] | Montant de TVA par taux. | |
vatBreakdown[].rate | string | peut être null | Code du taux de TVA (ex. 21, 6, CO pour cocontractant). |
vatBreakdown[].percentage | number | peut être null | Pourcentage de TVA. |
vatBreakdown[].amount | number | peut être null | Montant de TVA à ce taux. |
lines | object | Lignes du devis. | |
lines.totalCount | integer | Nombre total de lignes du document. | |
lines.isTruncated | boolean | Vrai si le document compte plus de lignes que celles renvoyées. | |
lines.items | object[] | Lignes dans l'ordre du document. | |
lines.items[].id | integer | Identifiant de la ligne (lineId ou parentLineId des outils de modification d'un devis). | |
lines.items[].number | string | peut être null | Numéro de la ligne tel qu'imprimé (ex. 1.2). |
lines.items[].type | string | supertitle, title, subtitle, item (article) ou other. | |
lines.items[].isOption | boolean | Vrai pour une ligne en option (variante), non comprise dans les totaux. | |
lines.items[].name | string | peut être null | Libellé de la ligne. |
lines.items[].description | string | peut être null | Description détaillée. |
lines.items[].quantity | number | peut être null | Quantité (articles). |
lines.items[].unit | string | peut être null | Unité (articles). |
lines.items[].unitPrice | number | peut être null | Prix unitaire hors TVA (articles). |
lines.items[].vatRate | number | peut être null | Taux de TVA en pourcents (articles). |
lines.items[].discountAmount | number | peut être null | Remise accordée sur la ligne (articles). |
lines.items[].amountExcludingVat | number | peut être null | Montant hors TVA, net de la remise de la ligne (articles). |
lines.items[].remark | string | peut être null | Remarque imprimée sous la ligne (devis). |
lines.items[].depositInvoiceId | integer | peut être null | Facture d'acompte déduite par cette ligne (à passer à get_invoice). |
amendments | object[] | Avenants de ce devis. | |
amendments[].id | integer | Identifiant du document lié. | |
amendments[].reference | string | peut être null | Numéro du document lié. |
amendments[].type | string | peut être null | Type de facture (acompte, finale, avancement…). |
amendments[].status | string | peut être null | Statut du document lié. |
amendments[].date | string (date) | peut être null | Date du document lié. |
amendments[].amountIncludingVat | number | peut être null | Total TVA comprise. |
invoices | object[] | Factures émises pour ce devis et ses avenants (vide sans accès aux factures). | |
creditNotes | object[] | Notes de crédit liées à ce devis (vide sans accès aux notes de crédit). | |
billingBalance | object | peut être null | Avancement de la facturation d'un devis accepté (absent sinon, ou sans accès aux factures). |
billingBalance.acceptedAmountExcludingVat | number | peut être null | Montant accepté : devis principal et avenants acceptés, hors TVA. |
billingBalance.invoicedAmountExcludingVat | number | peut être null | Montant déjà facturé (factures non annulées), hors TVA. |
billingBalance.creditedAmountExcludingVat | number | peut être null | Montant des notes de crédit, hors TVA. |
billingBalance.remainingAmountExcludingVat | number | peut être null | Reste à facturer, hors TVA. |
title | string | peut être null | Intitulé du devis. |
type | string | peut être null | Type : devis ou contrat. |
validUntil | string (date) | peut être null | Date de fin de validité de l'offre. |
isAmendment | boolean | Vrai pour un avenant (travaux complémentaires d'un devis). | |
parentEstimateId | integer | peut être null | Pour un avenant : identifiant du devis principal. |
id | integer | Identifiant du document (à passer à l'outil de détail). | |
reference | string | peut être null | Numéro du document (vide pour un brouillon de facture ou de note de crédit). |
status | string | peut être null | Statut du document. |
date | string (date) | peut être null | Date du document. |
customer | string | peut être null | Client tel qu'imprimé sur le document. |
tiersId | integer | Identifiant du tiers client (à passer à get_tiers). | |
dossierId | integer | Identifiant du dossier (à passer à get_dossier). | |
dossierReference | string | peut être null | Référence du dossier. |
amountExcludingVat | number | peut être null | Total hors TVA, net de la remise globale. |
vatAmount | number | peut être null | Montant de TVA. |
amountIncludingVat | number | peut être null | Total TVA comprise. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Créer 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": "create_estimate",
"title": "Créer un devis",
"description": "Crée un devis vide, à éditer, pour un dossier : client et adresse de facturation sont ceux du tiers facturé du dossier, qui doit avoir une adresse complète. Ajouter ensuite les lignes avec add_estimate_lines. 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 nouveau devis. Renvoie le devis créé.",
"inputSchema": {
"type": "object",
"properties": {
"dossierId": {
"description": "Dossier (champ id de search_dossiers).",
"type": "integer"
},
"name": {
"description": "Nom du devis (ex. Rénovation de la toiture), précédé du préfixe éventuel de la société.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"dossierId"
]
},
"outputSchema": {
"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/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/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"
]
},
"annotations": {
"title": "Créer un devis",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}