API Endpoints

Endpoint para emitir una factura electrónica a la DIAN

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

Este endpoint permite emitir una factura 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 factura electrónica

string
enum
required

Tipo de Documento / Factura. 01: Estándar, 02: Exportación, 03: Mandato, 04: Contingencia Facturador Electrónico, 05: Transporte, 06: AIU, 07: Factura electrónica de Compra de divisa, 08: Factura electrónica de Venta de divisa

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>

double
required

Número de la factura electrónica.
Campo oficial DIAN <ID>

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
resolution
object
required

Objeto que contiene la información de la Resolución de Numeración de Facturas asociada al emisor de la factura electrónica en formato JSON según el estándar de la DIAN.
Grupo de información oficial DIAN <InvoiceControl>

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

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>

additionalDocumentReference
object

Grupo de campos para información que describen un documento referenciado por esta factura. Este objeto es requerido para Factura electrónica de Contingencia.
Grupo de información oficial DIAN <AdditionalDocumentReference>

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>

creditNoteReference
object

Objeto que contiene la información de la nota de crédito referenciada en la factura electrónica.
Grupo de información oficial DIAN <CreditNoteReference>

debitNoteReference
object

Objeto que contiene la información de la nota de débito referenciada en la factura electrónica.
Grupo de información oficial DIAN <DebitNoteReference>

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

Updated 4 months 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 4 months ago