Stock d'un article

Nom de l'outilget_item_stock
Lecture seuleIdempotent

Description

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

Renvoie la disponibilité en stock d'un article (module Stock) : quantité totale et par emplacement, état (disponible, sous le minimum, rupture, surstock) d'après les seuils, quantité de réapprovisionnement et derniers mouvements. Aucune quantité n'est réservée par les commandes en cours.

Accès requis

Paramètres

NomTypePrésenceDescription
itemIdintegerobligatoireIdentifiant de l'article (champ id de search_items).

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
itemIdintegerIdentifiant de l'article.
namestringpeut être nullDésignation de l'article.
unitstringpeut être nullUnité de stock.
totalQuantitynumberQuantité physique totale, tous emplacements. Aucune quantité n'est réservée par les commandes en cours.
statusstringavailable, below-minimum (sous le stock minimum), out-of-stock (rupture) ou overstock (au-delà du stock maximum).
minimumQuantityintegerpeut être nullStock minimum (seuil de l'article, sinon celui de la société).
maximumQuantityintegerpeut être nullStock maximum (seuil de l'article, sinon celui de la société).
reorderQuantityintegerpeut être nullQuantité de réapprovisionnement conseillée.
locationsobject[]Quantité par emplacement de stockage.
locations[].locationIdintegerIdentifiant de l'emplacement.
locations[].namestringpeut être nullNom de l'emplacement (dépôt, camionnette…).
locations[].referencestringpeut être nullRéférence de l'emplacement.
locations[].quantitynumberQuantité sur cet emplacement.
recentMovementsobject[]Derniers mouvements de stock, du plus récent au plus ancien.
recentMovements[].datestring (date-time)Date et heure du mouvement, en heure locale belge avec son décalage UTC.
recentMovements[].typestringpeut être nullType de mouvement (entrée, sortie, retour chantier, ajustement…).
recentMovements[].quantitynumberpeut être nullVariation de stock : positive pour une entrée, négative pour une sortie, 0 pour un comptage d'inventaire.
recentMovements[].countedQuantitynumberpeut être nullPour un comptage d'inventaire : la quantité comptée.
recentMovements[].descriptionstringpeut être nullLibellé du mouvement.
recentMovements[].locationstringpeut être nullEmplacement concerné.
recentMovements[].dossierIdintegerpeut être nullDossier concerné (sortie vers un chantier, retour…).
recentMovements[].dossierReferencestringpeut être nullRéférence du dossier concerné.

Annotations MCP

AnnotationValeurSignification
titleStock d'un articleNom lisible affiché par le client MCP.
readOnlyHintouiL'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": "get_item_stock",
  "title": "Stock d'un article",
  "description": "Renvoie la disponibilité en stock d'un article (module Stock) : quantité totale et par emplacement, état (disponible, sous le minimum, rupture, surstock) d'après les seuils, quantité de réapprovisionnement et derniers mouvements. Aucune quantité n'est réservée par les commandes en cours.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "itemId": {
        "description": "Identifiant de l'article (champ id de search_items).",
        "type": "integer"
      }
    },
    "required": [
      "itemId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "itemId": {
        "description": "Identifiant de l'article.",
        "type": "integer"
      },
      "name": {
        "description": "Désignation de l'article.",
        "type": [
          "string",
          "null"
        ]
      },
      "unit": {
        "description": "Unité de stock.",
        "type": [
          "string",
          "null"
        ]
      },
      "totalQuantity": {
        "description": "Quantité physique totale, tous emplacements. Aucune quantité n'est réservée par les commandes en cours.",
        "type": "number"
      },
      "status": {
        "description": "available, below-minimum (sous le stock minimum), out-of-stock (rupture) ou overstock (au-delà du stock maximum).",
        "type": "string"
      },
      "minimumQuantity": {
        "description": "Stock minimum (seuil de l'article, sinon celui de la société).",
        "type": [
          "integer",
          "null"
        ]
      },
      "maximumQuantity": {
        "description": "Stock maximum (seuil de l'article, sinon celui de la société).",
        "type": [
          "integer",
          "null"
        ]
      },
      "reorderQuantity": {
        "description": "Quantité de réapprovisionnement conseillée.",
        "type": [
          "integer",
          "null"
        ]
      },
      "locations": {
        "description": "Quantité par emplacement de stockage.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "locationId": {
              "description": "Identifiant de l'emplacement.",
              "type": "integer"
            },
            "name": {
              "description": "Nom de l'emplacement (dépôt, camionnette…).",
              "type": [
                "string",
                "null"
              ]
            },
            "reference": {
              "description": "Référence de l'emplacement.",
              "type": [
                "string",
                "null"
              ]
            },
            "quantity": {
              "description": "Quantité sur cet emplacement.",
              "type": "number"
            }
          },
          "required": [
            "locationId",
            "quantity"
          ]
        }
      },
      "recentMovements": {
        "description": "Derniers mouvements de stock, du plus récent au plus ancien.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "description": "Date et heure du mouvement, en heure locale belge avec son décalage UTC.",
              "type": "string",
              "format": "date-time"
            },
            "type": {
              "description": "Type de mouvement (entrée, sortie, retour chantier, ajustement…).",
              "type": [
                "string",
                "null"
              ]
            },
            "quantity": {
              "description": "Variation de stock : positive pour une entrée, négative pour une sortie, 0 pour un comptage d'inventaire.",
              "type": [
                "number",
                "null"
              ]
            },
            "countedQuantity": {
              "description": "Pour un comptage d'inventaire : la quantité comptée.",
              "type": [
                "number",
                "null"
              ]
            },
            "description": {
              "description": "Libellé du mouvement.",
              "type": [
                "string",
                "null"
              ]
            },
            "location": {
              "description": "Emplacement concerné.",
              "type": [
                "string",
                "null"
              ]
            },
            "dossierId": {
              "description": "Dossier concerné (sortie vers un chantier, retour…).",
              "type": [
                "integer",
                "null"
              ]
            },
            "dossierReference": {
              "description": "Référence du dossier concerné.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "date"
          ]
        }
      }
    },
    "required": [
      "itemId",
      "totalQuantity",
      "status"
    ]
  },
  "annotations": {
    "title": "Stock d'un article",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}