Configuración de la impresora de recibos: conexión e impresión de pedidos

El RestaurantManage Print Agent es un servicio ligero de Windows que recibe comandos de impresión desde la nube y los envía a tu impresora de recibos térmica — permitiendo la impresión automática de recibos cuando se pagan los pedidos o cuando se necesitan imprimir tickets de cocina. El agente admite impresoras de red (puerto TCP 9100), impresoras USB y conexiones Windows Spooler. Esta guía cubre la instalación, configuración, conexión de la impresora y resolución de problemas.

¿Cómo funciona la impresión de recibos?

El flujo de trabajo de impresión está completamente automatizado. Cuando un cajero confirma el pago o se activa un ticket de cocina, el servidor de RestaurantManage genera el recibo completo como comandos de bytes ESC/POS — incluyendo nombre del restaurante, número de mesa, pedido detallado, precios, desglose de impuestos, total y método de pago. Estos bytes se envían a través de una conexión WebSocket segura (PrintHub) al Print Agent que se ejecuta en un PC con Windows en tu restaurante. El agente decodifica los datos y los envía directamente a la impresora térmica conectada. Todo el proceso tarda menos de dos segundos desde la confirmación del pago hasta el recibo impreso.

¿Cómo instalo el Print Agent?

1. Descarga: Obtén el instalador más reciente del Print Agent desde tu panel de administración o contacta con el soporte.
2. Instala: Ejecuta el instalador en un PC con Windows que permanecerá encendido durante el horario de servicio.
3. Configura: Abre config.json e introduce la URL base de la API, el ID de tu restaurante y la clave secreta del agente (proporcionada por tu administrador).
4. Conecta la impresora: Conecta tu impresora térmica por USB o conéctala a la misma red que el PC.
5. Inicia el servicio: Ejecuta el Print Agent — se conecta automáticamente al PrintHub y muestra un indicador de estado verde.
6. Impresión de prueba: Procesa un pago de prueba desde el panel de caja y verifica que el recibo se imprime correctamente.

¿Qué tipos de conexión de impresora se admiten?

El Print Agent admite tres métodos de conexión con conmutación automática entre ellos. Las impresoras de red se conectan vía TCP en el puerto 9100 — introduce la dirección IP de la impresora en la configuración. Este es el método recomendado para restaurantes con varias impresoras. Las impresoras USB se conectan directamente al PC y se accede a ellas mediante Windows Spooler o direccionamiento directo del puerto USB. El Windows Spooler usa el controlador de impresión estándar de Windows, que funciona con cualquier impresora reconocida por Windows. El agente intenta primero el Spooler, luego recurre al USB directo y finalmente intenta los recursos compartidos de red UNC.

¿Cómo configuro el Print Agent?

El archivo config.json contiene tres ajustes obligatorios: ApiBaseUrl (la URL del servidor RestaurantManage), RestaurantId (el ID único de tu restaurante del panel de administración) y AgentSecretKey (una clave secreta generada en el panel de administración que autentica el agente de impresión sin necesitar una cuenta de usuario). El agente se autentica con PrintHub usando esta clave secreta vía WebSocket. Para impresoras de red, añade la IP y el puerto de la impresora a la configuración. El agente registra toda la actividad en la carpeta logs/ para resolución de problemas.

¿Cómo funciona la actualización automática?

El Print Agent comprueba las actualizaciones aproximadamente cada 2,5 horas llamando al endpoint de actualización del servidor RestaurantManage. Si hay una nueva versión disponible, descarga el paquete de actualización como archivo ZIP a una carpeta de actualizaciones pendientes, ejecuta el script de instalación y reinicia el servicio automáticamente. Esto significa que tu restaurante siempre ejecuta la última versión sin intervención manual. Las comprobaciones de actualización incluyen un tiempo de espera específico por restaurante para evitar que todos los agentes se actualicen simultáneamente. Puedes ver la versión actual del agente en el panel de administración.

Solución de problemas comunes

• El agente no se conecta: Comprueba que ApiBaseUrl y AgentSecretKey en config.json sean correctos. Verifica el acceso a internet en el PC.
• El recibo no se imprime: Confirma que la impresora está encendida y conectada. Revisa la carpeta logs/ para obtener detalles del error.
• Texto ilegible en el recibo: Asegúrate de que tu impresora admite comandos ESC/POS. La mayoría de las impresoras térmicas de 80 mm son compatibles.
• La conexión se corta frecuentemente: El agente se reconecta automáticamente, pero comprueba la estabilidad de tu red. Una conexión Ethernet por cable es más fiable que el Wi-Fi.
• El agente no arranca como servicio: Ejecuta install-service.bat como Administrador para registrar correctamente el servicio de Windows.

Guías relacionadas

• Panel de caja: Cómo procesar los pagos que activan la impresión de recibos
• Pantalla de cocina: Cómo se integra la impresión de tickets de cocina con el flujo de pedidos
• Primeros pasos: Guía de configuración completa desde el registro hasta el primer pedido