Shooting House Integration (Financial Standing)
The Shooting House integration connects ACCELERO to the external Shooting House system to query the person's financial standing at the moment of access. With the plugin active, ACCELERO queries the external system by the person's CPF and, based on the response, grants or denies passage — useful in environments (such as shooting clubs) where entry depends on the member being financially up to date.
This integration is provided as a plugin (shootinghouse) and must be installed and enabled by the IONGRADE technical team. Contact support to check compatibility with your ACCELERO version.
Current plugin version: 1.0.0 — compatible with ACCELERO 2.17.0 or higher.
What the integration does
The integration adds an access verification rule that queries Shooting House in real time, during passage, and decides the release according to the returned financial standing.
| Feature | What happens in ACCELERO |
|---|---|
| Financial standing query | On an access attempt, ACCELERO queries Shooting House by the person's CPF and checks the returned financial status |
| Release for up-to-date standing | If the external system indicates a regular financial standing, access is authorized by the rule |
| Blocking for a financial pending item | If the financial status is negative (or the CPF is not recognized by the external system), access is denied |
| Behavior in case of failure | If the API query fails, access is granted or denied according to the option configured in If the request fails |
| Event recording | When access is denied by the rule, the log event "Access denied - Financial standing" is generated |
Conditions physical passage on the financial standing maintained in an external system, without the operator having to manually check the financial record on each access.
Configuration
Navigation path: Advanced > System > Integrations - Shooting House
The configuration screen has a single tab: General.
| Field | Description |
|---|---|
| Endpoint | Base URL of the Shooting House service used for the query. ACCELERO appends the person's CPF to this URL at query time. Provided by IONGRADE during deployment |
| User | User for authentication in the Shooting House service (Basic authentication) |
| Password | Password corresponding to the user |
| If the request fails | Defines the behavior when the API query fails: Access allowed or Access denied |
| Status | Switch that activates or deactivates the integration. With Status off, the verification rule always authorizes access, without querying the external system |
The credentials (Endpoint, User, and Password) are provided by IONGRADE during deployment. All fields are required.
Screen buttons
| Button | Function |
|---|---|
| Back | Returns without saving |
| Save | Persists the configuration |
Access verification rule
The plugin provides a dedicated access verification rule, "Shooting House - Financial standing query", that conditions passage on the person's financial standing in the external system.
Navigation path: Advanced > System > Customization - Customizable access rules, Access rules to enable field.
The rule is enabled for the whole system: once checked, it takes part in the decision of every person access. To suspend the verification without unchecking the rule, turn off the Status in the integration configuration.
How the rule decides
- Integration deactivated — if the configuration Status is off, the rule authorizes access without querying the external system.
- Successful query and regular standing — if Shooting House responds indicating an up-to-date financial standing, access is authorized.
- Successful query and irregular standing — if the returned financial status is negative, or the CPF is not recognized / the response is invalid, access is denied and the event "Access denied - Financial standing" is recorded.
- Query failure — if the API call fails (timeout or communication error), the decision follows the option configured in If the request fails: Access allowed grants; any other configuration denies access.
The query uses the person's document (CPF) registered in ACCELERO. People without a registered CPF, or whose CPF does not exist in Shooting House, have access denied by the rule.
How the query works
At the moment of access, ACCELERO makes a request to the configured Endpoint, providing the person's CPF, and authenticates with User and Password (Basic authentication). The integration works with a short response time limit; if the external service is slow or becomes unavailable, the call is treated as a failure and the decision follows the If the request fails option.
Release depends on the financial-standing indicator returned by Shooting House: a regular standing grants; an irregular standing blocks.
Integration test
The plugin provides an endpoint to validate communication with Shooting House from a CPF registered in ACCELERO, returning the person's name and the query result (Approved or Rejected).
Request: GET /external/shootinghouse/integration-teste/{cpf}, where {cpf} is the CPF digits only, the same as the document registered on the person in ACCELERO.
curl -k https://<accelero-server>/external/shootinghouse/integration-teste/12345678909
The endpoint finds the person by CPF and runs the same query the access rule runs (Endpoint + CPF + ?searchBy=CPF, with User and Password). Unlike the rule, it queries Shooting House even with Status turned off and does not apply the If the request fails option.
| Situation | Response |
|---|---|
| Query completed | HTTP 200 with JSON: cpf, pessoa (name in ACCELERO) and financeiro (Aprovado or Reprovado) |
| CPF with no person in ACCELERO | HTTP 400, "CPF não encontrado" |
| Query failure (empty or unreachable Endpoint, timeout) | HTTP 500, "Error checking ShootingHouse online server - authorized by exception" |
{"cpf":"12345678909","pessoa":"João Batista Ferreira","financeiro":"Aprovado"}
Reprovado (rejected) covers the same cases in which the rule denies access: negative financial status, CPF not recognized by Shooting House or a response in an invalid format.
When to use it: right after configuring the integration, to validate the Endpoint and credentials with the CPF of a known member; and to investigate an "Acesso negado - Situação financeira" denial, checking what Shooting House answers for that CPF at that moment.
The endpoint requires no login or token: anyone who can reach the ACCELERO server can query a person's name and financial status from a CPF. Restrict access to /external/shootinghouse/ in the firewall or reverse proxy, allowing only the technical team's network.
Use cases
Enable financial verification on access
- Request that IONGRADE install the
shootinghouseplugin. - Receive the Endpoint, User, and Password of the Shooting House service.
- In
Advanced > System > Integrations - Shooting House, fill in the fields and set If the request fails. - Turn on the Status switch.
- In
Advanced > System > Customization - Customizable access rules, check Shooting House - Financial standing query in Access rules to enable and save. - Validate with a known CPF in regular standing and another in irregular standing.
Investigate an access denied due to financial standing
- Locate the event "Access denied - Financial standing" in Logs and Monitoring.
- Confirm the person's standing directly in the Shooting House system.
- If the denial was improper, check the person's registered CPF in ACCELERO and the Endpoint configuration.
Best practices
- Registered and correct CPF: the query depends on the person's CPF; keep the document filled in and correct in the record.
- Consciously set "If the request fails": choosing Access allowed favors operational continuity during outages; Access denied favors the strictness of the control. Assess the customer's scenario.
- Deactivate via Status, not via the rule: to temporarily suspend the verification, turn off the Status in the configuration — the rule stops querying the external system and starts authorizing.
Troubleshooting
All accesses are being denied
Possible causes:
- Incorrect endpoint, user, or password, making the query fail with If the request fails = Access denied.
- People's CPFs not registered or not recognized by Shooting House.
Solution:
- Check the Endpoint, User, and Password in
Advanced > System > Integrations - Shooting House. - Test the communication with a known CPF (see Integration test).
- Confirm that the people's CPFs exist in the Shooting House system.
The verification is not being applied
Possible causes:
- The Status switch is off.
- The rule Shooting House - Financial standing query is not checked in
Advanced > System > Customization - Customizable access rules.
Solution:
- Turn on the Status in the configuration.
- Confirm that the rule is checked in Access rules to enable, on the
Advanced > System > Customization - Customizable access rulesscreen.
Accesses granted even with a financial pending item
Possible causes:
- If the request fails set to Access allowed combined with communication failures with Shooting House.
Solution:
- Check the stability of the communication with the Endpoint.
- Reassess the If the request fails option according to the customer's security policy.
Integration with other modules
People
The query uses the CPF from the People registry. Without a valid CPF, the rule denies access.
Access policy
The verification is applied as an access verification rule. See Access Policy to understand how verification rules participate in the release decision.
Logs and Events
Denials by the rule generate the event "Access denied - Financial standing". See Logs and Monitoring to track and audit these occurrences.
Next Steps
- People — Ensure the people's registered and correct CPF
- Access Policy — Understand how access verification rules act
- Logs and Monitoring — Track the events of access denied due to financial standing
- Plugins — Learn more about the ACCELERO plugin system