*MCP › Referencia › Finanzas › Proformas* # Listar proformas > Devuelve las proformas de la cuenta, paginadas por cursor, con la misma ficha que la lectura de detalle: número, estado del ciclo de vida y comercial, cliente (id y nombre), pedido de origen, proyecto, divisa e importes. Las líneas, las direcciones y las notas no se publican. Filtra por estado comercial (pending, confirmed, cancelled), contacto, pedido de origen, proyecto y fecha de emisión. Ordenadas por fecha de emisión, las más recientes primero. Comparte scope con las facturas porque una proforma es la factura que todavía no lo es. HERRAMIENTA `filmo_proformas_list` · `invoices: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: hasta 3 campos separados por comas, cada uno con un "-" inicial para descendente (p. ej. "-updatedAt,name"). Campos ordenables: createdAt, updatedAt, issueDate, proformaNumber. Por defecto, "-issueDate". 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ó. | | `operativeStatus` | string | No | Filtra por estado comercial: pending (a la espera de respuesta), confirmed (aceptado por el cliente) o cancelled (rechazado o cancelado). `pending`, `confirmed`, `cancelled` | | `operativeStatuses` | string[] | No | Filtra por operativeStatus, 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. `pending`, `confirmed`, `cancelled` | | `contactId` | string | No | Filtra por identificador del contacto al que se emite la proforma. | | `contactIds` | string[] | No | Filtra por contactId, 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. | | `orderId` | string | No | Filtra por identificador del pedido de origen de la proforma. | | `orderIds` | string[] | No | Filtra por orderId, 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. | | `projectId` | string | No | Filtra por identificador del proyecto vinculado a la proforma, directamente o a través de su pedido. | | `projectIds` | string[] | No | Filtra por projectId, 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. | | `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: created, issueDate, updated. | | `dateFilters.created` | object | No | | | `dateFilters.created.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.created.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.created.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.created.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.created.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.issueDate` | object | No | | | `dateFilters.issueDate.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.issueDate.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.issueDate.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.issueDate.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.issueDate.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.updated` | object | No | | | `dateFilters.updated.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.updated.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.updated.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.updated.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.updated.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 de la proforma. | | `proformaNumber` | string | Número de la proforma; null mientras es un borrador. | | `status` | string | Estado del ciclo de vida del documento. | | `operativeStatus` | string | Estado comercial: pending (a la espera de respuesta), confirmed (aceptado por el cliente) o cancelled; null si no consta. | | `issueDate` | string | Fecha de emisión en ISO 8601 UTC; null mientras no tiene. | | `currency` | string | Moneda de los importes, como código ISO 4217. | | `contact` | object | Contacto al que se emite la proforma; null si no consta. | | `contact.id` | string | Identificador del contacto. | | `contact.name` | string | Nombre del contacto. | | `orderId` | string | Pedido de origen de la proforma; null si no procede de uno. | | `orderNumber` | string | Número de ese pedido; null si no procede de uno. | | `projectId` | string | Proyecto vinculado a la proforma; null si no hay ninguno. | | `subTotal` | string | Subtotal antes de descuentos e impuestos, como cadena decimal. | | `discountTotal` | string | Total de descuentos, como cadena decimal. | | `taxesPrice` | string | Total de impuestos, como cadena decimal. | | `netPrice` | string | Base imponible, como cadena decimal. | | `grossPrice` | string | Total con impuestos, como cadena decimal. | | `totalPaid` | string | Pagos anticipados recibidos contra la proforma, como cadena decimal; null si no consta ninguno. | | `createdAt` | string | Fecha de creación en ISO 8601 UTC. | | `updatedAt` | string | Fecha de la última modificación en ISO 8601 UTC. | *Llamada · filmo_proformas_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_proformas_list", "arguments": { "limit": 20 } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "proformaNumber": "", "status": "", "operativeStatus": "", "issueDate": "2026-09-01T08:00:00Z", "currency": "EUR", "contact": { "id": "id_8f2a1c", "name": "Example" }, "orderId": "orde_8f2a1c", "orderNumber": "", "projectId": "proj_8f2a1c", "subTotal": "1234.50", "discountTotal": "1234.50", "taxesPrice": "1234.50", "netPrice": "1234.50", "grossPrice": "1234.50", "totalPaid": "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/proformas`](https://docs.filmo.io/es/rest-api/endpoint-reference/proformas/list-proformas). --- URL canónica: https://docs.filmo.io/es/mcp/tools/proformas/filmo-proformas-list Última actualización: 2026-10-25