Dataico
Cómo hacerloActualizado 9 de octubre de 2026

Nota Débito sin factura de referencia (API)

La API permite emitir una Nota Débito autónoma, es decir, sin referencia a una factura electrónica previa. En la nomenclatura de la DIAN corresponde al CustomizationID 32.

Cuándo usarla

Úsala cuando debas emitir una Nota Débito que no corresponde a una factura electrónica emitida previamente. Para el caso normal (una Nota Débito que aumenta el valor de una factura existente) sigue usando la Nota Débito con referencia a factura.

Cómo enviarla

Envíala con POST https://api.dataico.com/direct/dataico_api/v2/debit_notes y, dentro del objeto debit_note, el campo "sin_factura_referenciada": true. Con ese campo:

  • El objeto customer es obligatorio y completo, porque no hay una factura de donde tomar los datos del cliente.
  • invoice_period_start_date e invoice_period_end_date son obligatorios, en formato dd/MM/yyyy o dd/MM/yyyy HH:mm:ss.
  • No puedes enviar invoice_id, invoice_number, invoice_issue_date ni invoice_cufe.

La consulta (GET) y el reenvío (PUT) usan /debit_notes/{uuid} como cualquier Nota Débito, y la consulta por número es GET /debit_notes?number=.

Errores posibles

Mensaje Qué hacer
Estas usando el campo 'sin_factura_referenciada', entonces, no puedes usar los siguientes campos: invoice_id, invoice_number, invoice_issue_date, invoice_cufe Quita de la nota los campos que referencian una factura
Para esta Nota Débito sin factura referenciada, los campos de fechas de inicio de periodo y fin de periodo de facturación son requeridos Agrega invoice_period_start_date e invoice_period_end_date
Si estás usando nota débito sin factura referenciada, necesitas declarar cliente entero en el campo de "customer" Envía el objeto customer completo

Qué cambia en el documento

Elemento Nota Débito con factura Nota Débito autónoma
CustomizationID El código correspondiente a Nota Débito con referencia 32
BillingReference Presente, apunta a la factura Se omite
InvoicePeriod No se emite Se emite
Celda del CUFE en el PDF Presente No aparece

El periodo (InvoicePeriod) es obligatorio cuando la Nota Débito es autónoma.

Otros artículos que pueden interesar

Artículos relacionados

¿Este artículo te fue útil?