Este artículo describe la documentación del plugin para impresoras térmicas versión 2. Aquí se detalla cómo descargar y usar el plugin para la impresión directa desde la nube (aunque técnicamente se hace del lado del cliente).

Recuerda que este plugin no es para nada compatible con la versión 1, así que olvida todo lo que sepas sobre la versión anterior.

Instalación del plugin en Windows

  1. Instala y comparte tu impresora, puede ser genérica o con sus controladores; y colócale un nombre sin espacios ni caracteres especiales.
  2. Desde el panel de control imprime una página de prueba en la impresora y verifica que la misma sea impresa correctamente.
  3. Descarga el plugin y ejecútalo. Concede los permisos para el firewall en caso de que el mismo lo solicite. Recuerda que el plugin se va a ejecutar en segundo plano. Si quieres detenerlo puedes abrir el administrador de tareas.
  4. Ve a este ejemplo de las capacidades del plugin, y elige tu impresora de la lista. Si no aparece en la lista significa que no la instalaste correctamente. Revisa los puntos anteriores.
  5. Al presionar el botón, debe imprimirse un ticket parecido al siguiente:
Demostrar capacidades del plugin para impresoras térmicas

Demostrar capacidades del plugin para impresoras térmicas

Felicidades, ya puedes usar el plugin. Ahora puedes proceder a leer la documentación o ver el código de los ejemplos.

Nota: tal vez quieras hacer que el conector se ejecute siempre que inicie Windows.

Uso del conector dentro de JavaScript

Asegúrate de que el conector se está ejecutando. Ahora descarga el script e inclúyelo en tu proyecto:

Con eso, tendrás la clase ConectorPlugin de manera global. Después, dentro de tu script en donde quieras usar al conector, crea una instancia de la clase ConectorPlugin así:

Ahora puedes comenzar a imprimir tickets.  La sintaxis es:

Básicamente es crear la instancia, invocar operaciones (por ejemplo la alineación, texto, corte de papel, una imagen, etcétera) y finalmente llamar a imprimirEn pasándole el nombre de la impresora.

También puedes encadenar métodos, así:

Ambos métodos son válidos y puedes usar el que más te guste.

La función imprimirEn devuelve una promesa. Al resolverse, devolverá true en caso de éxito, y una cadena en caso de error.

Recuerda que igualmente puedes usar async y await. El código anterior quedaría así:

En el ejemplo vas a entenderlo de mejor manera.

Ejemplo simple de impresión de ticket

Ejemplo simple de impresión en impresora térmica usando JavaScript y Plugin

Ejemplo simple de impresión en impresora térmica usando JavaScript y Plugin

El ejemplo más simple queda así:

También puede ser con await:

Encadenando métodos usando promesas:

O encadenando métodos usando await:

Los 4 fragmentos de código hacen lo mismo, usa el que prefieras.

Documentación de la clase

Puedes encontrar toda la documentación y métodos en este enlace.

El log

Existe un archivo en donde se van a registrar todos los sucesos que ocurran con el plugin, así que recuerda que el archivo log es tu amigo y debes consultarlo siempre que ocurra algo inesperado.

Este log se va a encontrar en el mismo directorio que el plugin, y se ve algo así:

No pasa nada si eliminas el archivo, pero recuerda que es importante leerlo si tienes errores. El plugin va a crear este log cada mes.

Distribuyendo plugin

Puedes instalar el plugin en las computadoras que quieras. Por cierto, si contrataste un plan también debes colocar el archivo api_key.txt junto con el plugin.


Estoy disponible para trabajar en tu proyecto o realizar tu tarea pendiente, no dudes en ponerte en contacto conmigo.
Si el post fue de tu agrado muestra tu apoyo compartiéndolo, suscribiéndote al blog, siguiéndome o realizando una donación.

Suscribir por correo

Ingresa tu correo y recibirás mis últimas entradas sobre programación, open source, bases de datos y todo lo relacionado con informática

Únete a otros 2,597 suscriptores


parzibyte

Programador freelancer listo para trabajar contigo. Aplicaciones web, móviles y de escritorio. PHP, Java, Go, Python, JavaScript, Kotlin y más :) https://parzibyte.me/blog/software-creado-por-parzibyte/

0 Comentarios

Deja un comentario

Marcador de posición del avatar

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

A %d blogueros les gusta esto: