Détail d'un article

Tool nameget_item
Read-onlyIdempotent

Returns an item or assembly: description, sale prices, unit, category, suppliers and composition. The purchase price requires the profitability permission.

Description

Exact text sent to the model by tools/list (French, the language of the data):

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

Parameters

NameTypePresenceDescription
itemIdintegerrequiredIdentifiant 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
NameTypePresenceDescription
descriptionstringnullableDescription de l'article.
barcodestringnullableCode-barres (EAN).
salesPriceIncludingVatnumbernullablePrix de vente unitaire TVA comprise.
purchasePricenumbernullablePrix d'achat unitaire hors TVA (absent sans accès aux données de rentabilité).
mainSupplierstringnullableFournisseur principal.
mainSupplierTiersIdintegernullableIdentifiant du tiers fournisseur principal (à passer à get_tiers).
lastUseDatestring (date)nullableDate de dernière utilisation dans un document.
suppliersobject[]Fournisseurs actifs de l'article.
suppliers[].tiersIdintegerIdentifiant du tiers fournisseur (à passer à get_tiers).
suppliers[].namestringnullableNom du fournisseur.
suppliers[].referencestringnullableRéférence de l'article chez le fournisseur.
suppliers[].denominationstringnullableDésignation de l'article chez le fournisseur.
suppliers[].deliveryDelayDaysintegernullableDélai de livraison en jours.
suppliers[].orderQuantityintegernullableQuantité minimale ou multiple de commande.
suppliers[].isFavoritebooleanVrai pour le fournisseur favori.
suppliers[].pricenumbernullablePrix 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[].namestringnullableDésignation du composant.
components[].quantitynumbernullableQuantité par unité d'ouvrage.
components[].unitstringnullableUnité du composant.
idintegerIdentifiant de l'article (à passer à get_item ou get_item_stock).
kindstringarticle (fourniture stockable), job (ouvrage composé d'articles) ou other.
namestringnullableDésignation.
internalReferencestringnullableRéférence interne.
externalReferencestringnullableRéférence externe (fabricant, fournisseur).
categorystringnullableCatégorie (matériau, main d'œuvre…).
familystringnullableFamille d'articles.
brandstringnullableMarque.
unitstringnullableUnité de vente.
salesPricenumbernullablePrix de vente unitaire hors TVA, en euros.
vatRatenumbernullableTaux de TVA de vente en pourcents.
isActivebooleanFaux pour un article désactivé.
stockQuantitynumbernullableQuantité totale en stock, tous emplacements (articles ; absent sans le module Stock).

MCP annotations

AnnotationValueMeaning
titleDétail d'un articleHuman-readable name shown by the MCP client.
readOnlyHintyesThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintyesCalling it again with the same arguments has no further effect.
openWorldHintnoThe 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
  }
}