Items

Resumir stock por condición

Herramienta MCP: itemsStock_get_item_stock_summary.

Devuelve el stock de varios ítems según una condición de existencias (stock negativo, en cero, bajo o actual).

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "itemsStock_get_item_stock_summary",
    "arguments": { "stockCondition": "LOW_STOCK", "stockThreshold": 10 }
  }
}

Úsala para preguntas de stock sobre varios ítems ("¿qué productos tienen stock negativo?", "¿cuáles están en cero?"). Para el stock de un solo ítem, usa itemsStock_get_item_stock.

stockCondition es obligatorio. stockThreshold aplica solo con la condición LOW_STOCK y se usa cuando el usuario menciona un umbral (por ejemplo, "stock bajo menor de 10").

Paginación con start (desplazamiento desde 0) y limit (máximo 30 registros, por defecto 30). Ten en cuenta que metadata.total refleja el conteo sin filtrar y puede ser mayor que los resultados devueltos; las entradas sin nombre de ítem (ítems eliminados o categorías contables) se excluyen automáticamente. Si una página viene vacía pero metadata.total es mayor que cero, continúa con la siguiente página incrementando start en limit; no intentes recorrer todas las páginas: consulta como máximo dos y comunica al usuario que puede haber más resultados.

En la respuesta se muestra siempre el nombre de la bodega (nunca su ID); usa las demás herramientas para resolver nombres a partir de IDs de ítems.

Solo lectura.

post/tools/itemsStock_get_item_stock_summary

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/itemsStock_get_item_stock_summary
  • Auth
    HTTP bearer

Request body

stockCondition'NEGATIVE_STOCK' | 'ZERO_STOCK' | 'LOW_STOCK' | 'CURRENT_STOCK' required

Condición para filtrar el resumen de stock.

stockThresholdnumber

Umbral de stock, excluyente para la condición LOW_STOCK. Úsalo solo cuando stockCondition es LOW_STOCK y el usuario menciona un umbral (por ejemplo, "stock de ítems con stock bajo menor de 10").

limitinteger

Cantidad máxima de registros a devolver (entre 1 y 30).

startinteger

Índice del primer registro devuelto (desde 0).

Response

Resumen de stock por condición

Changes

No recorded changes to this operation across all 1 revision of this API.