Solavel Documentos
Português

Adicionar um dispositivo

Última atualização

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

  1. Tempo e presença → Dispositivos de ponto → Adicionar dispositivo.
  2. Dê um nome, escolha o local de presença e o fuso horário do relógio do dispositivo (por exemplo Asia/Amman).
  3. 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).
  4. Testar conexão. Uma boa resposta mostra modelo, firmware, usuários e registros do dispositivo e o relógio.
  5. 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.

#Próximo