API Endpoints

Endpoint para emitir un documento soporte electrónico a la DIAN

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

Este endpoint permite emitir un documento soporte electrónico a la DIAN.

Recuerda visitar previamente las guías de Inicio y la guía de Habilitación en la DIAN - Documento Soporte Electrónico

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

Objeto con la información del documento soporte electrónico

documentCurrency
object

La divisa aplicable al documento soporte debe enviarse a través de este objeto. Si no se incluye, se utilizará COP (Peso Colombiano) como moneda predeterminada.

date

Fecha de generación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente. Campo oficial DIAN <IssueDate>

double
required
≥ 0

Número del documento soporte electrónico

resolution
object
required

Objeto que contiene la información de la resolución asociada al emisor del documento soporte 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>

supplier
object
required

Objeto que contiene la información del proveedor del documento electrónico

items
array of objects
required

Array que contiene el listado de articulos y/o servicios

items*
withholdingTaxTotal
array of objects

En este objeto el emisor puede reportar las autorretenciones/retenciones a nivel general del documento, como ReteIVA o ReteRenta. Para reportarlas por línea, use el objeto withholdings dentro de items.
⚠️ Si se envía información en ambos niveles, la API consolida los valores por tipo de retención y tarifa, y envía la suma a la DIAN en el grupo de totales del documento. Para no duplicar una retención, repórtela en un solo nivel.
Las retenciones no afectan los valores de totalAmounts.
Grupo de información oficial DIAN <WithholdingTaxTotal>

withholdingTaxTotal
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

Descuentos Descuentos o cargos a nivel del DSE, estos descuentos o cargos no afectan las bases gravables. Si se desea agregar un descuento o cargo que afecte la base gravable se debe informan a nivel de items en el elemento discountAmount.
Grupo de información oficial DIAN <AllowanceCharge>

discountsAndCharges
totalAmounts
object
required

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

notes
array of strings

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

notes
orderReference
object

Grupo de campos para la información de la orden de pedido: Este grupo contiene los campos que describen una orden de compra/pedido asociada al Documento Soporte Electrónico (DSE). Incluye detalles como el número de la orden, la fecha de emisión, y cualquier referencia adicional que sea relevante para el documento.
Campo oficial DIAN <OrderReference>

billingReference
object

Exclusivo para referenciar la Nota de Ajuste que dio origen al presente Documento Soporte Electrónico (DSE). Incluye los datos clave de la Nota de Ajuste, como el número, la fecha de emisión y el motivo del ajuste.
Campo oficial DIAN <BillingReference>

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