Integração Liberado App (Antecedentes)
A integração Liberado App conecta o ACCELERO ao serviço Liberado App, plataforma de verificação que consulta antecedentes criminais e processos judiciais de uma pessoa a partir do CPF. Com o plugin ativo, a consulta é feita diretamente no cadastro de pessoas e no atendimento rápido de visitas, sem precisar acessar o portal externo do Liberado App.
Esta integração é disponibilizada como plugin (liberadoapp) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 1.0.0 — compatível com ACCELERO 2.16.9 ou superior.
O que a integração faz
Com o plugin ativo, o ACCELERO ganha um botão Consultar CPF nas telas de cadastro de pessoa e de atendimento rápido de visita. Ao clicar, o sistema consulta o serviço Liberado App e exibe o resultado em uma janela, com os processos e mandados encontrados para aquele CPF.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Consulta de antecedentes por CPF | Ao clicar em Consultar CPF, o ACCELERO envia o CPF ao Liberado App e recebe de volta os processos judiciais e mandados de prisão vinculados |
| Preenchimento do nome | Quando a consulta retorna o nome da pessoa, o campo Nome do cadastro é preenchido automaticamente com o dado recebido |
| Armazenamento no cadastro | O resultado da consulta é gravado nos metadados da pessoa, permitindo reuso posterior (cache) |
| Cache de consultas | Resultados podem ser reaproveitados por um número configurável de dias, evitando consultar o mesmo CPF repetidamente |
| Limite mensal de requisições | Um limite mensal de consultas pode ser definido para controlar o consumo do serviço |
| Registro em log | Cada consulta gera um registro no log de acesso da pessoa, indicando se o dado veio do serviço ou do cache |
Permite verificar antecedentes no momento do cadastro ou da entrada do visitante, sem sair do ACCELERO e sem acessar manualmente o portal do Liberado App.
Configuração
Caminho de acesso: Configurações > Plugins - Liberado App
A tela de configuração tem uma única aba (Geral) com os dados de conexão e os controles de consumo do serviço.
Tela de configuração Plugins - Liberado App (aba Geral), mostrando os campos API endpoint, API Key, Limite Mensal de Requisições e Dias para manter em cache.
| Campo | Descrição |
|---|---|
| API endpoint | URL do serviço Liberado App. Valor padrão: https://integration.liberadoapp.com |
| API Key | Chave de autenticação na API do Liberado App, obtida no painel administrativo do serviço |
| Limite Mensal de Requisições | Quantidade máxima de consultas permitidas por mês. Use 0 para ilimitado |
| Dias para manter em cache | Número de dias para manter os resultados em cache antes de permitir uma nova consulta do mesmo CPF. Use 0 para desativar o cache |
A API Key é fornecida pelo serviço Liberado App. Sem o endpoint e a chave configurados corretamente, as consultas falham.
Botões da tela
| Botão | Função |
|---|---|
| Salvar | Persiste a configuração |
| Voltar | Retorna à lista de configurações sem salvar |
Botão de consulta no cadastro
O plugin adiciona o botão Consultar CPF em duas telas, desde que o operador tenha a permissão adequada (ver Permissões):
- Cadastro de Pessoa (
Pessoas > Editar) — junto aos dados gerais da pessoa. - Atendimento rápido de visita (
eveEditQuick) — na área de dados do visitante.
Cadastro de pessoa com o botão Consultar CPF adicionado pelo plugin, próximo aos dados gerais.
Tela de atendimento rápido de visita com o botão Consultar CPF adicionado pelo plugin na área de dados do visitante.
Como usar
- Preencha o CPF no campo de documento da pessoa/visitante.
- Clique em Consultar CPF.
- O sistema valida o CPF (deve ter 11 dígitos) e consulta o Liberado App.
- O resultado é exibido na janela Verificação Liberado App.
A consulta exige um CPF válido com 11 dígitos. Se o campo de CPF estiver vazio ou inválido, o sistema exibe uma mensagem de erro e não realiza a consulta.
Janela de resultados
Após a consulta, abre-se a janela Verificação Liberado App com os achados organizados em blocos. Cada bloco indica a situação e, quando o serviço disponibiliza, um botão para Baixar PDF do documento correspondente.
Janela Verificação Liberado App exibindo blocos de Mandados de Prisão e Processos Judiciais, cada um com a situação e (quando disponível) o botão Baixar PDF.
| Bloco | Conteúdo |
|---|---|
| Mandados de Prisão | Mandados de prisão vinculados ao CPF consultado |
| Processos Judiciais | Processos judiciais vinculados ao CPF consultado |
Quando a consulta não retorna nenhum item, a janela exibe a mensagem "Nenhuma verificação disponível".
Se a resposta da consulta incluir o nome da pessoa, o campo Nome do cadastro é preenchido com esse valor.
Cache de consultas
Quando Dias para manter em cache é maior que zero, o ACCELERO reaproveita o último resultado armazenado para o CPF, em vez de fazer uma nova chamada ao serviço.
- A consulta usa o cache enquanto o número de dias desde a última pesquisa for menor que o valor configurado.
- Com 0 dias, o cache fica desativado: toda consulta vai ao serviço.
- Consultas atendidas pelo cache não descontam do limite mensal de requisições e ficam marcadas no log como originadas do cache.
Um cache maior reduz o consumo de requisições, mas pode mostrar um resultado mais antigo. Ajuste os dias conforme a criticidade da verificação no seu segmento.
Limite mensal de requisições
O campo Limite Mensal de Requisições controla quantas consultas podem ser feitas ao serviço em um mês.
- Com limite 0, as consultas são ilimitadas e o consumo não é contabilizado.
- Com limite maior que zero, cada consulta enviada ao serviço incrementa o contador do mês corrente.
- Ao atingir o limite, novas consultas são bloqueadas e o sistema informa "Limite mensal de requisições atingido".
- O contador é reiniciado no primeiro dia do mês seguinte.
Apenas as consultas que efetivamente vão ao serviço Liberado App consomem o limite. Resultados retornados do cache não são contabilizados.
Permissões
O plugin cria a permissão Realizar pesquisas LiberadoAPP (liberadoAppManage).
- O botão Consultar CPF só aparece para operadores cujo perfil tenha essa permissão.
- Configure a permissão no perfil de acesso dos operadores que devem poder consultar antecedentes.
Perfil de operador com a permissão Realizar pesquisas LiberadoAPP marcada.
Casos de uso
Verificar antecedentes ao cadastrar uma pessoa
- Em
Pessoas > Editar, preencha o CPF da pessoa. - Clique em Consultar CPF.
- Analise os mandados e processos exibidos na janela Verificação Liberado App.
- Quando disponível, use Baixar PDF para guardar o comprovante da consulta.
Verificar antecedentes na entrada de um visitante
- No atendimento rápido da visita, informe o CPF do visitante.
- Clique em Consultar CPF e avalie o resultado antes de liberar a entrada.
Controlar o consumo do serviço
- Em
Configurações > Plugins - Liberado App, defina o Limite Mensal de Requisições. - Ajuste Dias para manter em cache para reaproveitar consultas recentes do mesmo CPF.
Boas práticas
- Restrinja a permissão: conceda Realizar pesquisas LiberadoAPP apenas aos operadores que precisam consultar antecedentes — o dado é sensível.
- Use cache para CPFs recorrentes: em ambientes com muita reentrada, um cache de alguns dias reduz custos e acelera a verificação.
- Defina um limite mensal: evite estouros de consumo configurando o Limite Mensal de Requisições de acordo com o contrato com o serviço.
- Preencha o CPF antes de consultar: a consulta depende de um CPF válido de 11 dígitos no cadastro.
Troubleshooting
O botão "Consultar CPF" não aparece
Possíveis causas:
- O operador não tem a permissão Realizar pesquisas LiberadoAPP.
- O plugin não está habilitado.
Solução:
- Confirme que o perfil do operador possui a permissão
liberadoAppManage. - Verifique com a IONGRADE se o plugin está instalado e ativo.
A consulta retorna erro
Possíveis causas:
- API endpoint ou API Key incorretos.
- Serviço Liberado App indisponível ou sem conectividade a partir do servidor ACCELERO.
Solução:
- Revise os campos API endpoint e API Key em
Configurações > Plugins - Liberado App. - Teste a conectividade do servidor ACCELERO até o endpoint configurado.
- A mensagem de erro do serviço é exibida na própria tela de consulta — use-a como referência.
"Limite mensal de requisições atingido"
Causa: o número de consultas do mês alcançou o valor de Limite Mensal de Requisições.
Solução:
- Aguarde a virada do mês (o contador reinicia no primeiro dia do mês seguinte).
- Se necessário, aumente o limite ou defina 0 (ilimitado) na configuração.
Resultado parece desatualizado
Causa: a consulta foi atendida pelo cache, dentro do período de Dias para manter em cache.
Solução: reduza o número de dias de cache (ou use 0 para desativá-lo) para que novas consultas sempre vão ao serviço.
Integração com outros módulos
Pessoas
A consulta atua sobre o cadastro de Pessoas: usa o CPF informado, grava o resultado nos metadados da pessoa e pode preencher o campo Nome automaticamente. Se o CPF consultado ainda não existir como pessoa, o cadastro é criado com os dados retornados pela consulta.
Eventos (Visitas)
O botão de consulta também é adicionado ao atendimento rápido de Eventos, permitindo verificar antecedentes do visitante antes da liberação.
Logs e Monitoramento
Cada consulta gera um registro no log de acesso da pessoa, identificando a ação de pesquisa e se o dado veio do serviço ou do cache.
Próximos Passos
- Pessoas — Entenda o cadastro sobre o qual a consulta atua
- Eventos — Veja onde o botão de consulta aparece no atendimento de visitas
- Logs e Monitoramento — Acompanhe o registro das consultas realizadas
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO