Listar pagos recibidos
Herramienta MCP: incomePayments_getIncomePayments.
Devuelve los pagos registrados en el libro de pagos de ingresos, con paginación (hasta 30 por página) y filtros. Por defecto devuelve una versión ligera de cada pago; con detail: true devuelve el payload completo.
Ejemplo de llamada JSON-RPC:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "incomePayments_getIncomePayments",
"arguments": { "start": 0, "limit": 30 }
}
}
Paginación con start (cantidad de resultados a omitir) y limit (máximo 30 por página). Ordena con order_direction (ASC o DESC), busca por texto con query y filtra por dirección del pago con type: in para pagos recibidos (de clientes) o out para pagos salidas registrados en este mismo libro de pagos; úsala para listar "pagos" o "recibos" en cualquiera de las dos direcciones. Con fields amplías los campos de la respuesta y con metadata: true la respuesta se envuelve como { data: [...], metadata: { total } } en lugar de un arreglo plano. Con detail: false (valor por defecto) cada pago viene en versión ligera (ids, fechas, estado, número, cliente y montos); pide detail: true solo cuando el usuario pida el payload completo.
Para localizar un pago que el usuario identifica por su número visible, filtra con number: es una coincidencia por subcadena (por ejemplo "380" también coincide con "1000380"), no exacta, y NO es el id interno que usa incomePayments_getIncomePaymentById. Envía siempre el número completo que dio el usuario y, antes de usar el id devuelto, verifica que la respuesta tenga exactamente un resultado (metadata.total === 1) y que su campo number coincida exactamente con el buscado; si hay varias coincidencias, muéstralas y pide al usuario desambiguar.
Úsala para descubrir los id de los pagos que necesita incomePayments_getIncomePaymentById.
Solo lectura.
Request
- Base URLhttps://mcp.alegra.com
- URLhttps://mcp.alegra.com/tools/incomePayments_getIncomePayments
- AuthHTTP bearer
Request body
Response
Lista de pagos recibidos (versión ligera)
Changes
No recorded changes to this operation across all 1 revision of this API.