Leitura automática de documentos (OCR)
O módulo de OCR de documentos acelera o cadastro de visitantes no ACCELERO. Em vez de digitar manualmente os dados do documento, o operador aponta uma câmera para o documento da pessoa: o sistema lê a imagem, extrai automaticamente o nome e o número do documento e pré-preenche o cadastro do visitante.
É voltado para portarias e recepções com alto volume de visitantes, onde reduzir o tempo de atendimento e os erros de digitação faz diferença direta na fila de entrada.
Este recurso é disponibilizado como plugin e precisa ser instalado e habilitado pela equipe técnica da IONGRADE. Consulte o suporte para verificar a compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 0.0.4 — compatível com ACCELERO 2.16.9 ou superior.
O que o recurso faz
Com o módulo ativo, a tela de cadastro rápido de visitante ganha um botão para capturar o documento pela câmera.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Captura por câmera | O operador escolhe uma câmera, posiciona o documento e captura a imagem direto da tela de cadastro |
| Extração de dados | O módulo lê a imagem e retorna automaticamente o nome e o número do documento da pessoa |
| Pré-preenchimento | O número do documento extraído é lançado no campo de busca de documento do cadastro do visitante |
| Criação do cadastro | Se ainda não existir uma pessoa com aquele documento, o ACCELERO cria o registro automaticamente com nome e documento |
| Limite mensal de uso | Um limite configurável de consultas por mês controla o consumo do módulo |
Elimina a digitação manual do documento na recepção, reduzindo o tempo de atendimento e os erros de cadastro.
Pré-requisitos para o botão aparecer
O botão Capturar Documento (OCR) só aparece na tela de cadastro rápido de visitante quando todas as condições abaixo são atendidas:
- O operador tem a permissão de uso do OCR (ver Permissão).
- O limite mensal de requisições não foi atingido.
- Já foi informado um documento no cadastro, mas a pessoa ainda não existe no sistema (cadastro novo).
O recurso serve para agilizar o primeiro cadastro de um visitante. Se a pessoa já está cadastrada, o documento não pode ser capturado novamente — o sistema exibe um aviso e bloqueia a captura.
Como usar na recepção
Caminho de acesso: tela de cadastro rápido de visitante (em Eventos).
- Comece o cadastro do visitante e informe o documento da pessoa.
- Com o documento preenchido e a pessoa ainda não cadastrada, clique em Capturar Documento (OCR).
- Na janela de captura, selecione a câmera desejada.
- Clique em Iniciar Câmera.
- Posicione o documento dentro da área demarcada na tela, com boa iluminação.
- Clique em Capturar. A imagem é processada e, em caso de sucesso, o número do documento é preenchido automaticamente no cadastro.
Tela de cadastro rápido de visitante com o botão Capturar Documento (OCR) visível após informar o documento.
Janela (modal) Captura de Documento OCR, mostrando o card de instruções, o seletor de câmera, a área de vídeo com a moldura de posicionamento do documento e os botões Iniciar Câmera e Capturar.
Câmeras suportadas
A captura aceita as mesmas fontes de câmera usadas no restante do ACCELERO:
| Origem | Descrição |
|---|---|
| Webcam | Câmera local do dispositivo (notebook, USB) — prioriza a câmera traseira em alta resolução quando disponível |
| Câmera IP | Stream de uma câmera de rede |
| Gateway de vídeo | Stream entregue via gateway de vídeo do ACCELERO |
A câmera escolhida é lembrada no navegador e fica pré-selecionada na próxima captura, agilizando os atendimentos seguintes.
Configuração
Caminho de acesso: Configurações > Plugins - OCR
A tela de configuração possui uma única aba (Geral) com os parâmetros de conexão e de uso do módulo.
Tela de configuração do módulo de OCR, mostrando os campos API endpoint, Token de autenticação e Limite Mensal de Requisições.
| Campo | Descrição |
|---|---|
| API endpoint | Endereço do serviço de OCR — fornecido pela IONGRADE durante a implantação |
| Token de autenticação | Chave de autenticação do serviço de OCR — fornecida pela IONGRADE |
| Limite Mensal de Requisições | Quantidade máxima de capturas permitidas por mês. Use 0 para ilimitado |
O API endpoint e o Token de autenticação são dados sensíveis fornecidos pela IONGRADE na ativação do módulo. Não compartilhe essas credenciais.
Limite mensal de requisições
O limite controla quantas capturas podem ser processadas em um mês:
- Com limite 0, o uso é ilimitado.
- Com um limite maior que zero, cada captura bem-sucedida incrementa o contador do mês corrente.
- Ao atingir o limite, o botão de captura deixa de aparecer até a virada do mês.
- O contador é reiniciado automaticamente no primeiro dia do mês seguinte.
Quando o limite mensal é alcançado, novas capturas ficam indisponíveis e a recepção volta ao cadastro manual do documento até o próximo mês. Dimensione o limite conforme o volume esperado da recepção.
Permissão
A instalação do módulo cria uma permissão específica de uso do OCR, que deve ser atribuída aos perfis de operador que poderão usar a captura por câmera.
Operadores sem essa permissão não veem o botão de captura — para eles, o cadastro do visitante segue o fluxo manual normal.
Como funciona a captura
- O operador captura a imagem do documento pela câmera.
- A imagem é enviada ao serviço de OCR, que devolve o nome e o número do documento lidos.
- Se ainda não houver uma pessoa cadastrada com aquele documento, o ACCELERO cria o cadastro automaticamente com nome e documento.
- O número do documento é preenchido no cadastro do visitante, e o operador conclui as demais informações normalmente.
Se a imagem não puder ser processada (documento mal posicionado, iluminação ruim, falha de comunicação com o serviço), o sistema exibe uma mensagem de erro e mantém a janela aberta para uma nova tentativa. Nesses casos, reposicione o documento e capture novamente.
Casos de uso
Habilitar o OCR para uma recepção
- Solicitar à IONGRADE a instalação do módulo de OCR.
- Receber o API endpoint e o Token de autenticação.
- Em
Configurações > Plugins - OCR, preencher endpoint, token e o Limite Mensal de Requisições. - Atribuir a permissão de uso do OCR aos perfis dos operadores da recepção.
- Validar a captura com um documento de teste no cadastro rápido de visitante.
Cadastrar um visitante por OCR
- Iniciar o cadastro do visitante e informar o documento.
- Clicar em Capturar Documento (OCR).
- Selecionar a câmera, iniciar, posicionar o documento e clicar em Capturar.
- Conferir os dados pré-preenchidos e concluir o cadastro.
Boas práticas
- Iluminação e enquadramento: oriente os operadores a posicionar o documento dentro da área demarcada, com boa luz e sem reflexos, para aumentar a taxa de acerto da leitura.
- Permissão restrita: atribua a permissão de uso do OCR apenas aos operadores que realmente fazem cadastro de visitantes.
- Dimensionar o limite mensal: ajuste o Limite Mensal de Requisições ao volume real da recepção, evitando indisponibilidade no meio do mês.
- Conferir os dados lidos: o OCR agiliza o cadastro, mas o operador deve sempre conferir nome e documento antes de concluir.
Troubleshooting
O botão de captura não aparece
Possíveis causas:
- O operador não tem a permissão de uso do OCR.
- O Limite Mensal de Requisições já foi atingido.
- O documento ainda não foi informado no cadastro, ou a pessoa já existe no sistema.
Solução:
- Confirme se o perfil do operador tem a permissão de uso do OCR.
- Verifique se o limite mensal foi alcançado em
Configurações > Plugins - OCR. - Informe o documento e confirme que se trata de um cadastro novo (pessoa ainda não existente).
A captura retorna erro ao processar a imagem
Possíveis causas:
- Documento mal posicionado ou imagem de baixa qualidade.
- API endpoint ou Token de autenticação incorretos.
- Falha de comunicação com o serviço de OCR.
Solução:
- Reposicione o documento na área demarcada, com boa iluminação, e capture novamente.
- Confira o API endpoint e o Token de autenticação na tela de configuração.
- Se o erro persistir, contate o suporte IONGRADE.
As capturas pararam de funcionar no meio do mês
Possível causa:
- O Limite Mensal de Requisições foi atingido.
Solução:
- Verifique o limite configurado em
Configurações > Plugins - OCR. - Ajuste o limite (ou use 0 para ilimitado) conforme a necessidade da recepção. O contador é reiniciado no primeiro dia do mês seguinte.
Integração com outros módulos
Eventos (Visitantes)
O OCR atua diretamente no cadastro rápido de visitante do módulo de Eventos, preenchendo o documento e, quando necessário, criando o cadastro da pessoa.
Pessoas
Quando o documento lido ainda não existe, o módulo cria um registro em Pessoas com o nome e o documento extraídos do documento capturado.