Reports

Consultar cuentas por cobrar

Herramienta MCP: reports_get_receivables.

Devuelve las cuentas por cobrar como una lista paginada de facturas abiertas a una fecha de corte. Cada fila incluye el número del documento, el tipo de documento, el nombre del cliente, el saldo pendiente (missingAmount), el total pagado (totalPayed), el total, las fechas de emisión y vencimiento y el estado de emisión.

Devuelve como máximo 20 facturas (solo la primera página); las páginas adicionales no están expuestas por parámetros del MCP. Usa metadata.total para saber cuántas facturas coinciden con el reporte en total.

Úsala cuando el usuario pida el detalle factura por factura de las cuentas por cobrar: qué clientes deben, cuánto y con qué vencimientos, o listas filtradas por cliente, número o fechas. Para preguntas del tipo "¿cuánto nos deben en total?" usa reports_get_receivables_summary en su lugar.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_receivables",
    "arguments": { "asOf": "2026-09-30" }
  }
}

El parámetro asOf es obligatorio y va en formato YYYY-MM-DD; las facturas abiertas se evalúan a esa fecha de corte.

Solo lectura.

post/tools/reports_get_receivables

Request

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

Request body

asOfstring required

Fecha de corte del reporte, en formato YYYY-MM-DD. Obligatoria; las facturas abiertas se evalúan a esa fecha.

customerIdstring

Filtra por ID de cliente. Úsalo cuando el usuario nombre un cliente específico; las listas exponen el cliente como clientName.

numberstring

Filtra por número de la factura.

datestring

Filtra por fecha de emisión de la factura, en formato YYYY-MM-DD.

dueDatestring

Filtra por fecha de vencimiento de la factura, en formato YYYY-MM-DD.

Response

Lista paginada de facturas abiertas a la fecha de corte

Changes

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