Saltar a contenido

Tiquetes e impresión

Qu3ntas imprime tiquetes de venta en impresoras térmicas (las de papel de rollo) por protocolo ESC/POS. También puede abrir el cajón monedero conectado a la impresora.


Impresoras compatibles

Cualquier impresora térmica de 58 mm u 80 mm que soporte el protocolo ESC/POS. Las marcas más comunes en Colombia:

  • Epson TM-T20, TM-T88 y toda la serie TM
  • Star Micronics TSP100, TSP650
  • Bixolon SRP-350, SRP-330
  • Genéricas — impresoras POS de 58 mm y 80 mm sin marca (las más baratas)

¿58 mm o 80 mm?

  • 58 mm (32 columnas): la más común en negocios pequeños. Papel más barato, tiquete más angosto.
  • 80 mm (48 columnas): estándar en restaurantes y retail mediano. Más espacio para nombres largos y modificadores.

Dos formas de imprimir

Qu3ntas tiene dos mecanismos de impresión directa, según cómo uses la app:

Desde el navegador web — Qu3ntas Impresión (agente local)

El navegador no puede hablarle directo a una impresora USB, pero sí a un programa en 127.0.0.1 (localhost). Qu3ntas Impresión es un servicio pequeño que corre en tu PC y recibe los tiquetes del navegador por HTTP local.

Configurar:

  1. Instala Qu3ntas Impresión en el equipo donde está la impresora
  2. Ve a Ajustes → Impresora en Qu3ntas (web)
  3. Qu3ntas detecta el agente automáticamente — verás «Agente detectado (v…)» en verde
  4. Pega el token del agente (lo ves con cuad-impresion token en la terminal o en el acceso directo «Ver token de Qu3ntas Impresión»)
  5. Selecciona la impresora del listado (detecta todas las instaladas en Windows)
  6. Elige el ancho del papel: 58 mm o 80 mm
  7. Haz clic en Imprimir prueba — si salen bien las tildes y la ñ, está listo

Sin el agente

Si no instalas el agente, el tiquete sale igual por el diálogo de impresión del sistema (Ctrl+P). No es directo, pero funciona.

Desde la app de escritorio (Tauri)

La app de escritorio tiene acceso directo al hardware. No necesita el agente.

  1. Ve a Ajustes → Impresora
  2. Activa Imprimir directo en la térmica
  3. Elige el modo de conexión:
Modo Cuándo usarlo Ejemplo
Impresora de Windows La impresora USB ya instalada en el equipo. Qu3ntas le manda directo, sin diálogo POS-58
Impresora en red Conectada por cable Ethernet o WiFi. Usa el puerto RAW 9100 192.168.1.50:9100
Puerto serie / dispositivo Conectada por puerto COM o expuesta como dispositivo COM3
  1. Escribe el destino (nombre de impresora, IP:puerto o puerto COM)
  2. Selecciona el ancho del papel: 58 mm (32 columnas) o 80 mm (48 columnas)
  3. Configura las opciones:
Opción Qué hace
Cortar el papel al terminar Envía el comando de corte. Desactiva si tu impresora no tiene guillotina
Abrir el cajón con cada recibo Abre el cajón monedero automáticamente al confirmar la venta
  1. Haz clic en Página de prueba para verificar

Qué incluye el tiquete

El tiquete de venta imprime:

  • Encabezado: nombre del negocio, NIT, dirección, teléfono
  • Fecha y hora de la venta
  • Número de factura (o número POS si no hay resolución DIAN)
  • Productos: nombre, cantidad, precio unitario y subtotal por línea
  • Modificadores de cada producto (ej: «Doble +$5.000», «Sin cebolla»)
  • Descuentos aplicados
  • Subtotal, impuestos (IVA / impoconsumo) y total
  • Medio de pago y monto recibido (con cambio si es efectivo)
  • Propina (si aplica)
  • Nombre del cajero que realizó la venta
  • CUFE y código QR (si es factura electrónica DIAN)

Cajón monedero

El cajón monedero (o gaveta de dinero) no se conecta al computador. Se conecta a la impresora con un cable RJ-11 (como el de teléfono fijo). La impresora lo abre con un pulso eléctrico.

Abrir el cajón sin imprimir

Si necesitas abrir el cajón para dar cambio o sacar dinero:

  • En la web (con agente): haz clic en Abrir cajón en Ajustes → Impresora
  • En la app de escritorio: usa el botón Abrir cajón o el atajo F8

Configurar el cajón

  1. Conecta el cable RJ-11 del cajón al puerto DK o RJ-11 de la impresora
  2. En Qu3ntas, activa Abrir el cajón con cada recibo
  3. Al confirmar cada venta, el cajón se abre automáticamente

Solución de problemas

Problema Qué revisar
No imprime nada Verifica que la impresora esté encendida. Revisa la IP/nombre en la configuración. Haz clic en Página de prueba
Caracteres raros (ñ, tildes) En impresoras genéricas, prueba cambiando el código de página a CP858 (español) en la configuración del agente
No corta el papel Tu impresora puede no tener guillotina. Desactiva Cortar el papel en ajustes
No abre el cajón Verifica que el cable RJ-11 esté bien conectado entre la impresora y el cajón. Prueba con el botón Abrir cajón
«Agente no detectado» en la web Asegúrate de que Qu3ntas Impresión esté corriendo en el mismo equipo. Revisa que no haya un firewall bloqueando 127.0.0.1
Token inválido Obtén el token actualizado con cuad-impresion token en la terminal del equipo