Configurar la impresora Epson con tiques y logo

Qué necesita

• Una impresora de tiques Epson con Server Direct Print y conexión de red (LAN o Wi-Fi), por ejemplo TM-m30III, TM-m30II-H/-NT/-S/-SL, TM-m50/TM-m50II, TM-T88VII, TM-T88VI, TM-L100, TM-H6000V, TM-T70II-DT2, TM-T88VI-DT2.
• Acceso a Internet para la impresora: basta un router normal, sin redirección de puertos.
• Papel térmico de 80 o 58 mm, adecuado para la impresora. Las impresoras de tiques y las pantallas de pedidos solo se configuran aquí, no en el área admin de la WebApp o la app.
• Una cuenta de titular o administrador del club en la Administración en /admin.

Añadir la impresora en /admin

1. Abra /admin, elija la lista a la izquierda y vaya a «Operación» → «Impresoras de tickets».
2. Haga clic en «Añadir impresora de tickets» e introduzca un nombre, por ejemplo «Barra».
3. En «Lista» elija la lista (o déjelo vacío para todas) y en «Ancho del papel» 80 mm o 58 mm.
4. En «¿Qué imprime esta impresora?» marque lo que sale automáticamente: «Tickets de caja», «Informe Z» y «Comandas»; más detalles en la sección «Rutas de impresión» más abajo. Sin marcas la impresora solo imprime pruebas y tickets elegidos expresamente.
5. Haga clic en «Guardar». El diálogo sigue abierto y muestra la dirección de recogida, el «ID (usuario)» y la contraseña; la contraseña solo ahora: cópiela con «Copiar contraseña». «Nueva dirección» y «Nueva contraseña» invalidan las anteriores.

Configurar la impresora

1. Averigüe la dirección IP de la impresora: con la impresora apagada, mantenga pulsado el botón de avance (FEED) y enciéndala; la hoja de estado muestra la dirección IP.
2. Abra http://dirección-IP en el navegador de un ordenador de la misma red: es la interfaz web de la impresora (Web Config; en equipos más antiguos, EpsonNet Config). Vaya a «Advanced Settings» → «Administrator Login» e inicie sesión: en los modelos más recientes la contraseña es el número de serie de la impresora (usuario, si se pide, «epson»). Los modelos TM-i y TM-DT siguen el mismo camino.
3. Antes actualice los certificados raíz de la impresora: nuestro servidor usa un certificado de Let's Encrypt (cadena YR1 → ISRG Root YR → ISRG Root X1). Las listas de certificados antiguas de la impresora no lo conocen: entonces https:// falla sin aviso y no nos llega ninguna petición. Abra «Advanced Settings» → «Network Security» → «Root Certificate Update» y haga clic en «Update»; la impresora descarga la lista actual de Epson. Como alternativa, importe en «Network Security» → «CA Certificate» los archivos PEM «ISRG Root X1» e «ISRG Root YR» de letsencrypt.org/certificates.
4. Abra «TMI Settings» → «Server Direct Print» y ponga «Server Direct Print» (en el manual de Epson «Use Server Direct Print») en «Enable».
5. Introduzca en «URL» la dirección copiada, en «Interval» 5 segundos y en los campos «ID» y «Password» el usuario y la contraseña de /admin. La impresora inicia sesión con ellos mediante HTTP Digest, como describe el manual de Epson; nuestro servidor acepta Digest y Basic. Sin credenciales correctas responde «401» y la impresora no recibe nada. Menos de 5 segundos no aporta nada: nuestro servidor acepta como máximo una petición cada 400 ms por impresora.
6. Haga clic en «Apply» y después, en «TM-i Settings» (dirección /webconfig-i), en «Apply & Restart»: solo entonces la impresora aplica Server Direct Print y se reinicia. Luego cierre la sesión con «Administrator Logout»: mientras alguien tenga la sesión de administrador abierta, la impresora está en modo de configuración y no imprime nada.
7. En /admin haga clic en «Impresión de prueba» en la fila de la impresora. El tique de prueba llega con la siguiente consulta, es decir, en unos 5 segundos como mucho, y en la columna «Estado» aparece «última conexión» con la hora.

Como alternativa: impresoras Star con CloudPRNT

1. En lugar de Epson también sirve una impresora Star con CloudPRNT, p. ej. TSP143IV, TSP100IV, mC-Print3 o mC-Print2. Al añadirla, elija en «Conexión» «Star CloudPRNT (la impresora recoge los tickets)».
2. Abra la interfaz web de la impresora Star (dirección IP de la autoprueba) e inicie sesión como administrador.
3. Active CloudPRNT, introduzca en «Server URL» la dirección de /admin, de 5 a 10 segundos como intervalo de sondeo y en la autenticación (Basic) el usuario y la contraseña de /admin.
4. Guarde, reinicie la impresora y haga clic en «Impresión de prueba» en /admin. En el primer contacto el servidor guarda la dirección MAC de la impresora; otro dispositivo con la misma dirección se rechaza.

Impresoras de tickets económicas mediante el proxy de impresión (USB o red)

