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.

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

cURL

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

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

cURL

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

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}

cURL

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

Consulta y archivos son los de la factura: Facturas y Archivos. Las referencias completas están en Notas crédito y Notas débito.