HandyCafe Docs
owner cashier it-admin

Solução de Problemas

Esta página cobre soluções para problemas comuns organizados por categoria.

Problemas de Conexão

Cliente não consegue encontrar o servidor

Sintomas: Cliente mostra "Procurando pelo servidor" ou "Nenhum servidor encontrado."

Soluções:

  1. Verifique se o HandyCafe Server está em execução no PC de gerenciamento.
  2. Confirme se ambos os PCs estão na mesma sub-rede (ex.: ambos em 192.168.1.x).
  3. Verifique se o mDNS não está bloqueado pelo seu switch ou roteador de rede.
  4. Tente conexão manual: insira o endereço IP do servidor diretamente nas configurações do cliente.
  5. Verifique se nenhum outro software está usando a porta TCP do servidor (padrão: 5001).

Cliente conecta e depois desconecta imediatamente

Sintomas: Cliente brevemente mostra "Conectado" e depois volta para "Procurando."

Soluções:

  1. Verifique se a chave de conexão coincide tanto no servidor quanto no cliente. A chave é configurada em Configurações > Rede no servidor.
  2. Verifique a instabilidade da rede (perda de pacotes, problemas de cabo).
  3. Certifique-se de que o servidor não atingiu seu limite de licença de PCs.
  4. Revise os logs do servidor para mensagens de falha de autenticação.

Cliente mostra "Offline" no servidor, mas o PC está ligado

Sintomas: O PC cliente está ligado e o aplicativo cliente está em execução, mas o servidor o mostra como offline.

Soluções:

  1. No PC cliente, verifique se o HandyCafe Client está realmente em execução (verifique a bandeja do sistema).
  2. Verifique a conexão de rede no PC cliente (ele consegue pingar o servidor?).
  3. Verifique as regras de firewall: as portas TCP 5001-5003 devem estar abertas tanto no servidor quanto no cliente.
  4. Reinicie o HandyCafe Client no PC afetado.
  5. Se estiver usando VLANs, certifique-se de que as VLANs do servidor e do cliente possam se comunicar.

Não é possível conectar após alterar configurações de rede

Sintomas: Após alterar portas ou chave de conexão, os clientes não conseguem conectar.

Soluções:

  1. Certifique-se de que os clientes estão atualizados com os novos números de porta e chave de conexão.
  2. Reinicie o HandyCafe Server após alterar as configurações de rede.
  3. Atualize as regras de firewall para permitir as novas portas.
  4. Todos os clientes devem ser reconfigurados com os novos valores.

Problemas de Sessão

Não é possível iniciar uma sessão em um cliente

Sintomas: Botão de início está desativado ou ação de início falha com um erro.

Soluções:

  1. Verifique o status da licença. Se estiver em modo somente leitura, novas sessões não podem ser iniciadas.
  2. Verifique se o status do cliente é "Ocioso". Sessões só podem ser iniciadas em clientes ociosos.
  3. Verifique as permissões do caixa. O papel deve ter a permissão AUTH_CLIENT_LOGIN.
  4. Certifique-se de que a precificação está configurada (Configurações > Preços deve ter uma taxa horária válida).

Temporizador da sessão mostra tempo incorreto

Sintomas: O tempo exibido não corresponde ao tempo realmente decorrido.

Soluções:

  1. Verifique os relógios do sistema tanto no servidor quanto nos PCs clientes. Eles devem estar sincronizados (use NTP).
  2. Se a sessão foi pausada, a duração pausada não é contada.
  3. Para sessões pré-pagas, o temporizador mostra o tempo restante, não o tempo decorrido.

Custo da sessão parece errado

Sintomas: O valor cobrado não corresponde às expectativas.

Soluções:

  1. Verifique a tabela de preços. Se ativada, a sessão pode ter passado por múltiplos slots de preços com diferentes multiplicadores.
  2. Revise as configurações de preços: taxa horária base, IVA, taxa de inicialização, arredondamento.
  3. Verifique os segmentos de preços da sessão nos detalhes da transação para um detalhamento.
  4. Verifique a comissão e taxas fixas do método de pagamento.
  5. Para sessões pré-pagas, verifique se o modo "Travar na Compra" ou "Agenda ao Vivo" está ativo.

Sessão pausada não pode ser retomada

Sintomas: Ação de retomar falha ou não está disponível.

Soluções:

  1. Verifique se o PC cliente ainda está conectado ao servidor.
  2. Verifique se o status do cliente mostra "Pausado" (laranja).
  3. Se o cliente desconectou durante a pausa, pode ser necessário reconectar primeiro.

Problemas de Pagamento

Método de pagamento está faltando no menu suspenso

Sintomas: Método de pagamento esperado não aparece ao fechar uma sessão ou pedido.

Soluções:

  1. Verifique se o método de pagamento existe em Gerenciamento > Métodos de Pagamento.
  2. Verifique se o método de pagamento está ativo (não excluído ou desativado).
  3. Verifique as permissões do caixa. PAYMENT_MANAGE deve ser concedido para ver todos os métodos.

Cálculo de comissão parece incorreto

Sintomas: A comissão deduzida não corresponde à taxa esperada.

