---
title: "Listar entradas del libro mayor"
method: POST
path: "/tools/ledger_listLedgerEntries"
tags: ["Ledger"]
---

# Listar entradas del libro mayor

`POST /tools/ledger_listLedgerEntries`

## Request

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

Herramienta MCP: `ledger_listLedgerEntries`.

Lista las entradas del libro mayor de Alegra de forma paginada y filtrable, con filtros por rango de fechas, tipo de recurso, centro de costos y número de comprobante, además de ordenamiento.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ledger_listLedgerEntries",
    "arguments": { "from": "2026-09-01", "to": "2026-09-30", "resourceType": "invoice,journal" }
  }
}
```

Paginación con `page` (por defecto 1) y `limit` (máximo 5 resultados por página, 5 por defecto). Con `format` eliges `flat` (por defecto), que omite el array anidado `entries` de cada ítem para reducir el tamaño de la respuesta, o `full`, que incluye las entradas completas.

Ordena con `order_field` (por defecto `date`; valores pendientes de verificar con una llamada real) y `order_direction` (`ASC` o `DESC`, descendente por defecto). Filtra por rango de fechas con `from` y `to` (YYYY-MM-DD), por tipos de recurso con `resourceType` (separados por coma: `account`, `advanceAppliedJournal`, `bill`, `billDebit`, `billPayment`, `creditNote`, `debitNote`, `incomeDebitNote`, `inventoryAdjustment`, `invoice`, `invoiceCredit`, `invoicePayment`, `item`, `journal`, `retentionApplied`, `transaction`, `transactionIn` o `transactionOut`), por centros de costos con `costCenter_id` (IDs locales separados por coma; el servidor no convierte a IDs globales, así que los resultados pueden no coincidir si envías IDs globales) y por número de comprobante con `number`.

Con `fields` puedes solicitar campos adicionales separados por coma (por ejemplo `url,total`).

Úsala como punto de partida para descubrir los `resourceType` y `resourceId` que necesita `ledger_getLedgerEntry`.

Solo lectura.

## Request body

- object
  - `page` integer: Número de página. Por defecto 1.
  - `limit` integer: Cantidad de ítems por página. Máximo 5, por defecto 5.
  - `format` 'flat' | 'full': flat (por defecto) omite las entradas anidadas de cada ítem; full incluye el array completo de entradas.
  - `order_field` string: Campo por el cual ordenar. Por defecto date. Valores pendientes de verificar con una llamada real.
  - `order_direction` 'ASC' | 'DESC': Dirección de ordenamiento: ASC o DESC (por defecto DESC).
  - `from` string: Fecha inicial del filtro en formato YYYY-MM-DD.
  - `to` string: Fecha final del filtro en formato YYYY-MM-DD.
  - `resourceType` string: Tipos de recurso separados por coma: account, advanceAppliedJournal, bill, billDebit, billPayment, creditNote, debitNote, incomeDebitNote, inventoryAdjustment, invoice, invoiceCredit, invoicePayment, item, journal, retentionApplied, transaction, transactionIn, transactionOut.
  - `costCenter_id` string: IDs locales de centros de costos separados por coma. El servidor no convierte a IDs globales; los resultados pueden no coincidir si se envían IDs globales.
  - `number` string: Filtra por número de comprobante.
  - `fields` string: Campos adicionales a incluir, separados por coma (por ejemplo url,total).

## Response `200`

Lista paginada de entradas del libro mayor

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