Imprimir ticket en impresora térmica usando JavaScript y plugin

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.

Ticket impreso con plugin directamente desde JavaScript

English version here.

Y también he desarrollado un plugin para Android, míralo aquí:

Yo recomiendo la versión 3 y final, pero si quieres puedes ver las otras versiones igualmente.

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 (No olvides compartirla) 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 la clase ConectorPluginV3.

Paso 3: hola mundo

Ahora que el plugin está instalado y que has incluido la librería, puedes crear una nueva instancia de la clase ConectorPluginV3 así (el primer argumento es la URL donde escucha el plugin, lo verás mejor en el ejemplo):

const conector = new ConectorPluginV3();

Después simplemente escribe algo de texto y termina la impresión. El código completo es el siguiente:

La función imprimirEn 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.

Código completo

El HTML y JavaScript completo (sin incluir el conector del cual ya dejé el enlace anteriormente) queda así:

Si quieres puedes ver todos los ejemplos en GitHub o probar directamente lo que te acabo de mostrar en el siguiente enlace, solo asegúrate de estar ejecutando el plugin: https://parzibyte.github.io/ejemplos-javascript-plugin-v3/hola.html

Más sobre esta librería

Puedes ver más conectores y modos de uso en:

Plugin para impresoras térmicas versión 3

Versión para Linux y Raspberry Pi

El plugin también es compatible con distribuciones basadas en Debian y Raspbian. Puedes descargarlo como se indica en:

Plugin para impresoras térmicas versión 3

Para Android

Igualmente ya existe la versión para Android, míralo aquí:

Plugin gratuito para impresoras térmicas Bluetooth en Android

Encantado de ayudarte


Estoy disponible para trabajar en tu proyecto, modificar el programa del post o realizar tu tarea pendiente, no dudes en ponerte en contacto conmigo.

No te pierdas ninguno de mis posts

Suscríbete a mi canal de Telegram para recibir una notificación cuando escriba un nuevo tutorial de programación.

63 comentarios en “Imprimir ticket en impresora térmica usando JavaScript y plugin”

  1. Buenas! genial el plugin. Estoy probando estos días y probablemente compre la licencia. El tema que ayer y hoy me esta fallando algo. Recién salieron como 10 ticket seguidos iguales, y cada tanto salen 2 o 3 del mismo. Alguna idea cual podría ser el problema? gracias

  2. 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.

  3. 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

  4. 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)

    1. 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

    2. 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

  5. Hernando Hernandez

    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

    1. 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.

  6. 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

    1. 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 🙂

    2. 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.

    3. 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

  7. giancarlo melgarejo

    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 ?

    1. 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

  8. 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

    1. 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 🙂

    1. 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

    1. 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

    2. 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

  9. 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

    1. 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

Dejar un comentario