HandyCafe Docs
owner cashier

Gestion de sesiones

Las sesiones son la unidad de facturacion principal en HandyCafe. Cada vez que un cliente en su cibercafe o centro de gaming usa un PC o consola de juego, una sesion registra su tiempo de uso y calcula el costo. Esta pagina explica el ciclo de vida completo de la sesion, desde iniciar una sesion hasta cobrar el pago.

Tipos de sesion

HandyCafe admite dos tipos de sesiones:

  • Sesiones de PC. Sesiones en PCs cliente gestionadas a traves del Panel de administracion. El software cliente bloquea el PC cuando esta inactivo y lo desbloquea cuando comienza una sesion.
  • Sesiones de consola. Sesiones en consolas de juego (PlayStation, Xbox, etc.) gestionadas a traves de la pagina de Consolas. Estas son registradas solo por el servidor; no hay software cliente en la consola misma.

Ambos tipos de sesion siguen el mismo motor de precios y ciclo de vida pero se gestionan desde paginas diferentes en el panel de control.

Ciclo de vida de la sesion

Cada sesion sigue un ciclo de vida definido con transiciones de estado claras:

Inicio --> En ejecucion --> (Pausa <--> Reanudacion) --> Agregar tiempo --> Fin

Los estados en detalle:

  1. Inicio. Un cajero inicia la sesion. El PC cliente se desbloquea o el temporizador de la consola comienza.
  2. En ejecucion. La sesion esta activa. El tiempo corre y la facturacion se acumula.
  3. Pausa. El cajero detiene temporalmente la sesion. La facturacion se detiene. El cliente muestra un estado pausado.
  4. Reanudacion. El cajero continua una sesion pausada. La facturacion se reanuda desde un nuevo segmento de precios.
  5. Agregar tiempo. El cajero agrega (o quita) minutos a una sesion activa.
  6. Fin. La sesion termina. El sistema calcula el costo final y solicita el pago.

Iniciar una sesion

Para iniciar una nueva sesion en un PC cliente:

  1. Seleccione el cliente. En el Panel de administracion, haga clic en un PC que este en estado Inactivo (cian) para revelar los botones de accion.
  2. Elija el tipo de facturacion. Seleccione Pospago (paga al final) o Prepago (paga por adelantado).
  3. Asigne un miembro (opcional). Si el cliente es un miembro registrado, busque su cuenta usando el campo de busqueda con autocompletado. Asignar un miembro habilita los pagos con monedero y registra la sesion en su historial.
  4. Establezca duracion o monto (solo prepago). Para sesiones prepago, ingrese la cantidad de minutos que el cliente esta comprando o el monto monetario que esta pagando. El sistema calcula el tiempo correspondiente basandose en la franja de precios actual.
  5. Seleccione el metodo de pago. Elija el metodo de pago (Efectivo, Tarjeta de credito o cualquier metodo personalizado que haya configurado).
  6. Confirme. Revise los detalles y confirme. El PC cliente se desbloquea inmediatamente y el temporizador de sesion comienza.

Para sesiones de consola, el proceso es similar pero se inicia desde la pagina de Consolas.

Sesiones pospago

En una sesion pospago, el cliente usa el PC primero y paga cuando termina. Este es el modo de facturacion mas comun en cibercafes y centros de gaming.

Como funciona:

  • La sesion comienza sin pago por adelantado.
  • El temporizador corre y el costo se acumula en tiempo real basandose en la franja de precios activa.
  • Cuando la sesion se detiene, el sistema presenta el costo final calculado.
  • El cajero cobra el pago y confirma la transaccion.

Las sesiones pospago no tienen limite de tiempo. Se ejecutan hasta que el cajero las detiene o el cliente solicita irse.

Sesiones prepago

En una sesion prepago, el cliente paga por adelantado por una cantidad especifica de tiempo. La sesion termina automaticamente cuando el tiempo comprado expira.

Hay dos modos de precios prepago, configurados en Configuracion > Precios:

Bloquear al comprar

