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
                                        └─ Agente Mesero en la red  →  impresora con IP
App Comandas (tablet/móvil)  ────────────────────────────────────→  impresora con IP

Por eso una impresora USB necesita el Agente Mesero instalado en el ordenador al que está enchufada. Una impresora de red (con cable Ethernet o Wi-Fi y su propia IP) no va enchufada a ningún ordenador, pero el servidor en la nube no llega directamente a una IP de tu red local: para imprimir desde el TPV web hace falta un Agente Mesero abierto en cualquier equipo de esa misma red, que hace de puente y entrega los tickets. La app Mesero Comandas (tablet/móvil) sí imprime directa por IP, sin agente.

Dos modos de conexión

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

Modo	Cuándo usarlo	Necesita agente
Impresora (USB)	La impresora está enchufada por USB al mismo ordenador donde se usa el TPV.	Sí — el Agente Mesero en ese ordenador.
Red (IP)	La impresora tiene cable de red o Wi-Fi y una dirección IP propia. Ideal si varios ordenadores comparten la misma impresora.	Para el TPV web, sí: un Agente Mesero abierto en cualquier equipo de la red hace de puente. La app Comandas (tablet/móvil) imprime directa por IP, sin agente.

❓

¿Necesito instalar el Agente Mesero? En resumen:

Impresora por cable USB enchufada a un ordenador → Sí, instala el Agente en ese ordenador.
Impresora de red (cable Ethernet al router) y trabajas con la app Comandas en tablet/móvil → No hace falta instalar nada.
Impresora de red pero imprimes desde el TPV web (navegador) → necesitas un Agente Mesero abierto en algún ordenador de la misma red (hace de puente; no tiene por qué ser el de caja).

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

En Hardware, pulsa Descargar: se abre la Microsoft Store (Mesero Print Agent) y pulsas Obtener / Instalar. Es la opción recomendada: versión firmada, sin avisos y se actualiza sola.
Abre Mesero (queda como un icono junto al reloj de Windows).
Vuelve al TPV: debería aparecer «Mesero conectado».

🛡️

¿La Microsoft Store está bloqueada en tu equipo? En Hardware tienes también una descarga directa .exe como alternativa. Al instalarla, Windows mostrará un aviso azul «Windows protegió tu PC»: es normal — pulsa «Más información» y luego «Ejecutar de todos modos». Esto no ocurre con la versión de la Microsoft Store (firmada), por eso es la recomendada.

Mac

En Hardware, pulsa Descargar Mesero para Mac (se descarga un instalador MeseroPrintAgent.pkg). Por defecto se ofrece la versión para Apple Silicon; usa el enlace «Intel» solo si tu Mac es de procesador Intel.
Haz doble clic en el .pkg y sigue el instalador. Él se encarga de todo: cierra el agente si estaba abierto, instala «Mesero Print Agent» en Aplicaciones y lo vuelve a abrir automáticamente — no hay que arrastrar nada.
Vuelve al TPV: debería aparecer «Mesero conectado».

🍏

La app está notarizada por Apple, así que no aparecen advertencias de seguridad: el instalador .pkg coloca «Mesero Print Agent» en Aplicaciones por ti.
Si en tu caso se descargara un archivo .dmg en lugar del .pkg (instalador de respaldo), ábrelo y arrastra «Mesero Print Agent» a la carpeta Aplicaciones; ábrelo después desde Aplicaciones, no desde el disco (si lo abres desde el .dmg macOS lo ejecuta en modo protegido y no podrá imprimir).

🖨️

En Mac no hace falta instalar drivers ni crear colas a mano. Conecta la impresora térmica USB y el agente la detecta y la deja lista automáticamente. El agente también pone un icono 🖨️ en la barra de menús con una opción «Imprimir prueba» y «Salir».

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. Desde la app Comandas imprime directa; desde el TPV web basta con que haya un Agente Mesero abierto en algún equipo de la red que haga de puente.
Lo típico: un PC de caja con su impresora de tickets (modo Impresora + agente), o impresoras de red repartidas por cocina y barra.

🧰

«La impresora guardada no está disponible aquí» Si abres Hardware en un ordenador y ves este aviso, normalmente es porque cambiaste/renombraste la impresora (elígela en la lista y pulsa Guardar) o porque otro ordenador comparte el mismo terminal. En ese caso pulsa «Usar un terminal separado para este ordenador»: el botón deja a este ordenador con su propio terminal sin tocar la configuración del otro.

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…).

En Ajustes → Hardware configura la impresora de recibos y cajón, y abre «Impresoras de cocina y bar» para las demás.
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.
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).

💻

¿Solo usas tablet o móvil, sin ordenador? Una impresora de red también necesita un ordenador encendido con el Agente Mesero en la misma red: es él quien entrega los tickets a la impresora. La tablet por sí sola todavía no puede imprimir directamente en una impresora de red. Si no tienes ningún ordenador disponible, la opción que funciona hoy es una impresora USB conectada a un ordenador con el Agente.

Conecta la impresora a la red por cable Ethernet y enciéndela.
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.
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.
Pulsa Imprimir prueba para confirmar.

⚠️

La impresora debe estar en la misma red que el TPV. Muchas impresoras vienen de fábrica con una IP fija de otra red (por ejemplo 192.168.123.100, con DHCP desactivado). Si tu red es 192.168.1.x y la impresora es 192.168.123.x, no podrán comunicarse y la prueba fallará aunque el cable esté bien. Truco rápido: en el autotest compara los tres primeros números de la IP de la impresora con los de tu router; si no coinciden, es esto. También puedes pulsar 🔍 Buscar en red: si tu impresora no aparece en la lista de equipos encontrados, está en otra red.

Dejar la impresora «lista para enchufar»

Normalmente esto lo hace tu instalador o proveedor; si recibes la impresora ya configurada, puedes saltarte esta sección. 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.

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

📌

Para que la IP no cambie: usa DHCP con reserva en el router (asocia la dirección a la impresora) o una IP estática de tu rango. Así la IP guardada en Hardware sigue siendo válida tras reiniciar el router. Si vas a usar tablets, lo ideal es recibir la impresora ya configurada y solo enchufar el cable: cero pasos en el local.

Solución de problemas

💬

¿No imprime? Pregúntale al asistente. Desde el chat de ayuda dentro de Mesero (o por WhatsApp, si tienes tu número vinculado) puedes escribir algo como «no me imprime la comanda de cocina» y el asistente comprueba en vivo si el agente está conectado, qué impresora tienes configurada y si está fallando algún ticket — incluso puede lanzar una impresión de prueba y guiarte paso a paso. Es la forma más rápida de resolverlo.

«Mesero no detectado» / no aparece conectado: abre de nuevo el Agente Mesero en el ordenador de la impresora y espera unos segundos a que reconecte. Con el instalador .pkg de Mac el agente se reabre solo; si no lo ves, ábrelo 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» (solo con el .dmg de respaldo): lo estás abriendo desde el disco .dmg. Arrástralo a Aplicaciones y ábrelo desde ahí. Con el instalador .pkg normal esto no ocurre.
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, y haz doble clic en el .pkg para instalar la versión nueva.
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.

← AnteriorInicio rápido Siguiente →¿Qué es el modo Buffet?