Créer une facture

Tool namecreate_invoice
Write

Creates an unnumbered draft invoice: free, or from an accepted estimate (deposit, progress or final). Nothing is numbered or sent.

Description

Exact text sent to the model by tools/list (French, the language of the data):

Crée une facture en brouillon, sans numéro, comme l'écran du dossier : libre pour un dossier (kind free, à remplir avec add_invoice_lines), ou depuis un devis accepté : acompte (kind deposit, pourcentage d'acompte de la société), avancement (kind progress, percentage du montant signé ou amount hors TVA, dans la limite du reste à facturer) ou finale (kind final, montant signé moins ce qui est déjà facturé). Client et adresse sont ceux du tiers facturé. 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 une facture. Rien n'est numéroté ni envoyé. Renvoie la facture créée.

Required access

Parameters

NameTypePresenceDescription
kindstringrequiredfree (facture libre d'un dossier), deposit (acompte), progress (avancement) ou final (facture finale) d'un devis accepté.
dossierIdintegeroptionalDossier d'une facture libre (champ id de search_dossiers).
estimateIdintegeroptionalDevis accepté, pour deposit, progress et final (champ id de search_estimates ; le devis principal, pas un avenant).
percentagenumberoptionalAvancement : pourcentage du montant signé (devis et avenants acceptés) à facturer, 0,01 à 100.
amountnumberoptionalAvancement : montant hors TVA à facturer, à la place de percentage.

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
NameTypePresenceDescription
customerVatNumberstringnullableNuméro de TVA du client imprimé sur la facture.
customerAddressstringnullableAdresse du client imprimée sur la facture.
customerOrderNumberstringnullableRéférence de commande (bon de commande) du client.
dossierIndicationstringnullableIntitulé court du dossier.
structuredCommunicationstringnullableCommunication structurée du virement.
paymentTermstringnullableCondition de paiement.
discountPercentagenumbernullableRemise globale en pourcents.
discountAmountnumbernullableMontant de la remise globale (hors TVA).
retentionPercentagenumbernullableRetenue de garantie en pourcents.
retentionAmountnumbernullableMontant de la retenue de garantie.
paidAmountnumbernullableTotal des paiements reçus.
creditedAmountnumbernullableTotal des notes de crédit sur cette facture, TVA comprise.
paymentsobject[]Paiements reçus.
payments[].datestring (date)Date du paiement.
payments[].amountnumbernullableMontant payé.
payments[].methodstringnullableMoyen de paiement.
vatBreakdownobject[]Montant de TVA par taux.
vatBreakdown[].ratestringnullableCode du taux de TVA (ex. 21, 6, CO pour cocontractant).
vatBreakdown[].percentagenumbernullablePourcentage de TVA.
vatBreakdown[].amountnumbernullableMontant 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[].numberstringnullableNumé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[].namestringnullableLibellé de la ligne.
lines.items[].descriptionstringnullableDescription détaillée.
lines.items[].quantitynumbernullableQuantité (articles).
lines.items[].unitstringnullableUnité (articles).
lines.items[].unitPricenumbernullablePrix unitaire hors TVA (articles).
lines.items[].vatRatenumbernullableTaux de TVA en pourcents (articles).
lines.items[].discountAmountnumbernullableRemise accordée sur la ligne (articles).
lines.items[].amountExcludingVatnumbernullableMontant hors TVA, net de la remise de la ligne (articles).
lines.items[].remarkstringnullableRemarque imprimée sous la ligne (devis).
lines.items[].depositInvoiceIdintegernullableFacture d'acompte déduite par cette ligne (à passer à get_invoice).
estimateIdintegernullableIdentifiant du devis facturé (à passer à get_estimate ; absent sans accès aux devis).
estimateReferencestringnullableNumé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[].referencestringnullableNuméro du document lié.
creditNotes[].typestringnullableType de facture (acompte, finale, avancement…).
creditNotes[].statusstringnullableStatut du document lié.
creditNotes[].datestring (date)nullableDate du document lié.
creditNotes[].amountIncludingVatnumbernullableTotal TVA comprise.
typestringnullableType : acompte, finale, état d'avancement, intervention, proforma…
dueDatestring (date)nullableDate d'échéance.
amountDuenumbernullableMontant à payer TVA comprise : le total, diminué de la retenue de garantie éventuelle.
outstandingnumbernullableSolde 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.
daysOverdueintegernullableNombre de jours depuis l'échéance, pour une facture en retard.
idintegerIdentifiant du document (à passer à l'outil de détail).
referencestringnullableNuméro du document (vide pour un brouillon de facture ou de note de crédit).
statusstringnullableStatut du document.
datestring (date)nullableDate du document.
customerstringnullableClient tel qu'imprimé sur le document.
tiersIdintegerIdentifiant du tiers client (à passer à get_tiers).
dossierIdintegerIdentifiant du dossier (à passer à get_dossier).
dossierReferencestringnullableRéférence du dossier.
amountExcludingVatnumbernullableTotal hors TVA, net de la remise globale.
vatAmountnumbernullableMontant de TVA.
amountIncludingVatnumbernullableTotal TVA comprise.

MCP annotations

AnnotationValueMeaning
titleCréer une factureHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling it again with the same arguments has no further effect.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "name": "create_invoice",
  "title": "Créer une facture",
  "description": "Crée une facture en brouillon, sans numéro, comme l'écran du dossier : libre pour un dossier (kind free, à remplir avec add_invoice_lines), ou depuis un devis accepté : acompte (kind deposit, pourcentage d'acompte de la société), avancement (kind progress, percentage du montant signé ou amount hors TVA, dans la limite du reste à facturer) ou finale (kind final, montant signé moins ce qui est déjà facturé). Client et adresse sont ceux du tiers facturé. 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 une facture. Rien n'est numéroté ni envoyé. Renvoie la facture créée.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "kind": {
        "description": "free (facture libre d'un dossier), deposit (acompte), progress (avancement) ou final (facture finale) d'un devis accepté.",
        "type": "string"
      },
      "dossierId": {
        "description": "Dossier d'une facture libre (champ id de search_dossiers).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "estimateId": {
        "description": "Devis accepté, pour deposit, progress et final (champ id de search_estimates ; le devis principal, pas un avenant).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "percentage": {
        "description": "Avancement : pourcentage du montant signé (devis et avenants acceptés) à facturer, 0,01 à 100.",
        "type": [
          "number",
          "null"
        ],
        "default": null
      },
      "amount": {
        "description": "Avancement : montant hors TVA à facturer, à la place de percentage.",
        "type": [
          "number",
          "null"
        ],
        "default": null
      }
    },
    "required": [
      "kind"
    ]
  },
  "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": "Créer une facture",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}