# Notas crédito y débito

> Corregir una factura validada con una nota crédito (1 a 6) o débito (1 a 4) por la API de Trevol.

Fuente: https://platform.trevol.si/docs/notas

Una factura validada por la DIAN ya no se cambia. Se corrige con una **nota crédito** (devoluciones, anulaciones, descuentos) o una **nota débito** (intereses, gastos, cambio de valor). Se piden igual que la factura: `POST` con `Idempotency-Key`.

## Nota crédito

`POST /v1/credit_notes` (`createCreditNote`)

#### cURL

```bash
curl -X POST "https://api.trevol.si/v1/credit_notes" \
  -H "Authorization: Bearer $TREVOL_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "external_id": "DEV-2026-000045",
  "concept": "1",
  "description": "Devolución de una unidad por empaque dañado",
  "invoice": {
    "id": "inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b"
  },
  "items": [
    {
      "description": "Café especial 500 g",
      "code": "CAF-500",
      "unit": "94",
      "quantity": "1",
      "unit_price": "32000",
      "taxes": [
        {
          "code": "01",
          "rate": "19"
        }
      ]
    }
  ]
}'
```

[Probar en el Playground](https://platform.trevol.si/playground?op=createCreditNote&ejemplo=devolucion)

- Con una factura de Trevol, la nota usa su cliente si no envías `customer`.
- Trevol revisa **antes de numerar** que la nota crédito no pase del saldo de la factura.
- Conceptos de la DIAN: nota crédito 1 a 6; nota débito 1 a 4.
- `invoice` identifica la factura por `id` (`inv_…`) o por `number` + `cufe` + `issue_date` (para facturas emitidas fuera de Trevol).
- Las notas no admiten moneda extranjera, exportación ni tipos de operación.

## Nota débito

`POST /v1/debit_notes` (`createDebitNote`)

#### cURL

```bash
curl -X POST "https://api.trevol.si/v1/debit_notes" \
  -H "Authorization: Bearer $TREVOL_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "external_id": "INT-2026-000012",
  "concept": "1",
  "description": "Intereses de mora de la factura de septiembre",
  "invoice": {
    "id": "inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b"
  },
  "items": [
    {
      "description": "Intereses de mora",
      "unit": "94",
      "quantity": "1",
      "unit_price": "45000"
    }
  ]
}'
```

[Probar en el Playground](https://platform.trevol.si/playground?op=createDebitNote&ejemplo=intereses)

## Rechazos, reintentos y consultas

Una nota rechazada se corrige con `PUT` y el mismo número; una pendiente o en error se reenvía con `POST …/send`:

`PUT /v1/credit_notes/{id}` (`correctCreditNote`)

#### cURL

```bash
curl -X PUT "https://api.trevol.si/v1/credit_notes/cn_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b" \
  -H "Authorization: Bearer $TREVOL_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "external_id": "DEV-2026-000045",
  "concept": "1",
  "description": "Devolución de una unidad por empaque dañado",
  "invoice": {
    "id": "inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b"
  },
  "items": [
    {
      "description": "Café especial 500 g",
      "code": "CAF-500",
      "unit": "94",
      "quantity": "1",
      "unit_price": "32000",
      "taxes": [
        {
          "code": "01",
          "rate": "19"
        }
      ]
    }
  ]
}'
```

[Probar en el Playground](https://platform.trevol.si/playground?op=correctCreditNote&ejemplo=devolucion)

Consulta y archivos son los de la factura: [Facturas](/docs/facturas) y [Archivos](/docs/archivos). Las referencias completas están en [Notas crédito](/docs/api/credit-notes) y [Notas débito](/docs/api/debit-notes).