Notas crédito y débito

Para qué sirven

Documento	type_document_id	Código DIAN	Uso
Nota crédito	4	91	Anula / descuenta una factura
Nota débito	5	92	Incrementa valores de una factura
NC ajuste equivalente	26	94	Ajuste sobre documento equivalente
ND ajuste equivalente	25	93	Ajuste sobre documento equivalente

Endpoints

POST /api/ubl2.1/credit-note
POST /api/ubl2.1/credit-note/{testSetId}
POST /api/ubl2.1/debit-note
POST /api/ubl2.1/debit-note/{testSetId}
Authorization: Bearer <token_empresa>
Content-Type: application/json

• Sandbox / habilitación: usa /{testSetId} como en facturas.
• Producción (validación): usa la ruta sin testSetId.

Referencia a la factura (billing_reference)

Obligatoria en la práctica para NC/ND sobre FE:

"billing_reference": {
  "number": "SETT1",
  "uuid": "CUFE_DE_96_CARACTERES_DE_LA_FACTURA_ORIGINAL",
  "issue_date": "2026-07-15"
}

Campo	Descripción
number	Prefijo + número de la factura (ej. SETT1)
uuid	CUFE (96 caracteres)
issue_date	Fecha de emisión Y-m-d
type_document_id	Solo requerido si la nota es 25 o 26 (equivalente); valores 15–24

JSON mínimo — nota crédito

{
  "number": 1,
  "type_document_id": 4,
  "date": "2026-07-20",
  "time": "10:30:00",
  "resolution_number": "18760000001",
  "prefix": "NC",
  "discrepancyresponsecode": 2,
  "discrepancyresponsedescription": "Anulación de factura de venta electrónica",
  "billing_reference": {
    "number": "SETT1",
    "uuid": "REPLACE_CUFE",
    "issue_date": "2026-07-15"
  },
  "customer": { },
  "legal_monetary_totals": { },
  "credit_note_lines": [ ]
}

Completa customer, totales y líneas con la misma estructura que tu factura (ver ejemplo JSON y Postman).

Para débito, cambia a type_document_id: 5 y usa debit_note_lines (mismo patrón en colección).

Códigos de discrepancia (discrepancyresponsecode)

Valores habituales 1–6 (devolución, anulación, descuento, etc.). Describe siempre en discrepancyresponsedescription.

Resoluciones

Configura resoluciones NC/ND en:

PUT /api/ubl2.1/config/resolution

con el type_document_id de nota (4 o 5) y prefijos NC / ND (o los de tu DIAN).

Checklist

1. Emite la factura y guarda CUFE + número + fecha.
2. Ten resolución NC/ND activa.
3. Envía NC/ND con billing_reference correcto.
4. Consulta estado con Consultar estado si hace falta.

Soporte: WhatsApp