Cómo instalar el agente de impresión en la cocina

Qué hace ese programita en el mesón

El agente de impresión es un programita liviano que corre dentro del restaurante y hace de puente entre qmen.us, que está en la nube, y la impresora térmica, que está en tu red local. La nube no llega a la impresora que está detrás del router, así que es él quien se conecta hacia afuera, pregunta cada tanto si hay una comanda nueva, la imprime y confirma. No hace falta abrir ningún puerto en el router.

Hay versión para tres aparatos: Linux (un solo archivo AppImage), Windows (un solo archivo .exe) y Android (una app del proyecto, con impresora por Bluetooth o red). En los tres, la configuración es la misma pareja: la dirección de la Cocina y el token que te da el panel. qmen.us sigue funcionando en el navegador, sin app de tienda; lo único que se instala es el agente, y solo en ese aparato de la cocina.

Por qué conviene tener la comanda en papel

• La comanda sale sola, sin que nadie haga clic. El mesero envía desde la Mesa, qmen.us crea el trabajo de impresión y el programa lo recoge en la siguiente consulta, cada 3 segundos por defecto.
• Un ticket repetido es mejor que un pedido perdido. Impresora sin papel, apagada o internet inestable: el fallo se avisa y el trabajo vuelve a la fila. El servidor lo ofrece de nuevo tras un minuto sin confirmación y lo intenta hasta diez veces antes de rendirse.
• Cada estación imprime solo lo suyo. La dirección y el token son por Cocina, así que la parrilla no recibe el postre. Una casa con dos mesones y dos térmicas corre dos agentes, cada uno con su config.
• El mismo aparato puede imprimir y mostrar el monitor. Con el monitor activado en el config, la pantalla de la cocina se abre en el navegador al iniciar. Si solo quieres la pantalla, ni lo necesitas: basta abrir el enlace del monitor.

Cómo instalar el agente de impresión en 7 pasos

Son siete pasos, desde el botón en el panel hasta el programa arrancando solo cuando se enciende el aparato.

1. Activa la impresión de la estación en el panel

   En el panel, abre Cocinas. Cada estación es una tarjeta, y en ella está el bloque Impresión con el botón Configurar. Se abre la ventana Impresión de la cocina: activa el interruptor Imprimir pedidos, elige el Ancho del papel (80 mm o 58 mm), cuántas Copias quieres (de 1 a 5) y toca Guardar. La tarjeta pasa a mostrar Activada, con el ancho y las copias al lado.

2. Copia la dirección y el token

   En la misma ventana, en Datos para la app de impresión, hay dos líneas: la dirección de la Cocina y el token, oculto tras puntitos. El ojito lo revela y el botón de al lado lo copia. Si aparece (se genera al guardar), es que todavía no has guardado. Cuida bien el token: vale como contraseña de la impresión. El enlace Generar nuevo token invalida el anterior al instante.

3. Descarga la versión de tu aparato

   En el aparato de la cocina, descarga el archivo de tu sistema: en Windows un archivo .exe (Windows 7 en adelante), en Linux un AppImage que corre en cualquier distro. Es un solo archivo, en una carpeta. En Raspberry Pi y otros ARM, genera el AppImage en el propio aparato o ejecútalo directo desde el código fuente, con Python 3.9 o más nuevo.

4. Pega la dirección, el token y la impresora

   Junto al programa hay un config.json con base (la dirección), token, printer (la impresora) y poll (cada cuántos segundos pregunta). En Windows ese archivo vive en la misma carpeta del .exe; en Linux, en ~/.config/pedis-agent/config.json. El valor de printer depende de la conexión: network:192.168.0.50 para impresora de red, windows: para la cola predeterminada de Windows, file:/dev/usb/lp0 para USB en Linux, serial:/dev/ttyUSB0 para serial.

   Consejo: En Windows, instala la térmica como cola Generic / Text Only: un driver que dibuja la página mezcla los comandos y el papel sale sucio. En Linux, si /dev/usb/lp0 da permiso denegado, ejecuta sudo usermod -aG lp $USER e inicia sesión de nuevo.

5. Haz una prueba antes del servicio

   Antes de confiar en el almuerzo, haz una pasada solo con la impresora dummy: el ticket aparece en pantalla, sin gastar papel. Luego manda un pedido de prueba por la Mesa y mira salir el papel: encabezado con el local, la mesa, el número del pedido, el mesero, la estación y la hora, y cada ítem en letra grande, con el complemento y la observación debajo.

6. Haz que arranque solo

   En la cocina no hay tiempo de acordarse de abrir programas. Con pedis-agent --install, Windows crea una tarea que inicia al entrar a la sesión y Linux crea un servicio de usuario que se reinicia solo si se cae. En un aparato sin nadie con sesión iniciada, como una Raspberry Pi detrás de la tele, ejecuta también sudo loginctl enable-linger. Para deshacerlo, pedis-agent --uninstall.

7. En la tablet Android, es el mismo camino

   Si la cocina usa tablet, la app de Android (5.0 en adelante) hace el mismo trabajo y además muestra la pantalla de la cocina. En la pantalla inicial rellenas Dirección, Token e Impresora (bt: y la MAC de la térmica Bluetooth ya emparejada, o net: y la IP de la de red) y tocas Guardar e iniciar. Concede el permiso de Bluetooth y saca la app del ahorro de batería; si no, la impresión se detiene cuando la pantalla se apaga.

Preguntas frecuentes

Glosario

Agente de impresión

El programita que corre en el dispositivo de la cocina, busca las comandas en qmen.us, las imprime en la térmica y confirma.

Token de impresión

La contraseña de la impresión de una Cocina. Sale en el panel, va a la configuración del agente y puedes cambiarla cuando quieras.

Cocina

El monitor donde aparecen los pedidos y avanzan de En preparación hasta LISTO.

ESC/POS

El lenguaje que entienden las impresoras térmicas de comandas. Es lo que el agente genera para cada ticket.

Recursos relacionados