Saltearse al contenido

Playbook: Impresoras y Print Spooler


Mapa de Impresión en NAOS

PlataformaMétodo de impresiónConexiones
App MóvilDirecto desde la appBluetooth, WiFi/Red, USB, Built-in (Senraise)
Portal WebVia NAOS Print SpoolerWiFi/Red (Spooler → Impresora)

Problemas en la App Móvil

Problema 1: No imprime (Bluetooth)

Síntomas: Presionas imprimir y no pasa nada. La impresora no responde.

PasoVerificación
1¿La impresora está encendida y cargada?
2¿Está emparejada en los ajustes de Bluetooth de Android? (No solo en NAOS)
3¿La distancia es menor a 5 metros sin obstáculos?
4¿Otra app o dispositivo está conectado a la impresora? (Bluetooth es 1 a 1)

Solución:

  1. Apaga y enciende la impresora.
  2. En Android: Ajustes > Bluetooth > Desempareja la impresora > Vuelve a emparejar.
  3. En NAOS: Ajustes > Impresoras > Elimina la impresora > Vuelve a agregarla.
  4. Prueba con “Probar Impresión”.

Problema 2: No imprime (WiFi/Red)

Síntomas: Error de conexión al imprimir. Timeout.

PasoVerificación
1¿La impresora y la tablet están en la misma red WiFi?
2¿La IP de la impresora es correcta? (Imprime un reporte de red desde la impresora)
3¿El puerto es 9100? (Puerto estándar para ESC/POS)
4¿Hay un firewall bloqueando el puerto?

Solución:

  1. Verifica la IP imprimiendo la página de configuración de la impresora (generalmente manteniendo un botón).
  2. En NAOS: Ajustes > Impresoras > Edita la IP y puerto.
  3. Haz ping a la IP desde otro dispositivo para confirmar conectividad.

Problema 3: Caracteres extraños o texto ilegible

Síntomas: Se imprime basura, símbolos, o caracteres asiáticos.

Causa: La impresora no soporta ESC/POS o tiene un modo de emulación diferente.

Solución:

  1. Verifica que la impresora sea compatible con ESC/POS (la mayoría de térmicas lo son).
  2. Si la impresora tiene un interruptor DIP o configuración, activa el modo ESC/POS.
  3. Si es una impresora genérica muy económica, puede que no sea compatible — prueba con otra impresora.

Problema 4: Texto cortado o formato desalineado

Síntomas: El texto se corta en el borde derecho. Las columnas no se alinean.

Causa: El ancho de papel configurado no coincide con el real.

Solución:

  1. Verifica el ancho físico del rollo: 58mm (mini) o 80mm (estándar).
  2. NAOS detecta automáticamente el ancho en la mayoría de casos.
  3. Si no detecta: Ajustes > Impresoras > configura el ancho correcto.
AnchoCaracteres por líneaFormato
58mm32 charsCompacto — sin columna de impuesto por ítem
80mm42 charsCompleto — todas las columnas

Problema 5: QR de factura electrónica no se imprime

Síntomas: El recibo sale completo pero sin el código QR.

Causa: Algunas impresoras económicas no soportan impresión de imágenes/QR.

Solución:

  • Si la impresora tiene al menos 58mm y es ESC/POS compatible, debería imprimir QR.
  • NAOS usa tamaño QR 3 para 58mm y tamaño 5 para 80mm.
  • Si no imprime QR: la impresora no soporta el comando de imagen ESC/POS. Considera cambiar a una impresora compatible (Epson TM-T20, Star TSP, etc.).

Problema 6: Impresora Senraise (built-in) no funciona

Síntomas: El dispositivo Senraise H10 no imprime desde NAOS.

Diagnóstico: La impresora Senraise se detecta automáticamente — no requiere configuración.

Solución:

  1. Verifica que la app NAOS tiene permisos de acceso al hardware.
  2. Cierra la app completamente y vuelve a abrirla.
  3. Si otra app está usando la impresora, ciérrala primero (Bluetooth es exclusivo pero el built-in puede tener conflictos).

Problemas con el Print Spooler (Portal Web)

Problema 7: El Spooler no se detecta en NAOS

Síntomas: En el portal web, al configurar la impresora, no aparece la opción del Spooler o dice “Spooler no detectado”.

Diagnóstico:

  1. ¿El Spooler está corriendo? — Debe estar activo en localhost:9100.
  2. ¿Estás en la misma computadora? — El Spooler funciona localmente.
  3. ¿El navegador bloquea localhost? — Algunos navegadores restringen conexiones locales.