1. En lugar de una impresora Epson o Star con función en la nube también sirve una impresora de tickets ESC/POS económica, por USB o en red, por ejemplo Epson TM-T20, Xprinter, Munbyn o Rongta. Necesita cortador automático: cada ticket termina con un corte. Las impresoras sin cortador (barra de corte manual, muchas portátiles de 58 mm) no son compatibles.
2. Para ello, en la red del club funciona un pequeño proxy de impresión como contenedor Docker: en una Raspberry Pi (también modelos antiguos desde la Pi 2; la Pi 1 y la primera Pi Zero no sirven), un NAS o un PC. Se conecta por sí mismo a nuestro servidor, sin abrir puertos.
3. En /admin abra «Operación» → «Impresoras de tickets» → «Proxies de impresión», introduzca un nombre y haga clic en «Vincular proxy». El token del dispositivo solo se muestra ahora. Si la impresora está conectada al proxy por USB, marque «Impresora por USB en el proxy (/dev/usb/lp0)». Copie con «Copiar comando» el comando de inicio ya preparado (docker run …). Como alternativa, «docker compose» muestra la misma configuración como docker-compose.yml: cópielo con «Copiar YAML», guárdelo en una carpeta y ejecute allí «docker compose up -d».
4. Ejecute el comando en la Raspberry Pi o el ordenador. En el primer inicio, Docker descarga por sí mismo la imagen drinklist/print-proxy desde Docker Hub (https://hub.docker.com/r/drinklist/print-proxy, para amd64, arm64 y arm/v7). El contenedor se reinicia solo tras un reinicio o un corte de luz; poco después el proxy aparece como «conectado» en /admin. Consejo: con el añadido --test-print y la dirección IP de la impresora (o /dev/usb/lp0) la imagen imprime una página de prueba sin servidor, para comprobar cable, dirección y cortador.
5. Después añada la impresora: conexión «Proxy de impresión: impresora ESC/POS económica por USB o red (Docker, Raspberry Pi)», elija el proxy y en «Conexión en el proxy» red (dirección IP de la impresora en la red del club, puerto 9100) o USB (/dev/usb/lp0). Marque «La impresora tiene cortador automático», guarde y haga clic en «Impresión de prueba». Las rutas de impresión, reimpresiones y trabajos funcionan como con cualquier otra impresora.
6. Si el proxy no está conectado (corriente, internet), los tickets esperan y salen en cuanto vuelve a estar en línea; los de más de dos horas ya no se imprimen, pero se pueden reimprimir. La columna «Estado» muestra falta de papel o tapa abierta si la impresora lo informa; muchas impresoras económicas no lo hacen. «Nuevo token» invalida el anterior, «Quitar» desconecta el proxy definitivamente.

Rutas de impresión: comida a la cocina, bebidas a la barra

1. En «¿Qué imprime esta impresora?» cada impresora decide qué imprime automáticamente: «Tickets de caja» tras cada venta en efectivo, el «Informe Z» al cerrar la caja y «Comandas» para nuevos pedidos del pedido QR. Varias impresoras pueden imprimir lo mismo, p. ej. tickets en la barra y en la oficina.
2. Cocina: añada la impresora «Cocina», marque «Comandas» y en «Solo estos grupos de productos (categorías)» elija la categoría de sus platos, p. ej. «Comida», tal como está en los productos.
3. Barra: en la impresora «Barra» marque «Tickets de caja» y «Comandas» y además «Todos los demás productos (categoría sin impresora propia)». Sin categoría y sin esta marca una impresora imprime cada pedido completo.
4. Un pedido con 2 cañas y 1 escalope produce ahora dos comandas: el escalope en la cocina, las cañas en la barra, cada una con número de pedido, mesa o puesto, hora, cliente y notas. Las posiciones sin impresora adecuada no se imprimen. Opcionalmente hay «Precios en la comanda» e «Imprimir pedidos anulados como comanda de anulación».
5. El botón «Rutas de impresión» muestra el resumen: qué documento de qué lista y grupo de productos sale en qué impresora. Si la impresora no tiene lista elegida, «Para la lista» en el diálogo de la impresora limita sus rutas a una sola lista.

Pantalla de pedidos en lugar de comandas: para cocina y barra

1. Abra «Operación» → «Pantallas de pedidos» y haga clic en «Añadir pantalla de pedidos». Nombre, p. ej. «Cocina», y como en la impresora «Solo estos grupos de productos (categorías)» o «Todos los demás productos (categoría sin impresora propia)»: pantallas e impresoras siguen las mismas reglas.
2. Abra el enlace o el código QR en la tableta o la TV y elija «Añadir a pantalla de inicio». La pantalla se abre como app propia sin iniciar sesión, a pantalla completa, y mantiene la pantalla encendida. Un toque activa el sonido de nuevos pedidos.
3. Cada pedido abierto aparece como una gran ficha con número, mesa o puesto, cliente, notas y solo las posiciones de esta pantalla. El tiempo corre y la ficha se vuelve ámbar tras «Ámbar tras minutos» y roja tras «Rojo tras minutos».
4. Toque «En preparación» para tomar el pedido (la barra lo ve como tomado) y «Listo» para quitarlo de esta pantalla, con «Deshacer» durante 10 segundos. Entregar y cobrar sigue en la barra. «Nuevo enlace» invalida el anterior, p. ej. si se pierde una tableta.

Logo para tiques, PDF y pantalla de TV

1. En /admin abra «Organización» → «Datos maestros» y baje hasta la sección «Logo».
2. Haga clic en «Subir logo» y elija una imagen JPG o PNG de hasta 2 MB. Se gira y se reduce automáticamente.
3. Elija dónde aparece el logo: «En los tickets (impresora), arriba al centro», «En la pantalla TV/proyector, arriba a la derecha» y «En los PDF del club, arriba a la derecha (recibos, extractos, informes)».
4. Consejo: la impresora solo imprime en blanco y negro, así que el logo se convierte en puntos. Un logo sencillo, con bordes nítidos y mucho contraste sobre fondo claro, queda mejor en el tique.

Imprimir tiques

• Un tique lleva el logo, las líneas con letra de IVA, descuentos y reglas de precio, el total, la forma de pago y el IVA por tipo.
• «Diarios y cuentas» → «Diario de pagos»: «Imprimir ticket» en la fila de un pago envía el ticket a la impresora elegida; sin elección, a la primera impresora con «Tickets de caja». El justificante en PDF sigue disponible como siempre.
• «Operación» → «Caja y cierre Z»: «Imprimir cierre Z» en la fila de una sesión de caja cerrada imprime el cierre Z en papel.
• «Operación» → «Impresoras de tickets» → «Trabajos»: todos los trabajos con estado y error. «Reimprimir» imprime de nuevo un tique.

Si algo no funciona

• En la columna «Estado» sigue «nunca consultada»: la dirección falta o es incorrecta, Server Direct Print no está activado o la impresora no llega a Internet. Compruebe también la fecha y la hora de la impresora: si no son correctas, la conexión HTTPS falla. Si no consigue entrar en la interfaz web (falla el inicio de sesión), restablezca la impresora a los valores de fábrica con el botón FEED como describe el manual de Epson.
• Los trabajos se quedan «en espera» o «enviado»: ¿está encendida la impresora, con papel y la tapa cerrada? La impresora recoge los trabajos en la siguiente consulta; sin respuesta se vuelven a entregar y tras varios intentos se marcan como fallidos. Si /admin muestra para la impresora «Genera una nueva contraseña (necesaria para Epson)», la contraseña es anterior al inicio de sesión Digest: genere una nueva e introdúzcala en la impresora.
• Error con un mensaje de la impresora: normalmente falta papel o la tapa está abierta. Resuélvalo y el trabajo se reenvía automáticamente.
• Texto cortado o demasiado estrecho: el ancho de papel en /admin debe coincidir con el papel colocado (80 o 58 mm).
• Acentos o caracteres especiales incorrectos: compruebe que el firmware de la impresora esté actualizado; las versiones antiguas no manejan todos los juegos de caracteres.

Epson: solución de problemas de la práctica

• No llega ninguna petición al servidor aunque todo está introducido: normalmente la impresora no conoce el certificado de Let's Encrypt de nuestro servidor (visto con una TM-m30III, firmware TM-i 01.39 y certificados raíz 02.03). Ejecute «Advanced Settings» → «Network Security» → «Root Certificate Update» → «Update» o importe «ISRG Root X1» e «ISRG Root YR» (letsencrypt.org/certificates) en «Network Security» → «CA Certificate». Después, «Apply & Restart» en «TM-i Settings».
• Los ajustes cambiados no surten efecto: Server Direct Print solo aplica los cambios tras «Apply & Restart» en «TM-i Settings» (/webconfig-i).
• La impresora imprime una hoja «WebConfig Start» y nada más: alguien tiene abierta la interfaz web como administrador y la impresora está en modo de configuración. Cierre siempre la sesión con «Administrator Logout».
• La autoprueba imprime, pero desde la red no sale nada (incluso ePOS o el puerto 9100 aceptan datos sin imprimir): la conexión interna entre la parte de red y el mecanismo de impresión se ha colgado. Desenchufe la alimentación unos 30 segundos.
• Introduzca la dirección con https://, no con http://: las peticiones por http:// se redirigen y Epson no sigue redirecciones.
• En /admin, en «Operación» → «Impresoras de tickets», «Letzter Kontakt» (último contacto) en el diálogo de la impresora muestra las últimas peticiones con su resultado; este diagnóstico aparece en alemán. «Anmeldung angefordert (401 – bei Digest normal)» (inicio de sesión solicitado) es normal en la primera petición. Con «Digest-Anmeldung falsch (ID/Passwort prüfen)» (inicio de sesión Digest incorrecto) genere una contraseña nueva e introdúzcala en la impresora. Si aparece «seit dem letzten Serverstart kein Abruf angekommen» (ninguna petición desde el último arranque del servidor), la impresora no llega a nuestro servidor: revise https://, certificados raíz y red.