Objetivo

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

No Akita Soft, o foco principal é controle de acesso. O serviço envia pessoas, cartões, biometrias, placas e permissões para os equipamentos. Também recebe eventos de acesso e pode pedir ao Akita Soft uma validação antes de liberar a entrada ou saída.

Resumo do funcionamento

O fluxo normal é este:

1. A pessoa é cadastrada no Akita Soft.
2. O cartão, a face, a digital ou a placa são cadastrados no Akita Soft.
3. O equipamento Hikvision é cadastrado no Akita Soft.
4. A pessoa recebe permissão para o setor de acesso do equipamento.
5. O usuário cria um comando ou o sistema cria uma pendência automática.
6. O Insoft Hikvision Service busca o comando.
7. O serviço consulta a API do Akita Soft.
8. O serviço envia os dados ao Hikvision.
9. O equipamento passa a liberar ou negar o acesso conforme as regras do Akita Soft e do dispositivo.
10. Os eventos de acesso voltam para o Akita Soft.

O que acontece no comando 201

No Akita Soft, o principal comando de envio de cadastro para Hikvision é o comando 201.

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

• cadastro da pessoa;
• cartão ou cartões de acesso;
• face, se existir no Akita Soft;
• digital, se existir no Akita Soft e o equipamento tiver leitor de digital;
• validade do acesso;
• permissões básicas necessárias para o equipamento.

O serviço consulta primeiro a API do Akita Soft. Se a API não retornar a pessoa, o serviço não tem o que enviar ao equipamento.

Comandos mais comuns no Akita Soft

Quando o Akita Soft retorna pessoas para o serviço

O serviço pergunta ao Akita Soft:

Quais pessoas devem existir neste equipamento?

O Akita Soft só retorna pessoas que passam pelas regras de acesso daquele equipamento.

Para a pessoa aparecer na carga, normalmente ela precisa atender a estes pontos:

• existir no cadastro de pessoas;
• estar vinculada ao setor de acesso do equipamento;
• possuir cartão válido;
• possuir faixa ou grupo de acesso válido;
• estar dentro das regras de validade;
• não depender de um cartão vencido;
• ter face e digital vigentes, quando essas informações forem necessárias;
• estar relacionada ao equipamento correto.

Isso significa que uma pessoa apenas existir no Akita Soft não é suficiente.

Ela precisa estar autorizada para aquele equipamento específico. Se o comando 201 for enviado para uma pessoa que existe no sistema, mas não tem permissão no setor daquele Hikvision, a API pode não devolver nenhum cadastro para o serviço enviar.

Principais motivos para a pessoa não ser enviada

1. A pessoa não está no setor de acesso do equipamento

Cada equipamento Hikvision fica ligado a um setor de acesso.

Se a pessoa não tiver permissão nesse setor, a API não devolve essa pessoa para aquele equipamento.

Esse é um dos motivos mais comuns para o usuário dizer:

A pessoa existe no Akita Soft, mas não vai para o Hikvision.

Ela pode existir no sistema, mas não estar autorizada no setor daquele equipamento.

Nessa situação, reenviar o comando 201 várias vezes não resolve. Primeiro é necessário ajustar a permissão da pessoa no setor correto.

2. A pessoa não possui cartão válido

A consulta de pessoas do Akita Soft exige que exista cartão válido para a pessoa.

Se a pessoa não tem cartão, ou se o cartão está vencido, sem validade atual ou com vínculo incorreto, ela pode não aparecer para envio.

3. O cartão físico não atende à configuração do sistema

Em alguns ambientes, o Akita Soft trabalha com conversão de cartão físico.

Quando essa opção está ativa, a API só retorna cartões que atendem à tecnologia esperada. Se o cartão não estiver cadastrado corretamente nessa regra, a pessoa pode não ser retornada.

4. A pessoa está afastada ou com validade diferente da esperada

O serviço usa as datas retornadas pelo Akita Soft para montar a validade no Hikvision.

Se a pessoa possui afastamento, validade futura ou regra de fim de vigência, ela pode até ser enviada, mas não necessariamente liberará acesso naquele momento.

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

Para equipamentos Hikvision, a biometria precisa estar vigente e no tipo correto.

