Impresión
Cómo funciona la impresión en HWD POS (CUPS, Chrome/Chromium y el servicio hwpos-print) y cómo configurarla.
La impresión se instala por defecto (WITH_PRINTING=yes). Use WITH_PRINTING=no para omitirla en un servidor que no imprime, como uno que solo aloja la base de datos.
Componentes
| Componente | Para qué sirve | Si no está |
|---|---|---|
| CUPS | Imprimir en impresoras A4 (inyección/láser) y en impresoras de red por IPP/AirPrint. | Las impresoras térmicas (ESC/POS, 80 mm y 58 mm) siguen funcionando: no pasan por CUPS. |
| Google Chrome (o Chromium) | Convertir a PDF, sin ventana, el documento A4 completo (la factura y la cotización con su diseño). | La impresión tipo «recibo» sigue funcionando; el documento A4 diseñado no se puede generar. |
Servicio hwpos-print | Imprime, uno por uno, los documentos que el sistema pone en cola. | No se imprime nada. |
Servicio hwpos-plugins | Ejecuta el trabajo en segundo plano de los complementos (por ejemplo, enviar el correo al cliente en el servidor, sin que el vendedor espere). | Las tareas de fondo de los complementos no se ejecutan. |
Los dos servicios deben quedar activos y habilitados (arranque automático). El resumen final del instalador los verifica.
Comprobar el servicio de impresión
sudo systemctl status hwpos-print
sudo systemctl status hwpos-pluginsVer la actividad de impresión en tiempo real:
sudo journalctl -u hwpos-print -fTambién puede iniciar, detener y reiniciar el worker de impresión desde hwdpanel (opciones 4–6), ver los registros (opción 18) o reinstalar los servicios de fondo (opción 16).
Permisos del usuario del servicio
El usuario del servidor web (www-data en Ubuntu/Debian) debe pertenecer a estos grupos:
lp, para acceder a impresoras USB;lpadmin, para administrar colas IPP.
El instalador lo configura automáticamente.
Agregar impresoras
En HWD POS, vaya a Sistema → Impresoras:
- Agregue cada impresora.
- Elija el papel: térmica de 80 mm o 58 mm, o documento A4.
- Haga la prueba de impresión desde la misma pantalla.
Si el documento A4 sale con caracteres raros, la impresora A4 está configurada como térmica. Cambie su papel a documento A4.
Fallan los documentos PDF A4
En Ubuntu/Debian (amd64) el instalador instala Google Chrome desde su paquete .deb oficial. El chromium-browser de Ubuntu es solo un paso hacia Snap y, sin snapd, no funciona aunque el comando exista. El resumen del instalador y check.sh lo verifican ejecutándolo (--version) como el usuario del servidor web, no solo mirando si el comando existe.
Si falla la generación o la impresión de documentos PDF A4:
Compruebe el navegador:
sudo -u www-data google-chrome-stable --versionSi no responde, instálelo:
curl -fsSLO https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt-get install -y ./google-chrome-stable_current_amd64.debTambién puede usar la opción Chrome/Chromium de check.sh.
Si usa otro navegador, abra Ajustes en HWD POS y configure su ruta en chrome_path.
Servidores virtualizados (Proxmox)
- VM (KVM) o contenedor LXC: un LXC pesa menos, pero pasarle una impresora USB exige un contenedor privilegiado y un bind mount de
/dev/usb/lp0. En una VM se usa el USB passthrough de Proxmox (Hardware → Add → USB Device). - Lo más simple: impresoras de red (IP). Evitan por completo el paso de USB. El worker imprime por el socket 9100 (térmicas) o por una cola IPP/AirPrint (A4). Recomendado para entornos virtualizados.
- Recursos típicos para una tienda: 2 vCPU, 2–4 GB de RAM y 20 GB de disco.
- Dé a la VM o al contenedor una IP fija en la LAN para que las terminales y tablets se conecten.