Playbook: Impresoras y Print Spooler
Mapa de Impresión en NAOS
| Plataforma | Método de impresión | Conexiones |
|---|---|---|
| App Móvil | Directo desde la app | Bluetooth, WiFi/Red, USB, Built-in (Senraise) |
| Portal Web | Via NAOS Print Spooler | WiFi/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.
| Paso | Verificació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:
- Apaga y enciende la impresora.
- En Android: Ajustes > Bluetooth > Desempareja la impresora > Vuelve a emparejar.
- En NAOS: Ajustes > Impresoras > Elimina la impresora > Vuelve a agregarla.
- Prueba con “Probar Impresión”.
Problema 2: No imprime (WiFi/Red)
Síntomas: Error de conexión al imprimir. Timeout.
| Paso | Verificació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:
- Verifica la IP imprimiendo la página de configuración de la impresora (generalmente manteniendo un botón).
- En NAOS: Ajustes > Impresoras > Edita la IP y puerto.
- 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:
- Verifica que la impresora sea compatible con ESC/POS (la mayoría de térmicas lo son).
- Si la impresora tiene un interruptor DIP o configuración, activa el modo ESC/POS.
- 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:
- Verifica el ancho físico del rollo: 58mm (mini) o 80mm (estándar).
- NAOS detecta automáticamente el ancho en la mayoría de casos.
- Si no detecta: Ajustes > Impresoras > configura el ancho correcto.
| Ancho | Caracteres por línea | Formato |
|---|---|---|
| 58mm | 32 chars | Compacto — sin columna de impuesto por ítem |
| 80mm | 42 chars | Completo — 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:
- Verifica que la app NAOS tiene permisos de acceso al hardware.
- Cierra la app completamente y vuelve a abrirla.
- 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:
- ¿El Spooler está corriendo? — Debe estar activo en
localhost:9100. - ¿Estás en la misma computadora? — El Spooler funciona localmente.
- ¿El navegador bloquea localhost? — Algunos navegadores restringen conexiones locales.
Solución:
| OS | Verificar que corre | Comando |
|---|---|---|
| Windows | Icono en la bandeja del sistema (system tray) | Busca “NAOS Print Spooler” en la bandeja |
| macOS | Icono en la barra de menú | Busca el icono de NAOS en la barra superior |
| Linux | Proceso en background | Verifica que el proceso está corriendo |
- Si no está corriendo: Abre NAOS Print Spooler desde Aplicaciones.
- Si corre pero no detecta: Abre
http://localhost:9100en el navegador — deberías ver la interfaz del Spooler. - 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:
- Verifica que la impresora está encendida y en la misma red.
- En el Spooler: Agrega la impresora por IP y puerto (generalmente IP:9100).
- Presiona “Probar Conexión” — debe responder exitosamente.
- 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:
- No arrastres a la papelera.
- Ve a Preferencias del Sistema > Seguridad y Privacidad.
- En la pestaña General, verás un mensaje sobre la app bloqueada.
- Presiona “Abrir de todas formas”.
- 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
| Tiempo | Escena | Acción | Narración |
|---|---|---|---|
| 0:00 | Intro | Logo 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:20 | Diagrama | Mapa: 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:50 | App - Bluetooth | Configurar impresora Bluetooth paso a paso | ”Empecemos con Bluetooth. Primero empareja la impresora en los ajustes de Android, luego agrégala en NAOS.” |
| 1:30 | App - Prueba | Probar impresión exitosa | ”Siempre haz una prueba de impresión después de configurar.” |
| 2:00 | App - WiFi | Configurar impresora por IP | ”Para WiFi, necesitas la dirección IP de la impresora y el puerto, generalmente 9100.” |
| 2:30 | App - Senraise | Mostrar detección automática | ”Si tienes un dispositivo Senraise, la impresora se detecta automáticamente. No necesitas configurar nada.” |
| 3:00 | App - Problema BT | Desemparejar y reemparejar | ”Si el Bluetooth no funciona: desempareja en Android, vuelve a emparejar, y reconfigura en NAOS.” |
| 3:40 | App - Problema chars | Mostrar 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:10 | Portal - Spooler | Instalar y abrir Print Spooler | ”Para el portal web, necesitas el NAOS Print Spooler. Descárgalo desde la sección de descargas.” |
| 4:50 | Portal - Config | Agregar impresora en el Spooler | ”Abre el Spooler, agrega tu impresora por IP, y prueba la conexión.” |
| 5:20 | Portal - NAOS | Configurar 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:50 | Portal - macOS | Resolver alerta de seguridad | ”En macOS, si ves una alerta de seguridad, ve a Preferencias del Sistema, Seguridad, y presiona Abrir de todas formas.” |
| 6:20 | App - Anchos | Comparar 58mm vs 80mm | ”NAOS detecta automáticamente el ancho del papel: 58mm para compacto y 80mm para formato completo.” |
| 6:50 | Tips | Checklist | ”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:20 | Cierre | Logo + soporte | ”¿Problemas con tu impresora? Contacta soporte en naos.pa/soporte.” |