Cómo funciona la impresión

Mesero imprime tickets de cliente, comandas de cocina/barra y abre el cajón portamonedas usando tus impresoras térmicas de tickets. Esta guía explica las dos formas de conectar una impresora, cuándo usar cada una, cómo configurar varias impresoras por zona y cómo resolver los problemas más habituales.

El flujo, de un vistazo

Cuando se imprime un ticket, el TPV (que funciona en el navegador) no habla directamente con la impresora: envía la orden al servidor de Mesero, y el servidor la entrega a la impresora de dos formas posibles:

TPV (navegador)  →  Servidor Mesero  →  ┌─ Agente Mesero  →  impresora USB
                                        └─ o directo por red →  impresora con IP

Por eso una impresora USB necesita el Agente Mesero instalado en el ordenador al que está enchufada, mientras que una impresora de red (con cable Ethernet o Wi-Fi y su propia IP) no necesita agente: el servidor le imprime directamente.

Dos modos de conexión

En Ajustes → Hardware → Impresora de recibos y cajón eliges el modo:

El Agente Mesero (para impresoras USB)

El Agente Mesero es una pequeña aplicación que se ejecuta en el ordenador donde está la impresora USB y hace de puente entre el servidor y la impresora. Se descarga desde el propio TPV en Ajustes → Hardware, con el botón de descarga.

• Debe ejecutarse en el ordenador al que está conectada la impresora USB. No hace falta instalarlo en ordenadores que solo usan el TPV en el navegador y no tienen impresora.
• Cuando está abierto y conectado, el TPV muestra «Mesero conectado» en verde dentro de Hardware.
• Hay versión para Windows y para Mac. El TPV ofrece automáticamente la descarga correcta para tu sistema.

Windows

1. En Hardware, pulsa Descargar. Lo recomendado es instalar desde la Microsoft Store (sin avisos). Hay también una descarga directa .exe alternativa para entornos donde la Store esté bloqueada.
2. Abre Mesero (queda como un icono junto al reloj de Windows).
3. Vuelve al TPV: debería aparecer «Mesero conectado».

Mac

1. En Hardware, pulsa Descargar Mesero para Mac (se descarga un archivo .dmg). Usa el enlace «Intel» solo si tu Mac es de procesador Intel; el resto de Macs (Apple Silicon) usan la descarga normal.
2. Abre el .dmg y arrastra «Mesero Print Agent» a la carpeta Aplicaciones.
3. Expulsa el disco y abre Mesero Print Agent desde Aplicaciones (Launchpad o carpeta Aplicaciones).

El agente debe estar en marcha durante el servicio

El Agente Mesero tiene que estar ejecutándose en el ordenador de la impresora para poder imprimir. Recomendaciones:

• Déjalo abierto durante todo el servicio. Puede quedar minimizado (icono junto al reloj en Windows, o en la barra de menús en Mac); no hace falta tenerlo a la vista.
• Si reinicias o apagas el ordenador, vuelve a abrir Mesero al encenderlo (igual que abres el navegador con el TPV). Para que arranque solo: en Windows, añade un acceso directo a la carpeta «Inicio»; en Mac, Ajustes del Sistema → General → Ítems de inicio de sesión → añade «Mesero Print Agent».
• Si el TPV deja de imprimir y ves «Mesero no detectado», casi siempre es que el agente se cerró (o el PC se reinició): vuelve a abrirlo y en unos segundos reconecta. No se pierde la configuración.

Varios ordenadores en el mismo restaurante

Cada ordenador es un terminal independiente con su propia configuración de impresora. La regla es sencilla:

• Una impresora USB solo imprime desde el ordenador al que está enchufada (el que tiene su Agente Mesero). Otros ordenadores que solo usan el TPV en el navegador no imprimen a esa impresora USB.
• Para compartir una sola impresora entre varios ordenadores, usa el modo «Red» (IP). Es la forma más robusta: cualquier ordenador o tablet imprime a la misma impresora por su IP, sin agente.
• Lo típico: un PC de caja con su impresora de tickets (modo Impresora + agente), o impresoras de red repartidas por cocina y barra.

Varias impresoras por zona (recibos, cocina, barra)

Mesero soporta impresoras distintas por función: el ticket del cliente en caja, las comandas en cocina y las bebidas en barra. Cada zona se configura por separado y puede tener su propio modo (una USB por agente, otra de red…).

1. En Ajustes → Hardware configura la impresora de recibos y cajón, y abre «Impresoras de cocina y bar» para las demás.
2. En Ajustes → Impresoras → Categorías asigna cada categoría de la carta a un rol de impresión (Cocina, Barra…). Así Mesero sabe a qué impresora mandar cada plato de la comanda.
3. Si una categoría no tiene rol asignado, sus artículos no se enrutan a cocina/barra; si una zona no tiene impresora configurada, se usa como respaldo la impresora de tickets.

Todas las impresoras de un terminal deben ser accesibles desde ese terminal: enchufadas al ordenador del agente, o de red por IP. Si la impresora de cocina está físicamente lejos del PC de caja, configúrala como impresora de Red (IP).

Impresora de red (IP)

