Impresión POS¶
Aquí decides cómo salen las tirillas (ventana del navegador o impresora térmica a través del cliente de impresión), registras tus impresoras, descargas el cliente y creas los tokens con los que se conecta. Está en Menú → Configuración → Impresión POS (ruta /app/config?tab=pos-printing); la pestaña vecina Impresión por documento (?tab=documento-printing) afina lo mismo por cada tipo de documento.
Permiso
ACCESO_CONFIGURACION. La sección Tokens de cliente POS exige además CONFIG_CREDENCIALES.
Un vistazo¶
| Nombre | IP | Puerto | Ancho papel | Predeterminada | Estado | |
|---|---|---|---|---|---|---|
| Caja principal | 192.168.1.123 | 9100 | 80 | check | active | edit delete |
| Horno | 192.168.1.124 | 9100 | 58 | active | edit delete |
| Nombre | Creado | Último uso | Expira | Activo | Acciones |
|---|---|---|---|---|---|
| Caja principal | 1/9/2026 | 2/9/2026 | 1/9/2027 | autorenew delete 5 | |
| Caja vieja | 1/8/2025 | — | 1/8/2026 | autorenew delete |
- 1 Modo de impresión e Imprimir recibos automáticamente valen para toda la empresa; Guardar confirma con Modo de impresión guardado.
- 2 Agregar impresora: una fila por impresora térmica de red. La columna Predeterminada marca la que recibe las tirillas si no se indica otra.
- 3 Descargar instalador del cliente para Windows (muestra la versión publicada) y el enlace al paquete zip para Linux / macOS.
- 4 Nuevo token: crea la credencial que el cliente usa para conectarse. El token completo se muestra una sola vez.
- 5 Por token: interruptor Activo, Regenerar (icono naranja) y eliminar. Una fecha de Expira en rojo significa que ya venció.
Los tres modos¶
| Modo de impresión | Qué pasa al guardar una venta |
|---|---|
| Traditional (tirilla.html) | Se abre la ventana de impresión del navegador con la tirilla en HTML. |
| POS WebSocket (Thermal Printer) | La tirilla viaja al cliente de impresión y sale por la impresora térmica, sin ventana. |
| Both Methods Available | El cajero elige entre las dos opciones. |
Imprimir recibos automáticamente encendido imprime sin preguntar; apagado muestra primero el diálogo de impresión. Cómo se ve cada caso en la venta está en Imprimir.
Registrar una impresora¶
- Pulsa Agregar impresora. Se abre Agregar — Impresoras.
- Llena Nombre, Descripción, Dirección IP y Puerto (9100 por defecto). El nombre no se puede repetir dentro de la empresa.
- Ajusta Ancho papel (mm) (80 o 58), Codificación (CP1252), Estado (Activa / Inactiva) y Prioridad. Prioridad 1 es la más alta.
- Marca Predeterminada, Corte automático, Imprimir encabezado e Imprimir pie según necesites y pulsa Guardar (Guardado correctamente).
Solo puede haber una impresora Predeterminada: al marcar otra, la anterior deja de serlo sola.
Cliente de impresión y tokens¶
- Pulsa Nuevo token, escribe el Nombre (ej. Caja principal) y pulsa Crear.
- Aparece Token generado — cópialo ahora. Cópialo con el icono de copiar (Token copiado) y guárdalo. Al cerrar el diálogo no se puede volver a ver.
- Pulsa Descargar instalador y ejecútalo en el computador de la caja; el asistente pide el token y la IP de la impresora, los verifica y deja el cliente arrancando solo al encender el equipo. Detalles en Cliente de impresión.
Cada token vence al año de creado. Si lo perdiste, usa Regenerar: el diálogo Regenerar token avisa El token actual de "…" dejará de funcionar. ¿Continuar? y te muestra uno nuevo. El interruptor Activo lo desconecta sin borrarlo; la papelera pregunta ¿Eliminar el token "…"?.
Impresión por documento¶
| Documento | Modo de impresión | Auto-imprimir | Plantilla | Efectivo |
|---|---|---|---|---|
| Factura de venta | Usar configuración de empresa (predeterminado) | Usar predeterminado | Tirilla Térmica (Arial, 80mm) | pos_websocket / auto / tirilla_termica |
| Cotización | Traditional (tirilla.html) | No | Factura Formal (A4/Letter) | traditional / manual / factura_formal |
| Caja Diaria sistema | Usar configuración de empresa (predeterminado) | Usar predeterminado | Cierre Detallado (80mm) | pos_websocket / auto / cierre_detailed |
- Modo de impresión: Usar configuración de empresa (predeterminado) hereda lo de Impresión POS; las otras tres opciones son los mismos modos de arriba, solo para ese documento.
- Auto-imprimir: Usar predeterminado, Sí o No.
- Plantilla: un solo desplegable con dos grupos. Mis formatos son los que diseñaste en Formatos de impresión (botón Gestionar formatos); Plantillas del sistema son las clásicas: Usar predeterminado, Tirilla Estándar (Courier, 80mm), Tirilla Térmica (Arial, 80mm) y Factura Formal (A4/Letter). Para Caja Diaria aparecen en cambio Cierre Simple (80mm), Cierre Detallado (80mm), Cierre Térmico (ESC/POS optimizado) y Cierre Formal (A4/Letter).
- Efectivo: lo que realmente se aplicará (modo / auto o manual / plantilla), ya resueltas las herencias.
Configura una vez, afina por documento
Deja en Impresión POS lo que usas el 90 % del tiempo (por ejemplo térmica y automático) y en Impresión por documento cambia solo las excepciones, como la cotización que va en formato formal por el navegador.
El token se muestra una sola vez
Ni tú ni soporte pueden recuperar un token: solo se guarda su huella. Si no lo copiaste, regenera.
¿Problemas?
- El botón dice Instalador no publicado. Aún no se ha publicado el instalador en este servidor; usa el paquete zip o pide a soporte que lo publique.
- No puedo crear tokens (la sección aparece vacía o falla). Te falta
CONFIG_CREDENCIALES. - La fecha de Expira está en rojo y el cliente no conecta. El token venció: pulsa Regenerar y vuelve a configurarlo en el cliente.
- Puse POS WebSocket pero la tirilla sigue saliendo por el navegador. Revisa que ese documento no tenga su propio modo en Impresión por documento y que el cliente de impresión esté conectado (Cliente de impresión).
Siguiente: Preferencias.