Solución de problemas

Esta página cubre soluciones para problemas comunes organizados por categoría.

Problemas de conexión

El cliente no encuentra el servidor

Síntomas: El cliente muestra "Buscando servidor" o "Servidor no encontrado".

Soluciones:

1. Verifique que HandyCafe Server esté en ejecución en el PC de gestión.
2. Confirme que ambos PCs estén en la misma subred (por ejemplo, ambos en 192.168.1.x).
3. Verifique que mDNS no esté bloqueado por su switch o router de red.
4. Intente la conexión manual: ingrese la dirección IP del servidor directamente en la configuración del cliente.
5. Verifique que ningún otro software esté usando el puerto TCP del servidor (predeterminado: 5001).

El cliente se conecta y luego se desconecta inmediatamente

Síntomas: El cliente muestra brevemente "Conectado" y luego regresa a "Buscando".

Soluciones:

1. Verifique que la clave de conexión coincida en ambos, servidor y cliente. La clave se establece en Configuración > Red en el servidor.
2. Verifique si hay inestabilidad de red (pérdida de paquetes, problemas de cable).
3. Asegúrese de que el servidor no haya alcanzado su límite de PCs de licencia.
4. Revise los registros del servidor para mensajes de fallo de autenticación.

El cliente muestra "Desconectado" en el servidor pero el PC está encendido

Síntomas: El PC cliente está encendido y la aplicación cliente está en ejecución pero el servidor lo muestra como desconectado.

Soluciones:

1. En el PC cliente, verifique que HandyCafe Client esté realmente en ejecución (revise la bandeja del sistema).
2. Verifique la conexión de red del PC cliente (puede hacer ping al servidor?).
3. Verifique las reglas del firewall: los puertos TCP 5001-5003 deben estar abiertos en ambos, servidor y cliente.
4. Reinicie HandyCafe Client en el PC afectado.
5. Si usa VLANs, asegúrese de que las VLANs del servidor y el cliente puedan comunicarse.

No puede conectarse después de cambiar la configuración de red

Síntomas: Después de cambiar puertos o la clave de conexión, los clientes no pueden conectarse.

Soluciones:

1. Asegúrese de que los clientes estén actualizados con los nuevos números de puerto y clave de conexión.
2. Reinicie HandyCafe Server después de cambiar la configuración de red.
3. Actualice las reglas del firewall para permitir los nuevos puertos.
4. Todos los clientes deben reconfigurarse con los nuevos valores.

Problemas de sesión

No puede iniciar una sesión en un cliente

Síntomas: El botón de Iniciar está deshabilitado o la acción falla con un error.

Soluciones:

1. Verifique el estado de la licencia. Si está en modo de solo lectura, no se pueden iniciar nuevas sesiones.
2. Verifique que el estado del cliente sea "Inactivo". Las sesiones solo pueden iniciarse en clientes inactivos.
3. Verifique los permisos del cajero. El rol debe tener el permiso AUTH_CLIENT_LOGIN.
4. Asegúrese de que los precios estén configurados (Configuración > Precios debe tener una tarifa por hora válida).

El temporizador de sesión muestra una hora incorrecta

Síntomas: La hora mostrada no coincide con el tiempo real transcurrido.

Soluciones:

1. Verifique los relojes del sistema en ambos PCs, servidor y cliente. Deben estar sincronizados (use NTP).
2. Si la sesión fue pausada, la duración de la pausa no se cuenta.
3. Para sesiones prepago, el temporizador muestra el tiempo restante, no el tiempo transcurrido.

El costo de la sesión parece incorrecto

Síntomas: El monto cobrado no coincide con las expectativas.

Soluciones:

1. Verifique el horario de precios. Si está habilitado, la sesión puede haber pasado por múltiples franjas de precios con diferentes multiplicadores.
2. Revise la configuración de precios: tarifa por hora base, IVA, tarifa de inicio, redondeo.
3. Verifique los segmentos de precios de la sesión en los detalles de la transacción para un desglose.
4. Verifique la comisión y tarifas fijas del método de pago.
5. Para sesiones prepago, verifique si el modo "Bloquear al comprar" u "Horario en vivo" está activo.

La sesión pausada no puede reanudarse

Síntomas: La acción de reanudar falla o no está disponible.

Soluciones:

1. Verifique que el PC cliente siga conectado al servidor.
2. Verifique que el estado del cliente muestre "Pausado" (naranja).
3. Si el cliente se desconectó durante la pausa, puede necesitar reconectarse primero.

Problemas de pago

El método de pago no aparece en el menú desplegable

Síntomas: El método de pago esperado no aparece al cerrar una sesión o pedido.

Soluciones:

1. Verifique que el método de pago exista en Gestión > Métodos de pago.
2. Verifique que el método de pago esté activo (no eliminado ni deshabilitado).
3. Verifique los permisos del cajero. PAYMENT_MANAGE debe estar otorgado para ver todos los métodos.

El cálculo de la comisión parece incorrecto

Síntomas: La comisión deducida no coincide con la tasa esperada.

