1. Documentos equivalentes
Muisca - API de facturación electrónica
  • Introducción
  • Autenticación
  • Códigos de respuesta de la API
  • Consultar resoluciones
    • Resoluciones
      GET
  • Versión 2.0
    • Facturas electrónicas
      • Crear factura sector salud
      • Crear factura divisas
      • Consultar por ID
      • Consultar por prefijo y consecutivo
      • Crear factura electrónica
    • Documentos soporte
      • Crear documento soporte
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Documentos equivalentes
      • Consultar por ID
        GET
      • Crear tiquete P.O.S
        POST
      • Crear tiquete de transporte terrestre
        POST
      • Crear tiquete de cine
        POST
      • Crear tiquete de cobro de peajes
        POST
      • Crear tiquete aereo
        POST
      • Crear boleta de ingreso a espectáculos públicos
        POST
      • Consultar por prefijo y consecutivo
        GET
    • Notas crédito
      • Crear nota crédito
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Notas débito
      • Crear nota débito
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota crédito al documento equivalente
      • Crear nota crédito al documento equivalente
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota débito al documento equivalente
      • Crear nota débito al documento equivalente
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota de ajuste al documento soporte
      • Consultar por ID
      • Consultar por prefijo y consecutivo
      • Crear nota de ajuste
  • Preguntas frecuentes
    • ¿Cómo funciona la contingencia Dian en Nitro?
    • ¿Cómo autenticarme en la API?
    • ¿Cómo pruebo antes de pasar a producción?
    • ¿Debo reenviar un documento rechazado?
    • ¿Cuál es la diferencia entre pruebas, habilitación y producción?
    • ¿Dónde obtengo la API Key?
    • ¿Qué ambientes existen?
    • ¿Qué formatos de documentos puedo enviar?
    • ¿Qué hago si la Dian rechaza un documento?
    • ¿Qué pasa cuando la Dian no responde?
    • ¿Qué significa un código de respuesta HTTP?
    • ¿Qué significa el estado DianNoDisponible?
  • Lista de valores
    • Actividades económicas
    • Ciudades
    • Códigos de monedas
    • Código estandar del producto
    • Condiciones de entrega (INCOTERMS)
    • Departamentos
    • Medios de pagos
    • Paises
    • Responsabilidades fiscales
    • Tipos de identificacion
    • Tipos de documentos electrónicos
    • Tipos de operación
    • Tipos de persona
    • Tipos de regimen
    • Tributos (Impuestos/Retenciones)
    • Unidades de cantidad
    • Responsable de impuestos
    • Códigos Postales de Colombia
  • Estructura de datos
    • Ancho del PDF
    • Descuentos y cargos
    • Direcciones del cliente
    • Documentos equivalentes
    • Extensiones de facturas
    • Factura electrónica de venta
    • Factura electrónica sector salud
    • Factura electrónica de venta y compra de divisas
    • Formatos permitidos PDF
    • ID set de pruebas DIAN
    • Modo contingencia
    • Modos de ambiente de facturación
    • Notas de ajuste débito y crédito al documento equivalente
    • Notas crédito y débito de factura electrónica de venta
  • Organización
    • Actualizar logo de una organización
    • Agregar una organización hija
  • Schemas
    • Organización
      • AddCompany
      • AddUser
    • Response
    • Resolución Pos
    • Respuesta de consulta de documentos - Versión 3
    • FacturaRequestPOS
    • FacturaRequest
    • Productos
    • LineaProductoPeaje
    • NotasCred/Deb/Ajus
    • Sucursal
    • Supplier2
    • Dirección
    • Resolución
    • Cliente
    • Totales
    • Descuento
    • Cargos
    • Propinas
    • Transporte
    • TikectAereo
    • Cinema
    • EspectaculoPublico
    • SectorSalud
    • ComprayVentaDeDivisas
    • Retencioness
    • Impuestos
    • Mandante
Portal DIAN
  1. Documentos equivalentes

Crear tiquete P.O.S

Probando
POST
https://api.muisca.io/v2/documents/equivalent-documents
Emite un documento equivalente tipo Tiquete POS para transacciones de punto de venta. Diseñado para ventas al detal con información simplificada, ideal para comercios minoristas que requieren agilidad en la emisión de comprobantes.

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros del Body application/json

Ejemplos

Respuestas

