Endpoint para emitir una nota débito electrónica a la DIAN

Este endpoint permite emitir una nota débito electrónica a la DIAN.

Recuerda visitar previamente las guías de Inicio y la guía de Habilitación en la DIAN - Factura Electronica

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto con la información de la nota débito electrónica

foreignCurrency
object

Este objeto permite informar la tasa de cambio del peso colombiano (COP) frente a una moneda extranjera. Todos los valores de la solicitud se envían en COP y el documento se emite en COP. Cuando se envía este objeto, la API agrega automáticamente al XML la extensión CustomTagGeneral/TotalesCop (Anexo Técnico 1.9, Suplemento K) con la moneda extranjera, la tasa de cambio y los totales del documento expresados en esa moneda, que la representación gráfica de la DIAN muestra en su columna de moneda extranjera. Cada total se calcula dividiendo su valor en COP entre rateValue y se escribe con dos decimales, redondeado; para reemplazar alguno de esos valores, envíelo en totalAmounts.
Grupo de información oficial DIAN <PaymentExchangeRate> y extensión <TotalesCop>

string
length ≥ 1

Prefijo de la nota débito electrónica

double
required

Número de la nota débito electrónica

string
required

Concepto por el cual se genera la nota débito. Se debe colocar el Código que corresponda de la tabla de tipos de concepto de corrección para Notas débito disponibles de la DIAN

note
array of strings
length ≥ 1

Notas o información adicional: Texto libre, relativo al documento. Máximo 5000 caracteres por nota.
Campo oficial DIAN <Note>

note
associatedDocuments
array of objects
required
length ≥ 1

Array que contiene la información de las facturas electrónicas afectadas por la Nota. Todas las facturas afectadas deben ser de un mismo adquiriente

associatedDocuments*

Objeto que contiene la información del documento referencia

date
required

Fecha de emisión del documento referencia

string
required

Tipo de documento

double
required

Número del documento referencia

string
length between 1 and 4

Prefijo del documento referencia

string
required

CUFE del documento referencia

company
object
required

Objeto que contiene la información del obligado a facturar o emisor del documento electrónico.
Grupo de información oficial DIAN <AccountingSupplierParty>

customer
object
required

Objeto que contiene la información del adquiriente del documento electrónico.
Grupo de información oficial DIAN <AccountingCustomerParty>

items
array of objects
required

Array que contiene el listado de artículos y/o servicios

items*
discountsAndCharges
array of objects

Array con el listado de Descuentos o Cargos a nivel de factura. Grupo de campos para información relacionada con los descuentos o cargos que no afectan las bases gravables. Los descuentos o cargos que afectan bases gravables se deben informar a nivel de ítem.
Grupo de información oficial DIAN <AllowanceCharge>

discountsAndCharges
totalAmounts
object
required

Objeto que contiene la información de totales relacionados con el documento

payments
array of objects
required

Array con el listado de pagos. Grupo de campos para información relacionadas con el pago de la factura.
Grupo de información oficial DIAN <PaymentMeans>

payments*
advancePayments
array of objects

Array con el listado de anticipos. Grupo de campos para información relacionadas con un anticipo.
Grupo de información oficial DIAN <PrePaidPayment>

advancePayments
healthSectorGeneral
object

Objeto que contiene los campos de datos adicionales correspondientes al Sector Salud (Resolución 000948 de 2026, Min. Salud)

invoicePeriod
object

Objeto que contiene un grupo de campos relativos al periodo de facturación: Intervalo de fechas a las que hace referencia la factura, por ejemplo, en servicios públicos.
Campo oficial DIAN <InvoicePeriod>

orderReference
object

Grupo de campos para información que describen una Orden de Pedido referenciada por este documento electrónico.
Grupo de información oficial DIAN <OrderReference>

delivery
object

Fecha, hora y dirección de entrega de los bienes. Todos los campos son opcionales, pero se debe enviar al menos uno. Puede enviar solo la fecha, solo la dirección o ambas; la hora (time) solo se acepta si se envía la fecha (date). No aplica al documento soporte ni a su nota de ajuste.
Grupo de información oficial DIAN <Delivery>

despatchDocumentReferences
array of objects
length ≥ 1

Array con el listado de documentos despacho referenciados en la factura electrónica.
Grupo de información oficial DIAN <DespatchDocumentReference>

despatchDocumentReferences

Objeto que contiene la información de un documento despacho referenciado en la factura electrónica.
Grupo de información oficial DIAN <DespatchDocumentReference>

string
required

Prefijo y Número del documento despacho referenciado.
Grupo de información oficial DIAN <ID>

date

Fecha de emisión del documento despacho referenciado.
Grupo de información oficial DIAN <IssueDate>

receiptDocumentReferences
array of objects
length ≥ 1

Array con el listado de documentos recepción referenciados en la factura electrónica.
Grupo de información oficial DIAN <ReceiptDocumentReference>

receiptDocumentReferences

Objeto que contiene la información de un documento recepción referenciado en la factura electrónica.
Grupo de información oficial DIAN <ReceiptDocumentReference>

string
required

Prefijo y Número del documento recepción referenciado.
Grupo de información oficial DIAN <ID>

date

Fecha de emisión del documento recepción referenciado.
Grupo de información oficial DIAN <IssueDate>

string
enum

Identifica el código de debida diligencia del control cambiario. Es obligatorio cuando documentType ∈ {'07', '08'}. Este elemento acepta una de las siguientes opciones:
- 01 Debida Diligencia del Cliente – DDC General
- 02 Debida Diligencia del Cliente – DDC Reforzada
- 03 Debida diligencia intensificada por razón de la cuantía de las operaciones – DDC intensificada
- 04 Debida Diligencia del Cliente – DDC simplificada.
Grupo de información oficial DIAN <DebidaDiligencia en UBLExtension>

Allowed:
Headers
uuid
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Llave que identifica una operación lógica, generada por el integrador. Cuando se envía, la API garantiza que la operación se ejecute a lo sumo una vez para esa llave: un reintento tras un timeout, un error de red o un fallo del cliente devuelve el resultado de la primera ejecución en lugar de emitir un segundo documento.

Debe ser un UUID versión 4 en su forma canónica con guiones. Cualquier otro valor se rechaza con 400. Se acepta en mayúsculas o minúsculas: la API normaliza a minúsculas, de modo que la misma llave escrita distinto sigue siendo la misma operación.

Genera una llave nueva por cada operación lógica, guárdala junto con la operación y reutilízala en todos los reintentos de esa misma operación. Reutilizar una llave con un cuerpo diferente devuelve 422.

La respuesta almacenada refleja el resultado de la petición original y no se actualiza después: para conocer el estado actual del documento usa el endpoint GET o el webhook.

Las llaves se conservan 7 días.

Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json