Insoft Hikvision Service no Ponto Soft

Gilberto Júnior

Insoft Hikvision Service com Ponto Soft

Objetivo

Esta documentação explica, de forma simples, como o Insoft Hikvision Service trabalha com o Ponto Soft e os equipamentos Hikvision.

No Ponto Soft, o foco principal é manter os funcionários nos equipamentos e receber as marcações feitas por eles.

Resumo do funcionamento

O fluxo normal é este:

O funcionário é cadastrado no Ponto Soft.
O equipamento Hikvision também é cadastrado no Ponto Soft.
O usuário solicita uma carga ou o próprio sistema cria uma pendência.
O Insoft Hikvision Service busca essa pendência no Ponto Soft.
O serviço consulta os dados do funcionário.
O serviço envia ao Hikvision o cadastro, cartão, face e digital, quando existirem.
O funcionário passa a poder registrar no equipamento, conforme as regras do Ponto Soft.
O equipamento envia a marcação de volta para o serviço.
O serviço envia a marcação para o Ponto Soft.

O que acontece no comando de carga

No Ponto Soft, o principal comando de envio de cadastro para Hikvision é o comando 108.

Quando o comando 108 é processado, o serviço tenta enviar:

o cadastro do funcionário;
o cartão;
a face, caso esteja cadastrada no Ponto Soft;
a digital, caso esteja cadastrada no Ponto Soft e o equipamento possua leitor de digital.

Se uma dessas informações não existir ou não estiver válida no Ponto Soft, ela não será enviada.

Exemplo:

Funcionário possui cadastro e cartão, mas não possui face.
Resultado: o serviço envia cadastro e cartão, mas não envia face.

Outro exemplo:

Funcionário possui face, mas ela foi cadastrada para outro tipo de equipamento.
Resultado: o serviço pode entender que não há face Hikvision válida para enviar.

Comandos mais comuns no Ponto Soft

Comando	Explicação simples
`100`	Ajusta a data e hora do equipamento
`103`	Busca marcações antigas no equipamento
`108`	Envia o cadastro do funcionário ao Hikvision
`110`	Copia digitais do equipamento para o Ponto Soft
`111`	Envia digitais do Ponto Soft para o equipamento
`112`	Remove digitais do equipamento
`113`	Confere se o funcionário está no equipamento
`130`	Copia a face do equipamento para o Ponto Soft
`131`	Envia a face do Ponto Soft para o equipamento
`132`	Remove a face do equipamento
`133`	Captura a face usando o equipamento
`134`	Captura a digital usando o equipamento

Quando o Ponto Soft retorna funcionários para o serviço

O serviço pergunta ao Ponto Soft:

Quais funcionários devem existir neste equipamento?

O Ponto Soft só responde com funcionários que passam por algumas conferências.

Para o funcionário aparecer na carga, normalmente ele precisa atender a estes pontos:

ter CPF cadastrado;
estar ligado a uma pessoa no sistema;
estar ligado ao setor de acesso do relógio;
ter cartão ou credencial no setor correto;
pertencer a uma empresa e filial reconhecidas pelo cadastro de empregador;
ter o empregador sincronizado corretamente, com data/hora de sincronização preenchida;
não ter erro registrado na observação de sincronização do empregador;
estar relacionado ao equipamento correto;
ter face e digital vigentes, quando essas informações forem necessárias.

Se qualquer uma dessas condições estiver incorreta, o funcionário pode existir no Ponto Soft, mas não aparecer para envio ao Hikvision.

Principais motivos para o funcionário não ser enviado

1. O CPF não está preenchido

A API do Ponto Soft só retorna funcionários com CPF.

Se o funcionário está cadastrado, mas está sem CPF, ele pode não ser enviado ao equipamento.

2. O funcionário não está no setor de acesso do relógio

O equipamento Hikvision fica ligado a um setor de acesso.

O funcionário também precisa estar autorizado nesse mesmo setor. Se ele estiver em outro setor, a API não devolve esse funcionário para aquele equipamento.

3. O empregador não está sincronizado corretamente

Esse é um ponto muito importante.

Para a API retornar o funcionário, o empregador precisa estar sincronizado sem erro. A conferência considera empresa e filial.

Se a empresa ou filial do funcionário não bater com o empregador sincronizado, ou se o empregador estiver com erro de sincronização, o funcionário pode não ser retornado.

Um caso comum é haver problema no CPF do responsável do empregador, ou alguma falha na sincronização do empregador. Nesses casos, o usuário vê o funcionário no Ponto Soft, mas o serviço não recebe esse cadastro para enviar ao Hikvision.

Na prática, confira estes pontos:

o empregador possui data/hora de sincronização preenchida;
a observação de sincronização do empregador está vazia, sem erro;
a empresa do funcionário é a mesma empresa do empregador;
se o funcionário tem filial, o empregador também precisa estar na mesma filial;
se o funcionário está sem filial, o empregador também precisa estar sem filial.

Quando um lado está com filial preenchida e o outro não, ou quando as filiais são diferentes, a API pode não devolver o funcionário para a carga.