🟢200Success
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api.muisca.io/v2/documents/equivalent-documents' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "code": "20",
  "typeOperation": "10",
  "mode": "Test",
  "format": "Estandar",
  "size": "Estandar",
  "testSetId": "0e3d0669-03ed-4f70-a237-c9541d22c5a1",
  "prefix": "EPOS",
  "consecutive": 1,
  "orderReference": "ORD-2025-001",
  "currencyCode": "COP",
  "currencyRate": 0,
  "issuedAt": "2026-03-10",
  "dueAt": "2026-03-10",
  "periodStartDate": "2026-03-10",
  "periodEndDate": "2026-03-10",
  "deliveryAt": "2026-03-10",
  "deliveryTerms": "Entrega en puerta",
  "terms": "Términos y condiciones comerciales",
  "termDay": 30,
  "paymentMeanCode": "10",
  "sellerName": "Juan Vendedor",
  "branch": {
    "name": "Sucursal Principal",
    "address": "Calle Ficticia 123, Edificio Empresarial",
    "regionCode": "11",
    "regionName": "Departamento Ejemplo",
    "cityCode": "11001",
    "cityName": "Ciudad Ejemplo",
    "phone": "1234567890"
  },
  "resolution": {
    "key": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
    "prefix": "EPOS",
    "number": 18760000001,
    "rangeInitial": 1,
    "rangeFinal": 1000000,
    "validFrom": "2019-01-19",
    "validUntil": "2030-01-19"
  },
  "customer": {
    "companyName": "Mi empresa S.A",
    "personType": "2",
    "firstName": "Nombres del cliente",
    "lastName": "Apellidos del cliente",
    "identification": "1234567890",
    "digitCheck": "2",
    "identificationTypeCode": "13",
    "email": "clienteemail@gmail.com",
    "phone": "1234567890",
    "responsibleFor": "ZZ",
    "responsibilities": "R-99-PN",
    "BillingAddress": {
      "address": "Tu dirección 01 #02-03",
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001",
      "postalCode": "110011",
      "neighborhood": "Chapinero",
      "phone": "1234567890",
      "contactName": "Nombre Contacto"
    },
    "ShippingAddress": {
      "address": "Tu dirección 01 #02-03",
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001",
      "postalCode": "110011",
      "neighborhood": "Chapinero",
      "phone": "1234567890",
      "contactName": "Nombre Contacto"
    }
  },
  "lines": [
    {
      "code": "PROD001",
      "name": "Producto número 1",
      "modelName": "Modelo Prueba",
      "description": "Descrpción del producto número 1",
      "brandName": "Marca1",
      "itemCodeSupplier": "Supplier123",
      "unitMeasurementCode": "94",
      "unitMeasurementName": "Unidad",
      "price": 10000,
      "quantity": 5,
      "discountAmount": 5000,
      "chargeAmount": 5000,
      "standardType": "001",
      "standardCode": "10101501",
      "discounts": [
        {
          "name": "Descuento por volumen",
          "type": "P",
          "rate": 10,
          "amount": 1000
        }
      ],
      "charges": [
        {
          "name": "Costo de envío",
          "type": "F",
          "rate": 1000,
          "amount": 1000
        }
      ],
      "taxes": [
        {
          "name": "IVA",
          "code": "01",
          "type": "P",
          "rate": 19,
          "amount": 1900,
          "base": 10000
        }
      ],
      "withholdings": [
        {
          "name": "ReteIVA",
          "code": "05",
          "type": "P",
          "rate": 15,
          "amount": 285,
          "base": 1900
        }
      ]
    }
  ],
  "totals": {
    "amount": 50000,
    "prepaymentAmount": 0,
    "taxesAmount": 9500,
    "withholdingAmount": 1425,
    "discountsAmount": 0,
    "chargesAmount": 5000
  },
  "tip": {
    "base": 50000,
    "rate": 10,
    "amount": 5000
  },
  "notes": [
    "Nota importante 1",
    "Nota importante 2"
  ],
  "remark": "Comentarios adicionales"
}'
Respuesta Ejemplo de Respuesta
{
    "Id": "21158a97-2b72-4db6-8b75-4aeeefa016c6",
    "Cufe": "19dc6fbda4723595d089dcad098bfc3e25b9096c03ffe816d035ad8aa7b442f1db024a6702c4122f80b3db49c668ef88",
    "Sequence": "EPOS1",
    "Qr": "NumFac:EPOS1;FecFac:2026-07-01;HorFac:00:00:00-05:00;NitFac:830099008;DocAdq:1234567890;ValFac:150000.00;ValIva:28500.00;ValOtroIm:0.00;ValTolFac:178500.00;CUFE:19dc6fbda4723595d089dcad098bfc3e25b9096c03ffe816d035ad8aa7b442f1db024a6702c4122f80b3db49c668ef88;https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=19dc6fbda4723595d089dcad098bfc3e25b9096c03ffe816d035ad8aa7b442f1db024a6702c4122f80b3db49c668ef88",
    "Status": "Aprobada",
    "StatusReasons": [
        "Procesado Correctamente."
    ]
}
Modificado en 2026-11-06 03:28:48
Anterior
Consultar por ID
Siguiente
Crear tiquete de transporte terrestre
Built with