Guía de Instalación - NAOS Print Spooler

El NAOS Print Spooler es una aplicación de escritorio que actúa como puente entre el navegador web (NAOS POS) y las impresoras térmicas conectadas a tu red local.

¿Cómo funciona?

┌─────────────────┐      ┌──────────────────┐      ┌─────────────────────┐
│   Navegador     │ ───► │  Spooler Local   │ ───► │  Impresora Térmica  │
│   (NAOS POS)    │      │  localhost:9100   │      │  192.168.x.x:9100   │
└─────────────────┘      └──────────────────┘      └─────────────────────┘

El spooler corre en segundo plano en tu computadora y escucha en http://localhost:9100. Cuando realizas una venta en NAOS POS, el sistema envía el ticket al spooler, que lo reenvía a la impresora térmica.

Descargas

Plataforma	Enlace
Windows 64-bit	Descargar .exe
macOS Apple Silicon	Descargar .dmg
macOS Intel	Descargar .dmg
Linux ARM64	Descargar .AppImage / .deb

Configuración inicial

1. Instalar y abrir el spooler

Después de instalar, abre NAOS Print Spooler. Aparecerá un icono en la bandeja del sistema (Windows/Linux) o en la barra de menú (macOS).

2. Agregar una impresora

1. Haz clic en el icono del spooler para abrir la ventana de configuración
2. Ingresa la IP de tu impresora térmica (ej: 192.168.1.100)
3. El puerto por defecto es 9100
4. Haz clic en Probar conexión para verificar
5. Guarda la configuración

3. Configurar en NAOS POS

En NAOS POS → Configuración → Impresión:

1. Selecciona Tipo de conexión: Spooler
2. El sistema detectará automáticamente el spooler en localhost:9100
3. Selecciona la impresora configurada
4. Realiza una impresión de prueba

Tipos de impresión soportados

Tipo	Descripción
Factura	Ticket de venta con detalle fiscal
Pre-cuenta	Cuenta previa sin valor fiscal
Reporte X	Cierre parcial de caja
Reporte Z	Cierre diario de caja
Comanda de cocina	Orden para preparación

Solución de problemas

El spooler no inicia

• Verifica que el puerto 9100 no esté ocupado por otra aplicación
• En Windows, ejecuta como administrador

No se conecta a la impresora

• Verifica que la impresora esté encendida y conectada a la red
• Haz ping a la IP de la impresora: ping 192.168.x.x
• Verifica que el puerto 9100 esté abierto en el firewall

NAOS POS no detecta el spooler

• Verifica que el icono del spooler esté activo (verde) en la bandeja del sistema
• Abre http://localhost:9100/health en el navegador — debe responder OK
• Si usas HTTPS en NAOS POS, el navegador puede bloquear conexiones HTTP locales. Consulta la documentación de tu navegador

macOS: “La aplicación no se puede abrir”

• Haz clic derecho en la app → Abrir (en lugar de doble clic)
• O ve a Preferencias del Sistema → Seguridad y Privacidad y haz clic en “Abrir de todos modos”

Configuración avanzada

La configuración se guarda automáticamente en:

Plataforma	Ruta
Windows	%APPDATA%/naos-print-spooler/config.json
macOS	~/Library/Application Support/naos-print-spooler/config.json
Linux	~/.config/naos-print-spooler/config.json

Auto-inicio

El spooler puede configurarse para iniciar automáticamente con el sistema operativo desde la ventana de configuración.