Ya está disponible la versión 2.94 del plugin Caja.

Esta publicación resume los cambios principales disponibles en esta versión. Lo más destacable es la posibilidad de usar todos los navegadores clientes para imprimir en impresoras locales USB, mediante el protocolo webusb-api. Permitiendo impresión remota a otros dispositivos.

Novedades de la Versión 2.94 (Plugin Caja)

Esta versión incluye una reformulación completa de la arquitectura de impresión térmica vía WebUSB, haciendo que el proceso sea más flexible, inteligente y robusto, además de introducir mejoras solicitadas en el flujo de caja y la usabilidad.

🚀 Novedades Destacadas

1. Impresión Remota WebUSB (Puente de Impresión)

Cada ordenador puede configurarse como nodo de impresion asociado a una impresora. Si tu terminal tiene asociado una impresora, este hará de puente para poder imprimir en esa impresora desde otros dispositivos, requisito que el navegardor web asociado tenga una pestaña abierta en la instalación de FS.

Anteriormente, el protocolo WebUSB solo permitía imprimir en la impresora conectada físicamente al ordenador desde el que se realizaba la venta.

• Ahora: Hemos implementado una arquitectura de comunicación remota a través del servidor. Si realiza una venta desde un teléfono móvil (remoto), el servidor envía el ticket a la cola y el ordenador de la tienda (nodo local) lo detecta e imprime físicamente de forma automática.

2. Polling Globalizado en el Menú Superior

• El script de escucha y monitorización de nuevos tickets (webusb-printer.js) se ha integrado de forma global en el menú de la aplicación.
• Beneficio: La escucha en segundo plano permanece activa de forma transparente en cualquier página administrativa de FacturaScripts por la que esté navegando el operador, garantizando que no se pierda ni quede retenido ningún ticket remoto.

3. Panel Interactivo de Vinculación y Pruebas (EditTicketPrinter)

Hemos añadido una nueva sección visual interactiva dentro de la pestaña Configuración WebUSB de cada impresora:

• Emparejar Impresora USB: Permite asociar la impresora física al navegador con un solo clic (sin necesidad de abrir la consola del desarrollador).
• Probar Impresión (Test): Permite enviar un ticket de prueba ASCII/ESC-POS inmediato para validar la comunicación física.
• Desvincular Impresora: Permite borrar la autorización y el registro del navegador de forma segura.

4. Cobro Rápido con Dos Flujos de Salida

El botón principal del modal de Cobro Rápido se ha dividido en dos botones más eficientes:

• Finalizar: Liquidar la venta y emitir el ticket de impresión correspondiente.
• Finalizar sen ticket: Liquidar la venta en el sistema de forma silenciosa, sin emitir ningún ticket de papel (local o remoto).

🛠️ Mejoras y Ajustes de Rendimiento

• Leader Election en el Navegador: Si el operador tiene varias pestañas de FacturaScripts abiertas en el mismo navegador, el script elige automáticamente una pestaña "Líder" para realizar el polling cada 5 segundos. Esto evita llamadas duplicadas al servidor y ahorra recursos de procesamiento y red.
• Heartbeat de Impresora Activa: El polling actualiza automáticamente el estado de actividad (lastactivity) y asocia el identificador de cliente (client_token) de cada impresora conectada en el panel administrativo.
• Zero Overhead: Si el navegador del cliente no tiene ninguna impresora WebUSB emparejada localmente en el localStorage, el script se apaga de inmediato, reduciendo a cero el tráfico de red innecesario.

🐛 Corrección de Errores (Bugfixes)

• Compatibilidad con PostgreSQL: Se ha actualizado la consulta de búsqueda de tickets pendientes para utilizar el método $db->var2str() al manipular el estado booleano (printed), evitando errores en bases de datos PostgreSQL.
• Persistencia de Datos de Auditoría: En la acción de recuperación de comandos get-escpos, los tickets temporales ya no se eliminan físicamente de la base de datos, sino que se marcan como printed = true. Esto garantiza la conformidad y mantiene el historial para fines de auditoría.
• Limpieza de Logs de Depuración: Se han eliminado todos los dumps y escrituras de depuración temporales en disco (debug_qp.log), dejando el plugin listo y optimizado para entornos de producción estables.