Em termos práticos:

• face precisa estar salva como face Hikvision;
• digital precisa estar salva como digital Hikvision;
• a biometria não pode ter sido encerrada.

Se a face ou digital existir para outra tecnologia, o serviço pode enviar a pessoa sem essa biometria.

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

O serviço só busca equipamentos configurados como tipo HV, que representa Hikvision.

Se o equipamento estiver em outro tipo de modelo, ele não entra na lista do serviço.

7. O equipamento não está ligado ao servidor correto

O equipamento precisa estar vinculado ao servidor Hikvision correto no Akita Soft.

Se o servidor do serviço não for o mesmo servidor configurado no cadastro do equipamento, o serviço pode não enxergar esse equipamento.

8. O modo de operação do equipamento está ausente ou incorreto

O serviço espera que o equipamento Hikvision tenha um modo de operação.

Os modos usados são:

• leitor;
• controladora de acesso;
• leitura de placas.

Se esse modo não estiver preenchido corretamente, o equipamento pode ser ignorado.

9. O equipamento está offline

Mesmo que o Akita Soft retorne a pessoa corretamente, o envio não acontece se o equipamento estiver offline.

Nesse caso, o problema não está no cadastro da pessoa. O problema está na comunicação com o dispositivo, rede ou Hik Device Gateway.

10. O equipamento recusou o cadastro

O equipamento pode recusar informações por motivos próprios, como:

• cartão em formato incompatível;
• cartão já usado por outra pessoa no equipamento;
• face com qualidade insuficiente;
• digital inválida;
• limite de cadastros atingido;
• usuário do equipamento sem permissão;
• equipamento ocupado.

Validação remota de acesso

Alguns equipamentos trabalham com validação remota.

Nesse modo, o equipamento não decide sozinho se libera ou nega o acesso. Ele pergunta ao serviço, e o serviço pergunta ao Akita Soft.

O Akita Soft então aplica suas regras internas, como:

• pessoa autorizada ou não;
• cartão válido;
• setor correto;
• sentido de acesso;
• horário permitido;
• bloqueios;
• anti-dupla;
• regras de área;
• tipo de pessoa ou credencial.

Depois, o serviço responde ao equipamento:

liberar

ou

negar

Se a API do Akita Soft estiver indisponível ou demorar demais, a validação pode falhar.

Eventos de acesso

Quando alguém passa no equipamento, o Hikvision envia o evento ao serviço.

O serviço identifica o equipamento e envia o acesso ao Akita Soft.

O evento pode ser:

• acesso de pessoa;
• acesso de veículo;
• acesso liberado;
• acesso negado;
• evento online;
• evento recuperado depois, quando o equipamento ficou sem comunicação.

Controle de veículos e placas

Quando o equipamento é usado para leitura de placas, o serviço consulta os veículos no Akita Soft.

Para a placa ser enviada, normalmente é necessário:

• veículo ativo;
• placa cadastrada;
• tag cadastrada, quando usada;
• vínculo vigente entre veículo e pessoa, quando o setor exige restrição;
• equipamento cadastrado como leitura de placas.

Se o setor do equipamento for restrito, o Akita Soft pode retornar apenas veículos ligados a pessoas com permissão naquele setor.

Automação de conferência

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

Essa rotina compara:

• o que o Akita 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.

Exemplo:

Pessoa existe no Akita Soft e não existe no Hikvision.
Resultado: a automação pode criar um comando 201 para enviar essa pessoa.

Importante: a automação não corrige cadastro errado no Akita Soft. Se a pessoa não tem setor, cartão válido ou permissão, a automação também não terá essa pessoa 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 Akita 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:

• a pessoa existe no Akita Soft?
• a pessoa está no setor de acesso do equipamento?
• a pessoa possui cartão válido?
• o cartão está dentro da validade?
• a pessoa possui faixa ou grupo de acesso?
• a face e a digital estão vigentes e são do tipo Hikvision?
• o equipamento está cadastrado como Hikvision?
• o equipamento está ligado ao servidor correto?
• o modo de operação do equipamento está preenchido?
• o equipamento está online?
• o comando ficou com alguma mensagem de erro?
• em caso de placa, o veículo está ativo e com tag correta?