---
title: "Obtener ítem"
method: POST
path: "/tools/items_getItem"
tags: ["Items"]
---

# Obtener ítem

`POST /tools/items_getItem`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/items_getItem`
- Auth: HTTP bearer

Herramienta MCP: `items_getItem`.

Devuelve un producto o servicio por su ID, con la opción de incluir campos extra.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "items_getItem",
    "arguments": { "id": "17" }
  }
}
```

Si ya conoces el ID del ítem, prefiere esta herramienta sobre `items_getItems`: es más rápida y devuelve datos más completos. Si no conoces el ID, obténlo primero con `items_getItems`.

`fields` admite campos extra separados por comas. Incluye solo los campos que el usuario pidió explícitamente, nunca de forma especulativa: `itemVariants` y `variantAttributes` (datos de variantes hijas), `inventory` (stock por bodega), `subitems` (componentes de un kit), `images`, `editable,deletable` (verificaciones de gestión y permisos), `settingsOnShop`, `negativeSale`, `remissionedQuantity`, `source`, `simpleSale`, `attachments`, `productKey`, `tariffHeading`, `kitWarehouse`, `ico` y `taxCondition`.

Para consultas de stock (cantidades disponibles), `itemsStock_get_item_stock` y `itemsStock_get_item_stock_summary` son las herramientas adecuadas; usa `fields: "inventory"` solo cuando el usuario pregunte por el stock dentro del detalle del ítem.

Solo lectura.

## Request body

- object
  - `id` string, required: ID del ítem a consultar. Obtén IDs válidos con `items_getItems`.
  - `fields` string: Campos extra separados por comas. Incluye solo los campos que el usuario pidió explícitamente: `itemVariants`, `variantAttributes`, `inventory`, `subitems`, `images`, `editable`, `deletable`, `settingsOnShop`, `negativeSale`, `remissionedQuantity`, `source`, `simpleSale`, `attachments`, `productKey`, `tariffHeading`, `kitWarehouse`, `ico`, `taxCondition`.

## Response `200`

Detalle del ítem

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)