*MCP › Referencia › Finanzas › Tesorería* # Listar pagos de tesorería > Devuelve los cobros y pagos registrados en tesorería, los más recientes primero, con la misma proyección que su GET. Filtra por dirección, tipo, cuenta de tesorería, contacto, factura vinculada, nota de crédito o pedido, conciliación bancaria y fecha de pago. Las notas y el estado de conciliación no se publican. HERRAMIENTA `filmo_treasury_payments_list` · `treasury:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `limit` | integer | No | Tamaño de página (1-500). Por defecto es 50. = `50` | | `cursor` | string | No | Cursor opaco de la página que se devuelve. Pasa el valor de `pagination.nextCursor` de la respuesta anterior; trátalo como opaco. | | `sort` | string | No | Orden: un único campo, con un "-" inicial para descendente (p. ej. "-updatedAt"). Campos ordenables: date, amount, createdAt, updatedAt. Por defecto, "-date". Los empates se resuelven por id, así que el orden es estable entre páginas, y un cursor queda ligado al orden con el que se emitió. | | `direction` | string | No | Filtra por sentido: in (dinero que entra) u out (dinero que sale). `in`, `out` | | `type` | string | No | Filtra por tipo de pago: normal, deposit (un pago anticipado) o transfer (una transferencia interna entre cuentas de tesorería). `normal`, `deposit`, `transfer` | | `types` | string[] | No | Filtra por type, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. `normal`, `deposit`, `transfer` | | `treasuryAccountId` | string | No | Filtra por la cuenta de tesorería por la que pasa el pago. | | `contactId` | string | No | Filtra por el cliente o proveedor del pago. | | `invoiceId` | string | No | Filtra por la factura a la que está asignado el pago. | | `creditNoteId` | string | No | Filtra por la nota de crédito a la que está asignado el pago. | | `orderId` | string | No | Filtra por el pedido al que está asignado el pago. | | `reconciled` | boolean | No | Filtra por conciliación bancaria: true para los pagos conciliados, false para los que siguen pendientes. Si se omite, no se aplica ningún filtro. | | `includeTotal` | boolean | No | Ponlo en true para incluir `pagination.total`, el número de resultados que coinciden con los filtros en todas las páginas. Desactivado por defecto. = `false` | | `dateFilters` | object | No | Filtros de fecha por campo. Una fecha sin hora (YYYY-MM-DD) se lee en la zona horaria del negocio; un instante ISO 8601 con desplazamiento se aplica tal cual con gte, lte, gt y lt, mientras que on lo amplía al día completo del negocio que lo contiene. Campos: date. | | `dateFilters.date` | object | No | | | `dateFilters.date.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.date.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.date.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.date.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.date.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador del pago. | | `direction` | string | in cuando entra dinero (un cobro) y out cuando sale (un pago). | | `amount` | string | Importe del pago como cadena decimal, en la moneda indicada. | | `currency` | string | Moneda del pago, como código ISO 4217. | | `date` | string | Fecha del pago en ISO 8601 UTC. | | `type` | string | normal, o deposit cuando es un pago anticipado. | | `treasuryAccountId` | string | Cuenta de tesorería por la que pasa el pago. | | `contactId` | string | Cliente o proveedor del pago; null si no se ha declarado. | | `reference` | string | Referencia externa del pago; null si no tiene. | | `linkedDocuments` | object[] | Documentos a los que está asignado el pago; vacío si no está vinculado a ninguno. | | `linkedDocuments.type` | string | Tipo del documento vinculado. `invoice`, `creditNote`, `supplierInvoice`, `quote`, `proforma`, `salesReceipt`, `simpleCreditNote`, `purchaseOrder` | | `linkedDocuments.id` | string | Identificador del documento vinculado. | | `linkedDocuments.amount` | string | Importe de este pago asignado al documento, como cadena decimal. | | `createdAt` | string | Fecha de creación en ISO 8601 UTC. | | `updatedAt` | string | Fecha de la última modificación en ISO 8601 UTC. | *Llamada · filmo_treasury_payments_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_treasury_payments_list", "arguments": { "limit": 20 } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "direction": "", "amount": "1234.50", "currency": "EUR", "date": "2026-09-01T08:00:00Z", "type": "", "treasuryAccountId": "trea_8f2a1c", "contactId": "cont_8f2a1c", "reference": "", "linkedDocuments": [ { "type": "invoice", "id": "id_8f2a1c", "amount": "1234.50" } ], "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z" } ], "pagination": { "nextCursor": "eyJvIjo1MH0", "hasMore": true, "total": 1 }, "meta": { "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## La misma operación por REST Esta herramienta ejecuta [`GET /api/v1/treasury/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/list-treasury-payments). --- URL canónica: https://docs.filmo.io/es/mcp/tools/treasury/filmo-treasury-payments-list Última actualización: 2026-10-25