Por mucho tiempo he buscado la manera de imprimir texto en español en un ticket con una impresora térmica desde JavaScript, incluyendo también la letra ñ, el signo de apertura de interrogación, etcétera.
Esto es necesario porque en varias ocasiones necesitamos colocar algo como ¡Gracias por su compra! al final del ticket, y si no contamos con el símbolo ¡ entonces el mensaje puede no verse bien.
Lo mismo pasa cuando el nombre de un cliente tiene acentos y necesitamos imprimirlo en el ticket. Por ello es que en este post te mostraré cómo imprimir texto con acentos en una impresora térmica usando JavaScript.
Configurando entorno
Para poder comunicarnos con impresoras térmicas desde JS vamos a usar un plugin. Mira antes el tutorial de instalación y uso básico:
Ahora veamos el código en donde supondré que ya estás ejecutando el plugin, has impreso el ticket de prueba (además de haber compartido tu impresora) e importado el conector de JavaScript.
Probar si la impresora soporta acentos sin configurar nada
Algunas impresoras soportan la impresión de texto en español, acentos y eñes sin configurar nada. Solo debes imprimir el texto normalmente. Veamos el siguiente ejemplo:
Comenzamos creando una instancia del conector, una vez que la tenemos invocamos a EscribirTexto así:
En la impresora GOOJPRT PT-210 funciona sin configurar y la salida es igual a la que se ve a continuación:
Si en tu caso tu impresora no lo soporta vamos a ver una solución, ya que yo tengo una Xprinter X-58 y aparecen caracteres chinos o letras extrañas pero no aparece el texto en español.
Imprimiendo acentos
Ahora vamos a forzar a que tu impresora imprima texto con acentos. Si tu impresora es china deberías invocar al método DeshabilitarElModoDeCaracteresChinos y después de eso invocar a TextoSegunPaginaDeCodigos enviando el número de página, la codificación y el texto.
En mi caso he usado la página número 2 pero en lugar de cp860 (como debería ser) especifico cp850
Así puedo imprimir lo siguiente con todo y acentos, signos, etcétera:
cp850 con numero 2 ¿EL VELOZ MURCIÉLAGO
HINDÚ COMÍA FELIZ CARDILLO Y KIWI? ¡LA CIGÜEÑA TOCABA EL SAXOFÓN DETRÁS DEL
PALENQUE DE PAJA!.cp850 con número 2 ¿el veloz murciélago hindú comía feliz
cardillo y kiwi? ¡la cigüeña tocaba el saxofón detrás del palenque de paja!.
El código queda como se ve a continuación:
El resultado del ejemplo es:
Ejemplo completo: ticket de venta
Para demostrar más las capacidades de este plugin voy a crear un pequeño ticket de venta. El código queda así:
En este caso el nombre del cliente lleva acentos, el mensaje al final del ticket lleva la letra ñ así como el símbolo de apertura de exclamación.
Al final puedes diseñar tus tickets como te parezca, aquí solo te demuestro las capacidades del plugin.
Poniendo todo junto
El código completo del ejemplo que te mostré anteriormente queda así:
Puedes ver el código completo y otros ejemplos en este repositorio de GitHub: https://github.com/parzibyte/ejemplos-javascript-plugin-v3
También puedes probar la demostración aquí: https://parzibyte.github.io/ejemplos-javascript-plugin-v3/acentos.html
Recuerda que para probarla el plugin debe estar ejecutándose en segundo plano en el equipo donde pruebes.
Sobre las páginas de códigos
Las páginas de códigos cambian dependiendo de la impresora. Al imprimir en la impresora no es necesario indicar la codificación, pero yo lo hago porque convierto los caracteres usando iconv.
Si no te funciona con una página de códigos deberías probar combinando el número y el nombre de la página o leyendo la documentación de tu impresora.
Por cierto, en este caso lo hicimos con JavaScript pero el plugin también funciona en Python, Java y cualquier lenguaje que hable HTTP. Los conectores están listados en: https://parzibyte.me/blog/2022/09/30/plugin-impresoras-termicas-version-3/
Recuerda que si necesitas ayuda puedes enviarme un mensaje en https://parzibyte.me/#contacto.
