Modifier des lignes d'un devis
update_estimate_linesUpdates estimate lines (label, description, quantity, price, margin, discount, VAT, unit); Oxygenius recalculates all amounts.
Description
Modifie des lignes d'un devis (champ id des lignes de get_estimate) : libellé, description, quantité, prix imposé, marge, remise, TVA, unité. Seuls les champs fournis changent ; d'un titre ou d'un sous-titre, seuls le libellé et la description. Un libellé modifié ne change pas le prix. Les lignes d'option (variantes) se modifient dans l'application. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Oxygenius recalcule les prix, les sous-totaux, la TVA et les totaux comme l'écran du devis ; un devis accepté, refusé ou annulé, ou en attente de signature électronique, ne change plus (proposer create_estimate_version). Rien n'est envoyé au client. Renvoie le devis à jour.
Required access
- Permission:
estimate.list.view - Company that has enabled write tools (Settings → AI integration).
- Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
estimateId | integer | required | Devis (champ id de search_estimates). |
lines | object[] | required | Modifications, une par ligne, 50 au plus. |
lines[].lineId | integer | required | Identifiant de la ligne (champ id des lignes de get_estimate). |
lines[].name | string | optional | Nouveau libellé. |
lines[].description | string | optional | Nouvelle description ; chaîne vide pour l'effacer. |
lines[].quantity | number | optional | Nouvelle quantité ; celle d'un ouvrage multiplie les quantités de ses articles (un simple sous-titre n'a pas de quantité). |
lines[].unitPrice | number | optional | Prix unitaire hors TVA imposé : il remplace le prix calculé, sans marge. |
lines[].benefitPercentage | number | optional | Marge de la ligne en pourcents du prix de vente (0 à 99,99) ; le prix est recalculé. |
lines[].discountPercentage | number | optional | Remise de la ligne en pourcents (0 à 100). |
lines[].vatRate | number | optional | Taux de TVA en pourcents ; celui d'un ouvrage s'applique à ses articles. |
lines[].unit | string | optional | Unité, par son nom. |
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
| Name | Type | Presence | Description |
|---|---|---|---|
customerVatNumber | string | nullable | Numéro de TVA du client imprimé sur le devis. |
customerAddress | string | nullable | Adresse du client imprimée sur le devis. |
dossierIndication | string | nullable | Intitulé court du dossier. |
discountPercentage | number | nullable | Remise globale en pourcents. |
discountAmount | number | nullable | Montant de la remise globale (hors TVA). |
remark | string | nullable | Remarque imprimée sur le devis. |
vatBreakdown | object[] | Montant de TVA par taux. | |
vatBreakdown[].rate | string | nullable | Code du taux de TVA (ex. 21, 6, CO pour cocontractant). |
vatBreakdown[].percentage | number | nullable | Pourcentage de TVA. |
vatBreakdown[].amount | number | nullable | 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 | nullable | 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 | nullable | Libellé de la ligne. |
lines.items[].description | string | nullable | Description détaillée. |
lines.items[].quantity | number | nullable | Quantité (articles). |
lines.items[].unit | string | nullable | Unité (articles). |
lines.items[].unitPrice | number | nullable | Prix unitaire hors TVA (articles). |
lines.items[].vatRate | number | nullable | Taux de TVA en pourcents (articles). |
lines.items[].discountAmount | number | nullable | Remise accordée sur la ligne (articles). |
lines.items[].amountExcludingVat | number | nullable | Montant hors TVA, net de la remise de la ligne (articles). |
lines.items[].remark | string | nullable | Remarque imprimée sous la ligne (devis). |
lines.items[].depositInvoiceId | integer | nullable | 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 | nullable | Numéro du document lié. |
amendments[].type | string | nullable | Type de facture (acompte, finale, avancement…). |
amendments[].status | string | nullable | Statut du document lié. |
amendments[].date | string (date) | nullable | Date du document lié. |
amendments[].amountIncludingVat | number | nullable | 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 | nullable | Avancement de la facturation d'un devis accepté (absent sinon, ou sans accès aux factures). |
billingBalance.acceptedAmountExcludingVat | number | nullable | Montant accepté : devis principal et avenants acceptés, hors TVA. |
billingBalance.invoicedAmountExcludingVat | number | nullable | Montant déjà facturé (factures non annulées), hors TVA. |
billingBalance.creditedAmountExcludingVat | number | nullable | Montant des notes de crédit, hors TVA. |
billingBalance.remainingAmountExcludingVat | number | nullable | Reste à facturer, hors TVA. |
title | string | nullable | Intitulé du devis. |
type | string | nullable | Type : devis ou contrat. |
validUntil | string (date) | nullable | Date de fin de validité de l'offre. |
isAmendment | boolean | Vrai pour un avenant (travaux complémentaires d'un devis). | |
parentEstimateId | integer | nullable | Pour un avenant : identifiant du devis principal. |
id | integer | Identifiant du document (à passer à l'outil de détail). | |
reference | string | nullable | Numéro du document (vide pour un brouillon de facture ou de note de crédit). |
status | string | nullable | Statut du document. |
date | string (date) | nullable | Date du document. |
customer | string | nullable | 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 | nullable | Référence du dossier. |
amountExcludingVat | number | nullable | Total hors TVA, net de la remise globale. |
vatAmount | number | nullable | Montant de TVA. |
amountIncludingVat | number | nullable | Total TVA comprise. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Modifier des lignes d'un devis | Human-readable name shown by the MCP client. |
readOnlyHint | no | The tool changes nothing. |
destructiveHint | yes | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | yes | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"name": "update_estimate_lines",
"title": "Modifier des lignes d'un devis",
"description": "Modifie des lignes d'un devis (champ id des lignes de get_estimate) : libellé, description, quantité, prix imposé, marge, remise, TVA, unité. Seuls les champs fournis changent ; d'un titre ou d'un sous-titre, seuls le libellé et la description. Un libellé modifié ne change pas le prix. Les lignes d'option (variantes) se modifient dans l'application. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Oxygenius recalcule les prix, les sous-totaux, la TVA et les totaux comme l'écran du devis ; un devis accepté, refusé ou annulé, ou en attente de signature électronique, ne change plus (proposer create_estimate_version). Rien n'est envoyé au client. Renvoie le devis à jour.",
"inputSchema": {
"type": "object",
"properties": {
"estimateId": {
"description": "Devis (champ id de search_estimates).",
"type": "integer"
},
"lines": {
"description": "Modifications, une par ligne, 50 au plus.",
"type": "array",
"items": {
"type": "object",
"properties": {
"lineId": {
"description": "Identifiant de la ligne (champ id des lignes de get_estimate).",
"type": "integer"
},
"name": {
"description": "Nouveau libellé.",
"type": [
"string",
"null"
]
},
"description": {
"description": "Nouvelle description ; chaîne vide pour l'effacer.",
"type": [
"string",
"null"
]
},
"quantity": {
"description": "Nouvelle quantité ; celle d'un ouvrage multiplie les quantités de ses articles (un simple sous-titre n'a pas de quantité).",
"type": [
"number",
"null"
]
},
"unitPrice": {
"description": "Prix unitaire hors TVA imposé : il remplace le prix calculé, sans marge.",
"type": [
"number",
"null"
]
},
"benefitPercentage": {
"description": "Marge de la ligne en pourcents du prix de vente (0 à 99,99) ; le prix est recalculé.",
"type": [
"number",
"null"
]
},
"discountPercentage": {
"description": "Remise de la ligne en pourcents (0 à 100).",
"type": [
"number",
"null"
]
},
"vatRate": {
"description": "Taux de TVA en pourcents ; celui d'un ouvrage s'applique à ses articles.",
"type": [
"number",
"null"
]
},
"unit": {
"description": "Unité, par son nom.",
"type": [
"string",
"null"
]
}
},
"required": [
"lineId"
]
}
}
},
"required": [
"estimateId",
"lines"
]
},
"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": "Modifier des lignes d'un devis",
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": false
}
}