Numéroter une note de crédit
finalize_credit_noteGives a draft credit note its final legal number and prints it, as prepared by prepare_credit_note_finalization.
Description
Numérote et imprime une note de crédit en brouillon, préparée par prepare_credit_note_finalization : numéro légal définitif, et effet immédiat sur la facture créditée. Rien n'est envoyé au client. Exige le jeton de l'outil de préparation, après l'accord explicite de l'utilisateur sur ce qu'il a montré ; un jeton expiré, déjà utilisé ou d'un document modifié depuis est refusé. Ne jamais rappeler l'outil après un succès. Renvoie la note de crédit numérotée et son PDF.
Required access
- Permission:
credit-note.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 |
|---|---|---|---|
creditNoteId | integer | required | Note de crédit (champ id de search_credit_notes). |
confirmationToken | string | required | Jeton renvoyé par prepare_credit_note_finalization pour cette note de crédit. |
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 |
|---|---|---|---|
document | object | Le document après l'action, relu. | |
document.kind | string | estimate (devis), invoice (facture) ou credit_note (note de crédit). | |
document.id | integer | Identifiant du document. | |
document.reference | string | nullable | Numéro du document (vide pour un brouillon de facture ou de note de crédit). |
document.status | string | nullable | Statut actuel. |
document.date | string (date) | nullable | Date du document. |
document.customer | string | nullable | Client facturé. |
document.dossierId | integer | nullable | Dossier du document. |
document.amountExcludingVat | number | nullable | Total hors TVA, en euros. |
document.amountIncludingVat | number | nullable | Total TVA comprise, en euros. |
pdfDocumentId | integer | nullable | Document PDF du document de facturation, quand il en a un (get_document_download_link pour le télécharger). |
message | string | Ce qui a été fait, et ce qui se passe ensuite. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Numéroter une note de crédit | 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 | no | 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": "finalize_credit_note",
"title": "Numéroter une note de crédit",
"description": "Numérote et imprime une note de crédit en brouillon, préparée par prepare_credit_note_finalization : numéro légal définitif, et effet immédiat sur la facture créditée. Rien n'est envoyé au client. Exige le jeton de l'outil de préparation, après l'accord explicite de l'utilisateur sur ce qu'il a montré ; un jeton expiré, déjà utilisé ou d'un document modifié depuis est refusé. Ne jamais rappeler l'outil après un succès. Renvoie la note de crédit numérotée et son PDF.",
"inputSchema": {
"type": "object",
"properties": {
"creditNoteId": {
"description": "Note de crédit (champ id de search_credit_notes).",
"type": "integer"
},
"confirmationToken": {
"description": "Jeton renvoyé par prepare_credit_note_finalization pour cette note de crédit.",
"type": "string"
}
},
"required": [
"creditNoteId",
"confirmationToken"
]
},
"outputSchema": {
"type": "object",
"properties": {
"document": {
"description": "Le document après l'action, relu.",
"type": "object",
"properties": {
"kind": {
"description": "estimate (devis), invoice (facture) ou credit_note (note de crédit).",
"type": "string"
},
"id": {
"description": "Identifiant du document.",
"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 actuel.",
"type": [
"string",
"null"
]
},
"date": {
"description": "Date du document.",
"type": [
"string",
"null"
],
"format": "date"
},
"customer": {
"description": "Client facturé.",
"type": [
"string",
"null"
]
},
"dossierId": {
"description": "Dossier du document.",
"type": [
"integer",
"null"
]
},
"amountExcludingVat": {
"description": "Total hors TVA, en euros.",
"type": [
"number",
"null"
]
},
"amountIncludingVat": {
"description": "Total TVA comprise, en euros.",
"type": [
"number",
"null"
]
}
},
"required": [
"kind",
"id"
]
},
"pdfDocumentId": {
"description": "Document PDF du document de facturation, quand il en a un (get_document_download_link pour le télécharger).",
"type": [
"integer",
"null"
]
},
"message": {
"description": "Ce qui a été fait, et ce qui se passe ensuite.",
"type": "string"
}
},
"required": [
"document",
"message"
]
},
"annotations": {
"title": "Numéroter une note de crédit",
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}