HandyCafe Docs
owner cashier

Como Gerenciar Sessões

Este guia cobre todas as operações de sessão que um caixa ou proprietário realiza durante um turno típico. As sessões são a unidade central de faturamento no HandyCafe. Cada seção abaixo descreve uma única operação com etapas numeradas e o resultado esperado.

O Que Você Vai Precisar

  • Um servidor HandyCafe em execução com pelo menos um PC cliente conectado (mostrando um bloco azul "Ocioso").
  • Uma conta de caixa ou administrador logada no servidor.
  • Preços configurados (taxa horária, IVA e pelo menos um método de pagamento). Consulte o guia de configuração de preços se ainda não tiver feito isso.

Como Iniciar uma Sessão Pós-paga

Uma sessão pós-paga cobra o cliente quando a sessão termina. O cronômetro conta para cima sem limite predefinido.

  1. Localize o PC cliente ocioso no Painel de Administração. Ele mostrará um bloco azul com status "Ocioso".
  2. Clique em Iniciar no bloco do cliente.
  3. No diálogo de sessão, certifique-se de que o tipo de sessão está definido como Pós-pago. Este é o padrão.
  4. Opcionalmente, atribua um membro digitando um nome de usuário no campo de busca de membros. Se o cliente for um convidado, deixe este campo vazio.
  5. Clique em Confirmar.

Resultado esperado: O bloco do cliente fica verde e exibe um cronômetro contando a partir de 00:00:00. O PC cliente transita da tela de bloqueio para a área de trabalho da Página Online. A sessão agora está registrando tempo faturável.

Como Iniciar uma Sessão Pré-paga

Uma sessão pré-paga tem duração fixa. O cronômetro conta regressivamente e a sessão termina automaticamente quando o tempo se esgota.

  1. Localize o PC cliente ocioso no Painel de Administração.
  2. Clique em Iniciar no bloco do cliente.
  3. No diálogo de sessão, alterne o tipo de sessão para Pré-pago.
  4. Insira a duração da sessão. Você pode digitar um número de minutos diretamente ou clicar em um dos predefinidos de preços (por exemplo, 30 Minutos, 1 Hora, 2 Horas) se os tiver configurado.
  5. Selecione o método de pagamento que o cliente está usando (Dinheiro, Cartão ou qualquer método personalizado que você tenha criado).
  6. Opcionalmente, atribua um membro.
  7. Clique em Confirmar.

Resultado esperado: O bloco do cliente fica verde e exibe um cronômetro regressivo começando a partir da duração comprada. O PC cliente mostra a Página Online. Quando o cronômetro chega a zero, a sessão terminará automaticamente e o PC retornará ao estado ocioso.

Como Pausar uma Sessão

Pausar para o cronômetro de faturamento enquanto mantém a sessão aberta. Use isso quando um cliente precisar se ausentar temporariamente.

  1. Clique em Pausar no bloco verde (ativo) do cliente no Painel de Administração.
  2. Confirme a pausa no diálogo que aparece.

Resultado esperado: O bloco do cliente fica laranja e o cronômetro para de incrementar. O PC cliente mostra um estado pausado. Nenhum tempo é faturado enquanto a sessão está pausada. Um novo limite de segmento de preços é registrado no ponto de pausa.

Como Retomar uma Sessão Pausada

Retomar reinicia o cronômetro de faturamento de onde foi pausado.

  1. Clique em Retomar no bloco laranja (pausado) do cliente no Painel de Administração.
  2. Confirme o retomar no diálogo.

Resultado esperado: O bloco do cliente volta a ficar verde e o cronômetro retoma a contagem. Um novo segmento de preços começa no ponto de retomada. Se o cronograma de preços ativo tiver mudado desde que a sessão foi pausada (por exemplo, a sessão foi pausada em horário de baixa demanda e retomada em horário de pico), o novo segmento usará o multiplicador atual.

Como Adicionar Tempo a uma Sessão Ativa

Você pode estender ou encurtar uma sessão ativa adicionando minutos positivos ou negativos. Isso funciona para sessões pré-pagas e pós-pagas.

  1. Clique em Adicionar Tempo no bloco verde (ativo) do cliente no Painel de Administração.
  2. Insira o número de minutos a adicionar. Use um número positivo para estender (por exemplo, 30) ou um número negativo para encurtar (por exemplo, -15).
  3. Clique em Confirmar.

Resultado esperado: Para sessões pré-pagas, o cronômetro regressivo é atualizado para refletir o tempo adicionado ou removido. Para sessões pós-pagas, o ajuste de duração é registrado e será refletido no cálculo final de faturamento. Uma entrada de log registra o ajuste de tempo.

