El problema surge porque la versión antigua (2017) utilizaba una codificación de base de datos antigua (como latin1), mientras que las versiones recientes utilizan por defecto una codificación más moderna y estándar (como utf8mb4). Si instalas la nueva versión sobre la base de datos antigua directamente, el instalador detecta su codificación y la respeta. Sin embargo, si instalas sobre una base de datos nueva y vacía, el instalador configurará el sistema para usar la codificación moderna, añadiendo las constantes FS_MYSQL_CHARSET y FS_MYSQL_COLLATE al archivo config.php.
Si ya tienes este problema, la solución es instalar el complemento Backup y restaurar de nuevo la base de datos completa de tu instalación antigua (2017) sobre la actual.
Imprimir un ticket de factura
Con el complemento Tickets puede imprimir tickets de facturas, albaranes, pedidos, presupuestos y servicios. Simplemente haga clic en las opciones del botón Imprimir (la flecha desplegable) y seleccione Ticket.
En la siguiente pantalla podrá seleccionar la impresora de tickets que tenga configurada y el tipo de ticket deseado (por ejemplo, normal o para regalo).
Configurar impresora de tickets
Si todavía no ha configurado la conexión con la impresora de tickets, puede hacerlo desde el menú Administrador → Tickets, y haciendo clic en el botón Nuevo.
En la siguiente pantalla, escriba un nombre identificativo o la marca de la impresora y pulse el botón Guardar.
Por último, desde la misma página de configuración, debe descargar e instalar la aplicación de impresión (mc20printer) para conectar la impresora de tickets físicamente. En dicha aplicación deberá escribir la URL de su sistema y la clave API (API key) que se ha generado.
Recuerde que la aplicación de impresión (mc20printer) debe permanecer abierta y en ejecución en el equipo conectado a la impresora para que pueda recibir y procesar los trabajos de impresión de tickets.
Opciones de configuración
Entre las opciones de configuración de la impresora de tickets tenemos:
Configuración general:
Tamaño de la fuente estándar.
Tamaño de la fuente para el título.
Imprimir nombre corto de la empresa (en lugar del nombre completo).
Imprimir el teléfono de la empresa.
Imprimir los recibos de la factura.
Imprimir las formas de pago.
Imprimir el logotipo.
Textos personalizados:
Texto de cabecera del ticket.
Tamaño de la fuente del texto de cabecera.
Texto de pie de página del ticket.
Tamaño de la fuente del texto del pie de página.
Opciones de las líneas del documento (productos/servicios):
Imprimir referencias.
Imprimir descripciones.
Imprimir cantidades.
Imprimir precios.
Imprimir precios con IVA.
Imprimir descuentos.
Imprimir importe neto.
Imprimir totales (con impuestos).
Logotipo en los tickets
No todas las impresoras soportan imágenes, por lo que no tenemos un sistema universal para imprimir el logotipo en los tickets. Lo que si que tenemos es la opción de imprimir el logotipo que previamente tenga guardado la impresora. Para ello puede usar la propia app de configuración de su impresora (la que se suele instalar con los drivers) para cargar el logotipo.
Una vez guardado el logotipo en la impresora, marque la casilla de imprimir logo y pulse guardar:
Guía rápida: QZ Tray para imprimir tickets
Guía sencilla para instalar y usar QZ Tray con ElequipoIA y tu impresora térmica USB.
1) Instalar QZ Tray 🔗
Descarga: Ve a https://qz.io/download/.
Instala: Abre el archivo descargado y sigue el asistente de instalación (Windows .exe, macOS .pkg, instalador para Linux).
Abre QZ Tray: Tras la instalación, lo verás en ejecución en la bandeja del sistema (área de notificaciones).
Inicio automático: Haz clic derecho en el icono de QZ Tray en la bandeja del sistema → Activa la opción «Automatically Start» (Iniciar automáticamente).
Solo tienes que configurar esto una vez.
Es aconsejable seguir también las instrucciones oficiales de instalación en la página de QZ Tray.
2) Conectar y configurar la impresora
Abrir configuración
Dentro del panel de QZ Tray, pulsa en la opción «Configurar impresora» (o «Printer Configuration»).
Conexión (normalmente automática): QZ Tray intenta conectarse automáticamente si ya tiene permisos. Si aparece una ventana pidiendo permiso, pulsa «Allow» y marca «Remember this decision».
Escanear dispositivos: Pulsa el botón «Escanear dispositivos USB».
Elegir impresora: Normalmente tu impresora aparecerá reconocida en la lista (si ha sido testeada por el equipo de desarrollo). Pulsa «Seleccionar»; esto aplicará automáticamente los parámetros óptimos en la configuración manual y la impresora estará lista para usarse.
Si no aparece reconocida: Rellena manualmente los campos inferiores (Vendor ID, Product ID y, si es necesario, la interfaz y el endpoint). Asegúrate de que estos datos sean correctos y correspondan a tu modelo de impresora.
Para usuarios avanzados: Puedes realizar pruebas y depurar la conexión en https://demo.qz.io/.
Probar impresión: Elige el ancho de papel (habitualmente 80 mm o 58 mm) y pulsa «Imprimir ticket de prueba».
En el ticket de prueba verás impresa una «regla» con medidas.
Si la regla no coincide con el ancho real del papel (queda corta o provoca un salto de línea inesperado), el tamaño elegido es incorrecto. Cambia el ancho en la configuración y repite la prueba.
Demasiado estrecho (queda espacio sin usar a la derecha)
|-----------XX---|Demasiado ancho (el texto se parte en dos líneas)
- |————————————
——-XX—| Correcto (la línea toca ambos bordes en una sola línea continua)
|------------------------------XX---|
Si imprime correctamente, la configuración queda guardada automáticamente en tu navegador.
3) Imprimir un ticket
En el panel o menú de impresión del sistema, pulsa en el botón de QZ Tray.
Elige la impresora configurada (se utilizarán automáticamente los parámetros que guardaste para ella).
(Opcional) Elige el formato de ticket si hay varias opciones.
Pulsa “Imprimir Ticket”.
Solución rápida de problemas
-
No conecta:
-
Asegúrate de que QZ Tray está abierto y en ejecución (visible en la bandeja del sistema).
-
Recarga la página de ElequipoIA en tu navegador.
-
-
En localhost pide permiso constantemente:
-
Si trabajas en un entorno local (localhost), el navegador puede solicitar permiso en cada impresión porque no se usa un certificado SSL (HTTPS). Es un comportamiento normal en ese entorno.
-
-
No detecta la impresora:
-
Enciéndela y revisa la conexión del cable y el puerto USB.
-
Vuelve a la configuración y pulsa de nuevo «Escanear dispositivos USB».
-
-
Imprime mal o con símbolos raros:
-
Revisa el ancho de papel configurado (80 mm / 58 mm) y verifica con la regla del ticket de prueba.
-
Si configuraste la impresora manualmente, comprueba los campos inferiores (Vendor ID, Product ID, etc.) o prueba la conexión en demo.qz.io.
-


