Reports

Listar exportables

Herramienta MCP: reports_list_exportables.

Devuelve el historial de exportaciones de reportes de la compañía de los últimos 15 días, con su estado (IN_PROCESS, FINISHED, FAILED), filtros, fechas, progreso y nombre de archivo. Solo los exportables en estado FINISHED han terminado de generarse.

Paginación por cursor opaco: si metadata.to no es null, hay más páginas; llama de nuevo enviando from con ese valor. Los administradores ven los exportables de toda la compañía salvo que envíen own en true; los demás roles solo ven los suyos.

Úsala para descubrir exportables y obtener el idExportable que necesita reports_get_exportable: es siempre el paso previo a consultar uno. Si el usuario pregunta cómo va una exportación, si está lista o por sus filtros, consulta reports_get_exportable con el ID obtenido aquí. Esta herramienta devuelve estado y metadatos de las exportaciones, no el contenido de los archivos.

Al reportar el progreso de una exportación usa únicamente el campo progress (por ejemplo, "va en 67%"); nunca menciones fracciones (4/6), conteos, tareas ni valores inventados a partir del porcentaje.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_list_exportables",
    "arguments": {}
  }
}

Todos los parámetros son opcionales: sin ellos devuelve la primera página del historial de los últimos 15 días.

Solo lectura.

post/tools/reports_list_exportables

Request

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

Request body

limitinteger

Tamaño de la página. Si se omite, se usa el valor por defecto de la API.

fromstring

Cursor opaco de paginación (metadata.to de la página anterior). Omítelo en la primera página.

ownboolean

Si es true, devuelve solo los exportables del usuario autenticado, incluso para administradores. Por defecto false (los administradores ven toda la compañía).

Response

Página del historial de exportables de los últimos 15 días

Changes

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