En este post te voy a enseñar a imprimir en una impresora térmica usando JavaScript del lado del cliente, evitando confirmación por parte del usuario, gracias a un plugin.
Demostración en YouTube
¿Quieres ver el plugin en funcionamiento? he grabado el siguiente vídeo en donde se muestra cómo descargar el plugin, configurar la impresora, establecerla y usar los ejemplos.
También resuelvo algunas preguntas comunes. Por favor, míralo:
Paso 1: descargar plugin
Ve a la documentación oficial, instala tu impresora y descarga el plugin.
Tal vez tu navegador se queje del mismo, no te preocupes, te aseguro que es totalmente seguro y no es malintencionado.
Cuando acabes de descargar el plugin, ejecútalo, dale permiso de pasar a través del firewall y NO lo cierres.
Paso 2: incluir librería de JavaScript
En tu proyecto de JavaScript incluye el archivo llamado Impresora.js, ya sea descargándolo desde GitHub o desde GitHub pages.
Al incluir la librería tendrás dos clases (lo digo por si tienes unas clases que ya llevan ese nombre), una es Impresora, otra es OperacionTicket.
Paso 3: configurar impresora predeterminada
Por favor ve a este ejemplo, selecciona una impresora de la lista (una que sea térmica obviamente) y haz click en Establecer como predeterminada.
Si todo va bien, debe aparecer un ticket indicando que la impresora es compatible.
Nota: aquí también puedes usar el método setImpresora con el nombre de la impresora, preferentemente obtenida de la lista que obtienes al invocar a getImpresoras.
Recuerda haberla configurado y compartido como lo indico en la documentación.
Paso 4: hola mundo
Ahora que el plugin está instalado y que has incluido la librería, puedes crear una nueva instancia de la clase Impresora así:
let impresora = new Impresora();
El constructor de la clase acepta una URL distinta a la que es por defecto (por si en el futuro cambio el puerto, por ejemplo)
No es necesario que indiques la ruta, como lo dije, se toma la que es por defecto y solo indico esto por si en el futuro permito la posibilidad de cambiarlo.
Después simplemente escribe algo de texto y termina la impresión. El código completo es el siguiente:
La función end regresa una promesa que al resolverse indica el resultado de hacer la impresión.
Ese código debería imprimir tu ticket; si no se puede, por favor mira los ejemplos que están en la documentación.
El código de los ejemplos está en GitHub.
Más sobre esta librería
A continuación te presento algunos fragmentos de código, por favor recuerda que son tomados directamente de los ejemplos y que debes entenderlos antes de usarlos (si copias y pegas, no funcionará)
Recomiendo que leas un poco sobre los detalles técnicos o veas la documentación oficial.
Por cierto, en todos los ejemplos se usa fetch.
Establecer impresora predeterminada
Si quieres establecer la impresora predeterminada a través de código, puedes hacerlo.
Veamos el fragmento de código que existe en el ejemplo:
Solo tienes que hacer una petición PUT a la ruta del servidor /impresora (por ejemplo localhost:8080/impresora), enviando como JSON el nombre de la impresora.
Si el nombre de la impresora es correcto, el mismo se guardará y los siguientes tickets que imprimas se imprimirán en esa impresora (es decir, este paso solo lo debes hacer una vez).
La respuesta del servidor será una cadena; en caso de que la impresora sea compatible, se regresa el mismo nombre de la impresora y se imprimirá un ticket físico.
Obtener lista de impresoras
Igualmente puedes hacerlo a través de una petición GET /impresoras como en el siguiente fragmento de código en los ejemplos:
Eso devolverá un arreglo de las impresoras compartidas; así puedes mostrarle al usuario las impresoras que puede elegir.
Obtener impresora predeterminada
Finalmente, si quieres saber cuál impresora es la predeterminada, haz una petición GET a /impresora como en el fragmento:
Imprimir
Puedes hacer tu propia librería, simplemente mira los detalles técnicos; al final debes hacer una petición POST a /imprimir, con un arreglo como datos.
Preguntas frecuentes
Por favor, antes de dejar un comentario, lee las preguntas frecuentes.
Ejecutar plugin al inicio de Windows
Buenas noticias, he creado un post para indicar cómo ejecutar el plugin al inicio de Windows. Míralo aquí.
Hola, alguna idea para imprimir cupones uno tras otro?; es decir que si genero 3 cupones, que la impresora haga el corte por cupon, a mi me sale los 3 cupones en uno(impresora epson t88v)
Hola, buen día. Lo que dices sería algo así:
// iniciar impresora y todo eso. Después:
impresora.write(“Cupón 1”);
impresora.cut();
impresora.cutPartial();
impresora.write(“Cupón 2”);
impresora.cut();
impresora.cutPartial();
impresora.write(“Cupón 3”);
impresora.cut();
impresora.cutPartial();
impresora.imprimirEnImpresora(“Tu impresora”);
Ten en cuenta que la impresora debe poder cortar el papel. Saludos
con unas cuantas dudas, espero se pueda resolver:
1- porque al inicio me imprime una “@”.
2- cuando finaliza la impresión corta y me desperdicia una porcion de papel.
3- como puedo agregar un marco a la impresion.
4- como puedo agregar una codigo de barra.
de antemano muchas gracias, y buen aporte del plugin
Hola. Respondo tus dudas:
1 – No lo sé, no me ha pasado a mí y a ninguno de mis clientes. Supongo que es el modelo de tu impresora
2 – Puede que sea el encabezado y pie, o cuestión de modificar el plugin para evitar el corte
3 – No es posible por el momento
4 – No es posible por el momento pero en un futuro lo será
Saludos 🙂
Wey… te rifaste! Incluso funciona con impresoras “normales”! En los próximos días haré la compra de la versión Premium! Gracias!
Me parece bien. Saludos 🙂
Gracias Amigo
Como hago para quitar el encabezado y pie de pagina
o talvez podrias poner mas pequeñito es muy grande
Hola. El encabezado se puede quitar con la versión premium. Para más información no dudes en contactarme: https://parzibyte.me/blog/contacto/
Amigo tiene plugin para 32 bits solo me funciona para 64 bits
Hola. Por el momento no, sin embargo, puedes contratarme para hacer el plugin compatible con procesadores de 32 bits: https://parzibyte.me/blog/contrataciones-ayuda/
Amigo al momento de presionar el boton impresora predeterminada me da el siguiente error:
No se pudo establecer la impresora con el nombre \\192.168.2.2\Star SP700 TearBar (SP712)
Hola. No funciona con impresoras en red, mira las limitaciones: https://parzibyte.github.io/plugin-ticket-js/
9/30/2019, 2:07:55 PM Al imprimir: Error en el servidor: sql: no rows in result set
Hola. Por favor lee las preguntas frecuentes: https://parzibyte.github.io/plugin-ticket-js/#faq
Saludos
Hola disculpa alguna solucion para una impresorade etiquetas zebra 420t
Hola; las impresoras de etiquetas son muy distintas a las impresoras térmicas. Por suerte, las mismas vienen (la mayoría de veces) acompañadas con un software de impresión de etiquetas así que solo basta con descargarlo, y listo (tal vez requieran el serial o el comprobante de compra)
Saludos
gracias por el aporte, una pregunta no es necesario llamar a la libreria ?? el archivo Imprimir.js esta en un carpeta que es JS no abra problemas sobre la ruta??
Hola, no importa la ubicación de Impresora.js siempre y cuando la cargues correctamente. Podría estar en una carpeta como js/a/b/c/Impresora.js pero en tu HTML debes incluirlo igual con la misma ruta
Saludos
realize los pasos como mencionas, pero al momento de hacer imprimir me sale en la pantalla el código de imprimir.js donde menciona HOLA MUNDO , donde podría ser error xfavor no manejo muy bien el javascript.
El envió que hago es mediante un <a href=’js/imprimir.js’>
Y gracias de antemano por tiempo
Hola. Si se fija en los ejemplos, y en el código de los ejemplos, verá que debe incluir el script con la etiqueta <script src=”js/imprimir.js”>
Por favor revise los ejemplos, verá que ahí está el código funcionando perfectamente.
Recuerde que también puede contratarme para que yo haga el trabajo: https://parzibyte.me/blog/contrataciones-ayuda/
Saludos
una pregunta para que sirve .then(valor => {
loguear(“Al imprimir: ” + valor);
});
Simplemente estoy esperando el valor de respuesta de fetch, para comprobar si el servidor me regresa la cadena de “Impreso correctamente”; esto es simplemente para indicar que la impresión ya fue terminada
Más sobre fetch: https://parzibyte.me/blog/2019/06/03/fetch-api-javascript-peticiones-http-promesas/
Saludos
Hola que tal, estoy probando tu método, pero en tu página nunca logra establecer la impresora, a pesar de estar corriendo el servidor y ya permitirle todos los permisos de firewall, aun asi intente darle imprimir y me manda este error Al imprimir: Error en el servidor: sql: no rows in result set
Hola, buen día. El error es porque no se ha establecido la impresora, por lo tanto no puede leer datos (no rows) de la BD, porque no se han guardado.
El nombre de la impresora solamente se guarda si la impresión es exitosa, pero en tu caso parece que no se puede establecer la impresora que intentas, tal vez no la has compartido