---
title: "Consultar stock de un ítem"
method: POST
path: "/tools/itemsStock_get_item_stock"
tags: ["Items"]
---

# Consultar stock de un ítem

`POST /tools/itemsStock_get_item_stock`

## Request

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

Herramienta MCP: `itemsStock_get_item_stock`.

Devuelve la cantidad de stock de un solo ítem, con desglose opcional por bodega.

Ejemplo de llamada JSON-RPC:

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

Úsala cuando el usuario pregunte por el stock de un ítem concreto ("¿cuántas unidades hay de X?"). Para el stock de varios ítems a la vez, o consultas por condición de existencias, usa `itemsStock_get_item_stock_summary`.

`itemId` es el identificador único del ítem (`idGlobal`); obtén IDs válidos con `items_getItems` o `items_getItem`. `documentDate` es opcional y permite consultar el stock en una fecha histórica concreta (formato `YYYY-MM-DD`).

En la respuesta se muestra siempre el nombre de la bodega (nunca su ID).

Solo lectura.

## Request body

- object
  - `itemId` union, required: ID del ítem, representado por `idGlobal`. Identificador único del ítem.
    - string
    - number
  - `documentDate` string: Fecha del documento en formato `YYYY-MM-DD`. Fecha opcional para consultar el stock en un momento específico.

## Response `200`

Stock 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)