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: Settings > Integrations - Shooting House
The configuration screen has a single tab: General.
The Shooting House integration configuration screen (Settings > Integrations - Shooting House), General tab, showing the Endpoint, User, Password, If the request fails fields, and the Status switch.
| 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 can be assigned to condition passage on the person's financial standing in the external system.
Navigation path: assign the access verification rule Shooting House - Financial standing query in the access configuration where it should act.
Selection/assignment screen of the "Shooting House - Financial standing query" access verification rule.
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.
Query flow: access attempt → query to Shooting House by CPF → evaluation of the financial standing (regular/irregular/failure) → authorization or denial of access.
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).
Document how to use the integration test endpoint (/external/shootinghouse/integration-teste/{cpf}) — required authentication, response format, and usage scenarios — after confirming with the technical team.
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
Settings > Integrations - Shooting House, fill in the fields and set If the request fails. - Turn on the Status switch.
- Assign the rule Shooting House - Financial standing query where the control should be applied.
- 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
Settings > 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 assigned to the desired access.
Solution:
- Turn on the Status in the configuration.
- Confirm that the verification rule is assigned where the control should act.
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