---
title: "Obtener balance general"
method: POST
path: "/tools/reports_get_general_balance"
tags: ["Reports"]
---

# Obtener balance general

`POST /tools/reports_get_general_balance`

## Request

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

Herramienta MCP: `reports_get_general_balance`.

Devuelve el Estado de Situación Financiera (balance general) en JSON: árboles de cuentas de activos, pasivos, patrimonio y cuentas de orden no nulas, agrupados por fecha de corte, con totales por sección. Puede incluir análisis vertical y horizontal comparando hasta tres periodos adicionales.

Usa el endpoint JSON síncrono: no genera archivos de Excel, CSV ni PDF.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_general_balance",
    "arguments": { "date": "2026-09-30" }
  }
}
```

Úsala cuando el usuario pida el balance general o la situación financiera a una fecha, la composición de activos, pasivos y patrimonio, o una comparación del balance entre varios periodos.

`date` es obligatoria y va en formato YYYY-MM-DD. Para comparar periodos, activa `includeComparativeAnalysis` junto con `periodsCount` entre 1 y 3; `analysisType` en `horizontal` o `both` requiere análisis comparativo, mientras que `vertical` puede usarse solo.

Solo lectura.

## Request body

- object
  - `date` string, required: Fecha de corte del balance, en formato YYYY-MM-DD.
  - `comparisonType` 'month' | 'year' | 'quarter': Granularidad del periodo para generar las fechas de comparación: month, year o quarter. Por defecto month.
  - `periodsCount` integer: Cantidad de periodos anteriores adicionales a comparar (0 a 3). Usa 0 para una sola fecha de corte.
  - `filterZeroBalance` boolean: Oculta las cuentas con saldo cero que no tengan cuentas hijas visibles. Por defecto false.
  - `analysisType` 'none' | 'horizontal' | 'vertical' | 'both': Análisis a incluir: none, horizontal, vertical o both. Horizontal y both requieren análisis comparativo; vertical puede usarse solo. Por defecto none.
  - `includeComparativeAnalysis` boolean: Habilita varios periodos y el análisis comparativo. Requiere `periodsCount` entre 1 y 3. Por defecto false.

## Response `200`

Estado de situación financiera con los árboles de cuentas por fecha de corte

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