Solución:

OSVerificar que correComando
WindowsIcono en la bandeja del sistema (system tray)Busca “NAOS Print Spooler” en la bandeja
macOSIcono en la barra de menúBusca el icono de NAOS en la barra superior
LinuxProceso en backgroundVerifica que el proceso está corriendo
  1. Si no está corriendo: Abre NAOS Print Spooler desde Aplicaciones.
  2. Si corre pero no detecta: Abre http://localhost:9100 en el navegador — deberías ver la interfaz del Spooler.
  3. Si el navegador bloquea: Prueba con otro navegador o desactiva el bloqueo de mixed content.

Problema 8: El Spooler no encuentra la impresora

Síntomas: El Spooler está activo pero al agregar una impresora dice “No se puede conectar”.

Solución:

  1. Verifica que la impresora está encendida y en la misma red.
  2. En el Spooler: Agrega la impresora por IP y puerto (generalmente IP:9100).
  3. Presiona “Probar Conexión” — debe responder exitosamente.
  4. Si no conecta: verifica que no hay firewall bloqueando el puerto 9100.

Problema 9: Spooler no inicia en macOS (alerta de seguridad)

Síntomas: macOS muestra “No se puede abrir porque no se puede verificar el desarrollador”.

Solución:

  1. No arrastres a la papelera.
  2. Ve a Preferencias del Sistema > Seguridad y Privacidad.
  3. En la pestaña General, verás un mensaje sobre la app bloqueada.
  4. Presiona “Abrir de todas formas”.
  5. Alternativa: Haz clic derecho en la app > “Abrir” (en vez de doble clic).

Guión del Video

Título: “Configurar Impresoras en NAOS — App Móvil y Portal Web”

Duración estimada: 7-8 minutos

TiempoEscenaAcciónNarración
0:00IntroLogo NAOS + título”En este video aprenderás a configurar y resolver problemas de impresoras en NAOS, tanto en la app móvil como en el portal web.”
0:20DiagramaMapa: App (BT/WiFi/USB/Built-in) y Web (Spooler)“NAOS imprime de dos formas: directo desde la app móvil por Bluetooth, WiFi o USB, y desde el portal web usando el Print Spooler.”
0:50App - BluetoothConfigurar impresora Bluetooth paso a paso”Empecemos con Bluetooth. Primero empareja la impresora en los ajustes de Android, luego agrégala en NAOS.”
1:30App - PruebaProbar impresión exitosa”Siempre haz una prueba de impresión después de configurar.”
2:00App - WiFiConfigurar impresora por IP”Para WiFi, necesitas la dirección IP de la impresora y el puerto, generalmente 9100.”
2:30App - SenraiseMostrar detección automática”Si tienes un dispositivo Senraise, la impresora se detecta automáticamente. No necesitas configurar nada.”
3:00App - Problema BTDesemparejar y reemparejar”Si el Bluetooth no funciona: desempareja en Android, vuelve a emparejar, y reconfigura en NAOS.”
3:40App - Problema charsMostrar caracteres extraños”Si ves caracteres extraños, verifica que la impresora soporta ESC/POS. Las impresoras genéricas muy baratas a veces no lo soportan.”
4:10Portal - SpoolerInstalar y abrir Print Spooler”Para el portal web, necesitas el NAOS Print Spooler. Descárgalo desde la sección de descargas.”
4:50Portal - ConfigAgregar impresora en el Spooler”Abre el Spooler, agrega tu impresora por IP, y prueba la conexión.”
5:20Portal - NAOSConfigurar en el portal web”En NAOS, ve a Configuración, Impresoras, y selecciona Print Spooler. El portal detectará automáticamente las impresoras del Spooler.”
5:50Portal - macOSResolver alerta de seguridad”En macOS, si ves una alerta de seguridad, ve a Preferencias del Sistema, Seguridad, y presiona Abrir de todas formas.”
6:20App - AnchosComparar 58mm vs 80mm”NAOS detecta automáticamente el ancho del papel: 58mm para compacto y 80mm para formato completo.”
6:50TipsChecklist”Resumen: empareja Bluetooth en Android antes que en NAOS, usa IP correcta para WiFi, instala el Spooler para el portal web, y siempre prueba la impresión.”
7:20CierreLogo + soporte”¿Problemas con tu impresora? Contacta soporte en naos.pa/soporte.”