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:
- Instala Qu3ntas Impresión en el equipo donde está la impresora
- Ve a Ajustes → Impresora en Qu3ntas (web)
- Qu3ntas detecta el agente automáticamente — verás «Agente detectado (v…)» en verde
- Pega el token del agente (lo ves con
cuad-impresion tokenen la terminal o en el acceso directo «Ver token de Qu3ntas Impresión») - Selecciona la impresora del listado (detecta todas las instaladas en Windows)
- Elige el ancho del papel: 58 mm o 80 mm
- 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.
- Ve a Ajustes → Impresora
- Activa Imprimir directo en la térmica
- 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 |
- Escribe el destino (nombre de impresora, IP:puerto o puerto COM)
- Selecciona el ancho del papel: 58 mm (32 columnas) o 80 mm (48 columnas)
- 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 |
- 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¶
- Conecta el cable RJ-11 del cajón al puerto DK o RJ-11 de la impresora
- En Qu3ntas, activa Abrir el cajón con cada recibo
- 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 |