API Endpoints
Contáctanos

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

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

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 para esta factura.
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>

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 23 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 23 days ago