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: Avançado > Sistema > Integrações - Shooting House
A tela de configuração possui uma única aba: Geral.
| 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 condiciona a passagem à situação financeira da pessoa no sistema externo.
Caminho de acesso: Avançado > Sistema > Personalização - Regras de acesso customizáveis, campo Regras de acesso a habilitar.
A regra é habilitada para o sistema inteiro: uma vez marcada, participa da decisão de todos os acessos de pessoas. Para suspender a verificação sem desmarcar a regra, desligue o Status na configuração da integração.
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.
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).
Requisição: GET /external/shootinghouse/integration-teste/{cpf}, onde {cpf} é o CPF só com números, igual ao documento cadastrado na pessoa do ACCELERO.
curl -k https://<servidor-accelero>/external/shootinghouse/integration-teste/12345678909
O endpoint localiza a pessoa pelo CPF e faz a mesma consulta que a regra de acesso faz (Endpoint + CPF + ?searchBy=CPF, com Usuário e Senha). Diferente da regra, ele consulta o Shooting House mesmo com o Status desligado e não aplica a opção Caso falhe a requisição.
| Situação | Resposta |
|---|---|
| Consulta concluída | HTTP 200 com JSON: cpf, pessoa (nome no ACCELERO) e financeiro (Aprovado ou Reprovado) |
| CPF sem pessoa no ACCELERO | HTTP 400, "CPF não encontrado" |
| Falha na consulta (Endpoint vazio ou inacessível, timeout) | HTTP 500, "Error checking ShootingHouse online server - authorized by exception" |
{"cpf":"12345678909","pessoa":"João Batista Ferreira","financeiro":"Aprovado"}
Reprovado cobre os mesmos casos em que a regra nega o acesso: status financeiro negativo, CPF não reconhecido pelo Shooting House ou resposta em formato inválido.
Quando usar: logo após configurar a integração, para validar Endpoint e credenciais com o CPF de um associado conhecido; e para investigar uma negação "Acesso negado - Situação financeira", conferindo o que o Shooting House responde para aquele CPF naquele momento.
O endpoint não exige login nem token: qualquer um que alcance o servidor do ACCELERO consegue consultar o nome e a situação financeira de uma pessoa a partir do CPF. Restrinja o acesso a /external/shootinghouse/ no firewall ou no proxy reverso, liberando apenas a rede da 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
Avançado > Sistema > Integrações - Shooting House, preencher os campos e definir Caso falhe a requisição. - Ativar o interruptor Status.
- Em
Avançado > Sistema > Personalização - Regras de acesso customizáveis, marcar Shooting House - Consulta situação financeira em Regras de acesso a habilitar e salvar. - 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
Avançado > Sistema > 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 marcada em
Avançado > Sistema > Personalização - Regras de acesso customizáveis.
Solução:
- Ative o Status na configuração.
- Confirme que a regra está marcada em Regras de acesso a habilitar, na tela
Avançado > Sistema > Personalização - Regras de acesso customizáveis.
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