Stock d'un article
Nom de l'outil
get_item_stockLecture seuleIdempotent
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.
Accès requis
- Permission :
item-job.list.view - Module de licence actif :
STOCK - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
itemId | integer | obligatoire | Identifiant 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
| Nom | Type | Présence | Description |
|---|---|---|---|
itemId | integer | Identifiant de l'article. | |
name | string | peut être null | Désignation de l'article. |
unit | string | peut être null | Unité de stock. |
totalQuantity | number | Quantité physique totale, tous emplacements. Aucune quantité n'est réservée par les commandes en cours. | |
status | string | available, below-minimum (sous le stock minimum), out-of-stock (rupture) ou overstock (au-delà du stock maximum). | |
minimumQuantity | integer | peut être null | Stock minimum (seuil de l'article, sinon celui de la société). |
maximumQuantity | integer | peut être null | Stock maximum (seuil de l'article, sinon celui de la société). |
reorderQuantity | integer | peut être null | Quantité de réapprovisionnement conseillée. |
locations | object[] | Quantité par emplacement de stockage. | |
locations[].locationId | integer | Identifiant de l'emplacement. | |
locations[].name | string | peut être null | Nom de l'emplacement (dépôt, camionnette…). |
locations[].reference | string | peut être null | Référence de l'emplacement. |
locations[].quantity | number | Quantité sur cet emplacement. | |
recentMovements | object[] | Derniers mouvements de stock, du plus récent au plus ancien. | |
recentMovements[].date | string (date-time) | Date et heure du mouvement, en heure locale belge avec son décalage UTC. | |
recentMovements[].type | string | peut être null | Type de mouvement (entrée, sortie, retour chantier, ajustement…). |
recentMovements[].quantity | number | peut être null | Variation de stock : positive pour une entrée, négative pour une sortie, 0 pour un comptage d'inventaire. |
recentMovements[].countedQuantity | number | peut être null | Pour un comptage d'inventaire : la quantité comptée. |
recentMovements[].description | string | peut être null | Libellé du mouvement. |
recentMovements[].location | string | peut être null | Emplacement concerné. |
recentMovements[].dossierId | integer | peut être null | Dossier concerné (sortie vers un chantier, retour…). |
recentMovements[].dossierReference | string | peut être null | Référence du dossier concerné. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Stock d'un article | Nom lisible affiché par le client MCP. |
readOnlyHint | oui | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | oui | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'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
}
}