4. O funcionário não tem relação correta entre funcionário e pessoa

Alguns comandos do Ponto Soft usam o código do funcionário, mas o serviço precisa trabalhar com o código da pessoa.

A API faz essa conversão automaticamente. Se a relação entre funcionário e pessoa estiver ausente ou incorreta, o serviço pode procurar o cadastro errado ou não encontrar cadastro nenhum.

5. O cartão não está no vínculo correto

O cartão precisa estar vinculado ao funcionário no setor de acesso correto.

Se o cartão existe no cadastro geral, mas não está ligado ao setor usado pelo relógio, ele pode não ir para o equipamento.

6. A biometria está vencida ou salva no tipo errado

Para equipamentos Hikvision, o Ponto Soft precisa ter biometria no tipo esperado para Hikvision.

Em termos práticos:

face precisa estar salva como face Hikvision;
digital precisa estar salva como digital Hikvision;
a biometria não pode estar vencida.

Se a digital foi coletada para outra tecnologia, por exemplo Intelbras, ela não será enviada como digital Hikvision.

7. O equipamento não está cadastrado como Hikvision

O serviço só trabalha com equipamentos do tipo Hikvision no Ponto Soft.

Se o equipamento estiver cadastrado com outro tipo, ele será ignorado pelo serviço.

8. O equipamento está inativo ou sem dados obrigatórios

O equipamento precisa estar ativo e precisa ter dados mínimos, como:

servidor ou estação vinculada;
setor de acesso;
endereço de rede;
porta;
usuário;
senha;
tipo de equipamento Hikvision.

Se esses dados estiverem ausentes, o serviço pode não conseguir trabalhar com o equipamento.

9. O equipamento está offline

Mesmo que o Ponto Soft retorne o funcionário corretamente, o envio não acontece se o equipamento estiver offline ou sem comunicação.

Nesse caso, o problema não é o cadastro do funcionário. O problema está na comunicação com o equipamento, com a rede ou com o Hik Device Gateway.

10. O equipamento recusou o cadastro

O equipamento pode recusar um cadastro por motivos próprios, como:

cartão em formato incompatível;
face com qualidade insuficiente;
digital inválida;
limite de cadastros atingido;
usuário e senha do equipamento sem permissão;
equipamento ocupado.

Cargas de funcionários

Além dos comandos comuns, o Ponto Soft possui uma rotina de carga de funcionários.

Essa rotina cria uma pendência para o serviço processar. O serviço busca essas pendências, envia ou remove o funcionário no equipamento e depois informa ao Ponto Soft se conseguiu concluir.

Em geral:

operação de inclusão tenta enviar o funcionário ao equipamento;
operação de exclusão tenta remover o funcionário do equipamento;
se houver erro, a observação da carga deve indicar a causa.

Marcações de ponto

Quando o funcionário registra o ponto no Hikvision, o equipamento envia a marcação para o serviço.

O serviço grava a marcação e envia ao Ponto Soft com informações como:

equipamento;
funcionário ou pessoa;
CPF;
empregador;
cartão;
data e hora;
identificador único da marcação;
informação de registro online ou offline.

O Ponto Soft evita duplicidade. Se a mesma marcação já foi enviada antes, ela pode ser reconhecida como já existente.

Por que uma marcação pode não aparecer no Ponto Soft

Uma marcação pode não aparecer por alguns motivos:

o equipamento não conseguiu enviar o evento para o serviço;
o serviço estava parado;
a API do Ponto Soft estava indisponível;
o CPF não foi encontrado;
o empregador não bateu com o cadastro;
o funcionário não foi encontrado no setor do relógio na data da marcação;
a marcação já existia;
houve erro de validação no Ponto Soft.

Automação de conferência

O serviço pode executar uma rotina automática em horário configurado.

Essa rotina compara:

o que o Ponto Soft diz que deve estar no equipamento;
o que realmente existe no Hikvision;
o histórico local do serviço.

Se ela encontrar diferença, cria comandos para corrigir.

Importante: a automação não corrige cadastro errado no Ponto Soft. Se a API não retorna o funcionário por causa de empresa, filial, setor, CPF ou empregador, a automação também não terá esse funcionário para enviar.

Uso com Hik Device Gateway

Alguns clientes usam o Hik Device Gateway.

Nesse caso, o serviço não fala diretamente com cada equipamento. Ele fala com o Gateway, e o Gateway fala com os equipamentos.

As regras de cadastro continuam sendo do Ponto Soft. O Gateway só muda o caminho da comunicação.

Mais detalhes em:

Uso com Hik Device Gateway

Checklist para RH e TI

Antes de acionar o Suporte, confira:

o funcionário tem CPF?
o funcionário tem código de pessoa vinculado?
o funcionário está no setor de acesso do relógio?
o relógio está cadastrado como Hikvision?
o relógio está ativo?
o relógio está ligado ao servidor correto?
o empregador está sincronizado sem erro?
empresa e filial do funcionário batem com o empregador?
o cartão está no vínculo correto?
a face e a digital estão vigentes e são do tipo Hikvision?
o equipamento está online?
o comando ficou com alguma mensagem de erro?