Como Parar uma Sessão e Receber Pagamento

Parar uma sessão encerra o faturamento, calcula o total a cobrar e registra uma transação.

  1. Clique em Parar no bloco verde (ativo) do cliente no Painel de Administração.
  2. Revise o diálogo de detalhamento de custos. Ele exibe:
    • Duração total da sessão.
    • Taxa horária aplicada.
    • Segmentos de preços (se a sessão abrangeu vários intervalos de cronograma de preços).
    • Taxa de inicialização (se configurada).
    • Valor do IVA.
    • Total a cobrar.
  3. Selecione o método de pagamento (Dinheiro, Cartão ou um método personalizado).
  4. Clique em Confirmar para finalizar a sessão.

Resultado esperado: O bloco do cliente retorna ao status azul "Ocioso". O PC cliente mostra a tela de bloqueio. Uma transação é criada com o detalhamento completo dos custos. A transação aparece no Relatório de Caixa e na página de Logs.

Como Iniciar uma Sessão de Membro com Dedução de Carteira

Se um membro tiver saldo na carteira, o custo da sessão pode ser deduzido da carteira em vez de exigir pagamento em dinheiro no final.

  1. Clique em Iniciar no bloco do cliente ocioso.
  2. No campo de busca de membros, digite o nome de usuário ou nome de exibição do membro e selecione-o nos resultados.
  3. O diálogo mostrará o saldo atual da carteira do membro.
  4. Selecione o tipo de sessão (Pós-pago ou Pré-pago).
  5. Para Pré-pago, insira a duração ou selecione um predefinido. Para Pós-pago, prossiga diretamente.
  6. Clique em Confirmar.

Resultado esperado: A sessão começa com o membro atribuído. Para pós-pago, quando a sessão é parada, o sistema oferecerá a opção de deduzir o valor da carteira do membro. Para pré-pago, o valor é deduzido da carteira no início da sessão. Registros de consumo da carteira são criados no histórico de transações do membro.

Como Iniciar uma Sessão de Console

Sessões de console funcionam da mesma forma que sessões de PC, mas para consoles de jogos (PlayStation, Xbox, etc.) que não executam o software cliente HandyCafe.

  1. Navegue até a página de Consoles na barra lateral esquerda.
  2. Localize o console em que você deseja iniciar uma sessão.
  3. Clique em Iniciar no bloco do console.
  4. Selecione Pós-pago ou Pré-pago. O preço do console usa o multiplicador configurado para aquele console específico.
  5. Opcionalmente, atribua um membro.
  6. Clique em Confirmar.

Resultado esperado: O bloco do console fica verde com um cronômetro em execução. Sessões de console usam o multiplicador de preços individual do console aplicado sobre a taxa horária base.

Como Transferir uma Sessão Entre PCs

Se um cliente precisar mudar para um PC diferente, você pode transferir a sessão sem parar e reiniciar.

  1. Clique em Transferir no bloco ativo (verde) do cliente para o PC que está executando a sessão.
  2. No diálogo, selecione o PC de destino na lista de clientes ociosos.
  3. Clique em Confirmar.

Resultado esperado: A sessão é transferida para o novo PC. O PC original retorna ao estado ocioso e o PC de destino se torna ativo com o mesmo cronômetro de sessão, atribuição de membro e estado de faturamento. Nenhum intervalo de preços é criado.

Erros Comuns a Evitar

  • Esquecer de parar sessões no final do dia. Qualquer sessão deixada em execução durante a noite continuará acumulando cobranças. Sempre verifique se todas as sessões estão fechadas antes de fechar o caixa.
  • Pausar em vez de parar. Pausar mantém a sessão aberta. Se o cliente foi embora definitivamente, pare a sessão para registrar o pagamento.
  • Adicionar tempo negativo além de zero. Se você subtrair mais minutos do que restam em uma sessão pré-paga, a sessão terminará imediatamente. Verifique o tempo restante antes de inserir um valor negativo.
  • Parar uma sessão antes que o cliente termine. Uma vez parada, o cliente perde o acesso ao PC. Sempre confirme com o cliente antes de parar.
  • Não atribuir um membro. Se um membro estiver presente mas não for atribuído, o saldo da carteira dele não estará disponível para pagamento e a sessão não aparecerá no histórico dele. Atribua o membro no início da sessão para um rastreamento preciso.
  • Ignorar o detalhamento de custos. Sempre revise o diálogo de detalhamento de custos antes de confirmar o pagamento. Esta é sua última chance de identificar cobranças incorretas ou aplicar ajustes manuais.