Receive Alerts for Accounting Integration Sync Failures
The accounting sync orchestrator tracks failure patterns and emits alert events when: three or more consecutive sync attempts for a single record fail, the total error count for an organization exceeds a configurable threshold in a 24-hour window, or the integration has not successfully synced any records in over 48 hours despite pending records. These events are written to the sync log repository and surfaced as in-app notifications to the organization administrator. Global administrators receive platform-level summaries if multiple organizations are simultaneously experiencing issues. Alerts include a direct link to the integration status screen for immediate action.
User Story
Acceptance Criteria
- Given a sync record fails three consecutive retry attempts, when the third failure is logged, then an in-app alert is sent to the organization administrator identifying the record type and error
- Given the total sync error count for an organization exceeds 10 in a 24-hour window, when the threshold is crossed, then an in-app alert is sent to both the organization administrator and global administrators
- Given approved records have been pending sync for over 48 hours with an enabled connector, when the staleness threshold is reached, then an in-app alert is sent to the organization administrator with a link to the status dashboard
- Given an alert is received, when the administrator clicks it, then they are taken directly to the integration status screen showing the affected records
- Given an alert was triggered and the administrator subsequently resolves all errors, when the failed records are successfully retried, then a follow-up resolution notification confirms the issue is cleared
- Given a global administrator, when multiple organizations simultaneously trigger sync failure alerts, then they receive a consolidated platform-level alert summarizing the affected organizations rather than individual alerts per organization
Business Value
Passive monitoring of the integration status dashboard is not a reliable failure detection mechanism for administrators who have many other responsibilities. Proactive alerts ensure that accounting sync failures are detected and addressed within hours rather than days, protecting the integrity of financial records and the timeliness of volunteer reimbursement payments at Blindeforbundet and HLF.
Components
- Accounting Sync Orchestrator service
- Sync Log Repository data
- Integration Status Screen ui