El costo se congela en el momento en que comienza la sesion. La franja de precios y el multiplicador activos al momento de la compra se usan para toda la duracion de la sesion, sin importar los cambios de horario que ocurran mientras la sesion esta en curso.

Ejemplo: Un cliente compra 60 minutos a las 10:00 AM durante una franja de tarifa estandar. Aunque el horario de precios cambie a una franja de mitad de precio a las 11:00 AM, el tiempo restante del cliente no se ve afectado. Recibio exactamente lo que pago a la tarifa original.

Horario en vivo

El costo se ajusta en tiempo real a medida que la sesion pasa por diferentes franjas de precios. Si la sesion del cliente abarca un cambio de franja, el tiempo restante se recalcula basandose en los nuevos precios.

Ejemplo: Un cliente compra 60 minutos a las 10:00 AM durante una franja de tarifa estandar. A las 11:00 AM, el horario cambia a una franja de mitad de precio. Ya que cada minuto ahora cuesta la mitad, el tiempo restante del cliente se extiende efectivamente. Puede terminar con mas minutos totales que los originalmente comprados.

Pausar una sesion

Pausar detiene temporalmente la facturacion sin finalizar la sesion. Esto es util cuando un cliente necesita ausentarse brevemente.

Para pausar una sesion:

  1. Seleccione el PC activo en el Panel de administracion y haga clic en el boton Pausar en la tarjeta.

Que sucede cuando se pausa una sesion:

  • La facturacion se detiene inmediatamente. No se acumula costo durante la pausa.
  • El segmento de precios actual se cierra con un limite de "pausa".
  • El PC cliente muestra un estado pausado con un indicador naranja.
  • El temporizador de sesion se congela.

Las sesiones pausadas permanecen pausadas indefinidamente hasta que un cajero las reanude o detenga.

Reanudar una sesion

Reanudar continua una sesion pausada desde donde se detuvo.

Para reanudar una sesion:

  1. Seleccione el PC pausado en el Panel de administracion y haga clic en el boton Reanudar en la tarjeta.

Que sucede cuando se reanuda una sesion:

  • Un nuevo segmento de precios comienza en la hora actual, usando la franja de precios activa.
  • La facturacion se reanuda.
  • El PC cliente regresa al estado activo (verde).

Tenga en cuenta que la franja de precios al momento de reanudar puede diferir de la franja cuando se pauso la sesion. El nuevo segmento usa cualquier tarifa que este actualmente vigente en el horario de precios.

Agregar tiempo

Puede agregar o quitar minutos de una sesion activa en cualquier momento.

Para agregar tiempo:

  1. Seleccione el PC activo en el Panel de administracion y haga clic en el boton Agregar tiempo en la tarjeta.
  2. Ingrese la cantidad de minutos a agregar. Use un valor positivo para extender la sesion o un valor negativo para reducirla.
  3. Confirme.

Que sucede cuando se agrega tiempo:

  • Se crea un registro de transaccion en el historial de la sesion.
  • Para sesiones prepago, la hora de fin se ajusta hacia adelante (o atras) por la cantidad de minutos especificada.
  • Para sesiones pospago, el evento de agregar tiempo se registra pero no establece una hora de fin fija.

Detener una sesion

Detener una sesion finaliza toda la facturacion, bloquea el PC cliente y activa el proceso de pago.

Para detener una sesion:

  1. Seleccione el PC activo o pausado en el Panel de administracion y haga clic en el boton Detener en la tarjeta.
  2. Aparece el Dialogo de pago mostrando un resumen de la sesion.

Dialogo de pago

El dialogo de pago muestra la siguiente informacion:

Campo Descripcion
Duracion Tiempo activo total (excluyendo periodos de pausa)
Monto calculado El costo bruto calculado basado en los segmentos de precios
Monto cobrado El monto a cobrar al cliente (por defecto es el calculado pero puede modificarse)
IVA Monto del impuesto, si esta configurado
Comision Comision del metodo de pago, si aplica
Tarifa fija Tarifa fija del metodo de pago, si aplica
Metodo de pago Menu desplegable para seleccionar como esta pagando el cliente

