ALalegra
Reports

Consultar estado de resultados

Herramienta MCP: reports_get_profit_and_loss.

Devuelve el Estado de Resultados de la compañía para un rango de fechas, como un árbol jerárquico de cuentas (ingresos, costo, costo de producción y gastos) con saldos por periodo, análisis vertical y horizontal con variaciones comparativas, y filas de totales con el resultado neto.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_profit_and_loss",
    "arguments": { "from": "2026-01-01", "to": "2026-09-30" }
  }
}

Úsala cuando el usuario pida el estado de resultados, las utilidades o pérdidas de un periodo, el detalle de ingresos, costos y gastos con análisis comparativo, o el resultado neto del negocio.

Las fechas from y to son obligatorias y van en formato YYYY-MM-DD. Por defecto el reporte incluye asientos de cierre, análisis comparativo contra periodos anteriores, análisis horizontal y vertical, cuentas con saldo cero y el código contable de cada cuenta; todos esos parámetros son opcionales y pueden ajustarse según lo que pida el usuario.

Los parámetros useNewApi, useInventoryParallel, maxParallelRequests, maxParallelItems, forceInventoryParallel y forceSummary son de uso avanzado: controlan el motor y el rendimiento internos del reporte. Recomendación: no los envíes, déjalos sin definir.

Solo lectura.

post/tools/reports_get_profit_and_loss

Request

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

Request body

fromstring required

Fecha inicial del periodo, en formato YYYY-MM-DD. Calcúlala a partir de la consulta del usuario (por ejemplo, "enero de 2026" → "2026-01-01").

tostring required

Fecha final del periodo, en formato YYYY-MM-DD. Calcúlala a partir de la consulta del usuario (por ejemplo, "2026" → "2026-12-31").

costCenterIdstring

Filtra el reporte por centro de costo. Úsalo solo cuando el usuario pida filtrar por un centro de costo específico.

includeClosingPeriodsboolean

Incluye los movimientos de los periodos de cierre (asientos de cierre). Por defecto true.

includeComparativeAnalysisboolean

Incluye análisis comparativo contra periodos anteriores (variación absoluta y relativa). Por defecto true.

periodsToCompareCountinteger

Cuántos periodos anteriores comparar. Por defecto 1.

comparisonType'years' | 'months' | 'quarters'

Granularidad para construir los periodos de comparación: years, months o quarters. years es la opción más confiable. Por defecto years.

sortBy'asc' | 'desc'

Dirección de ordenamiento de las filas del reporte: asc o desc. Por defecto desc.

decimalPrecisioninteger

Número de decimales para los montos, de 0 a 6. Por defecto 0.

includeHorizontalAnalysisboolean

Incluye análisis horizontal (variación entre periodos). Por defecto true.

includeVerticalAnalysisboolean

Incluye análisis vertical (porcentaje sobre ingresos o total). Por defecto true.

includeZeroBalanceAccountsboolean

Incluye las cuentas cuyo saldo es cero. Por defecto true.

contableCodeboolean

Incluye el código contable de cada cuenta. Por defecto true.

useNewApistring

Selector del motor de reportes (uso avanzado). Déjalo sin definir salvo petición explícita.

useInventoryParallelboolean

Uso avanzado: activa el procesamiento de inventarios en paralelo. Recomendación: no lo envíes. Por defecto false.

maxParallelRequestsinteger

Uso avanzado: máximo de solicitudes en paralelo. Recomendación: no lo envíes. Por defecto 50.

maxParallelItemsinteger

Uso avanzado: máximo de ítems en paralelo. Recomendación: no lo envíes. Por defecto 100.

forceInventoryParallelboolean

Uso avanzado: fuerza el procesamiento de inventarios en paralelo. Recomendación: no lo envíes. Por defecto false.

forceSummaryboolean

Uso avanzado: fuerza una versión resumida del reporte. Recomendación: no lo envíes. Por defecto false.

Response

Estado de resultados del periodo con árbol de cuentas y análisis

Changes

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