HandyCafe Docs
owner cashier it-admin

Solucion de problemas

Esta pagina cubre soluciones para problemas comunes organizados por categoria.

Problemas de conexion

El cliente no encuentra el servidor

Sintomas: El cliente muestra "Buscando servidor" o "Servidor no encontrado".

Soluciones:

  1. Verifique que HandyCafe Server este en ejecucion en el PC de gestion.
  2. Confirme que ambos PCs esten en la misma subred (por ejemplo, ambos en 192.168.1.x).
  3. Verifique que mDNS no este bloqueado por su switch o router de red.
  4. Intente la conexion manual: ingrese la direccion IP del servidor directamente en la configuracion del cliente.
  5. Verifique que ningun otro software este usando el puerto TCP del servidor (predeterminado: 5001).

El cliente se conecta y luego se desconecta inmediatamente

Sintomas: El cliente muestra brevemente "Conectado" y luego regresa a "Buscando".

Soluciones:

  1. Verifique que la clave de conexion coincida en ambos, servidor y cliente. La clave se establece en Configuracion > Red en el servidor.
  2. Verifique si hay inestabilidad de red (perdida de paquetes, problemas de cable).
  3. Asegurese de que el servidor no haya alcanzado su limite de PCs de licencia.
  4. Revise los registros del servidor para mensajes de fallo de autenticacion.

El cliente muestra "Desconectado" en el servidor pero el PC esta encendido

Sintomas: El PC cliente esta encendido y la aplicacion cliente esta en ejecucion pero el servidor lo muestra como desconectado.

Soluciones:

  1. En el PC cliente, verifique que HandyCafe Client este realmente en ejecucion (revise la bandeja del sistema).
  2. Verifique la conexion 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, asegurese de que las VLANs del servidor y el cliente puedan comunicarse.

No puede conectarse despues de cambiar la configuracion de red

Sintomas: Despues de cambiar puertos o la clave de conexion, los clientes no pueden conectarse.

Soluciones:

  1. Asegurese de que los clientes esten actualizados con los nuevos numeros de puerto y clave de conexion.
  2. Reinicie HandyCafe Server despues de cambiar la configuracion 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 sesion

No puede iniciar una sesion en un cliente

Sintomas: El boton de Iniciar esta deshabilitado o la accion falla con un error.

Soluciones:

  1. Verifique el estado de la licencia. Si esta 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. Asegurese de que los precios esten configurados (Configuracion > Precios debe tener una tarifa por hora valida).

El temporizador de sesion muestra una hora incorrecta

Sintomas: 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 sesion fue pausada, la duracion de la pausa no se cuenta.
  3. Para sesiones prepago, el temporizador muestra el tiempo restante, no el tiempo transcurrido.

El costo de la sesion parece incorrecto

Sintomas: El monto cobrado no coincide con las expectativas.

Soluciones:

  1. Verifique el horario de precios. Si esta habilitado, la sesion puede haber pasado por multiples franjas de precios con diferentes multiplicadores.
  2. Revise la configuracion de precios: tarifa por hora base, IVA, tarifa de inicio, redondeo.
  3. Verifique los segmentos de precios de la sesion en los detalles de la transaccion para un desglose.
  4. Verifique la comision y tarifas fijas del metodo de pago.
  5. Para sesiones prepago, verifique si el modo "Bloquear al comprar" u "Horario en vivo" esta activo.

La sesion pausada no puede reanudarse

Sintomas: La accion de reanudar falla o no esta 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 desconecto durante la pausa, puede necesitar reconectarse primero.

Problemas de pago

El metodo de pago no aparece en el menu desplegable

Sintomas: El metodo de pago esperado no aparece al cerrar una sesion o pedido.

Soluciones:

  1. Verifique que el metodo de pago exista en Gestion > Metodos de pago.
  2. Verifique que el metodo de pago este activo (no eliminado ni deshabilitado).
  3. Verifique los permisos del cajero. PAYMENT_MANAGE debe estar otorgado para ver todos los metodos.

El calculo de la comision parece incorrecto

Sintomas: La comision deducida no coincide con la tasa esperada.

