Este módulo proporciona una alternativa de software puro a la Odoo IoT Box para la impresión de recibos térmicos en el Punto de Venta, utilizando QZ Tray como controlador de impresión.
Extiende base_report_to_printer_qz —que añade soporte de backend de QZ Tray a printing.printer— y lleva esa funcionalidad al POS, permitiendo a los usuarios seleccionar una impresora con backend = qztray directamente desde la configuración del POS.
Características principales:
- Soporte de cajón de efectivo: el comando de apertura del cajón de efectivo (ESC p) se envía automáticamente después de cada impresión de recibo.
- No requiere IoT Box: diseñado como una alternativa solo de software para configuraciones en las que no es deseable desplegar infraestructura IoT.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Imprime los recibos del POS directamente en una impresora térmica local usando el software QZ Tray en lugar de una IoT Box. Actívalo por punto de venta, elige una impresora QZ Tray y los recibos junto con los comandos del cajón de efectivo se envían automáticamente.
Este módulo permite a un punto de venta imprimir los recibos de los clientes en una impresora térmica local sin necesidad de una Odoo IoT Box. Funciona junto con QZ Tray, un pequeño programa instalado en el ordenador del cajero.
En los ajustes del punto de venta, dentro de la sección de dispositivos, aparece una nueva opción "QZTray". Cuando se activa, puedes elegir una "QZTray Receipt Printer" entre las impresoras ya configuradas con el backend de QZ Tray, y marcar la opción del cajón de efectivo.
Durante el pago, el recibo que se muestra en pantalla se convierte en una imagen y luego el servidor lo transforma en comandos de impresora ESC/POS. Esos comandos se envían a la impresora seleccionada a través de QZ Tray. Después de cada recibo, se envía automáticamente el comando de apertura del cajón de efectivo, de modo que el cajón se abre sin clics adicionales.
También existe una ruta de servidor para renderizar cualquier imagen de recibo con el ancho correcto para papel de 58 mm u 80 mm. El módulo toca la configuración del punto de venta (pos.config) y la lista de impresoras de impresión, y añade un servicio de impresora dentro de la interfaz del POS. No modifica documentos de contabilidad, inventario ni ventas.
Depende de
Modelos y campos (1)
- pos.config · amplía un modelo existenteis_qztray (Enable QZ Tray Printing), iface_qztray_printer_id (QZ Tray Printer)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.
Fuentes · Odoo 19.0
Confirmado el 2026-11-03 en la rama 19.0 de OCA/pos.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Instalación
Fuente · Odoo 19.0Este módulo requiere la siguiente dependencia que no es de Python:
- QZ Tray debe estar instalado y en ejecución en la máquina cliente que opera el POS.
Dependencia de módulo de Odoo (debe instalarse primero):
- base_report_to_printer_qz — proporciona el backend de impresora QZ Tray y el modelo printing.printer con soporte para backend = qztray.
Dependencias de Python (instaladas automáticamente mediante external_dependencies):
- python-escpos
Configuración
Fuente · Odoo 19.0Para configurar este módulo, necesita:
- Instalar y lanzar la aplicación de escritorio QZ Tray en la máquina donde está conectada la impresora térmica.
- En Odoo, vaya a Point of Sale \> Configuration \> Settings.
- Seleccione su configuración de POS y active QZ Tray Printing.
- Opcionalmente, seleccione una QZ Tray Printer de la lista — solo se muestran las impresoras con backend = qztray (gestionadas por base_report_to_printer_qz). Si se deja vacío, QZ Tray utilizará la impresora predeterminada del sistema.
- Guarde la configuración y abra la sesión de POS.
Para extender o personalizar la plantilla del recibo, herede PosEscposController en su propio módulo y sobrescriba los métodos _get_* relevantes (por ejemplo, _get_header, _get_order_lines). No se requieren cambios en el frontend.
Para usar este módulo, necesita:
- Abrir una sesión de POS que tenga habilitada la impresión con QZ Tray.
- Asegurarse de que la aplicación de escritorio QZ Tray esté en ejecución en la máquina del POS.
- Procesar una venta y hacer clic en Payment para imprimir el recibo.
El recibo se envía directamente a la impresora térmica a través de QZ Tray. El HTML del recibo se renderiza a PNG y se convierte al formato ESC/POS en el servidor antes de enviarse siguiendo la lógica nativa de Odoo. El cajón de efectivo se abre automáticamente después de cada impresión si está habilitado.
No se requiere ninguna configuración de IoT Box ni de impresora de red.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.