API Endpoints

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
Responses

Updated about 1 month 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 about 1 month ago