*API REST › Objetos › Finanzas*

# Nota de crédito

> Nota de crédito: lo que se reembolsa al cliente.

Una nota de crédito: lo que se devuelve al cliente, vinculada a la factura que corrige. Su ciclo de vida como documento va de borrador a validada y a anulada, pero `status` es una cadena libre: tolera cualquier valor. Solo se publican los totales; el documento fiscal firmado, el desglose de impuestos, las líneas y el motivo no. Comparte el scope de las facturas.

Esquemas: `CreditNoteDto`

## Atributos

| 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. |

## Valores

| Campo | Valores |
| --- | --- |
| `status` | `draft`, `validated`, `voided` |

## Ejemplo

*Credit note · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "creditNoteNumber": "string",
  "status": "draft",
  "issueDate": "2026-09-01T08:00:00Z",
  "currency": "EUR",
  "contactId": "string",
  "invoiceId": "string",
  "subTotal": "1234.50",
  "taxesPrice": "1234.50",
  "netPrice": "1234.50",
  "grossPrice": "1234.50",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/credit-notes`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/list-credit-notes) — Listar notas de crédito
- [`GET /api/v1/credit-notes/{creditNoteId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/get-a-credit-note) — Obtener una nota de crédito

## Lo modifican

- [`POST /api/v1/credit-notes/{creditNoteId}/validate`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/validate-a-credit-note) — Validar una nota de crédito
- [`POST /api/v1/credit-notes/{creditNoteId}/void`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/void-a-credit-note) — Anular una nota de crédito

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/credit-note  
Última actualización: 2026-10-25