API Endpoints
Contáctanos

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

post
https://sandbox-api.alegra.com/e-provider/col/v1/debit-notes

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. Es importante tener en cuenta que todos los valores en la factura deben enviarse en COP. Dentro de este elemento, se incluirá exclusivamente: La moneda extranjera utilizada. La tasa de cambio aplicada. Las valores convertidos correspondientes. Este elemento cumple con las especificaciones del UBLextension de Interoperabilidad, permitiendo el soporte para operaciones de exportación.
Grupo de información oficial DIAN <PaymentExchangeRate>

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

string
length ≤ 500

Nota o información adicional: Texto libre, relativo al documento.
Campo oficial DIAN <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

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>

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:
Responses

Updated 9 days ago

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

Updated 9 days ago