Stock d'un article
Tool name
get_item_stockRead-onlyIdempotent
Returns an item's stock (Stock module): quantity per location, state against thresholds, reorder quantity and latest movements.
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.
Required access
- Permission:
item-job.list.view - Active licence module:
STOCK - Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
itemId | integer | required | Identifiant 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
| Name | Type | Presence | Description |
|---|---|---|---|
itemId | integer | Identifiant de l'article. | |
name | string | nullable | Désignation de l'article. |
unit | string | nullable | 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 | nullable | Stock minimum (seuil de l'article, sinon celui de la société). |
maximumQuantity | integer | nullable | Stock maximum (seuil de l'article, sinon celui de la société). |
reorderQuantity | integer | nullable | Quantité de réapprovisionnement conseillée. |
locations | object[] | Quantité par emplacement de stockage. | |
locations[].locationId | integer | Identifiant de l'emplacement. | |
locations[].name | string | nullable | Nom de l'emplacement (dépôt, camionnette…). |
locations[].reference | string | nullable | 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 | nullable | Type de mouvement (entrée, sortie, retour chantier, ajustement…). |
recentMovements[].quantity | number | nullable | Variation de stock : positive pour une entrée, négative pour une sortie, 0 pour un comptage d'inventaire. |
recentMovements[].countedQuantity | number | nullable | Pour un comptage d'inventaire : la quantité comptée. |
recentMovements[].description | string | nullable | Libellé du mouvement. |
recentMovements[].location | string | nullable | Emplacement concerné. |
recentMovements[].dossierId | integer | nullable | Dossier concerné (sortie vers un chantier, retour…). |
recentMovements[].dossierReference | string | nullable | Référence du dossier concerné. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Stock d'un article | Human-readable name shown by the MCP client. |
readOnlyHint | yes | The tool changes nothing. |
destructiveHint | no | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | yes | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The 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
}
}