Objetivo

Este guia ajuda a entender por que uma pessoa ou funcionário pode não ser enviado ao equipamento Hikvision, mesmo parecendo estar cadastrado no Akita Soft ou no Ponto Soft.

Essa situação costuma gerar relatos como:

O funcionário já está cadastrado, tem cartão, face e digital, mas a carga não envia para o Hikvision.

Em muitos casos, o problema não está no serviço nem no equipamento. O problema está em algum cadastro ou vínculo que impede a API de retornar essa pessoa para aquele equipamento.

Primeiro entendimento importante

O serviço só envia ao equipamento os cadastros que a API retorna.

Portanto, existem dois cenários bem diferentes.

Cenário 1: a API não retornou a pessoa

Nesse caso, o serviço não tem cadastro para enviar.

O problema normalmente está em:

• empresa;
• filial;
• empregador;
• setor de acesso;
• cartão;
• vínculo de pessoa;
• vínculo de funcionário;
• validade;
• biometria vencida;
• equipamento cadastrado no servidor errado.

Cenário 2: a API retornou a pessoa, mas o equipamento recusou

Nesse caso, o cadastro chegou até o serviço, mas não foi aceito pelo Hikvision.

O problema normalmente está em:

• equipamento offline;
• usuário ou senha incorretos;
• cartão incompatível;
• face com baixa qualidade;
• digital inválida;
• equipamento cheio;
• equipamento ocupado;
• erro de comunicação;
• Hik Device Gateway sem comunicação.

Como diferenciar os dois cenários

Quando o comando termina, a mensagem de retorno pode indicar quantos cadastros estavam disponíveis para envio.

Se aparecer algo como:

Disponíveis para envio: 0

isso indica que a API não retornou a pessoa para aquele equipamento.

Se aparecer que havia cadastros disponíveis, mas houve erro em cartão, face, digital ou pessoa, então a pessoa chegou ao serviço, mas houve falha ao enviar ao equipamento.

Checklist rápido para Ponto Soft

Quando o problema ocorre no Ponto Soft, 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 cartão está vinculado ao setor correto?
• o relógio está cadastrado como Hikvision?
• o relógio está ativo?
• o relógio possui setor de acesso?
• o relógio está ligado ao servidor correto?
• o empregador está sincronizado?
• a sincronização do empregador terminou sem erro?
• empresa e filial do funcionário batem com o empregador?
• a face está salva como face Hikvision?
• a digital está salva como digital Hikvision?
• a biometria está vigente?
• o equipamento está online?

Caso muito comum no Ponto Soft

O funcionário existe no Ponto Soft, mas a API não retorna porque o empregador não está sincronizado corretamente.

Isso pode acontecer por:

• empresa incorreta;
• filial incorreta;
• empregador sem sincronização concluída;
• empregador sem data/hora de sincronização preenchida;
• erro registrado na sincronização do empregador;
• problema no CPF do responsável do empregador;
• relação incorreta entre funcionário e pessoa.

Também confira a combinação entre empresa e filial:

• funcionário com filial precisa bater com empregador da mesma filial;
• funcionário sem filial precisa bater com empregador também sem filial;
• filial diferente ou preenchida apenas em um dos lados pode fazer a API não retornar o funcionário.

Nessa situação, reenviar o comando várias vezes não resolve. É preciso corrigir o cadastro que impede a API de retornar o funcionário.

Checklist rápido para Akita Soft

Quando o problema ocorre no Akita Soft, confira:

• a pessoa existe no cadastro de pessoas?
• a pessoa está vinculada ao setor de acesso do equipamento?
• a pessoa possui cartão válido?
• o cartão está dentro da validade?
• existe faixa ou grupo de acesso para essa pessoa?
• a pessoa está bloqueada ou afastada?
• a face está salva como face Hikvision?
• a digital está salva como digital Hikvision?
• a biometria está vigente?
• o equipamento está cadastrado como Hikvision?
• o equipamento está ligado ao servidor correto?
• o modo de operação do equipamento está configurado?
• o equipamento está online?
• em caso de veículo, a placa está ativa e a tag está cadastrada?

Caso muito comum no Akita Soft

A pessoa existe no Akita Soft, mas não está no setor de acesso do equipamento.

Nesse caso, ela pode aparecer normalmente no cadastro de pessoas, mas não será considerada uma pessoa que deve estar naquele Hikvision.

Outro caso comum é a pessoa não possuir cartão válido. A API depende do cartão para montar o cadastro que será enviado ao equipamento.

Face não foi enviada

Se a pessoa foi enviada, mas a face não foi:

• a pessoa pode não ter face cadastrada;
• a face pode estar vencida;
• a face pode ter sido cadastrada para outra tecnologia;
• o equipamento pode não permitir cadastro facial;
• a imagem pode ter sido recusada pelo Hikvision;
• a imagem pode estar com baixa qualidade.

Equipamentos Hikvision podem recusar faces quando a imagem está ruim, escura, desfocada, pequena, distante ou fora do enquadramento.

Digital não foi enviada

Se a pessoa foi enviada, mas a digital não foi:

• a pessoa pode não ter digital cadastrada;
• a digital pode estar vencida;
• a digital pode ter sido cadastrada para outra tecnologia;
• o equipamento pode não ter leitor de digital;
• o equipamento pode já ter atingido o limite de digitais daquela pessoa;
• o equipamento pode ter recusado o template da digital.

Cartão não foi enviado

Se a pessoa foi enviada, mas o cartão não funcionou:

• o cartão pode estar vencido;
• o cartão pode estar bloqueado;
• o cartão pode estar vinculado a outro setor;
• o cartão pode estar em formato diferente do esperado pelo Hikvision;
• o mesmo cartão pode estar associado a outra pessoa no equipamento;
• a configuração de quantidade de dígitos do cartão pode estar diferente.

Equipamento não aparece para o serviço

Se o equipamento não aparece no serviço, confira:

No Ponto Soft

• o equipamento está ativo?
• está cadastrado como Hikvision?
• possui setor de acesso?
• possui estação ou servidor vinculado?
• possui endereço, porta, usuário e senha?

No Akita Soft

• o equipamento está cadastrado como tipo Hikvision?
• está vinculado ao servidor Hikvision correto?
• possui modo de operação?
• possui endereço, porta, usuário e senha?
• está no setor de acesso correto?

Eventos não aparecem no sistema

Quando a pessoa registra no equipamento, o equipamento precisa enviar o evento ao serviço.

Se o evento não aparece no Akita Soft ou Ponto Soft, confira:

• o serviço está em execução?
• o equipamento está online?
• o equipamento consegue acessar o servidor do serviço?
• a porta de eventos está liberada?
• o servidor mudou de IP?
• a API do sistema principal está disponível?
• o evento ficou pendente de sincronização?
• o evento já tinha sido enviado antes?

O que enviar ao Suporte

Para agilizar o atendimento, envie:

• sistema usado: Akita Soft ou Ponto Soft;
• código do equipamento;
• nome ou código da pessoa;
• código do funcionário, se for Ponto Soft;
• código do comando;
• data e hora em que o comando foi solicitado;
• mensagem de retorno do comando;
• se o equipamento está online;
• se usa Hik Device Gateway;
• print dos cadastros principais, como setor, cartão, empregador, face ou digital.

Quanto mais completa for essa informação, mais rápido o Suporte consegue identificar se o problema está no cadastro, no serviço, no equipamento ou na comunicação.