API Endpoints

Endpoint para emitir una nota crédito electrónica a la DIAN

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

Este endpoint permite emitir una nota crédito 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 crédito electrónica

string
enum

Tipo de Nota de Crédito. 91: Estándar, 91-22: Estándar sin referencia a Factura, 02: Exportación. Este atributo es opcional, sino se envia este valor, Alegra asociará esta Nota Crédito como una Nota Crédito de Venta Estándar

Allowed:
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 crédito electrónica

double
required

Número de la nota crédito electrónica

string
required
^[1-6]$

Concepto por el cual se genera la nota crédito. Este elemento acepta una de las siguientes opciones: 1 Devolución parcial de los bienes y/o no aceptación parcial del servicio; 2 Anulación de factura electrónica; 3 Rebaja o descuento parcial o total; 4 Ajuste de precio; 5 Descuento comercial por pronto pago; 6 Descuento comercial por volumen de ventas.
Campo oficial DIAN <ResponseCode>

note
array of strings
length ≥ 1

Notas o información adicional: Texto libre, relativo al documento.
Campo oficial DIAN <Note>

note
associatedDocuments
array of objects
length between 1 and 1

Array que contiene la información de la factura electrónica afectada por la Nota. Solamente puede reportar 1 factura electrónica y debe ser de un mismo adquiriente. Obligatorio si el tipo de documento es Estandar o Exportación.

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*
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*
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
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>

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 about 1 month 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 about 1 month ago