Numéroter une note de crédit

Nom de l'outilfinalize_credit_note
ÉcritureDestructifExige un jeton de confirmation

Description

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

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.

Accès requis

Paramètres

NomTypePrésenceDescription
creditNoteIdintegerobligatoireNote de crédit (champ id de search_credit_notes).
confirmationTokenstringobligatoireJeton renvoyé par prepare_credit_note_finalization pour cette note de crédit.

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
documentobjectLe document après l'action, relu.
document.kindstringestimate (devis), invoice (facture) ou credit_note (note de crédit).
document.idintegerIdentifiant du document.
document.referencestringpeut être nullNuméro du document (vide pour un brouillon de facture ou de note de crédit).
document.statusstringpeut être nullStatut actuel.
document.datestring (date)peut être nullDate du document.
document.customerstringpeut être nullClient facturé.
document.dossierIdintegerpeut être nullDossier du document.
document.amountExcludingVatnumberpeut être nullTotal hors TVA, en euros.
document.amountIncludingVatnumberpeut être nullTotal TVA comprise, en euros.
pdfDocumentIdintegerpeut être nullDocument PDF du document de facturation, quand il en a un (get_document_download_link pour le télécharger).
messagestringCe qui a été fait, et ce qui se passe ensuite.

Annotations MCP

AnnotationValeurSignification
titleNuméroter une note de créditNom 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.
idempotentHintnonRappeler 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": "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
  }
}