Reports

Consultar cuentas por pagar

Herramienta MCP: reports_get_payables.

Devuelve las cuentas por pagar como una lista paginada de facturas de compra abiertas a una fecha de corte. Cada fila incluye el número de la factura de compra (billNumber), el tipo de documento, el nombre del proveedor, el saldo pendiente (missingAmount), el total pagado (totalPayed), el total, las fechas de emisión y vencimiento, el prefijo 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 pagar: a qué proveedores se les debe, cuánto y con qué vencimientos, o listas filtradas por proveedor, número o fechas. Para preguntas del tipo "¿cuánto debemos en total?" usa reports_get_payables_summary en su lugar.

Ejemplo de llamada JSON-RPC:

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

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

Solo lectura.

post/tools/reports_get_payables

Request

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

Request body

asOfstring required

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

customerIdstring

Filtra por ID de proveedor. Úsalo cuando el usuario nombre un proveedor específico.

billNumberstring

Filtra por número del documento de compra.

datestring

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

dueDatestring

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

Response

Lista paginada de facturas de compra abiertas a la fecha de corte

Changes

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