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:

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:

See the gist on github.

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í:

See the gist on github.

Ahora puedes comenzar a imprimir tickets.  La sintaxis es:

See the gist on github.

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í:

See the gist on github.

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.

See the gist on github.

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

See the gist on github.

En el ejemplo vas a entenderlo de mejor manera.

Ejemplo simple de impresión de ticket

El ejemplo más simple queda así:

See the gist on github.

También puede ser con await:

See the gist on github.

Encadenando métodos usando promesas:

See the gist on github.

O encadenando métodos usando await:

See the gist on github.

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í:

See the gist on github.

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.