Soluciones:

  1. Verifique la tasa de comision del metodo de pago (como porcentaje) y la tarifa fija.
  2. Formula de comision: comision = (monto cobrado * tasa de comision / 100) + tarifa fija.
  3. Verifique si el cajero aplico una modificacion manual al monto cobrado.

Problemas de visualizacion del cliente

La pantalla de espera del cliente esta en blanco

Sintomas: La pantalla de espera no muestra nada en lugar de la presentacion configurada.

Soluciones:

  1. Verifique que la pantalla de espera este habilitada en Configuracion > 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 validos y no esten danados.
  4. Active una sincronizacion para enviar la configuracion mas reciente al cliente.

El menu del cliente no muestra aplicaciones

Sintomas: El lanzador de aplicaciones esta vacio o faltan categorias.

Soluciones:

  1. Verifique que las aplicaciones y categorias esten configuradas en Configuracion > Clientes > Contenido.
  2. Verifique que las categorias y aplicaciones tengan la visibilidad activada.
  3. Verifique que el cliente haya recibido los datos mas recientes del menu (los cambios se envian automaticamente via TCP).
  4. Reinicie el cliente si la sincronizacion en tiempo real no aplico.

El tema de apariencia del cliente no se aplica

Sintomas: El cliente muestra la apariencia predeterminada en lugar del tema configurado.

Soluciones:

  1. Verifique que la configuracion del tema este guardada en Configuracion > Clientes > Apariencia.
  2. Active un envio de configuracion a los clientes.
  3. Reinicie la aplicacion del cliente.

Problemas de escritorio remoto

El escritorio remoto esta lento o entrecortado

Sintomas: El video tiene retraso, tartamudea o tiene baja tasa de fotogramas.

Soluciones:

  1. Reduzca la tasa de bits (pruebe 1000-2000 kbps para uso estandar en LAN).
  2. Reduzca la configuracion de FPS.
  3. Use Ethernet cableado en lugar de WiFi.
  4. Verifique si hay congestion de red o alto uso de ancho de banda de otras aplicaciones.
  5. Asegurese de que el puerto UDP 5004 no este bloqueado ni limitado en velocidad.

El escritorio remoto muestra pantalla negra

Sintomas: La ventana de escritorio remoto se abre pero solo muestra negro.

Soluciones:

  1. Verifique que el cliente este en linea y responda (intente tomar una captura de pantalla primero).
  2. Verifique que el puerto UDP 5004 este abierto bidireccionalmente.
  3. El controlador de graficos del cliente puede necesitar actualizacion.
  4. Intente solicitar una actualizacion de fotograma clave.

No puede controlar el raton o teclado de forma remota

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

Soluciones:

  1. Verifique que el puerto de gestion remota (TCP 5003) este abierto.
  2. Verifique que la aplicacion 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"

Sintomas: 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 resolucion 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"

Sintomas: Hay mas clientes conectados de los que la licencia permite.

Soluciones:

  1. Desconecte clientes inactivos que no esten en uso.
  2. Verifique el conteo actual de clientes vs. su limite de licencia.
  3. Actualice su licencia para mas capacidad de PCs.
  4. Nota: las consolas cuentan para el limite total de PCs.

La licencia muestra "expired" o "revoked"

Sintomas: El servidor entra en modo restringido.

Soluciones:

  1. Verifique la fecha de expiracion de su licencia.
  2. Renueve su licencia a traves del sitio web de HandyCafe.
  3. Para licencias revocadas, contacte al soporte de HandyCafe.

Problemas generales

Los cambios de configuracion no se guardan

Sintomas: Los cambios se revierten al navegar fuera de la configuracion.

Soluciones:

  1. Asegurese de hacer clic en el boton Guardar despues de realizar cambios.
  2. Verifique si hay errores de validacion (campos resaltados con mensajes de error).
  3. Verifique que tenga permisos de administrador.

Los registros de auditoria no tienen entradas

Sintomas: Las acciones esperadas no aparecen en la pagina de Registros.

Soluciones:

  1. Verifique los filtros del registro. Asegurese de que la categoria y el rango de fechas correctos esten seleccionados.
  2. Verifique que el permiso LOG_DISPLAY_FULL este otorgado (de lo contrario solo se muestran los registros del dia).
  3. Busque usando el campo de busqueda de texto para la accion especifica.