Détail d'un article
Tool name
get_itemRead-onlyIdempotent
Returns an item or assembly: description, sale prices, unit, category, suppliers and composition. The purchase price requires the profitability permission.
Description
Renvoie le détail d'un article ou d'un ouvrage : description, prix de vente HTVA et TVAC, unité, catégorie, fournisseurs (délais, références), composition d'un ouvrage. Le prix d'achat n'est renvoyé qu'aux utilisateurs qui ont accès aux données de rentabilité.
Required access
- Permission:
item-job.list.view - 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 |
|---|---|---|---|
description | string | nullable | Description de l'article. |
barcode | string | nullable | Code-barres (EAN). |
salesPriceIncludingVat | number | nullable | Prix de vente unitaire TVA comprise. |
purchasePrice | number | nullable | Prix d'achat unitaire hors TVA (absent sans accès aux données de rentabilité). |
mainSupplier | string | nullable | Fournisseur principal. |
mainSupplierTiersId | integer | nullable | Identifiant du tiers fournisseur principal (à passer à get_tiers). |
lastUseDate | string (date) | nullable | Date de dernière utilisation dans un document. |
suppliers | object[] | Fournisseurs actifs de l'article. | |
suppliers[].tiersId | integer | Identifiant du tiers fournisseur (à passer à get_tiers). | |
suppliers[].name | string | nullable | Nom du fournisseur. |
suppliers[].reference | string | nullable | Référence de l'article chez le fournisseur. |
suppliers[].denomination | string | nullable | Désignation de l'article chez le fournisseur. |
suppliers[].deliveryDelayDays | integer | nullable | Délai de livraison en jours. |
suppliers[].orderQuantity | integer | nullable | Quantité minimale ou multiple de commande. |
suppliers[].isFavorite | boolean | Vrai pour le fournisseur favori. | |
suppliers[].price | number | nullable | Prix d'achat chez ce fournisseur (absent sans accès aux données de rentabilité). |
components | object[] | Pour un ouvrage : les articles qui le composent. | |
components[].itemId | integer | Identifiant de l'article composant. | |
components[].name | string | nullable | Désignation du composant. |
components[].quantity | number | nullable | Quantité par unité d'ouvrage. |
components[].unit | string | nullable | Unité du composant. |
id | integer | Identifiant de l'article (à passer à get_item ou get_item_stock). | |
kind | string | article (fourniture stockable), job (ouvrage composé d'articles) ou other. | |
name | string | nullable | Désignation. |
internalReference | string | nullable | Référence interne. |
externalReference | string | nullable | Référence externe (fabricant, fournisseur). |
category | string | nullable | Catégorie (matériau, main d'œuvre…). |
family | string | nullable | Famille d'articles. |
brand | string | nullable | Marque. |
unit | string | nullable | Unité de vente. |
salesPrice | number | nullable | Prix de vente unitaire hors TVA, en euros. |
vatRate | number | nullable | Taux de TVA de vente en pourcents. |
isActive | boolean | Faux pour un article désactivé. | |
stockQuantity | number | nullable | Quantité totale en stock, tous emplacements (articles ; absent sans le module Stock). |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Détail 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",
"title": "Détail d'un article",
"description": "Renvoie le détail d'un article ou d'un ouvrage : description, prix de vente HTVA et TVAC, unité, catégorie, fournisseurs (délais, références), composition d'un ouvrage. Le prix d'achat n'est renvoyé qu'aux utilisateurs qui ont accès aux données de rentabilité.",
"inputSchema": {
"type": "object",
"properties": {
"itemId": {
"description": "Identifiant de l'article (champ id de search_items).",
"type": "integer"
}
},
"required": [
"itemId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"description": {
"description": "Description de l'article.",
"type": [
"string",
"null"
]
},
"barcode": {
"description": "Code-barres (EAN).",
"type": [
"string",
"null"
]
},
"salesPriceIncludingVat": {
"description": "Prix de vente unitaire TVA comprise.",
"type": [
"number",
"null"
]
},
"purchasePrice": {
"description": "Prix d'achat unitaire hors TVA (absent sans accès aux données de rentabilité).",
"type": [
"number",
"null"
]
},
"mainSupplier": {
"description": "Fournisseur principal.",
"type": [
"string",
"null"
]
},
"mainSupplierTiersId": {
"description": "Identifiant du tiers fournisseur principal (à passer à get_tiers).",
"type": [
"integer",
"null"
]
},
"lastUseDate": {
"description": "Date de dernière utilisation dans un document.",
"type": [
"string",
"null"
],
"format": "date"
},
"suppliers": {
"description": "Fournisseurs actifs de l'article.",
"type": "array",
"items": {
"type": "object",
"properties": {
"tiersId": {
"description": "Identifiant du tiers fournisseur (à passer à get_tiers).",
"type": "integer"
},
"name": {
"description": "Nom du fournisseur.",
"type": [
"string",
"null"
]
},
"reference": {
"description": "Référence de l'article chez le fournisseur.",
"type": [
"string",
"null"
]
},
"denomination": {
"description": "Désignation de l'article chez le fournisseur.",
"type": [
"string",
"null"
]
},
"deliveryDelayDays": {
"description": "Délai de livraison en jours.",
"type": [
"integer",
"null"
]
},
"orderQuantity": {
"description": "Quantité minimale ou multiple de commande.",
"type": [
"integer",
"null"
]
},
"isFavorite": {
"description": "Vrai pour le fournisseur favori.",
"type": "boolean"
},
"price": {
"description": "Prix d'achat chez ce fournisseur (absent sans accès aux données de rentabilité).",
"type": [
"number",
"null"
]
}
},
"required": [
"tiersId"
]
}
},
"components": {
"description": "Pour un ouvrage : les articles qui le composent.",
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"description": "Identifiant de l'article composant.",
"type": "integer"
},
"name": {
"description": "Désignation du composant.",
"type": [
"string",
"null"
]
},
"quantity": {
"description": "Quantité par unité d'ouvrage.",
"type": [
"number",
"null"
]
},
"unit": {
"description": "Unité du composant.",
"type": [
"string",
"null"
]
}
},
"required": [
"itemId"
]
}
},
"id": {
"description": "Identifiant de l'article (à passer à get_item ou get_item_stock).",
"type": "integer"
},
"kind": {
"description": "article (fourniture stockable), job (ouvrage composé d'articles) ou other.",
"type": "string"
},
"name": {
"description": "Désignation.",
"type": [
"string",
"null"
]
},
"internalReference": {
"description": "Référence interne.",
"type": [
"string",
"null"
]
},
"externalReference": {
"description": "Référence externe (fabricant, fournisseur).",
"type": [
"string",
"null"
]
},
"category": {
"description": "Catégorie (matériau, main d'œuvre…).",
"type": [
"string",
"null"
]
},
"family": {
"description": "Famille d'articles.",
"type": [
"string",
"null"
]
},
"brand": {
"description": "Marque.",
"type": [
"string",
"null"
]
},
"unit": {
"description": "Unité de vente.",
"type": [
"string",
"null"
]
},
"salesPrice": {
"description": "Prix de vente unitaire hors TVA, en euros.",
"type": [
"number",
"null"
]
},
"vatRate": {
"description": "Taux de TVA de vente en pourcents.",
"type": [
"number",
"null"
]
},
"isActive": {
"description": "Faux pour un article désactivé.",
"type": "boolean"
},
"stockQuantity": {
"description": "Quantité totale en stock, tous emplacements (articles ; absent sans le module Stock).",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"kind",
"isActive"
]
},
"annotations": {
"title": "Détail d'un article",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}