Détail d'un article
Nom de l'outil
get_itemLecture seuleIdempotent
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é.
Accès requis
- Permission :
item-job.list.view - 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 |
|---|---|---|---|
description | string | peut être null | Description de l'article. |
barcode | string | peut être null | Code-barres (EAN). |
salesPriceIncludingVat | number | peut être null | Prix de vente unitaire TVA comprise. |
purchasePrice | number | peut être null | Prix d'achat unitaire hors TVA (absent sans accès aux données de rentabilité). |
mainSupplier | string | peut être null | Fournisseur principal. |
mainSupplierTiersId | integer | peut être null | Identifiant du tiers fournisseur principal (à passer à get_tiers). |
lastUseDate | string (date) | peut être null | 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 | peut être null | Nom du fournisseur. |
suppliers[].reference | string | peut être null | Référence de l'article chez le fournisseur. |
suppliers[].denomination | string | peut être null | Désignation de l'article chez le fournisseur. |
suppliers[].deliveryDelayDays | integer | peut être null | Délai de livraison en jours. |
suppliers[].orderQuantity | integer | peut être null | Quantité minimale ou multiple de commande. |
suppliers[].isFavorite | boolean | Vrai pour le fournisseur favori. | |
suppliers[].price | number | peut être null | 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 | peut être null | Désignation du composant. |
components[].quantity | number | peut être null | Quantité par unité d'ouvrage. |
components[].unit | string | peut être null | 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 | peut être null | Désignation. |
internalReference | string | peut être null | Référence interne. |
externalReference | string | peut être null | Référence externe (fabricant, fournisseur). |
category | string | peut être null | Catégorie (matériau, main d'œuvre…). |
family | string | peut être null | Famille d'articles. |
brand | string | peut être null | Marque. |
unit | string | peut être null | Unité de vente. |
salesPrice | number | peut être null | Prix de vente unitaire hors TVA, en euros. |
vatRate | number | peut être null | Taux de TVA de vente en pourcents. |
isActive | boolean | Faux pour un article désactivé. | |
stockQuantity | number | peut être null | Quantité totale en stock, tous emplacements (articles ; absent sans le module Stock). |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Détail 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",
"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
}
}