Insoft Hikvision Service no Akita Soft

Gilberto Júnior

Insoft Hikvision Service com Akita Soft

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:

A pessoa é cadastrada no Akita Soft.
O cartão, a face, a digital ou a placa são cadastrados no Akita Soft.
O equipamento Hikvision é cadastrado no Akita Soft.
A pessoa recebe permissão para o setor de acesso do equipamento.
O usuário cria um comando ou o sistema cria uma pendência automática.
O Insoft Hikvision Service busca o comando.
O serviço consulta a API do Akita Soft.
O serviço envia os dados ao Hikvision.
O equipamento passa a liberar ou negar o acesso conforme as regras do Akita Soft e do dispositivo.
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

Comando	Explicação simples
`200`	Ajusta a data e hora do equipamento
`201`	Envia cadastro, cartões, face e digital da pessoa
`206`	Envia placas de veículos
`207`	Remove placas de veículos
`208`	Busca eventos antigos no equipamento
`210`	Copia a face do equipamento para o Akita Soft
`211`	Envia a face do Akita Soft para o equipamento
`212`	Remove a face do equipamento
`213`	Confere se a pessoa está no equipamento
`220`	Captura a face usando o equipamento
`221`	Captura a digital usando o equipamento
`1`, `3`	Copiam digitais do equipamento para o Akita Soft
`11`, `13`	Enviam digitais do Akita Soft para o equipamento
`21`, `23`	Removem digitais do equipamento

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?