---
title: "Consultar cuentas por pagar"
method: POST
path: "/tools/reports_get_payables"
tags: ["Reports"]
---

# Consultar cuentas por pagar

`POST /tools/reports_get_payables`

## Request

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

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:

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

## Request body

- object
  - `asOf` string, required: Fecha de corte del reporte, en formato YYYY-MM-DD. Obligatoria; las facturas de compra abiertas se evalúan a esa fecha.
  - `customerId` string: Filtra por ID de proveedor. Úsalo cuando el usuario nombre un proveedor específico.
  - `billNumber` string: Filtra por número del documento de compra.
  - `date` string: Filtra por fecha de emisión de la factura de compra, en formato YYYY-MM-DD.
  - `dueDate` string: Filtra por fecha de vencimiento de la factura de compra, en formato YYYY-MM-DD.

## Response `200`

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

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)