Anulacion del cajero: El cajero puede ajustar manualmente el monto cobrado. Por ejemplo, un cajero podria redondear hacia abajo como cortesia o aplicar un descuento manual. El monto calculado original siempre se preserva en los registros para auditoria.

  1. Seleccione un metodo de pago y confirme. La sesion se registra, el PC cliente se bloquea y la transaccion se guarda.

Proceso de liquidacion

Cuando una sesion se detiene, el motor de liquidacion ejecuta estos pasos:

  1. Cierra el ultimo segmento de precios abierto.
  2. Suma todos los montos de segmentos cerrados.
  3. Aplica reglas de redondeo (siempre redondea hacia arriba al paso de redondeo configurado).
  4. Aplica el minimo de tarifa de inicio (el total nunca es menor que la tarifa de inicio).
  5. Calcula la comision del metodo de pago (basada en BPS) y la tarifa fija.
  6. Presenta los montos finales en el dialogo de pago.

Para una explicacion detallada de como funcionan los segmentos de precios y los calculos de liquidacion, consulte Precios de sesiones.

Sesiones de miembros

Cuando un miembro se asigna a una sesion, opciones de facturacion adicionales estan disponibles:

  • Pago con monedero. El costo de la sesion puede deducirse del saldo del monedero del miembro.
  • Deduccion de paquete de tiempo. Si el miembro ha comprado un paquete de tiempo, los minutos se deducen de su saldo de paquete en lugar de cobrar un monto monetario.
  • Descuento de miembro. Si el miembro tiene un descuento configurado (en puntos base), se aplica al costo de la sesion.
  • Historial de sesiones. La sesion se vincula a la cuenta del miembro y aparece en su historial de sesiones.

Los miembros tambien pueden iniciar sus propias sesiones desde la pantalla de espera del cliente iniciando sesion con su nombre de usuario y contrasena o a traves de OAuth (si esta configurado).

Valores de estado de sesion

Cada PC cliente muestra un indicador de estado codificado por color:

Estado Color Significado
En linea Verde La sesion esta activa y en curso
Pausado Naranja La sesion esta pausada; la facturacion esta detenida
Inactivo Cian El cliente esta conectado pero no hay sesion activa
Desconectado Rojo El cliente no esta conectado al servidor
Admin Morado El cliente esta en modo de administracion/mantenimiento
Ocupado Amarillo El cliente esta procesando una solicitud

Estos colores de estado aparecen en las tarjetas de cliente en el Panel de administracion, facilitando ver el estado de cada PC de un vistazo.

Segmentos de precios de sesion

Cada sesion se divide en uno o mas segmentos de precios. Se crea un nuevo segmento cada vez que ocurre un evento relevante para la facturacion:

  • Inicio de sesion
  • Pausa
  • Reanudacion
  • Cambio de franja de precios (cuando el reloj cruza a una franja horaria diferente del horario)
  • Cambio de precio base (si el administrador cambia la tarifa por hora durante la sesion)
  • Desconexion o reconexion

Cada segmento registra la franja de precios, multiplicador, precio base, hora de inicio, hora de fin y monto calculado. El total de la sesion es la suma de todos los segmentos, sujeto a reglas de redondeo y cargo minimo.

Para detalles completos sobre como se calculan los segmentos, consulte Precios de sesiones.

Cargo minimo y tarifa de inicio

Incluso sesiones muy cortas se cobran al menos el monto de la tarifa de inicio. Esto se configura en Configuracion > Precios y asegura que cada sesion genere un nivel minimo de ingresos, sin importar lo breve que haya sido el uso.

Ejemplo: Si su tarifa de inicio esta en $1.00 y un cliente usa un PC por solo 30 segundos, el monto cobrado es $1.00, no la fraccion de centavo que 30 segundos costarian a la tarifa por hora.


Siguientes pasos