--- title: "Emisión Documento Equivalente POS a la DIAN" method: POST path: "/equivalent-documents/pos" tags: ["Documentos Equivalentes electrónicos"] --- # Emisión Documento Equivalente POS a la DIAN `POST /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](https://e-provider-docs.alegra.com/docs/gu%C3%ADa-creaci%C3%B3n-de-una-compa%C3%B1%C3%ADa-asociada) y la guía de [Habilitación en la DIAN - Documento Equivalente POS Electrónico](https://e-provider-docs.alegra.com/docs/gu%C3%ADa-del-proceso-de-habilitaci%C3%B3n-en-la-dian-documento-equivalente-pos-electr%C3%B3nico) ## Request body - object - `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 - `currencyCode` string, required — Código de la moneda a la cual se hace la conversión. Ver el listado disponible en la tabla DIAN- Monedas. Campo oficial DIAN - `rateValue` number, float, required — Valor de la tasa de cambio de la moneda utilizada para la conversión en el campo 'currencyCode' a Pesos Colombianos. Campo oficial DIAN - `rateDate` string, date, required — Fecha en la que se fijó o acordó la tasa de cambio. Campo oficial DIAN - `documentType` '07' — 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> - `number` 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> - `resolutionNumber` string, required — Número de Resolución o de Autorización: Número del código de la resolución otorgada para la numeración.
Campo oficial DIAN <InvoiceAuthorization> - `prefix` string — Prefijo de la Resolución o Autorización.
Campo oficial DIAN <Prefix> - `minNumber` number, required — Valor inicial del rango de numeración.
Campo oficial DIAN <From> - `maxNumber` number, required — Valor final del rango de numeración.
Campo oficial DIAN <To> - `startDate` string, date, required — Fecha de inicio de la autorización de la numeración.
Campo oficial DIAN <StartDate> - `endDate` string, date, required — Fecha final de la autorización de la numeración.
Campo oficial DIAN <EndDate> - `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> - `id` string, required — Id de la empresa. Id único generado por la API - `organizationType` 1 | 2 — Identificador de tipo de organización jurídica de la de persona, puede ser una de las siguientes opciones: `1` Persona Jurídica y asimiladas; `2` Persona Natural y asimiladas.
Campo oficial DIAN <AdditionalAccountID> - `identificationNumber` string — Número de identificación o NIT del emisor, sin guiones ni DV.
Campo oficial DIAN <CompanyID> - `dv` string — DV del NIT del emisor. Es obligatorio si identificationType = 31.
Campo oficial DIAN <@schemeID> - `name` string — Nombre (Razón Social) del Emisor. Si no se envía, se tomará el Nombre/Razón Social de la compañía.
Campo oficial DIAN <RegistrationName> - `tradeName` string — Nombre Comercial del Emisor.
Campo oficial DIAN <Name> - `regimeCode` string — Obligaciones o responsabilidades tributarias del emisor. El elemento acepta las siguientes opciones: "O-13" Gran contribuyente; "O-15" Autorretenedor; "O-23" Agente de retención IVA; "O-47" Régimen simple de tributación; "R-99-PN" No aplica - Otros.Para reportar varias obligaciones / responsabilidades se deben separar los valores con ';'. Ejemplo O-13;O-15;
Campo oficial DIAN <TaxLevelCode> - `taxCode` object — Objeto que contiene el grupo de detalles tributarios del Emisor.
Campo oficial DIAN <TaxScheme> - `id` '01' | '04' | 'ZA' | 'ZZ', required — Identificador del tributo. Este elemento acepta una de las siguientes opciones: `01` IVA; `04` INC; `ZA` IVA e INC; `ZZ` No aplica. default: ZZ
Campo oficial DIAN <ID> - `email` string — Correo electrónico. Se debe colocar el correo de recepción para documentos e instrumentos electrónicos.
Campo oficial DIAN <ElectronicMail> - `phone` string — Número de teléfono, celular u otro.
Campo oficial DIAN <Telephone> - `address` object — Este objeto contiene la información sobre la dirección física donde se expidió el documento. Si no se incluye el objeto 'taxAddress', los datos de este objeto se utilizarán como valores predeterminados para 'taxAddress'.
Grupo de información oficial DIAN <PhysicalLocation> - `address` string, required — Dirección del lugar fisico.
Campo oficial DIAN <Line> - `city` string, required — Código de la Ciudad. Se debe colocar el Código que corresponda de la tabla de municipios disponibles de la DIAN.
Campo oficial DIAN <ID> - `postalCode` string — Código Postal del lugar físico del proveedor.
Campo oficial DIAN <PostalZone> - `taxAddress` 0 — unresolved $ref - `contact` object — Objeto que contiene la información de contacto del emisor del documento electrónico.
Campo oficial DIAN <Contact> - `name` string — Nombre del contacto del emisor.
Campo oficial DIAN <Name> - `telefax` string — Número de teléfono, celular u otro del contacto.
Campo oficial DIAN <Telefax> - `note` string — Nota adicional del contacto.
Campo oficial DIAN <Note> - `commercialRegistrationNumber` string — Número de matrícula mercantil.
Campo oficial DIAN <CorporateRegistrationScheme/Name> - `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> - `name` string, required — Nombre o Razón Social del Adquiriente.
Campo oficial DIAN <Name> - `organizationType` 1 | 2 — Identificador de tipo de organización jurídica del adquiriente, puede ser una de las siguientes opciones: `1` Persona Jurídica y asimiladas; `2` Persona Natural y asimiladas. Default: `2`.
Campo oficial DIAN <AdditionalAccountID> - `identificationType` string, required — Tipo de documento de identificación del adquiriente. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN.
Campo oficial DIAN <@schemeName> - `identificationNumber` string, required — Número de identificación del adquiriente.
Campo oficial DIAN <ID> - `dv` string — DV del NIT del adquiriente. Es obligatorio si identificationType = 31.
Campo oficial DIAN <@schemeID> - `taxCode` object — Objeto que contiene el grupo de detalles tributarios del adquiriente.
Campo oficial DIAN <TaxScheme> - `id` '01' | '04' | 'ZA' | 'ZZ', required — Identificador del tributo. Este elemento acepta una de las siguientes opciones: `01` IVA; `04` INC; `ZA` IVA e INC; `ZZ` No aplica. default: ZZ
Campo oficial DIAN <ID, del Grupo TaxScheme> - `tradeName` string — Nombre Comercial del adquiriente.
Campo oficial DIAN <PartyName/Name> - `email` string — Correo electrónico. El correo de notificación será enviado a esta dirección en caso de tener habilitado notificationByEmail en Compañía.
Campo oficial DIAN <ElectronicMail> - `phone` string — Número de teléfono, celular u otro.
Campo oficial DIAN <Telephone> - `contact` object — Objeto que contiene la información de contacto del adquiriente del documento electrónico.
Campo oficial DIAN <Contact> - `name` string — Nombre del contacto del adquiriente.
Campo oficial DIAN <Name> - `items` object[], required — Array que contiene el listado de artículos y/o servicios - `code` object — Objeto que contiene el grupo de datos de identificación del artículo y/o servicio de acuerdo con un estándar.
Grupo de información oficial DIAN <StandardItemIdentification> - `identificationId` string — Código de artículo de acuerdo con el estándar descrito en el atributo.
Campo oficial DIAN <ID> - `id` string — Código del estándar. Se debe colocar el Código que corresponda de la tabla de Códigos de Productos disponibles de la DIAN
Campo oficial DIAN <schemeID> - `sellersItemIdentification` object — Grupo de datos de identificación del artículo o servicio de acuerdo con el vendedor.
Grupo de información oficial DIAN <SellersItemIdentification> - `id` string, required — Código del artículo o servicio de acuerdo con el vendedor.
Campo oficial DIAN <ID> - `extendedId` string — Código del vendedor correspondiente a una subespecificación del artículo.
Campo oficial DIAN <ExtendedID> - `description` string, required — Nombre y descripción del articulo y/o servicio que se está vendiendo en esta linea del documento.
Campo oficial DIAN <Description> - `price` number, float, required — Precio del articulo y/o servicio.
Campo oficial DIAN <PriceAmount> - `priceReference` object — Si se proporciona un precio de referencia, el atributo "price" debe ser cero (0.00), ya que se considera una muestra o regalo comercial.
Campo oficial DIAN <AlternativeConditionPrice> - `priceAmount` number, required — Valor del artículo o servicio. Este precio se deberá utilizar para calcular el impuesto correspondiente.
Campo oficial DIAN <PriceAmount> - `priceTypeCode` '01' | '02' | '03', required — Deberá contener uno de los siguientes valores posibles de acuerdo al precio informado en el elemento "priceAmount":
"1": Valor comercial; "2": Valor en Inventarios; "3": Otro valor
Campo oficial DIAN <PriceTypeCode> - `discount` number, float — Porcentaje de descuento del articulo y/o servicio. Se debe informar a nivel de ítem, si y solamente si el descuento afecta la base gravable del ítem.
Campo oficial DIAN </cac:AllowanceCharge/cbc:MultiplierFactorNumeric> - `discountAmount` number, float — Valor de descuento del articulo y/o servicio. Se debe informar a nivel de ítem, si y solamente si el descuento afecta la base gravable del ítem.
Campo oficial DIAN </cac:AllowanceCharge/cbc:Amount> - `quantity` number, float, required — Cantidad del articulo y/o servicio.
Campo oficial DIAN <InvoicedQuantity> - `unitCode` string, required — Código de Unidad de medida del articulo y/o servicio. Se debe colocar el Código que corresponda de la tabla de unidades de la DIAN.
Campo oficial DIAN <@unitCode> - `subtotal` number, float, required — Subtotal del articulo y/o servicio. El subtotal de la línea es igual a la Cantidad x Precio Unidad menos Descuentos más Recargos que apliquen al articulo y/o servicio.
Campo oficial DIAN <LineExtensionAmount> - `taxAmount` number, float, required — Valor total de los impuestos aplicados al articulo y/o servicio. - `total` number, float, required — Valor total del articulo y/o servicio. - `taxes` object[] — Array que contiene el listado de tributos/impuestos que aplican al articulo y/o servicio - `taxCode` string, required — Código o identificador del impuesto. Se debe colocar el Código que corresponda de la tabla de tipos de tributos/impuestos disponibles de la DIAN.
Campo oficial DIAN <ID> - `taxableAmount` number, float, required — Base Imponible sobre la que se calcula el valor del impuesto.
Campo oficial DIAN <TaxableAmount> - `taxPercentage` string — Porcentaje o tarifa de impuesto. Ejemplo: Para indicar la tarifa general asociada al impuesto de IVA, se debe enviar un porcentaje de 19.
Campo oficial DIAN <Percent> - `taxBaseUnitMeasure` number, float — Unidad de medida base para el tributo. Usado en el caso de que el tributo es un valor fijo por unidad tributada: informar el valor del tributo por unidadtributada. - `taxPerUnitAmount` number, float — Valor del tributo por unidad. Correspode al valor nominal del tributo por unidad - `taxAmount` number, float, required — Valor y/o importe del impuesto.
Campo oficial DIAN <TaxAmount> - `withholdings` Items[] — Este grupo de información debe utilizarse cuando el emisor es autorretenedor, permitiendo declarar las autorretenciones aplicadas a nivel de ítem, como por ejemplo ReteIVA o ReteFuente.
⚠️ Importante: Este elemento es independiente del objeto withholdingTaxTotal en el documento POS.
Si la misma información se reporta en ambos lugares, los montos serán sumados por la DIAN.
Grupo de información oficial DIAN <WithholdingTaxTotal> — unresolved $ref - `packSize` number — Número de productos por empaque.
Campo oficial DIAN <PackSizeNumeric> - `brandName` string — Marca del artículo.
Campo oficial DIAN <BrandName> - `modelName` string — Modelo del artículo.
Campo oficial DIAN <ModelName> - `additionalItemProperties` object[] — Array que contiene el grupo de información para adicionar información específica del ítem que puede ser solicitada por autoridades o entidades diferentes a la DIAN - `name` string, required — Característica que quiere informar del ítem, por ejemplo (Talla, Color) - `value` string, required — Valor de la característica que se quiere informar, por ejemplo (M, Negro) - `payments` object[], 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> - `paymentForm` string, required — Forma de pago del documento, este elemento acepta una de las siguientes opciones: "1" Contado; "2" Crédito
Campo oficial DIAN <ID> - `paymentMethod` string, required — Medio de pago. Se debe colocar el Código que corresponda de la tabla de métodos de pago disponibles de la DIAN.
Campo oficial DIAN <PaymentMeansCode> - `paymentDueDate` string, date — Fecha de vencimiento del documento POS electrónico. Si Forma de Pago es igual a 2, este valor debe ser enviado.
Campo oficial DIAN <PaymentDueDate> - `paymentID` string — Texto libre para informar datos adicionales sobre el medio de pago.
Campo oficial DIAN <PaymentID> - `discountsAndCharges` object[] — Array con el listado de Descuentos o Cargos a nivel de documento equivalente POS.
Grupo de información oficial DIAN <AllowanceCharge> - `isCharge` boolean, required — True si se desea informar un cargo o false si se desea informar un descuento.
Campo oficial DIAN <ChargeIndicator> - `reasonCode` '00' | '01' — Código para categorizar el descuento, este elemento acepta una de las siguientes opciones: "00", Descunto no condicionado; "01" Descuento condicionado. Valor por default "01".
Campo oficial DIAN <AdditionalAccountID> - `baseAmount` number, float, required — Valor Base para calcular el descuento o el cargo.
Campo oficial DIAN <BaseAmount> - `percentageAmount` number, float, required — Porcentaje a aplicar.
Campo oficial DIAN <MultiplierFactorNumeric> - `amount` number, float, required — Valor total del cargo o descuento.
Campo oficial DIAN <Amount> - `reason` string — Razón (texto): Texto libre para informar la razón del cargo o descuento.
Campo oficial DIAN <AllowanceChargeReason> - `withholdingTaxTotal` object[] — 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> - `taxCode` '05' | '06' | '07', required — Tipo de retención a aplicar. Este elemento acepta una de las siguientes opciones: 05,ReteIVA; 06,ReteRenta; 07,ReteICA.
Campo oficial DIAN <Percent> - `taxPercentage` string — Porcentaje o tarifa de impuesto. Ejemplo: Para indicar la tarifa general asociada al impuesto de IVA, se debe enviar un porcentaje de 19.
Campo oficial DIAN <Percent> - `taxableAmount` number, float, required — Base Imponible sobre la que se calcula el valor del impuesto.
Campo oficial DIAN <TaxableAmount> - `taxAmount` number, float, required — Valor y/o importe del impuesto.
Campo oficial DIAN <TaxAmount> - `totalAmounts` object, required — Objeto que contiene la información de totales relacionados con el documento - `grossTotal` number, float, required — Total valor bruto antes de tributos. Suma de todos los subtotales correspondientes a los árticulos y/o servicios. Campo oficial DIAN - `taxableTotal` number, float, required — Total valor base imponible. Base imponible para el cálculo de los tributos - `taxTotal` number, float, required — Total valor tributos/impuestos - `discountTotal` number, float — Total valor descuentos. Suma de todos los descuentos aplicados al total de la factura - `chargeTotal` number, float — Total valor cargos. Suma de todos los cargos aplicados al total de la factura - `payableTotal` number, float, required — Total valor factura. Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor tributos + valor cargos – valor descuentos - `currencyCode` string — Código de moneda de la transacción - `buyerBenefits` object - `identification` string, required — Código o documento de identificación del comprador - `name` string, required — Nombre y apellidos del comprador - `points` string, required — Corresponde a un valor donde se informe la Cantidad de Puntos acumulados por el comprador - `cashRegister` object - `plate` string, required — Corresponde a la placa de inventario de la caja - `location` string, required — Corresponde a la ubicación de la caja. ALMACEN - `cashier` string, required — Corresponde los nombres y apellidos del cajero o vendedor - `type` string, required — Corresponde al tipo de caja - `saleCode` string, required — Corresponde al código de la venta - `subtotal` string, required — Corresponde al subtotal de la venta - `note` string[] — Notas o información adicional: Texto libre, relativo al documento.
Campo oficial DIAN <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> - `number` string, required — Prefijo y Número del documento referenciado, para el caso de documentos POS en contingencia se deberá enviar el número del documento generado.
Grupo de información oficial DIAN <ID> - `issueDate` string, date, required — Fecha de emisión del documento referenciado; obligatorio en operaciones en contingencia cuando se quiera referenciar un documento POS físico.
Grupo de información oficial DIAN <IssueDate> - `documentTypeCode` string — Identificador del tipo de documento de referencia, corresponde a una codificación propia de la empresa.
Grupo de información oficial DIAN <DocumentTypeCode> - `creditNoteReferences` object[] — Array con el listado de notas de crédito referenciadas en el documento equivalente POS.
Grupo de información oficial DIAN <CreditNoteDocumentReference> - `id` string — Id registrado por la API E-providers, en caso de que el documento de referencia haya sido emitido a través de E-providers solo se necesita este dato para identificar el documento, de lo contrario deben enviarse los campos fullNumber, cude y date - `fullNumber` string — Prefijo + Número de la nota de ajuste referenciada.
Campo oficial DIAN <ID en CreditNoteDocumentReference> - `cude` string — CUDE de la nota de ajuste relacionada.
Campo oficial DIAN <UUID en CreditNoteDocumentReference> - `date` string, date — Fecha de emisión de la nota de ajuste relacionada.
Campo oficial DIAN <IssueDate en CreditNoteDocumentReference> ## Response `200` Objeto que representa la respuesta cuando se envía un documento equivalente electrónico a la DIAN - object - `equivalent-document` object - `id` string — Id del documento equivalente electrónico - `date` string, date-time — Fecha de emisión del documento equivalente electrónico - `status` 'REGISTERED' | 'WAITING_RESPONSE' | 'FAILED' | 'SENT' — Estado del documento equivalente electrónico - `legalStatus` 'ACCEPTED' | 'ACCEPTED_WITH_OBSERVATIONS' | 'REJECTED' — Estado legal del documento equivalente electrónico ante la DIAN - `companyIdentification` string — Identificación de la empresa emisora - `cude` string — Código único de documento equivalente electrónico asignado para el documento - `prefix` string — Prefijo de documento equivalente electrónico - `number` number, double — Número de documento equivalente electrónico - `fullNumber` string — Número de documento equivalente electrónico (Incluye prefijo y número) - `governmentResponse` object — Objeto con información de la respuesta de la DIAN - `code` string — Código de respuesta de la DIAN - `message` string — Mensaje de respuesta de la DIAN - `errorMessages` string[] — Array con mensajes de error devueltos por la DIAN - `xmlFileName` string — Nombre del archivo XML que se envió a la DIAN - `zipFileName` string — Nombre del archivo Zip que se envió a la DIAN - `qrCodeContent` string — Contenido para la construcción del Código QR - `errors` object[] — Array con mensajes de error generados en el sistema - `code` string — Código de error - `message` string — Mensaje de error - `files` object - `xml` string — Link de descarga a el XML que se envia a la DIAN. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento. - `attachedDocument` string — Link de descarga a el AttachedDocument obetenido como respuesta de al DIAN al enviar el archivo XML. Este campo solo se añade al tener una respuesta de la DIAN. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento. - `zip` string — Link de descarga a el Zip obetenido como respuesta de al DIAN al enviar el archivo XML. Este campo solo se añade al tener una respuesta de la DIAN, es generado de forma asincrona, puede tardar hasta 1 minuto en estar disponible. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento. ## Other responses - `400` — Objeto que representa una respuesta de error por validaciones - `404` — Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder - `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema --- [API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)