*MCP › Referencia › Finanzas › Facturas de proveedor* # Listar facturas de proveedor > Devuelve las facturas recibidas de proveedores, paginadas por cursor, con la misma ficha compacta que la lectura de detalle. Filtra por estado dentro del ciclo de compras, contacto proveedor, pedido de venta vinculado, proyecto, fecha de factura y fecha de vencimiento. Ordenadas por fecha de factura, las más recientes primero. HERRAMIENTA `filmo_supplier_invoices_list` · `supplier-invoices:read` · 120/min · Puede requerir un add-on · 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, invoiceDate, dueDate. Por defecto, "-invoiceDate". 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ó. | | `status` | string | No | Filtra por estado dentro del ciclo de compras: draft, validated o voided. `draft`, `validated`, `voided` | | `statuses` | string[] | No | Filtra por status, 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. `draft`, `validated`, `voided` | | `contactId` | string | No | Filtra por identificador del contacto proveedor que emitió la factura. | | `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 venta al que está vinculada la factura. | | `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 factura, 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, due, invoiceDate, 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.due` | object | No | | | `dateFilters.due.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.due.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.due.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.due.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.due.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.invoiceDate` | object | No | | | `dateFilters.invoiceDate.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.invoiceDate.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.invoiceDate.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.invoiceDate.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.invoiceDate.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 factura de proveedor. | | `supplierInvoiceNumber` | string | Número que el proveedor puso en la factura; null si no se registró. | | `status` | string | Estado de la factura dentro del ciclo de compras. | | `createdAt` | string | Fecha de creación en ISO 8601 UTC. | | `updatedAt` | string | Fecha de la última modificación en ISO 8601 UTC. | *Llamada · filmo_supplier_invoices_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_supplier_invoices_list", "arguments": { "limit": 20 } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "supplierInvoiceNumber": "", "status": "", "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/supplier-invoices`](https://docs.filmo.io/es/rest-api/endpoint-reference/supplier-invoices/list-supplier-invoices). --- URL canónica: https://docs.filmo.io/es/mcp/tools/supplier-invoices/filmo-supplier-invoices-list Última actualización: 2026-10-25