---
title: "Consultar balance de prueba por tercero"
method: POST
path: "/tools/reports_get_third_party_trial_balance"
tags: ["Reports"]
---

# Consultar balance de prueba por tercero

`POST /tools/reports_get_third_party_trial_balance`

## Request

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

Herramienta MCP: `reports_get_third_party_trial_balance`.

Devuelve el balance de prueba por tercero como un árbol JSON anidado: raíces del catálogo (activos, pasivos, patrimonio, ingresos, gastos, etc.) con `previousBalance`, `debit`, `credit` y `finalBalance` (montos como cadenas decimales), cuentas hijas según la jerarquía PUC y líneas `thirdPartyLines` bajo las cuentas que desglosan por contacto o por tercero no asociado.

`rowsCount` es la cantidad de terceros con movimientos en el periodo (no el total de contactos de la compañía). Un resultado vacío (`rowsCount` 0 y `data` vacía) es válido cuando no hay movimientos o el tercero filtrado no los tiene.

Usa el endpoint JSON síncrono: no genera un archivo de Excel exportable.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_third_party_trial_balance",
    "arguments": { "fromDate": "2026-01-01", "toDate": "2026-01-31" }
  }
}
```

Úsala cuando el usuario pida el balance de prueba por tercero, los saldos por cliente o proveedor con débitos y créditos del periodo, o el movimiento de un contacto específico mediante el filtro `idClient`.

Las fechas `fromDate` y `toDate` son obligatorias y van en formato YYYY-MM-DD.

Solo lectura.

## Request body

- object
  - `fromDate` string, 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").
  - `toDate` string, 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").
  - `idClient` string: Filtro opcional por ID de tercero (contacto). Si el contacto no tiene movimientos en el periodo, la respuesta queda vacía (`rowsCount` 0).

## Response `200`

Balance de prueba por tercero como árbol JSON anidado

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