Ledger

Listar entradas del libro mayor

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:

{
  "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.

post/tools/ledger_listLedgerEntries

Request

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

Request body

pageinteger

Número de página. Por defecto 1.

limitinteger

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_fieldstring

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

fromstring

Fecha inicial del filtro en formato YYYY-MM-DD.

tostring

Fecha final del filtro en formato YYYY-MM-DD.

resourceTypestring

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_idstring

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.

numberstring

Filtra por número de comprobante.

fieldsstring

Campos adicionales a incluir, separados por coma (por ejemplo url,total).

Response

Lista paginada de entradas del libro mayor

Changes

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