Stock d'un article

Tool nameget_item_stock
Read-onlyIdempotent

Returns an item's stock (Stock module): quantity per location, state against thresholds, reorder quantity and latest movements.

Description

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

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.

Required access

Parameters

NameTypePresenceDescription
itemIdintegerrequiredIdentifiant de l'article (champ id de search_items).

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
itemIdintegerIdentifiant de l'article.
namestringnullableDésignation de l'article.
unitstringnullableUnité 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).
minimumQuantityintegernullableStock minimum (seuil de l'article, sinon celui de la société).
maximumQuantityintegernullableStock maximum (seuil de l'article, sinon celui de la société).
reorderQuantityintegernullableQuantité de réapprovisionnement conseillée.
locationsobject[]Quantité par emplacement de stockage.
locations[].locationIdintegerIdentifiant de l'emplacement.
locations[].namestringnullableNom de l'emplacement (dépôt, camionnette…).
locations[].referencestringnullableRé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[].typestringnullableType de mouvement (entrée, sortie, retour chantier, ajustement…).
recentMovements[].quantitynumbernullableVariation de stock : positive pour une entrée, négative pour une sortie, 0 pour un comptage d'inventaire.
recentMovements[].countedQuantitynumbernullablePour un comptage d'inventaire : la quantité comptée.
recentMovements[].descriptionstringnullableLibellé du mouvement.
recentMovements[].locationstringnullableEmplacement concerné.
recentMovements[].dossierIdintegernullableDossier concerné (sortie vers un chantier, retour…).
recentMovements[].dossierReferencestringnullableRéférence du dossier concerné.

MCP annotations

AnnotationValueMeaning
titleStock d'un articleHuman-readable name shown by the MCP client.
readOnlyHintyesThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintyesCalling 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": "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
  }
}