Détail d'un article

Nom de l'outilget_item
Lecture seuleIdempotent

Description

Texte exact envoyé au modèle par tools/list :

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

Paramètres

NomTypePrésenceDescription
itemIdintegerobligatoireIdentifiant 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
NomTypePrésenceDescription
descriptionstringpeut être nullDescription de l'article.
barcodestringpeut être nullCode-barres (EAN).
salesPriceIncludingVatnumberpeut être nullPrix de vente unitaire TVA comprise.
purchasePricenumberpeut être nullPrix d'achat unitaire hors TVA (absent sans accès aux données de rentabilité).
mainSupplierstringpeut être nullFournisseur principal.
mainSupplierTiersIdintegerpeut être nullIdentifiant du tiers fournisseur principal (à passer à get_tiers).
lastUseDatestring (date)peut être nullDate de dernière utilisation dans un document.
suppliersobject[]Fournisseurs actifs de l'article.
suppliers[].tiersIdintegerIdentifiant du tiers fournisseur (à passer à get_tiers).
suppliers[].namestringpeut être nullNom du fournisseur.
suppliers[].referencestringpeut être nullRéférence de l'article chez le fournisseur.
suppliers[].denominationstringpeut être nullDésignation de l'article chez le fournisseur.
suppliers[].deliveryDelayDaysintegerpeut être nullDélai de livraison en jours.
suppliers[].orderQuantityintegerpeut être nullQuantité minimale ou multiple de commande.
suppliers[].isFavoritebooleanVrai pour le fournisseur favori.
suppliers[].pricenumberpeut être nullPrix d'achat chez ce fournisseur (absent sans accès aux données de rentabilité).
componentsobject[]Pour un ouvrage : les articles qui le composent.
components[].itemIdintegerIdentifiant de l'article composant.
components[].namestringpeut être nullDésignation du composant.
components[].quantitynumberpeut être nullQuantité par unité d'ouvrage.
components[].unitstringpeut être nullUnité du composant.
idintegerIdentifiant de l'article (à passer à get_item ou get_item_stock).
kindstringarticle (fourniture stockable), job (ouvrage composé d'articles) ou other.
namestringpeut être nullDésignation.
internalReferencestringpeut être nullRéférence interne.
externalReferencestringpeut être nullRéférence externe (fabricant, fournisseur).
categorystringpeut être nullCatégorie (matériau, main d'œuvre…).
familystringpeut être nullFamille d'articles.
brandstringpeut être nullMarque.
unitstringpeut être nullUnité de vente.
salesPricenumberpeut être nullPrix de vente unitaire hors TVA, en euros.
vatRatenumberpeut être nullTaux de TVA de vente en pourcents.
isActivebooleanFaux pour un article désactivé.
stockQuantitynumberpeut être nullQuantité totale en stock, tous emplacements (articles ; absent sans le module Stock).

Annotations MCP

AnnotationValeurSignification
titleDétail d'un articleNom lisible affiché par le client MCP.
readOnlyHintouiL'outil ne modifie rien.
destructiveHintnonL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintouiRappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire.
openWorldHintnonL'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
  }
}