Una impresora de red imprime por su dirección IP, sin drivers, y la pueden compartir todos los ordenadores y tablets del restaurante — es lo recomendado para varios terminales. Para alcanzar una impresora de tu red local basta con tener un Agente Mesero abierto en cualquier equipo de esa misma red: él entrega los tickets a la impresora (el servidor en la nube no llega directamente a una IP local).

1. Conecta la impresora a la red por cable Ethernet y enciéndela.
2. Imprime su autotest (normalmente se mantiene pulsado el botón FEED mientras se enciende): te dará su IP, la máscara y si tiene DHCP activado.
3. En Ajustes → Hardware elige el modo Red. Pulsa 🔍 Buscar en red para que el Agente Mesero detecte la impresora automáticamente y elígela de la lista, o introduce su IP a mano. Comprueba el puerto (por defecto 9100) y pulsa Guardar.
4. Pulsa Imprimir prueba para confirmar.

Dejar la impresora «lista para enchufar»

Esto se hace una sola vez al preparar el equipo (no durante el servicio, y el restaurante no tiene que ejecutar nada). Recomendamos activar DHCP: así la impresora coge sola una dirección del router y se conecta en cualquier red donde la enchufes.

1. Conecta la impresora por USB a un ordenador Windows.
2. Abre la utilidad de red del fabricante (suele llamarse «Printer Test Tool» o «Net Setting», incluida con la impresora).
3. Activa DHCP y guarda. Alternativa: fija una IP estática dentro del rango de tu red (p. ej. 192.168.1.50).
4. Desconecta el USB y conéctala por Ethernet. Ya cogerá su IP sola; léela del autotest e introdúcela en Hardware.

Solución de problemas

• «Mesero no detectado» / no aparece conectado: abre el Agente Mesero en el ordenador de la impresora y espera unos segundos a que se conecte. En Mac, comprueba que lo abriste desde Aplicaciones.
• macOS lo envía a la papelera al abrirlo: es una versión antigua o descargada de otro sitio. Descarga siempre desde el TPV (Hardware → Descargar Mesero para Mac): esa versión está notarizada por Apple y no da advertencias.
• El agente avisa de que «no está instalado»: lo estás abriendo desde el disco .dmg. Arrástralo a Aplicaciones y ábrelo desde ahí.
• La prueba imprime pero los tickets reales no: asegúrate de haber seleccionado la impresora correcta y pulsado Guardar, de que el agente esté conectado, y de que el ordenador desde el que cobras es el que tiene la impresora (o usa modo Red).
• Impresora de red: la prueba falla y no hay manera de conectar: casi siempre la impresora trae una IP fija de otra red. Mira su autotest y comprueba que esté en el mismo rango que tu router (mismos tres primeros números). Actívale DHCP o ponle una IP de tu red una sola vez con la utilidad del fabricante por USB (ver «Dejar la impresora lista para enchufar»).
• «Pre-ticket cancelado por timeout» o un error de impresión que se repite: normalmente significa que el ticket no llegó al agente (agente cerrado, ordenador equivocado, o impresora mal seleccionada). Corrige la configuración (impresora correcta + Guardar, agente abierto). Un error antiguo puede seguir mostrándose unos minutos mientras se reintentan los trabajos en cola; desaparece solo tras varios reintentos o se limpia al cerrar/reabrir el TPV.
• macOS muestra «Actualización disponible» o «Support Ending for Intel-Based Apps»: estás usando una versión antigua o la versión Intel en un Mac Apple Silicon. Descarga de nuevo desde el TPV (Hardware → Descargar Mesero para Mac), usando el enlace normal salvo que tu Mac sea Intel, e instálala en Aplicaciones.
• Probar impresión / Probar cajón: en Hardware hay botones para lanzar una página de prueba y abrir el cajón sin tener que crear un pedido. En Ajustes avanzados puedes ajustar el pulso de apertura del cajón si tu modelo lo necesita.

Preguntas frecuentes

¿Tengo que instalar el agente en todos los ordenadores?
No. Solo en el ordenador que tiene la impresora USB enchufada. Los demás imprimen a través de él (si comparten terminal) o usa impresoras de red.

¿Funciona con impresora de red?
Sí, en modo «Red» con la IP de la impresora — la comparten todos los terminales. Para llegar a una impresora de tu red local necesitas un Agente Mesero abierto en algún equipo de esa red; puedes detectarla con 🔍 Buscar en red en lugar de teclear la IP.

Conecté la impresora de red pero el TPV no la encuentra. ¿Por qué?
Lo más probable es que traiga una IP fija de fábrica de otra red (p. ej. 192.168.123.100) con DHCP desactivado, así que no está en el mismo rango que tu router. Imprime su autotest, compara los tres primeros números con los de tu red y actívale DHCP (o ponle una IP de tu rango) una sola vez con la utilidad del fabricante por USB. Después solo hay que enchufar el cable.

¿Puedo tener cocina y barra en impresoras distintas del ticket?
Sí. Configura cada zona en Hardware y asigna las categorías de la carta a roles de impresión en Ajustes → Impresoras → Categorías.

¿Mesero funciona en Mac?
Sí. El Agente Mesero tiene versión para Mac (Apple Silicon e Intel), notarizada por Apple, con detección automática de la impresora USB.

¿Qué impresoras son compatibles?
Impresoras de tickets térmicas estándar ESC/POS (habitualmente 80 mm), por USB o por red. El cajón portamonedas se abre a través de la propia impresora de tickets.