*MCP › Referencia › Finanzas › Abonos*

# Listar notas de crédito

> Devuelve las notas de crédito emitidas a clientes, paginadas por cursor: qué se reembolsa y contra qué factura.

Filtra por estado del ciclo de vida, contacto, pedido de origen, proyecto, factura rectificada y fecha de emisión. El documento fiscal firmado, el desglose de impuestos, las líneas y el motivo de la corrección no se publican. Ordenadas por fecha de emisión, las más recientes primero.

HERRAMIENTA `filmo_credit_notes_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, grossPrice. 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ó. |
| `status` | string | No | Filtra por estado del ciclo de vida del documento: 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 al que se emite la nota de crédito. |
| `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 nota de crédito. |
| `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 nota de crédito. |
| `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. |
| `invoiceId` | string | No | Filtra por identificador de la factura que rectifica la nota de crédito. |
| `invoiceIds` | string[] | No | Filtra por invoiceId, 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 nota de crédito. |
| `creditNoteNumber` | string | Número de la nota de crédito; null mientras es un borrador. |
| `status` | string | Estado del ciclo de vida del documento: draft, validated o voided (los mismos valores que admite el filtro `status`). `draft`, `validated`, `voided` |
| `issueDate` | string<date-time> | Fecha de emisión en ISO 8601 UTC; null si no consta. |
| `currency` | string | Moneda, como código ISO 4217. |
| `contactId` | string | Contacto al que se emite la nota de crédito; null si no consta. |
| `invoiceId` | string | Factura que rectifica esta nota de crédito; null si no está asociada a ninguna. |
| `subTotal` | string | Subtotal antes de descuentos e impuestos, 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. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC. |

*Llamada · filmo_credit_notes_list*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_credit_notes_list",
    "arguments": {
      "limit": 20
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "creditNoteNumber": "<creditNoteNumber>",
        "status": "draft",
        "issueDate": "2026-09-01T08:00:00Z",
        "currency": "EUR",
        "contactId": "cont_8f2a1c",
        "invoiceId": "invo_8f2a1c",
        "subTotal": "1234.50",
        "taxesPrice": "1234.50",
        "netPrice": "1234.50",
        "grossPrice": "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/credit-notes`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/list-credit-notes).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/credit-notes/filmo-credit-notes-list  
Última actualización: 2026-10-25