Integração Shooting House (Situação Financeira)
A integração Shooting House conecta o ACCELERO ao sistema externo Shooting House para consultar a situação financeira da pessoa no momento do acesso. Com o plugin ativo, o ACCELERO consulta o sistema externo pelo CPF da pessoa e, com base na resposta, libera ou nega a passagem — útil em ambientes (como clubes de tiro) onde a entrada depende de o associado estar em dia financeiramente.
Esta integração é disponibilizada como plugin (shootinghouse) 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.17.0 ou superior.
O que a integração faz
A integração adiciona uma regra de verificação de acesso que consulta o Shooting House em tempo real, durante a passagem, e decide a liberação conforme a situação financeira retornada.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Consulta de situação financeira | Ao tentar o acesso, o ACCELERO consulta o Shooting House pelo CPF da pessoa e verifica o status financeiro retornado |
| Liberação por situação em dia | Se o sistema externo indica situação financeira regular, o acesso é autorizado pela regra |
| Bloqueio por pendência financeira | Se o status financeiro é negativo (ou o CPF não é reconhecido pelo sistema externo), o acesso é negado |
| Comportamento em caso de falha | Se a consulta à API falhar, o acesso é liberado ou negado conforme a opção configurada em Caso falhe a requisição |
| Registro de evento | Quando o acesso é negado pela regra, é gerado o evento de log "Acesso negado - Situação financeira" |
Condiciona a passagem física à situação financeira mantida em um sistema externo, sem que o operador precise consultar manualmente o cadastro financeiro a cada acesso.
Configuração
Caminho de acesso: Configurações > Integrações - Shooting House
A tela de configuração possui uma única aba: Geral.
Tela de configuração da integração Shooting House (Configurações > Integrações - Shooting House), aba Geral, mostrando os campos Endpoint, Usuário, Senha, Caso falhe a requisição e o interruptor Status.
| Campo | Descrição |
|---|---|
| Endpoint | URL base do serviço Shooting House usada para a consulta. O ACCELERO acrescenta o CPF da pessoa a esta URL no momento da consulta. Fornecida pela IONGRADE durante a implantação |
| Usuário | Usuário para autenticação no serviço Shooting House (autenticação Basic) |
| Senha | Senha correspondente ao usuário |
| Caso falhe a requisição | Define o comportamento quando a consulta à API falha: Acesso permitido ou Acesso negado |
| Status | Interruptor que ativa ou desativa a integração. Com o Status desligado, a regra de verificação sempre autoriza o acesso, sem consultar o sistema externo |
As credenciais (Endpoint, Usuário e Senha) são fornecidas pela IONGRADE durante a implantação. Todos os campos são obrigatórios.
Botões da tela
| Botão | Função |
|---|---|
| Voltar | Retorna sem salvar |
| Salvar | Persiste a configuração |
Regra de verificação de acesso
O plugin disponibiliza uma regra de verificação de acesso dedicada — "Shooting House - Consulta situação financeira" — que pode ser atribuída para condicionar a passagem à situação financeira da pessoa no sistema externo.
Caminho de acesso: atribua a regra de verificação de acesso Shooting House - Consulta situação financeira na configuração de acesso onde ela deve atuar.
Tela de seleção/atribuição da regra de verificação de acesso "Shooting House - Consulta situação financeira".
Como a regra decide
- Integração desativada — se o Status da configuração estiver desligado, a regra autoriza o acesso sem consultar o sistema externo.
- Consulta bem-sucedida e situação regular — se o Shooting House responde indicando situação financeira em dia, o acesso é autorizado.
- Consulta bem-sucedida e situação irregular — se o status financeiro retornado é negativo, ou o CPF não é reconhecido / a resposta é inválida, o acesso é negado e é registrado o evento "Acesso negado - Situação financeira".
- Falha na consulta — se a chamada à API falha (timeout ou erro de comunicação), a decisão segue a opção configurada em Caso falhe a requisição: Acesso permitido libera; qualquer outra configuração nega o acesso.
A consulta usa o documento (CPF) da pessoa cadastrado no ACCELERO. Pessoas sem CPF cadastrado, ou cujo CPF não exista no Shooting House, têm o acesso negado pela regra.
Como funciona a consulta
No momento do acesso, o ACCELERO faz uma requisição ao Endpoint configurado, informando o CPF da pessoa, e autentica com Usuário e Senha (autenticação Basic). A integração trabalha com um tempo limite curto de resposta; se o serviço externo demorar ou ficar indisponível, a chamada é tratada como falha e a decisão segue a opção Caso falhe a requisição.
A liberação depende do indicador de situação financeira retornado pelo Shooting House: situação regular libera; situação irregular bloqueia.
Fluxo da consulta: tentativa de acesso → consulta ao Shooting House por CPF → avaliação da situação financeira (regular/irregular/falha) → autorização ou negação do acesso.
Teste da integração
O plugin disponibiliza um endpoint para validar a comunicação com o Shooting House a partir de um CPF cadastrado no ACCELERO, retornando o nome da pessoa e o resultado da consulta (Aprovado ou Reprovado).
Documentar a forma de uso do endpoint de teste de integração (/external/shootinghouse/integration-teste/{cpf}) — autenticação necessária, formato da resposta e cenários de uso — após confirmação com a equipe técnica.
Casos de uso
Habilitar a verificação financeira no acesso
- Solicitar à IONGRADE a instalação do plugin
shootinghouse. - Receber o Endpoint, Usuário e Senha do serviço Shooting House.
- Em
Configurações > Integrações - Shooting House, preencher os campos e definir Caso falhe a requisição. - Ativar o interruptor Status.
- Atribuir a regra Shooting House - Consulta situação financeira onde o controle deve ser aplicado.
- Validar com um CPF conhecido em situação regular e outro em situação irregular.
Investigar um acesso negado por situação financeira
- Localizar o evento "Acesso negado - Situação financeira" em Logs e Monitoramento.
- Confirmar a situação da pessoa diretamente no sistema Shooting House.
- Se a negação foi indevida, verificar o CPF cadastrado da pessoa no ACCELERO e a configuração do Endpoint.
Boas práticas
- CPF cadastrado e correto: a consulta depende do CPF da pessoa; mantenha o documento preenchido e correto no cadastro.
- Defina conscientemente o "Caso falhe a requisição": escolher Acesso permitido privilegia a continuidade da operação durante indisponibilidades; Acesso negado privilegia o rigor do controle. Avalie o cenário do cliente.
- Desative pelo Status, não pela regra: para suspender temporariamente a verificação, desligue o Status na configuração — a regra deixa de consultar o sistema externo e passa a autorizar.
Troubleshooting
Todos os acessos estão sendo negados
Possíveis causas:
- Endpoint, usuário ou senha incorretos, fazendo a consulta falhar com Caso falhe a requisição = Acesso negado.
- CPFs das pessoas não cadastrados ou não reconhecidos pelo Shooting House.
Solução:
- Confira Endpoint, Usuário e Senha em
Configurações > Integrações - Shooting House. - Teste a comunicação com um CPF conhecido (ver Teste da integração).
- Confirme que os CPFs das pessoas existem no sistema Shooting House.
A verificação não está sendo aplicada
Possíveis causas:
- Interruptor Status desligado.
- Regra Shooting House - Consulta situação financeira não atribuída ao acesso desejado.
Solução:
- Ative o Status na configuração.
- Confirme que a regra de verificação está atribuída onde o controle deve atuar.
Acessos liberados mesmo com pendência financeira
Possíveis causas:
- Caso falhe a requisição definido como Acesso permitido somado a falhas de comunicação com o Shooting House.
Solução:
- Verifique a estabilidade da comunicação com o Endpoint.
- Reavalie a opção Caso falhe a requisição conforme a política de segurança do cliente.
Integração com outros módulos
Pessoas
A consulta usa o CPF do cadastro de Pessoas. Sem CPF válido, a regra nega o acesso.
Política de acesso
A verificação é aplicada como uma regra de verificação de acesso. Consulte Política de Acesso para entender como as regras de verificação participam da decisão de liberação.
Logs e Eventos
As negações pela regra geram o evento "Acesso negado - Situação financeira". Consulte Logs e Monitoramento para acompanhar e auditar essas ocorrências.
Próximos Passos
- Pessoas — Garanta o CPF cadastrado e correto das pessoas
- Política de Acesso — Entenda como as regras de verificação de acesso atuam
- Logs e Monitoramento — Acompanhe os eventos de acesso negado por situação financeira
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO