Préparer un envoi Peppol

Nom de l'outilprepare_peppol_send
ÉcritureIdempotentPrépare une action, sans effet

Description

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

Prépare l'envoi d'une facture ou d'une note de crédit numérotée par le réseau Peppol (send_peppol), comme le bouton « Envoyer via Peppol » : le fichier UBL est transmis au client par Digiteal, par Mercurius pour un client marqué Mercurius. Refusée pour un client sans numéro de TVA, un document sans UBL, ou déjà transmis (seul un envoi en erreur se refait). Ne change rien : renvoie le document tel qu'il est enregistré, les effets de l'action et les points d'attention, et un jeton de confirmation valable 10 minutes. Montrer le tout à l'utilisateur et attendre son accord explicite avant l'outil de l'action ; un document modifié ensuite doit être préparé à nouveau.

Accès requis

Paramètres

NomTypePrésenceDescription
kindstringobligatoireinvoice (facture) ou credit_note (note de crédit).
documentIdintegerobligatoireDocument (champ id de search_invoices ou search_credit_notes).

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
actionstringAction préparée, et outil qui l'exécute avec le jeton.
documentobjectDocument visé, tel qu'il est enregistré : le montrer à l'utilisateur.
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.
effectsstring[]Ce que l'action déclenche dans Oxygenius et au dehors : à annoncer à l'utilisateur.
warningsstring[]Points à signaler à l'utilisateur avant qu'il décide.
confirmationTokenstringJeton à passer à l'outil de l'action, seulement après l'accord explicite de l'utilisateur sur ce document et ces effets.
expiresAtstring (date-time)Échéance du jeton (10 minutes) ; au-delà, ou si le document change, préparer à nouveau.

Annotations MCP

AnnotationValeurSignification
titlePréparer un envoi PeppolNom lisible affiché par le client MCP.
readOnlyHintnonL'outil ne modifie rien.
destructiveHintnonL'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": "prepare_peppol_send",
  "title": "Préparer un envoi Peppol",
  "description": "Prépare l'envoi d'une facture ou d'une note de crédit numérotée par le réseau Peppol (send_peppol), comme le bouton « Envoyer via Peppol » : le fichier UBL est transmis au client par Digiteal, par Mercurius pour un client marqué Mercurius. Refusée pour un client sans numéro de TVA, un document sans UBL, ou déjà transmis (seul un envoi en erreur se refait). Ne change rien : renvoie le document tel qu'il est enregistré, les effets de l'action et les points d'attention, et un jeton de confirmation valable 10 minutes. Montrer le tout à l'utilisateur et attendre son accord explicite avant l'outil de l'action ; un document modifié ensuite doit être préparé à nouveau.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "kind": {
        "description": "invoice (facture) ou credit_note (note de crédit).",
        "type": "string"
      },
      "documentId": {
        "description": "Document (champ id de search_invoices ou search_credit_notes).",
        "type": "integer"
      }
    },
    "required": [
      "kind",
      "documentId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "action": {
        "description": "Action préparée, et outil qui l'exécute avec le jeton.",
        "type": "string"
      },
      "document": {
        "description": "Document visé, tel qu'il est enregistré : le montrer à l'utilisateur.",
        "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"
        ]
      },
      "effects": {
        "description": "Ce que l'action déclenche dans Oxygenius et au dehors : à annoncer à l'utilisateur.",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "warnings": {
        "description": "Points à signaler à l'utilisateur avant qu'il décide.",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "confirmationToken": {
        "description": "Jeton à passer à l'outil de l'action, seulement après l'accord explicite de l'utilisateur sur ce document et ces effets.",
        "type": "string"
      },
      "expiresAt": {
        "description": "Échéance du jeton (10 minutes) ; au-delà, ou si le document change, préparer à nouveau.",
        "type": "string",
        "format": "date-time"
      }
    },
    "required": [
      "action",
      "document",
      "confirmationToken",
      "expiresAt"
    ]
  },
  "annotations": {
    "title": "Préparer un envoi Peppol",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}