Comece aqui quando algo não funcionar. Encontre o seu sintoma, leia o que ele significa e siga a correção. A maioria dos problemas vem da rede, de uma Comm Key errada, do fuso horário errado ou de um código não associado, e não do terminal.
#Verificações rápidas (faça-as primeiro)
- O PC do conector está ligado e mostra Online na aba Conectores?
- O cartão do dispositivo diz o que está errado? (Ele informa, por exemplo, "O conector ... está offline", "Configuração necessária" ou "Nenhum conector atribuído".)
- Clique em Testar conexão no dispositivo. Leia a resposta com a ajuda da tabela de estados.
- Abra Atividade no dispositivo: as marcações estão chegando e o que aconteceu com elas?
#Dispositivo inacessível
"Dispositivo inacessível" ou "não respondeu a tempo".
| Verificar | Como |
|---|---|
| Energia e cabo | O terminal está ligado e a luz de rede está acesa? |
| Endereço e porta | Compare com o menu do dispositivo (ZKTeco: Menu → Comm. → Ethernet; porta 4370). O endereço pode ter mudado se o dispositivo usa DHCP: dê a ele um endereço fixo. |
| Mesma rede | O PC do conector e o terminal precisam estar no mesmo segmento de rede, ou ter roteamento entre si. Um Wi-Fi de visitantes ou outra VLAN bloqueia a comunicação. |
| Firewall | Libere a porta do dispositivo a partir do PC: 4370 TCP/UDP para a ZKTeco, 5010 TCP para a Anviz, a porta web (80) para a Hikvision. |
| Uma conexão por vez | Alguns terminais aceitam apenas uma conexão de PC. Feche outros programas de ponto conectados ao mesmo dispositivo. |
| Ping a partir do PC | No prompt de comando: ping <device address>. Se falhar, o problema é a rede, não o SolaHR. |
#O conector
| Sintoma | Solução |
|---|---|
| Conector Offline | Ligue o PC; verifique o serviço com sc query SolaHRDeviceConnect (deve dizer RUNNING); verifique o acesso dele à internet. As marcações em espera são enviadas quando ele voltar. |
| "O conector não recebeu a solicitação" | O mesmo vale aqui: o PC está desligado, em suspensão ou offline. Desative a suspensão desse PC. |
| «O conector precisa ser emparelhado de novo» / «O conector foi revogado» | Gere um novo código de emparelhamento e emparelhe novamente (Instalar). |
| "Código expirado - crie um novo" | Um código de emparelhamento dura 15 minutos e funciona uma única vez. |
| O Windows avisa sobre o instalador | Esperado: a pré-visualização não tem assinatura de código. Confira o valor SHA-256 e depois Mais informações → Executar assim mesmo. |
127.0.0.1:8790 não abre |
Outro programa pode estar usando essa porta. O serviço continua funcionando sem a página. |
#Autenticação e chaves
| Sintoma | Solução |
|---|---|
| Acessível · Comm Key recusada | Digite a chave de comunicação (Comm Key) do dispositivo (Menu → Comm. → PC Connection). Sem chave significa 0. As chaves têm de 1 a 6 dígitos. No firmware ZKTeco Ver 6.60, o dispositivo pede login mesmo com a chave 0; o conector 0.1.5 e posteriores tratam isso, então atualize o conector se ainda ver o problema. |
| Acessível · dispositivo ocupado | Aguarde um minuto e teste novamente. |
| Hikvision: login recusado | Use um usuário de dispositivo separado, criado para o SolaHR (não admin), e verifique se o dispositivo está ativado. |
| Suprema: login recusado | Use um operador somente leitura do BioStar 2 e o endereço exato do servidor (com https://). |
| "Número de série diferente" | O dispositivo nesse endereço não é o que foi cadastrado. Verifique o IP. |
#Configuração necessária
Configuração necessária é um estado, não uma falha do terminal. O tipo de conexão precisa do software do fabricante no PC do conector, e ele ainda não está pronto. Siga Configuração do SDK do fabricante ou clique em Usar a conexão integrada. Para a maioria dos terminais ZKTeco, ZKTeco (direto) não precisa de software adicional.
#As marcações chegam, mas nenhuma presença aparece
| Causa | Solução |
|---|---|
| O código não está associado | Usuários do dispositivo → vincule o código. As marcações em espera são gravadas assim que você o vincula. Veja Associação e presença. |
| Faltam as configurações de folha da data | Adicione-as e depois use Reprocessar pendentes. |
| Antes da data de Importar histórico a partir de ou antes da data de início do funcionário | Edite a data do dispositivo ou corrija a data de início. |
| O dia já foi lançado pelo RH ou pelo portal | Uma marcação do dispositivo não o sobrescreve. Veja Marcações rejeitadas na aba Revisão. |
| O funcionário está suspenso sem remuneração | Nenhuma presença é criada. |
| Uma saída sem entrada | Adicionar o check‑in ausente na Frequência. |
#Horários errados
| Sintoma | Solução |
|---|---|
| Diferença de horas inteiras | Edite o dispositivo e defina o Fuso horário do relógio do dispositivo correto (por exemplo Asia/Amman, Asia/Dubai). |
| Diferença de minutos | Sincronizar horário agora (proprietário). Verifique também o relógio do próprio dispositivo e as configurações de horário de verão. |
| Um turno noturno aparece dividido | Verifique a opção de turno noturno da escala de trabalho em Escalas de trabalho. |
#Nomes e texto
| Sintoma | Solução |
|---|---|
Nomes em árabe aparecem como ??? ou símbolos estranhos |
No cadastro do dispositivo, defina a codificação de texto: primeiro UTF-8, depois Windows-1256 (árabe), depois GBK. Leia os usuários novamente. |
| Nomes cortados | Muitos terminais permitem apenas um nome curto (muitas vezes 24 caracteres ou menos). |
#As alterações não funcionam
| Sintoma | Solução |
|---|---|
| "As alterações neste dispositivo estão desativadas no PC do conector" | Ative Permitir alterações nos dispositivos na página do conector. |
| Editar, ativar, excluir ou enviar está esmaecido / "não compatível aqui" | O tipo de conexão ou o modelo não é compatível. A ZKTeco direta não consegue ativar/desativar usuários nem copiar rostos; o tipo SDK da ZKTeco consegue (testado em software). |
| Copiar, reiniciar ou sincronizar horário não aparece | Apenas proprietário. |
| "O dispositivo não tem espaço livre para isso" | O terminal está cheio de usuários, rostos ou digitais. Exclua os usuários não utilizados. |
| "O dispositivo recusou a alteração" | Verifique a chave de comunicação e se o dispositivo permite alterações remotas. |
#Dispositivos com envio
| Sintoma | Solução |
|---|---|
| "Último contato" está antigo ou vazio | Verifique a configuração de servidor do terminal (ZKTeco: Menu → Comm. → Cloud Server Setting): endereço, porta e se o terminal tem acesso à rede. |
| Marcações rejeitadas | O número de série do dispositivo deve coincidir com o cadastrado no SolaHR. Veja Quarentena. |
| HTTP simples recusado | Muitos dispositivos com envio falam apenas HTTP. Peça ao seu administrador que leia o painel Prontidão da instalação; ele verifica as regras do servidor web. |
#Perguntas frequentes
O SolaHR guarda digitais ou rostos? Não. Nunca. Ele só sabe se uma pessoa tem rosto ou digital em um dispositivo. Veja o que é armazenado.
Preciso abrir uma porta no roteador? Não. O conector só faz conexões de saída para o SolaHR. Apenas os dispositivos com envio precisam alcançar o SolaHR, e isso é possível.
Funciona sem internet? O conector continua funcionando dentro do escritório, mas não alcança o SolaHR; as marcações esperam e são enviadas depois.
Posso usar mais de um conector? Sim, um por unidade é o mais comum. Cada dispositivo é atribuído a um conector.
Meu terminal é compatível? Veja Dispositivos compatíveis. Até agora, apenas o ZKTeco iFace702 foi conectado de verdade; os outros modelos são esperados ou não testados. Teste um primeiro.
Posso misturar conector e importação de arquivo? Sim. As marcações repetidas são reconhecidas e não são contadas duas vezes.
Com que frequência as marcações são lidas? Como você escolher: a cada 1, 2, 5, 10, 15 ou 30 minutos. Veja Associação e presença.
É seguro executar o conector? Ele escuta apenas no próprio PC e mantém os segredos criptografados, mas é uma pré-visualização sem assinatura e seu serviço do Windows não foi testado em todas as configurações do Windows. Trate o PC como um servidor.
Onde consigo ajuda? Use solahr-dc diagnostics no PC do conector para gerar um pacote de suporte sem segredos e envie-o com o nome do dispositivo e o estado que você vê.