Modifier une facture

Nom de l'outilupdate_invoice
ÉcritureDestructifIdempotent

Description

Texte exact envoyé au modèle par tools/list :

Modifie l'en-tête d'une facture en brouillon : date, échéance, délai de paiement (l'échéance suit, comme dans le formulaire), bon de commande du client, tiers facturé. Seuls les champs fournis changent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon (sans numéro, à éditer) change : le numéro d'une facture est légal et définitif. Oxygenius recalcule les prix, les sous-totaux, la TVA et les totaux comme l'écran du document. Rien n'est envoyé au client.

Accès requis

Paramètres

NomTypePrésenceDescription
invoiceIdintegerobligatoireFacture (champ id de search_invoices).
datestring (date)facultatifNouvelle date de la facture (AAAA-MM-JJ) ; l'échéance passe au lendemain si elle devient antérieure.
dueDatestring (date)facultatifNouvelle échéance (AAAA-MM-JJ).
paymentTermIdintegerfacultatifDélai de paiement (paymentTerms de get_reference_lists) ; l'échéance devient la date plus ce délai.
poNumberstringfacultatifNuméro de bon de commande du client ; chaîne vide pour l'effacer.
billingTiersIdintegerfacultatifNouveau tiers facturé : un tiers lié au dossier (champ tiersId des tiers de get_dossier), à l'adresse complète.

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
NomTypePrésenceDescription
customerVatNumberstringpeut être nullNuméro de TVA du client imprimé sur la facture.
customerAddressstringpeut être nullAdresse du client imprimée sur la facture.
customerOrderNumberstringpeut être nullRéférence de commande (bon de commande) du client.
dossierIndicationstringpeut être nullIntitulé court du dossier.
structuredCommunicationstringpeut être nullCommunication structurée du virement.
paymentTermstringpeut être nullCondition de paiement.
discountPercentagenumberpeut être nullRemise globale en pourcents.
discountAmountnumberpeut être nullMontant de la remise globale (hors TVA).
retentionPercentagenumberpeut être nullRetenue de garantie en pourcents.
retentionAmountnumberpeut être nullMontant de la retenue de garantie.
paidAmountnumberpeut être nullTotal des paiements reçus.
creditedAmountnumberpeut être nullTotal des notes de crédit sur cette facture, TVA comprise.
paymentsobject[]Paiements reçus.
payments[].datestring (date)Date du paiement.
payments[].amountnumberpeut être nullMontant payé.
payments[].methodstringpeut être nullMoyen de paiement.
vatBreakdownobject[]Montant de TVA par taux.
vatBreakdown[].ratestringpeut être nullCode du taux de TVA (ex. 21, 6, CO pour cocontractant).
vatBreakdown[].percentagenumberpeut être nullPourcentage de TVA.
vatBreakdown[].amountnumberpeut être nullMontant de TVA à ce taux.
linesobjectLignes de la facture.
lines.totalCountintegerNombre total de lignes du document.
lines.isTruncatedbooleanVrai si le document compte plus de lignes que celles renvoyées.
lines.itemsobject[]Lignes dans l'ordre du document.
lines.items[].idintegerIdentifiant de la ligne (lineId ou parentLineId des outils de modification d'un devis).
lines.items[].numberstringpeut être nullNuméro de la ligne tel qu'imprimé (ex. 1.2).
lines.items[].typestringsupertitle, title, subtitle, item (article) ou other.
lines.items[].isOptionbooleanVrai pour une ligne en option (variante), non comprise dans les totaux.
lines.items[].namestringpeut être nullLibellé de la ligne.
lines.items[].descriptionstringpeut être nullDescription détaillée.
lines.items[].quantitynumberpeut être nullQuantité (articles).
lines.items[].unitstringpeut être nullUnité (articles).
lines.items[].unitPricenumberpeut être nullPrix unitaire hors TVA (articles).
lines.items[].vatRatenumberpeut être nullTaux de TVA en pourcents (articles).
lines.items[].discountAmountnumberpeut être nullRemise accordée sur la ligne (articles).
lines.items[].amountExcludingVatnumberpeut être nullMontant hors TVA, net de la remise de la ligne (articles).
lines.items[].remarkstringpeut être nullRemarque imprimée sous la ligne (devis).
lines.items[].depositInvoiceIdintegerpeut être nullFacture d'acompte déduite par cette ligne (à passer à get_invoice).
estimateIdintegerpeut être nullIdentifiant du devis facturé (à passer à get_estimate ; absent sans accès aux devis).
estimateReferencestringpeut être nullNuméro du devis facturé.
creditNotesobject[]Notes de crédit sur cette facture (vide sans accès aux notes de crédit).
creditNotes[].idintegerIdentifiant du document lié.
creditNotes[].referencestringpeut être nullNuméro du document lié.
creditNotes[].typestringpeut être nullType de facture (acompte, finale, avancement…).
creditNotes[].statusstringpeut être nullStatut du document lié.
creditNotes[].datestring (date)peut être nullDate du document lié.
creditNotes[].amountIncludingVatnumberpeut être nullTotal TVA comprise.
typestringpeut être nullType : acompte, finale, état d'avancement, intervention, proforma…
dueDatestring (date)peut être nullDate d'échéance.
amountDuenumberpeut être nullMontant à payer TVA comprise : le total, diminué de la retenue de garantie éventuelle.
outstandingnumberpeut être nullSolde restant dû : montant à payer moins paiements et notes de crédit (absent pour un brouillon, une facture annulée ou proforma).
isOverduebooleanVrai si la facture est ouverte, échue et pas soldée.
daysOverdueintegerpeut être nullNombre de jours depuis l'échéance, pour une facture en retard.
idintegerIdentifiant du document (à passer à l'outil de détail).
referencestringpeut être nullNuméro du document (vide pour un brouillon de facture ou de note de crédit).
statusstringpeut être nullStatut du document.
datestring (date)peut être nullDate du document.
customerstringpeut être nullClient tel qu'imprimé sur le document.
tiersIdintegerIdentifiant du tiers client (à passer à get_tiers).
dossierIdintegerIdentifiant du dossier (à passer à get_dossier).
dossierReferencestringpeut être nullRéférence du dossier.
amountExcludingVatnumberpeut être nullTotal hors TVA, net de la remise globale.
vatAmountnumberpeut être nullMontant de TVA.
amountIncludingVatnumberpeut être nullTotal TVA comprise.

Annotations MCP

AnnotationValeurSignification
titleModifier une factureNom lisible affiché par le client MCP.
readOnlyHintnonL'outil ne modifie rien.
destructiveHintouiL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintouiRappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire.
openWorldHintnonL'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": "update_invoice",
  "title": "Modifier une facture",
  "description": "Modifie l'en-tête d'une facture en brouillon : date, échéance, délai de paiement (l'échéance suit, comme dans le formulaire), bon de commande du client, tiers facturé. Seuls les champs fournis changent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon (sans numéro, à éditer) change : le numéro d'une facture est légal et définitif. Oxygenius recalcule les prix, les sous-totaux, la TVA et les totaux comme l'écran du document. Rien n'est envoyé au client.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "invoiceId": {
        "description": "Facture (champ id de search_invoices).",
        "type": "integer"
      },
      "date": {
        "description": "Nouvelle date de la facture (AAAA-MM-JJ) ; l'échéance passe au lendemain si elle devient antérieure.",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      },
      "dueDate": {
        "description": "Nouvelle échéance (AAAA-MM-JJ).",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      },
      "paymentTermId": {
        "description": "Délai de paiement (paymentTerms de get_reference_lists) ; l'échéance devient la date plus ce délai.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "poNumber": {
        "description": "Numéro de bon de commande du client ; chaîne vide pour l'effacer.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "billingTiersId": {
        "description": "Nouveau tiers facturé : un tiers lié au dossier (champ tiersId des tiers de get_dossier), à l'adresse complète.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      }
    },
    "required": [
      "invoiceId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "customerVatNumber": {
        "description": "Numéro de TVA du client imprimé sur la facture.",
        "type": [
          "string",
          "null"
        ]
      },
      "customerAddress": {
        "description": "Adresse du client imprimée sur la facture.",
        "type": [
          "string",
          "null"
        ]
      },
      "customerOrderNumber": {
        "description": "Référence de commande (bon de commande) du client.",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierIndication": {
        "description": "Intitulé court du dossier.",
        "type": [
          "string",
          "null"
        ]
      },
      "structuredCommunication": {
        "description": "Communication structurée du virement.",
        "type": [
          "string",
          "null"
        ]
      },
      "paymentTerm": {
        "description": "Condition de paiement.",
        "type": [
          "string",
          "null"
        ]
      },
      "discountPercentage": {
        "description": "Remise globale en pourcents.",
        "type": [
          "number",
          "null"
        ]
      },
      "discountAmount": {
        "description": "Montant de la remise globale (hors TVA).",
        "type": [
          "number",
          "null"
        ]
      },
      "retentionPercentage": {
        "description": "Retenue de garantie en pourcents.",
        "type": [
          "number",
          "null"
        ]
      },
      "retentionAmount": {
        "description": "Montant de la retenue de garantie.",
        "type": [
          "number",
          "null"
        ]
      },
      "paidAmount": {
        "description": "Total des paiements reçus.",
        "type": [
          "number",
          "null"
        ]
      },
      "creditedAmount": {
        "description": "Total des notes de crédit sur cette facture, TVA comprise.",
        "type": [
          "number",
          "null"
        ]
      },
      "payments": {
        "description": "Paiements reçus.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "description": "Date du paiement.",
              "type": "string",
              "format": "date"
            },
            "amount": {
              "description": "Montant payé.",
              "type": [
                "number",
                "null"
              ]
            },
            "method": {
              "description": "Moyen de paiement.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "date"
          ]
        }
      },
      "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 de la facture.",
        "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"
        ]
      },
      "estimateId": {
        "description": "Identifiant du devis facturé (à passer à get_estimate ; absent sans accès aux devis).",
        "type": [
          "integer",
          "null"
        ]
      },
      "estimateReference": {
        "description": "Numéro du devis facturé.",
        "type": [
          "string",
          "null"
        ]
      },
      "creditNotes": {
        "description": "Notes de crédit sur cette facture (vide sans accès aux notes de crédit).",
        "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"
          ]
        }
      },
      "type": {
        "description": "Type : acompte, finale, état d'avancement, intervention, proforma…",
        "type": [
          "string",
          "null"
        ]
      },
      "dueDate": {
        "description": "Date d'échéance.",
        "type": [
          "string",
          "null"
        ],
        "format": "date"
      },
      "amountDue": {
        "description": "Montant à payer TVA comprise : le total, diminué de la retenue de garantie éventuelle.",
        "type": [
          "number",
          "null"
        ]
      },
      "outstanding": {
        "description": "Solde restant dû : montant à payer moins paiements et notes de crédit (absent pour un brouillon, une facture annulée ou proforma).",
        "type": [
          "number",
          "null"
        ]
      },
      "isOverdue": {
        "description": "Vrai si la facture est ouverte, échue et pas soldée.",
        "type": "boolean"
      },
      "daysOverdue": {
        "description": "Nombre de jours depuis l'échéance, pour une facture en retard.",
        "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 une facture",
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}