Esta página leva você de «tenho um terminal na parede» a «o SolaHR o lê»: encontrar o dispositivo, escolhê-lo no catálogo de modelos, reunir o endereço IP, a porta e a chave de comunicação no menu do próprio dispositivo, testar a conexão e entender o status retornado. A referência clique a clique das telas está em Dispositivos de ponto; esta página acrescenta o conhecimento de que você precisa em volta.
Antes de começar, o conector deve estar instalado e mostrando Online, a menos que você pretenda usar envio ou importação de arquivo.
#A versão curta
- Tempo e presença → Dispositivos de ponto → Adicionar dispositivo.
- Dê um nome, escolha o local de presença e o fuso horário do relógio do dispositivo (por exemplo
Asia/Amman). - Escolha o tipo de conexão, o conector e informe o endereço IP do dispositivo, a porta e a chave de comunicação (vazio significa 0).
- Testar conexão. Uma boa resposta mostra modelo, firmware, usuários e registros do dispositivo e o relógio.
- Associe os usuários e depois Salvar e iniciar sincronização.
Você pode sair no meio: um dispositivo inacabado mostra Configuração incompleta com Retomar configuração.
#Descoberta: deixe o conector encontrar o dispositivo
No PC do conector, abra a página do conector (http://127.0.0.1:8790) e pressione Procurar dispositivos. Ela faz uma busca somente de leitura na rede local e não altera nada. No SolaHR os resultados aparecem em Encontrados pelo seu conector com endereço e porta; um clique preenche o endereço. Dispositivos que pedem chave de comunicação são marcados com «pede login (Comm Key, geralmente 0)».
A descoberta só vê dispositivos do mesmo segmento de rede do PC e só protocolos que o conector conhece. Se o seu terminal não for encontrado, ele pode estar em outra VLAN ou ser de um tipo não lido diretamente. Digite o endereço você mesmo.
#O catálogo de modelos
Em Seu dispositivo você pode pesquisar o catálogo por marca ou modelo. Nesta versão há 147 modelos da ZKTeco, Hikvision, Suprema, Anviz e EBKN. Ao escolher um, aparece:
| Exibido | Significado |
|---|---|
| Testado em um dispositivo real | Conectado de verdade, com o firmware indicado. Hoje só o ZKTeco iFace702. |
| Deve funcionar · mesma família de protocolo | Documentado como de mesmo protocolo que um modelo que funciona; não testado por nós. |
| Desconhecido: não testado | Está no catálogo, mas não há evidência para nenhum dos lados. |
| Configurações recomendadas | Um botão, Aplicar configurações recomendadas, preenche porta, transporte e codificação. |
| Onde achar as configurações neste dispositivo | O caminho no menu (resumido abaixo). |
| Problemas conhecidos e Próximos passos | Por exemplo, o firmware ZKTeco Ver 6.60 pede login mesmo com chave 0; o conector 0.1.5 e posteriores tratam isso. |
O modelo é opcional. Se o melhor tipo de conexão para o modelo for diferente do que você escolheu, o SolaHR oferece Mudar para .... A lista completa, com manual oficial e links de suporte, está em Dispositivos compatíveis. Um dispositivo fora do catálogo ainda pode funcionar se usar um dos mesmos protocolos; tente Testar conexão.
#Achar o endereço IP, a porta e a chave de comunicação no dispositivo
Cada fabricante redige os menus de forma um pouco diferente, e os menus mudam conforme modelo e firmware. Use estes caminhos como guia e confirme no manual do seu dispositivo (links em Dispositivos compatíveis).
#ZKTeco (direto, porta 4370)
Na maioria dos terminais ZKTeco, pressione Menu e:
| Você precisa | Onde no dispositivo |
|---|---|
| Endereço IP, máscara de sub-rede, gateway, DHCP | Menu → Comm. → Ethernet |
| Porta | TCP COMM. Port na mesma tela. O valor de fábrica é 4370; deixe-o se não o alterou. |
| Chave de comunicação | Menu → Comm. → PC Connection → Comm Key. Um número de 1 a 6 dígitos; 0 significa sem chave (valor de fábrica). |
| ID do dispositivo / número da máquina | Mesma tela PC Connection. Deixe o Número da máquina do SolaHR em 1, a menos que o dispositivo use outro. |
| Servidor ADMS (para envio, no lugar do conector) | Menu → Comm. → Cloud Server Setting: o endereço do servidor (ou um nome de domínio, se a opção de domínio estiver ativa) e a porta do servidor. |
Um terminal ZKTeco novo de fábrica é documentado como iniciando no IP 192.168.1.201 com máscara 255.255.255.0; portanto PC e terminal devem estar no mesmo segmento, ou você altera antes o endereço do dispositivo. Os nomes de menu acima vêm dos manuais atuais da ZKTeco (por exemplo o manual do usuário do SpeedFace-V3L); terminais mais antigos, como a série iClock, têm menus parecidos. Transporte: deixe Auto (TCP primeiro, UDP só se o TCP falhar). Nomes árabes aparecem ilegíveis: mantenha UTF-8, depois tente Windows-1256 (cp1256) e então GBK.
#Hikvision (ISAPI, porta web 80)
Os terminais Hikvision são configurados principalmente pela página web integrada.
| Você precisa | Onde |
|---|---|
| Encontrar o dispositivo na rede | A ferramenta SADP da Hikvision (em HiTools) lista os dispositivos Hikvision da rede local, ativa os novos e pode alterar o IP. A Hikvision informa que o SADP deixa de receber atualizações a partir de abril de 2026 e indica o novo HiTools Delivery. |
| Endereço IP | Página web do dispositivo → Configuration → Network → Basic Settings → TCP/IP |
| Um login para o SolaHR | Página web → Configuration → System → User Management. Crie um usuário separado para o SolaHR; não use admin. |
| Porta | 80 (HTTP), a menos que alterada nas configurações de rede do dispositivo |
Um dispositivo Hikvision novo precisa ser ativado (você define a senha de administrador) antes de ser usado. A Hikvision documenta os endereços de fábrica em seus manuais; confirme o seu lá em vez de adivinhar.
#Suprema (por um servidor BioStar 2)
O SolaHR não fala diretamente com terminais Suprema. Ele lê eventos do seu servidor BioStar 2.
| Você precisa | Onde |
|---|---|
| Endereço do servidor | O endereço da página web do BioStar 2, normalmente https://<server>:443 |
| Um login | No BioStar 2, crie um operador somente de leitura; não use o administrador principal |
| Tipos de evento | O BioStar 2 rotula cada evento com um código; se importar demais, defina os códigos de evento permitidos nas configurações do dispositivo no SolaHR |
Endereços IP dos terminais e configurações do servidor são definidos no próprio BioStar 2; veja o BioStar 2 Administrator Guide.
#Anviz (direto, TCP 5010, ou CrossChex Cloud)
| Você precisa | Onde |
|---|---|
| Endereço IP e porta | Menu do dispositivo → Communication / Network (em alguns modelos: a página web do dispositivo). A porta padrão é 5010. |
| Modo TCP | Defina como Server, para que o PC do conector possa conectar-se ao dispositivo. (O modo Client faz o dispositivo conectar-se a um PC, para dispositivos em outra rede.) |
| ID do dispositivo | No mesmo menu de comunicação, se você usar um |
| Porta e ID devem coincidir | A porta no SolaHR deve ser igual à configurada no dispositivo |
Para o CrossChex Cloud, é preciso uma conta de nuvem Anviz com acesso de desenvolvedor (chave de API e segredo); não há nada a configurar no PC do conector. O SolaHR também pergunta como ler o checktime da nuvem (UTC ou local), pois a Anviz não informa com clareza: escolha conforme o que você vê no CrossChex Cloud.
#EBKN / Secureeye (somente envio)
Não há conexão direta. Nas configurações de servidor/nuvem do dispositivo, informe o endereço de envio mostrado na página do dispositivo no SolaHR.
#Qualquer outro terminal
Use a importação de arquivo (exportação do dispositivo) ou, se o terminal ou seu software puder enviar marcações a um endereço web, o caminho de envio genérico (o SolaHR mostra um endereço e um token de uso único).
#Testar conexão
Pressione Testar conexão. O SolaHR pede ao conector que contate o dispositivo; costuma levar alguns segundos. Uma boa resposta mostra Modelo, Firmware, Usuários no dispositivo, Registros no dispositivo e o Relógio do dispositivo. Se o relógio estiver errado em mais de dois minutos, você recebe um aviso, pois os horários das marcações seguem o relógio do dispositivo. Você pode Pular por enquanto.
#O que significa o status
| Você vê | O que significa | O que fazer |
|---|---|---|
| Acessível (verde), com modelo e contagens | O dispositivo respondeu e a chave foi aceita. | Continue para a associação. |
| Acessível · Comm Key recusada | O dispositivo está lá, mas a chave está errada. | Informe a chave de comunicação de Menu → Comm. → PC Connection. Um dispositivo sem chave tem a chave 0. |
| Acessível · dispositivo ocupado | O dispositivo está ocupado (muitas vezes alguém está cadastrando ou o dispositivo está sincronizando). | Aguarde um minuto e teste novamente. |
| Dispositivo inacessível / "não respondeu a tempo" | Nada respondeu nesse endereço e porta. | Energia, cabo, endereço, porta, mesma rede, firewall. Veja Solução de problemas. |
| "O conector não recebeu a solicitação" | O PC do conector está desligado, em repouso ou offline. | Ligue-o. As marcações em espera são enviadas depois. |
| Configuração necessária | Este tipo de conexão precisa do software do fabricante no PC e ele não está pronto. É um status, não uma falha do terminal. | Siga Configurar o SDK do fabricante ou mude para a conexão direta integrada. |
| "Número de série diferente" | O dispositivo nesse endereço não é o registrado. | Confira o endereço IP; dois dispositivos podem ter trocado de endereço. |
| "O conector foi revogado" / "precisa ser emparelhado novamente" | O conector perdeu o emparelhamento. | Emparelhe de novo na aba Conectores. |
| Configuração incompleta | Você saiu dos passos guiados antes do fim. | Retomar configuração. |
| Offline / «O conector ... está offline» (no cartão) | O PC do conector está desligado ou sem rede. | Ligue-o; as marcações em espera são enviadas depois. |
| «O dispositivo envia ao SolaHR - último contato ...» (dispositivos de envio) | Quando o SolaHR teve notícias do dispositivo pela última vez. | Se for antigo, confira a configuração de servidor e a rede do dispositivo. |
#Dispositivos com envio (ADMS e similares)
Em vez de um conector, um terminal pode enviar as marcações ao SolaHR. Primeiro você cadastra o dispositivo no SolaHR (o SolaHR precisa do número de série dele) e depois informa o endereço do SolaHR na configuração de nuvem/ADMS do terminal (Menu → Comm. → Cloud Server Setting na ZKTeco). O envio é simples, mas confia no número de série do dispositivo; por isso, mantenha a rede permitida o mais restrita possível e revise as marcações. Muitos terminais ADMS falam apenas HTTP simples; seu administrador pode precisar permitir isso no servidor web, o que o painel Prontidão da instalação da página de dispositivos verifica.