Reports

Consultar balance de prueba

Herramienta MCP: reports_get_trial_balance.

Devuelve el balance de prueba (también llamado balance de comprobación o sumas y saldos) como un árbol jerárquico de cuentas contables: raíces del catálogo (activos, pasivos, patrimonio, ingresos, gastos, etc.), totales del periodo (totalDebit, totalCredit y un saldo deudor o acreedor según la naturaleza de la cuenta) y saldos previos anteriores a la fecha inicial (previousTotals).

Usa el endpoint JSON síncrono: no genera un archivo exportable. Para filtrar el árbol por nombre de cuenta, usa el parámetro accountName, que aplica después de la llamada: los nodos que coinciden conservan su subárbol completo y sus ancestros se conservan para mantener la ruta del árbol intacta.

Ejemplo de llamada JSON-RPC:

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

Úsala cuando el usuario pida el balance de prueba o de comprobación, las sumas y saldos de un periodo, o el detalle de débitos y créditos por cuenta contable.

Las fechas from y to son obligatorias y van en formato YYYY-MM-DD.

Solo lectura.

post/tools/reports_get_trial_balance

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/reports_get_trial_balance
  • 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, "enero de 2026" → "2026-01-31").

idCostCenterinteger

ID local del centro de costo para filtrar el libro mayor por ese centro de costo.

accountNamestring

Filtro sin distinción de mayúsculas sobre el nombre de la cuenta (name/text).

Response

Balance de prueba como árbol jerárquico de cuentas contables

Changes

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