ALalegra
Items

Listar categorías de ítems

Herramienta MCP: itemCategories_getItemCategories.

Devuelve la lista de categorías de productos y servicios, con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "itemCategories_getItemCategories",
    "arguments": { "start": 0, "limit": 30 }
  }
}

Úsala para descubrir las categorías disponibles o buscar una por nombre cuando no conoces su ID. Si ya conoces el ID, prefiere itemCategories_getItemCategory: es más rápida y devuelve datos más completos.

fields admite valores separados por comas: editable, deletable y status. order_field (por ejemplo name) y order_direction solo se envían cuando el usuario pide explícitamente un orden.

Paginación con start (desplazamiento desde 0) y limit (cantidad de resultados por página; no la superes por encima de 30, que es el máximo permitido). Con metadata: true la respuesta incluye el total de categorías.

Solo lectura.

post/tools/itemCategories_getItemCategories

Request

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

Request body

limitinteger

Cantidad máxima de categorías a devolver. No la superes por encima de 30: es el máximo permitido.

startinteger

Desplazamiento de paginación (desde 0).

metadataboolean

Si es true, la respuesta incluye metadatos con el total de categorías.

namestring

Filtra las categorías por nombre.

fieldsstring

Campos extra separados por comas (por ejemplo editable,deletable,status).

order_direction'ASC' | 'DESC'

Dirección del orden.

order_fieldstring

Campo por el que ordenar (por ejemplo name).

Response

Lista de categorías de ítems

Changes

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