Accounting

Listar comprobantes contables

Herramienta MCP: accounting_listJournals.

Lista los comprobantes contables de la compañía con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounting_listJournals",
    "arguments": { "limit": 10 }
  }
}

Soporta paginación por start y limit (hasta 30 por página, 30 por defecto), orden con order_field y order_direction (ASC o DESC, ascendente por defecto), y filtros por fecha exacta con date (YYYY-MM-DD), cliente con client_name o client_id, texto parcial con reference u observations, numeración con id o number, tipo de comprobante con type (por ejemplo closing-period) y estado con status (open o void).

Con fields puedes ampliar cada comprobante con información adicional separada por comas (type, numberTemplate) y con format: simple se omite el detalle pesado de las líneas del comprobante.

Úsala como punto de partida para descubrir los id de los comprobantes que necesitan accounting_getJournal o accounting_getJournalEntriesGraph, o para revisar los comprobantes de una fecha o cliente concretos.

Solo lectura.

post/tools/accounting_listJournals

Request

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

Request body

startinteger

Desde qué comprobante consultar (0 para la primera página).

limitinteger

Cantidad de comprobantes a retornar. Máximo 30, por defecto 30.

order_direction'ASC' | 'DESC'

Orden ascendente o descendente. Por defecto ASC.

order_fieldstring

Campo por el cual ordenar: date, name, reference u observations. Valores pendientes de verificar con una llamada real.

datestring

Filtra por fecha exacta del comprobante en formato YYYY-MM-DD.

client_namestring

Filtra por nombre del cliente (búsqueda parcial).

referencestring

Filtra por referencia (búsqueda parcial).

observationsstring

Filtra por observaciones (búsqueda parcial).

client_idstring

Filtra por id del cliente.

idstring

Filtra por número del comprobante.

numberstring

Filtra por numeración del comprobante.

typestring

Filtra por tipo de comprobante, por ejemplo closing-period. Valores pendientes de verificar con una llamada real.

status'open' | 'void'

Filtra por estado del comprobante: open o void.

fieldsstring

Campos adicionales separados por coma: type, numberTemplate.

format'simple'

Formato simple para evitar cargar líneas/detalle pesado del comprobante.

Response

Lista de comprobantes contables

Changes

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