API Endpoints
Contáctanos

Emisión Documento Equivalente POS a la DIAN

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

Este endpoint permite emitir un Documento Equivalente Electrónico Tiquete de Máquina Registradora con sistema P.O.S 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 del Documento Equivalente POS

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
enum

Indica que se emitirá un documento equivalente POS electrónico reemplazando un documento físico generado en contingencia, este elemento acepta la siguiente opción: 07 Contingencia por parte del emisor.
Campo oficial DIAN <InvoiceTypeCode>

Allowed:
string
required

Número del documento equivalente.
Campo oficial DIAN <ID>

resolution
object
required

Objeto que contiene la información de la Resolución de Numeración asociada al emisor de Documentos Equivalentes POS 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

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*
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
withholdingTaxTotal
array of objects

Si el emisor es autorretenedor, puede usar este objeto para reportar autorretenciones totales a nivelgeneral del documento (como ReteIVA o ReteFuente).
Para reportarlas por línea, use el objeto withholdings dentro de items.
⚠️ Si se incluye información en ambos niveles, la DIAN sumará los valores.
Campo oficial DIAN <WithholdingTaxTotal>

withholdingTaxTotal
totalAmounts
object
required

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

buyerBenefits
object
cashRegister
object
note
array of strings
length ≥ 1

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

note
additionalDocumentReference
object

Grupo de campos para información que describen un documento referenciado por el documento equivalente POS electrónico. Este objeto es requerido cuando se generen POS electrónicos en contingencia y deban ser enviados a la DIAN. Grupo de información oficial DIAN <AdditionalDocumentReference>

creditNoteReferences
array of objects

Array con el listado de notas de crédito referenciadas en el documento equivalente POS.
Grupo de información oficial DIAN <CreditNoteDocumentReference>

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