Soluciones:

1. Verifique la tasa de comisión del método de pago (como porcentaje) y la tarifa fija.
2. Fórmula de comisión: comisión = (monto cobrado * tasa de comisión / 100) + tarifa fija.
3. Verifique si el cajero aplicó una modificación manual al monto cobrado.

Problemas de visualización del cliente

La pantalla de espera del cliente está en blanco

Síntomas: La pantalla de espera no muestra nada en lugar de la presentación configurada.

Soluciones:

1. Verifique que la pantalla de espera esté habilitada en Configuración > Clientes > Pantalla de espera.
2. Verifique que al menos un elemento multimedia (imagen o video) haya sido agregado.
3. Verifique que los archivos multimedia sean válidos y no estén dañados.
4. Active una sincronización para enviar la configuración más reciente al cliente.

El menú del cliente no muestra aplicaciones

Síntomas: El lanzador de aplicaciones está vacío o faltan categorías.

Soluciones:

1. Verifique que las aplicaciones y categorías estén configuradas en Configuración > Clientes > Contenido.
2. Verifique que las categorías y aplicaciones tengan la visibilidad activada.
3. Verifique que el cliente haya recibido los datos más recientes del menú (los cambios se envían automáticamente vía TCP).
4. Reinicie el cliente si la sincronización en tiempo real no aplicó.

El tema de apariencia del cliente no se aplica

Síntomas: El cliente muestra la apariencia predeterminada en lugar del tema configurado.

Soluciones:

1. Verifique que la configuración del tema esté guardada en Configuración > Clientes > Apariencia.
2. Active un envío de configuración a los clientes.
3. Reinicie la aplicación del cliente.

Problemas de escritorio remoto

El escritorio remoto está lento o entrecortado

Síntomas: El video tiene retraso, tartamudea o tiene baja tasa de fotogramas.

Soluciones:

1. Reduzca la tasa de bits (pruebe 1000-2000 kbps para uso estándar en LAN).
2. Reduzca la configuración de FPS.
3. Use Ethernet cableado en lugar de WiFi.
4. Verifique si hay congestión de red o alto uso de ancho de banda de otras aplicaciones.
5. Asegúrese de que el puerto UDP 5004 no esté bloqueado ni limitado en velocidad.

El escritorio remoto muestra pantalla negra

Síntomas: La ventana de escritorio remoto se abre pero solo muestra negro.

Soluciones:

1. Verifique que el cliente esté en línea y responda (intente tomar una captura de pantalla primero).
2. Verifique que el puerto UDP 5004 esté abierto bidireccionalmente.
3. El controlador de gráficos del cliente puede necesitar actualización.
4. Intente solicitar una actualización de fotograma clave.

No puede controlar el ratón o teclado de forma remota

Síntomas: Puede ver la pantalla remota pero los clics y pulsaciones de tecla no tienen efecto.

Soluciones:

1. Verifique que el puerto de gestión remota (TCP 5003) esté abierto.
2. Verifique que la aplicación del cliente tenga los permisos del sistema apropiados.
3. Algunos juegos en pantalla completa pueden bloquear la entrada remota.

Problemas de licencia

La licencia muestra "offline_grace"

Síntomas: El estado de la licencia muestra offline_grace con una cuenta regresiva.

Soluciones:

1. Restaure la conectividad a internet en el PC servidor.
2. Verifique la resolución DNS. El servidor debe alcanzar el servidor de licencias.
3. Verifique si hay proxy o firewall bloqueando conexiones HTTPS salientes.
4. Tiene 72 horas para restaurar la conectividad antes de que el servidor se bloquee.

La licencia muestra "over_limit"

Síntomas: Hay más clientes conectados de los que la licencia permite.

Soluciones:

1. Desconecte clientes inactivos que no estén en uso.
2. Verifique el conteo actual de clientes vs. su límite de licencia.
3. Actualice su licencia para más capacidad de PCs.
4. Nota: las consolas cuentan para el límite total de PCs.

La licencia muestra "expired" o "revoked"

Síntomas: El servidor entra en modo restringido.

Soluciones:

1. Verifique la fecha de expiración de su licencia.
2. Renueve su licencia a través del sitio web de HandyCafe.
3. Para licencias revocadas, contacte al soporte de HandyCafe.

Problemas generales

Los cambios de configuración no se guardan

Síntomas: Los cambios se revierten al navegar fuera de la configuración.

Soluciones:

1. Asegúrese de hacer clic en el botón Guardar después de realizar cambios.
2. Verifique si hay errores de validación (campos resaltados con mensajes de error).
3. Verifique que tenga permisos de administrador.

Los registros de auditoría no tienen entradas

Síntomas: Las acciones esperadas no aparecen en la página de Registros.

Soluciones:

1. Verifique los filtros del registro. Asegúrese de que la categoría y el rango de fechas correctos estén seleccionados.
2. Verifique que el permiso LOG_DISPLAY_FULL esté otorgado (de lo contrario solo se muestran los registros del día).
3. Busque usando el campo de búsqueda de texto para la acción específica.