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.
Presentando la versión 2
Actualización febrero de 2021: ya existe la versión 2 de este plugin. Es una mejora.
Presentando plugin para impresoras térmicas v2 – Compatible con JavaScript y otros lenguajes
Puedes usar esta versión o usar la versión 2. Como tú lo prefieras. Recuerda que ambas versiones son totalmente distintas y no son compatibles entre sí.
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 como se indica en la página.
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
Nota: recomiendo ver el ejemplo en la documentación oficial, pues establecer la impresora predeterminada siempre trae problemas, así que en su lugar usa “imprimirEnImpresora.
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
Te repito que no deberías establecer la impresora predeterminada, sino invocar a “imprimirEnImpresora” en lugar de “end” tal y como se muestra en el ejemplo.
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í.
Versión para Linux
Después de un poco de trabajo he compilado la versión para Linux, si quieres échale un vistazo.
59 Comentarios
Jean Carlos · noviembre 7, 2021 a las 5:58 am
El script recibe const RUTA_API = “http://localhost:8000”, esto funciona perfecto en la computadora donde esta la impresora, al fijar una ip de Lan en mi caso const RUTA_API = “http://192.168.1.24:8000” funciona perfecto, la interrogante es que mi sitio tiene un certificado SSL y si cambio de localhost a una ip de la lan, por consola me da este error: net::ERR_SSL_PROTOCOL_ERROR
uncaught (in promise) TypeError: Failed to fetch
at Impresora.end
Estoy en pruebas para poder tener el Permium una vez se resuelva este problema.
Muchas Gracias.
parzibyte · noviembre 7, 2021 a las 12:32 pm
No va a funcionar por temas de seguridad
Hernando · septiembre 30, 2021 a las 1:48 pm
Hola, como esta?
Desde un tiempo llevo usando su sistema de impresión que me ha sido muy útil en mis proyecto, pero en el dia de hoy se me esta presentando el siguiente error
Access to fetch at ‘http://localhost:8000/impresoras’ from origin ‘http://dominio.adquirido’ has been blocked by CORS policy: The request client is not a secure context and the resource is in more-private address space local.
impresora.js:73 GET http://localhost:8000/impresoras net::ERR_FAILED
Nunca habia tenido un error y hoy me salio este error, me puedes colaborar
parzibyte · octubre 1, 2021 a las 11:03 am
Hola. Ya le he respondido por correo pero le dejo aquí un post explicando por si a alguien más le sirve: https://parzibyte.me/blog/2021/10/01/the-request-client-is-not-a-secure-context-and-the-resource-is-in-more-private-address-space-local/
Hernando · febrero 4, 2021 a las 1:13 pm
Hola amigo, te pregunto como configuro mi sitio para imprimir ya que tengo la version premium, me sale (index):1 Uncaught (in promise) TypeError: Failed to fetch, yo realizo el siguiente codigo para imprimir de JS
imp = new Impresora()
imp.ruta = ‘dominioregistrdo.extencion:4000’
imp.write(“…………………………………………”)
imp.feed(5)
imp.cut()
imp.imprimirEnImpresora(“nombre de impresora”)
Al final me sale el error
impresora.js:137 Fetch failed loading: POST “http://dominioregistrdo.extencion:4000/imprimir_en”.
imprimirEnImpresora @ impresora.js:137
(anonymous) @ VM1823:1
(index):1 Uncaught (in promise) TypeError: Failed to fetch
Promise.then (async)
imprimirEnImpresora @ impresora.js:141
(anonymous)
parzibyte · febrero 4, 2021 a las 1:34 pm
Hola. El código que le funciona con el plugin gratuito le debe funcionar con el premium, la única diferencia es que en la gratuita aparece el encabezado y el pie. Por ello es que antes de obtener la versión premium se indica que se familiaricen con la versión gratuita. Recuerde que en la documentación oficial (https://parzibyte.github.io/plugin-ticket-js) hay varios ejemplos
hernando · febrero 4, 2021 a las 1:38 pm
amigo, me puedes confirmar por que puerto configuraste el dominio que te proporcione, ya que utilizo el plugin y cada ves que hago new Impresora() me sale el localhost:8000
parzibyte · febrero 4, 2021 a las 2:20 pm
Hola. Si quiere comunicarse conmigo puede hacerlo desde el correo en donde le envié el plugin premium para una comunicación más directa
Saludos!
Hernando · febrero 4, 2021 a las 9:43 am
Hola, quiero saber si el .exe se puede instalar en el celular o tablet
Hernando · febrero 4, 2021 a las 7:48 am
Hola, Te pregunto se puede usar el .exe desde un dispositivo móvil como tablet o celular?
parzibyte · febrero 4, 2021 a las 12:01 pm
Hola. Si puede instalarlo en el dispositivo significa que sí se puede
Saludos
Hernando Hernandez · enero 29, 2021 a las 10:18 am
Hola amigo, gracias por su gran aporte, estoy interesado en comprar la versión paga, pero te pregunto hay alguna forma en la cual no se me restringa a ningún dominio aunque el valor aumente, además si te pago hoy mismo cuanto te demoras en activar o mandar el nuevo plugin
parzibyte · enero 29, 2021 a las 12:00 pm
Hola. Encontrará toda la información en: https://parzibyte.github.io/plugin-ticket-js/
Saludos
Juan · noviembre 10, 2020 a las 9:15 am
Está genial esto, me ayudó mucho. Cada impresión saca tu logo parzibyte.me/blog. ¿Para quitar el logo debo pagar por la versión premium? ¿en dicho caso cuanto vale?
parzibyte · noviembre 10, 2020 a las 11:11 am
Hola, gracias por sus comentarios. Le respondo sus dudas en las preguntas frecuentes:
https://parzibyte.github.io/plugin-ticket-js/#faq
Saludos 🙂
Francisco Cruz · agosto 5, 2020 a las 4:11 pm
Hola estoy haciendo una prueba desde tu pagina
https://parzibyte.github.io/plugin-ticket-js/ejemplos/simple/index.html
lee las impresoras perfectamente
predetermina la impresora sin problema, en este punto envia un ticket de prueba
pero al darle el boton de imprimir ticket me genera el siguiente error
5/8/2020 16:07:24 Al imprimir: Error en el servidor:
me interesa comprar el plugin
Francisco Cruz · agosto 5, 2020 a las 4:26 pm
En la consola recibo el siguiente mensaje
Access to fetch at ‘http://localhost:8000/imprimir_en’ from origin ‘null’ has been blocked by CORS policy: No ‘Access-Control-Allow-Origin’ header is present on the requested resource. If an opaque response serves your needs, set the request’s mode to ‘no-cors’ to fetch the resource with CORS disabled.
Wil · julio 6, 2020 a las 7:00 pm
En la version premium cuando mencionas esto de los 3 dominios, a que te refieres, donde configuras los dominios, o te refieres que el plugin solo podra recibir peticiones de 3 dominios/subdominios diferentes?
parzibyte · julio 6, 2020 a las 8:19 pm
Hola, me parece que ya le respondí por correo, pero así es, solo aceptará peticiones de los dominios configurados.
Saludos 🙂
Victor · abril 25, 2020 a las 12:12 pm
Hola excelente trabajo, una pregunta, el plugin los tines compilado para linux
Victor · abril 25, 2020 a las 1:51 am
Hola Amigo, excelente trabajo, por casualidad tienes el plugin compilado para linux???, Tengo que montarlo en linux
parzibyte · abril 25, 2020 a las 12:36 pm
Hola. Por el momento solo para Windows; si quieres una versión personalizada puedes hablarme de manera privada.
Saludos 🙂
PEDRO DE LEON RODAS · marzo 6, 2020 a las 7:48 pm
Buen dia.
Que precio tiene tu plugin ?
El pago se hace por Paypal ?
Gracias
parzibyte · marzo 6, 2020 a las 8:58 pm
Buen día. El precio y la dirección de pago lo encuentras aquí: https://parzibyte.github.io/plugin-ticket-js/#faq
Saludos
Crystien Guzman · enero 27, 2020 a las 5:24 pm
Buenas Noches amigo Parzibyte, primero que nada debo agradecer toto el aporte que has hecho. pero requiero de tu ayuda para solucionar un problema que ya me esta dando dolor de cabeza. Me esta generando un error al momento de mandar a imprimir mientras que cuando le doy a establecer como predeterminado si se ejecuta exitosamente.. Podrias ayudame por favor
parzibyte · enero 27, 2020 a las 7:21 pm
Hola, gracias por sus comentarios. Le genera algún error o simplemente no imprime? debería refrescar la página e intentar de nuevo; o probar con el método imprimirEnImpresora que le permite indicar el nombre de la misma.
Saludos 🙂
Crystien Guzman · enero 27, 2020 a las 7:27 pm
Ya probe varios metodos de los que indica y no se que pasa, el error que genera es incluso desde la pagina que coloca como test (27/1/2020 21:20:03 Al imprimir: Error en el servidor: ) ese es el error…. pero cuando coloco la impresora como predeterminada desde el boton si me genera una informacion. Por favor ayuda.
Crystien Guzman · enero 27, 2020 a las 7:37 pm
27/1/2020 21:20:03 Al imprimir: Error en el servidor: ese es el error que me dio amigo.! ya no se que probar para que envie la impresion. Sin embargo con el metodo de impresion desde PHP si me funciono solo que al subirlo a un servidor (nube cpanel) me da error al imprimir tambien entonces estoy en ese problema. Sera que puedes ayudarme amigo por favor
parzibyte · enero 27, 2020 a las 8:02 pm
Ya veo… podría mostrarme el código que usa? o es solo en la demostración?
Jorge · enero 24, 2020 a las 7:38 pm
¿Cómo puedo imprimir desde PHP?
¿Puedo imprimir un PDF?
parzibyte · enero 24, 2020 a las 8:09 pm
Solo se puede imprimir desde JavaScript, pues ese es el propósito del plugin. Sobre el PDF, no, no es posible.
Saludos 🙂
Omar Gerardo · enero 13, 2020 a las 4:27 pm
Pregunta se puede imprimir un pequeño logo una imagen jpg con el plugin
parzibyte · enero 13, 2020 a las 5:27 pm
Por el momento solo se pueden imprimir códigos QR, en el futuro implementaré la impresión de imágenes.
Saludos 🙂
giancarlo melgarejo · diciembre 30, 2019 a las 4:12 pm
Buenas tardes,
Quisiera mas información sobre la versión premium, a que se refiere que solo es para 3 dominios ? , eso quiere decir que una ves que establezca los dominios ya no los podre cambiar ?, por ejemplo si yo trabajo con un dominio y a futuro el dominio lo cambio ya no podre hacer eso ? , la licencia es permanente o tengo que pagar algo al año ?
parzibyte · diciembre 30, 2019 a las 4:16 pm
Hola. Actualmente es un pago único; los 3 dominios se pueden cambiar.
Saludos
llanera_sol · noviembre 29, 2019 a las 4:32 pm
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)
parzibyte · noviembre 29, 2019 a las 11:49 pm
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
ervin · noviembre 27, 2019 a las 4:16 pm
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
parzibyte · noviembre 27, 2019 a las 5:16 pm
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 🙂
Carlos · noviembre 16, 2019 a las 7:43 pm
Wey… te rifaste! Incluso funciona con impresoras “normales”! En los próximos días haré la compra de la versión Premium! Gracias!
parzibyte · noviembre 16, 2019 a las 9:50 pm
Me parece bien. Saludos 🙂
Elias · octubre 1, 2019 a las 5:11 pm
Gracias Amigo
Como hago para quitar el encabezado y pie de pagina
o talvez podrias poner mas pequeñito es muy grande
parzibyte · octubre 1, 2019 a las 5:13 pm
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/
luis · octubre 1, 2019 a las 4:17 pm
Amigo tiene plugin para 32 bits solo me funciona para 64 bits
parzibyte · octubre 1, 2019 a las 4:19 pm
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/
Pablo · octubre 1, 2019 a las 3:37 pm
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)
parzibyte · octubre 1, 2019 a las 3:57 pm
Hola. No funciona con impresoras en red, mira las limitaciones: https://parzibyte.github.io/plugin-ticket-js/
pablo · septiembre 30, 2019 a las 2:08 pm
9/30/2019, 2:07:55 PM Al imprimir: Error en el servidor: sql: no rows in result set
parzibyte · septiembre 30, 2019 a las 4:06 pm
Hola. Por favor lee las preguntas frecuentes: https://parzibyte.github.io/plugin-ticket-js/#faq
Saludos
Cesar · septiembre 30, 2019 a las 1:40 pm
Hola disculpa alguna solucion para una impresorade etiquetas zebra 420t
parzibyte · septiembre 30, 2019 a las 4:10 pm
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
Orlando · septiembre 25, 2019 a las 9:22 am
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??
parzibyte · septiembre 25, 2019 a las 9:36 am
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
Orlando · septiembre 26, 2019 a las 7:47 pm
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
parzibyte · septiembre 26, 2019 a las 8:12 pm
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
Rodrigo · septiembre 25, 2019 a las 8:54 am
una pregunta para que sirve .then(valor => {
loguear(“Al imprimir: ” + valor);
});
parzibyte · septiembre 25, 2019 a las 9:34 am
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
Gustavo · septiembre 21, 2019 a las 5:04 pm
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
parzibyte · septiembre 21, 2019 a las 7:20 pm
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