Soluções:

  1. Verifique a taxa de comissão do método de pagamento (como porcentagem) e a taxa fixa.
  2. Fórmula de comissão: comissão = (valor cobrado * taxa de comissão / 100) + taxa fixa.
  3. Verifique se o caixa aplicou uma substituição manual ao valor cobrado.

Problemas de Exibição do Cliente

Tela ociosa do cliente está em branco

Sintomas: A tela ociosa não mostra nada em vez da apresentação de slides configurada.

Soluções:

  1. Verifique se a tela ociosa está ativada em Configurações > Clientes > Tela Ociosa.
  2. Verifique se pelo menos um item de mídia (imagem ou vídeo) foi adicionado.
  3. Verifique se os arquivos de mídia são válidos e não estão corrompidos.
  4. Acione uma sincronização para enviar as configurações mais recentes para o cliente.

Menu do cliente não mostra aplicativos

Sintomas: O lançador de aplicativos está vazio ou faltam categorias.

Soluções:

  1. Verifique se os aplicativos e categorias estão configurados em Configurações > Clientes > Conteúdo.
  2. Verifique se as categorias e aplicativos têm a visibilidade ativada.
  3. Verifique se o cliente recebeu os dados mais recentes do menu (as alterações são enviadas automaticamente via TCP).
  4. Reinicie o cliente se a sincronização em tempo real não foi aplicada.

Tema de aparência do cliente não é aplicado

Sintomas: O cliente mostra a aparência padrão em vez do tema configurado.

Soluções:

  1. Verifique se as configurações de tema estão salvas em Configurações > Clientes > Aparência.
  2. Acione um envio de configurações para os clientes.
  3. Reinicie o aplicativo cliente.

Problemas de Desktop Remoto

Desktop remoto está lento ou instável

Sintomas: O feed de vídeo está atrasado, com falhas ou tem baixa taxa de quadros.

Soluções:

  1. Reduza a taxa de bits (tente 1000-2000 kbps para uso padrão em LAN).
  2. Reduza a configuração de FPS.
  3. Use Ethernet com fio em vez de WiFi.
  4. Verifique se há congestionamento de rede ou uso elevado de largura de banda por outros aplicativos.
  5. Certifique-se de que a porta UDP 5004 não está bloqueada ou com limite de taxa.

Desktop remoto mostra tela preta

Sintomas: A janela do desktop remoto abre, mas mostra apenas preto.

Soluções:

  1. Verifique se o cliente está online e responsivo (tente capturar uma captura de tela primeiro).
  2. Verifique se a porta UDP 5004 está aberta bidirecionalmente.
  3. O driver gráfico do cliente pode precisar de atualização.
  4. Tente solicitar uma atualização de quadro-chave.

Não é possível controlar mouse ou teclado remotamente

Sintomas: Você pode ver a tela remota, mas cliques e teclas não têm efeito.

Soluções:

  1. Verifique se a porta de gerenciamento remoto (TCP 5003) está aberta.
  2. Verifique se o aplicativo cliente tem permissões de sistema apropriadas.
  3. Alguns jogos em tela cheia podem bloquear a entrada remota.

Problemas de Licenciamento

Licença mostra "offline_grace"

Sintomas: Status da licença mostra offline_grace com uma contagem regressiva.

Soluções:

  1. Restaure a conectividade com a internet no PC do servidor.
  2. Verifique a resolução de DNS. O servidor deve alcançar o servidor de licenciamento.
  3. Verifique se há proxy ou firewall bloqueando conexões HTTPS de saída.
  4. Você tem 72 horas para restaurar a conectividade antes que o servidor seja bloqueado.

Licença mostra "over_limit"

Sintomas: Mais clientes estão conectados do que a licença permite.

Soluções:

  1. Desconecte clientes ociosos que não estão em uso.
  2. Verifique a contagem atual de clientes em relação ao limite da sua licença.
  3. Atualize sua licença para mais capacidade de PCs.
  4. Nota: consoles contam para o limite total de PCs.

Licença mostra "expired" ou "revoked"

Sintomas: Servidor entra em modo restrito.

Soluções:

  1. Verifique a data de expiração da sua licença.
  2. Renove sua licença através do site do HandyCafe.
  3. Para licenças revogadas, entre em contato com o suporte do HandyCafe.

Problemas Gerais

Alterações de configurações não estão sendo salvas

Sintomas: Alterações são revertidas após navegar para longe das configurações.

Soluções:

  1. Certifique-se de clicar no botão Salvar após fazer alterações.
  2. Verifique se há erros de validação (campos destacados com mensagens de erro).
  3. Verifique se você tem permissões de administrador.

Logs de auditoria estão faltando entradas

Sintomas: Ações esperadas não aparecem na página de Logs.

Soluções:

  1. Verifique os filtros de log. Certifique-se de que a categoria correta e o intervalo de datas estão selecionados.
  2. Verifique se a permissão LOG_DISPLAY_FULL é concedida (caso contrário, apenas os logs de hoje são mostrados).
  3. Pesquise usando o campo de pesquisa de texto para a ação específica.