Reports

Totalizar cuentas por cobrar

Herramienta MCP: reports_get_receivables_summary.

Devuelve los totales agregados de las cuentas por cobrar a una fecha de corte, en un único objeto de resumen: missingAmount (saldo total pendiente de cobro), totalDocuments (cantidad de facturas abiertas incluidas), total (suma de los totales de las facturas) y totalRetentions (suma de retenciones aplicadas; en algunos backends incluye además totalDebitNotes con el total de notas débito).

Úsala cuando el usuario pregunte por los totales de las cuentas por cobrar o el saldo global pendiente de los clientes, del tipo "¿cuánto nos deben?", sin necesitar cada factura. Para el detalle factura por factura usa reports_get_receivables en su lugar.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_receivables_summary",
    "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_summary

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/reports_get_receivables_summary
  • 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 pida los totales de las cuentas por cobrar de un cliente específico.

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

Resumen agregado de las cuentas por cobrar a la fecha de corte

Changes

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