Skip to content
NAOS POS Logo NAOS

Guía de Instalación - NAOS Print Spooler

This content is not available in your language yet.

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

PlataformaEnlace
Windows 64-bitDescargar .exe
macOS Apple SiliconDescargar .dmg
macOS IntelDescargar .dmg
Linux ARM64Descargar .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

TipoDescripción
FacturaTicket de venta con detalle fiscal
Pre-cuentaCuenta previa sin valor fiscal
Reporte XCierre parcial de caja
Reporte ZCierre diario de caja
Comanda de cocinaOrden 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:

PlataformaRuta
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.