API Endpoints
Contáctanos

Endpoint para emitir una nota de ajuste crédito - POS Electrónico DIAN

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

Este endpoint permite emitir una nota de ajuste al documento equivalente electrónico a la DIAN.

Recuerda visitar previamente las guías de Inicio y la guía de Habilitación en la DIAN - Documento Equivalente POS 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 equivalente electrónico

foreignCurrency
object

Objeto para informar la tasa de cambio del peso colombiano (COP) a una moneda extranjera. Si no se incluye, se utilizará COP (Peso Colombiano) como moneda predeterminada en el documento

string
length ≥ 1

Prefijo de la nota de ajuste

double
required

Número de la nota de ajuste del documento equivalente electrónico

string
length ≥ 1

Información adicional: Texto libre, relativo al documento

discrepancy
object
required

Objeto que contiene el Grupo para explicaciones sobre la naturaleza de la Nota de ajuste al DE

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

Objeto que contiene la información del adquiriente del documento electrónico. Si el cliente no requiere el documento a su nombre no se deberá enviar el grupo y se emitirá al Consumidor Final. Si se requiere que el documento POS electrónico salga a su nombre se deberán enviar los datos marcados como obligatorios.
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 documento equivalente POS.
Grupo de información oficial DIAN <AllowanceCharge>

discountsAndCharges
delivery
object

Información acerca del envío y la compañía encargada

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?