API Endpoints
Contáctanos

Endpoint para emitir una nota de ajuste al documento soporte electrónico a la DIAN

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

Este endpoint permite emitir una nota de ajuste al 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 de una nota de ajuste al 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.

double
required

Número de la nota de ajuste del Documento Soporte Electrónico.
Campo oficial DIAN <ID>

string
length ≥ 1
^[a-zA-Z0-9]+$

Indica el prefijo asignado a las notas de ajuste.
Campo oficial DIAN <ID>

notes
array of strings

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

notes
invoiceDocumentReference
object
required
discrepancies
array of objects
required

Array que contiene el listado de objetos que explican la naturaleza de la Nota de ajuste al documento soporte

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

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

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

Did this page help you?
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

Did this page help you?