Asistente de Configuracion de Impresora
El Asistente de configuracion de impresora guia al operador para configurar correctamente la impresion en una terminal POS, sin necesidad de conocer las 12 estrategias disponibles. Detecta el dispositivo, recomienda las mejores opciones y prueba la impresion antes de guardar.
Ubicacion: dialogo de configuracion de impresora → boton Asistente (icono varita magica).
Cuando usar el asistente
| Escenario | Recomendacion |
|---|---|
| Configurar una nueva terminal por primera vez | Si — el asistente es la via mas rapida |
| Migrar un terminal a un nuevo dispositivo (ej. de PC a tablet) | Si — re-detecta capacidades |
| Cambiar la impresora del terminal | Si — sugerira la mejor estrategia para el nuevo hardware |
| Ajustar opciones avanzadas (codificacion, copias, etc.) | No — usar el dialogo de configuracion clasico |
Pasos del asistente
El asistente consta de 4 pasos guiados con un stepper visual.
Paso 1 — Detectar
El asistente analiza automaticamente:
| Capacidad | Detectada por |
|---|---|
| Tipo de dispositivo | Inspeccion del User-Agent + caracteristicas del navegador |
| Web Bluetooth disponible | 'bluetooth' in navigator |
| QZ Tray disponible | Conexion WebSocket a QZ Tray (probe asincrono) |
| Bridge nativo MAUI | window.nativePrint.isAvailable() |
| Contexto seguro (HTTPS) | window.isSecureContext |
| Pantalla tactil | ontouchstart / maxTouchPoints |
El dispositivo se clasifica en una de 6 clases:
| Clase | Cuando se asigna |
|---|---|
| DesktopChrome | PC con Chrome o Edge desktop |
| DesktopOther | PC con Safari, Firefox, etc. |
| AndroidTablet | Android sin "Mobile" en UA |
| AndroidPhone | Android con "Mobile" en UA |
| IOSDevice | iPhone, iPad o iPod |
| MauiHybrid | App POS movil con bridge nativo |
Paso 2 — Elegir
Segun la clase detectada, el asistente muestra de 2 a 4 estrategias rankeadas por score (0-100):
Recomendaciones por clase
MauiHybrid (app POS movil):
- Red TCP (ESC/POS) — score 100
- Bluetooth ESC/POS — score 90
iOS:
- WebPRNT WiFi (Star/Epson) — score 95
- Red TCP (ESC/POS) — score 70 (requiere PC servidor)
- Navegador — score 40
AndroidTablet / AndroidPhone:
- Web Bluetooth — score 95 (si HTTPS y BT disponible)
- WebPRNT WiFi — score 90
- RawBT (Android intent) — score 75
- Navegador — score 30
DesktopChrome:
- QZ Tray ESC/POS — score 100 si QZ esta corriendo, 90 si no
- QZ Tray driver Windows — score 85 (solo si QZ esta corriendo)
- Red TCP (ESC/POS) — score 80
- Web Bluetooth — score 70 (si HTTPS y BT)
- WebPRNT WiFi — score 65
DesktopOther:
- Red TCP (ESC/POS) — score 80
- WebPRNT WiFi — score 75
- Navegador — score 30
Cada recomendacion muestra:
- Titulo y descripcion breve
- Score (0-100)
- Tags indicativos:
Requiere app externa(QZ Tray, RawBT)HTTPS(Web Bluetooth)
Paso 3 — Configurar
Segun la estrategia elegida, se muestra un formulario adaptado:
| Estrategia | Campos |
|---|---|
| Red TCP | IP/Host, Puerto |
| WebPRNT WiFi | IP/URL, Puerto HTTP |
| Web Bluetooth | Identificador (auto al emparejar) + boton Emparejar |
| QZ Tray / WindowsDriver | Combo de impresoras + boton Buscar |
| Android intent | Esquema (default rawbt) |
| Bluetooth ESC/POS | Direccion MAC |
| Browser / None | Sin campos |
Adicionalmente, todos los tipos comparten:
| Campo | Predeterminado |
|---|---|
| Ancho del papel | 80mm |
| Copias | 1 |
| Codificacion | CP850 |
Emparejamiento Web Bluetooth
Al tocar Emparejar:
- El navegador muestra un dialogo nativo con los dispositivos BT cercanos.
- El operador selecciona la impresora.
- El navegador guarda el permiso para esa origen + dispositivo.
- El identificador se guarda en
localStoragepor terminal. - Las impresiones siguientes no requieren volver a emparejar.
Paso 4 — Probar
El asistente envia automaticamente una impresion de prueba con los datos configurados. El resultado se muestra:
| Resultado | Significado |
|---|---|
| OK (verde) | La estrategia se ejecuto sin errores. La impresora deberia haber emitido el ticket. Verificar fisicamente. |
| Falla (rojo) | Mensaje de error tecnico. Volver al paso 3 para revisar configuracion. |
Botones disponibles:
- Probar de nuevo: re-envia la prueba sin guardar.
- Atras: vuelve al paso 3 para ajustar.
- Guardar configuracion: persiste la configuracion en la terminal y cierra el asistente.
Persistencia y herencia
Cuando se guarda desde el asistente:
- La configuracion se persiste en la entidad
POSTerminal. - Los campos no tocados explicitamente respetan los defaults de empresa ya aplicados al crear la terminal.
- Las preferencias del navegador (ej. permiso BT) se almacenan en
localStoragecon clavecore360.webbt.devices.
Ver Defaults de impresion por empresa para configurar valores predeterminados a nivel empresa.
Troubleshooting
| Sintoma | Causa probable | Solucion |
|---|---|---|
| Web Bluetooth no aparece como recomendacion | No hay HTTPS o navegador sin soporte | Acceder a Core360 por HTTPS desde Chrome/Edge |
| QZ Tray no aparece detectado pero esta instalado | El servicio QZ no esta corriendo | Reiniciar QZ Tray desde la bandeja del sistema |
| El dialogo de emparejamiento BT no muestra dispositivos | La impresora no esta en modo emparejable | Ver el manual de la impresora para activar BT discoverable |
| Error CORS al imprimir WebPRNT | La impresora bloquea CORS | Habilitar "Allow Cross-Origin" en el panel admin de la impresora |
| RawBT no se abre al imprimir | RawBT no esta marcado como handler por defecto | Reinstalar RawBT y aceptar "siempre" en el primer intent |