Purpose Statement
The Clear Overdue Events feature automatically removes overdue status indicators for Medication Counts and Custody Exchanges after a configurable number of days.
This feature helps agencies:
Reduce dashboard clutter from historical overdue events
Maintain a clean and actionable medication management interface
Align overdue notifications with agency compliance policies
Automatically cancel outdated overdue alerts and banners
Background Information
Within the Medications module, overdue events are generated when medication counts or custody exchanges are not completed on time. Over time, these alerts can accumulate and create unnecessary visual noise—especially for agencies managing multiple kits, stations, or shifts.
The Clear Overdue Events feature allows administrators to define how long overdue events remain visible before they are automatically cleared.
Key considerations:
Applies to both Medication Counts and Custody Exchanges
Configurable from 0–31 days
Performs a one-time retroactive cleanup when first enabled
Cancels associated overdue notifications
This feature is particularly useful for agencies balancing operational efficiency with DEA and internal compliance requirements.
Required Permissions
To configure this feature, users must have:
Medications Module – Admin or Configuration access
Permission to access Medications Setup
Permission to modify System Settings within Medications
Recommended Role: Administrator or designated Data Manager
Video
Step-by-Step Guide
1. Navigate to Medication Setup
Go to Medications.
Select Setup.
2. Open Settings
From the Medications Setup screen, select Settings.
3. Enable Clear Overdue Events
Locate the Enable Clear Overdue Events toggle.
Switch the toggle to ON.
Two configuration fields will appear:
Clear Overdue Counts
Clear Overdue Custody Exchanges
4. Configure Clear Overdue Counts
In the Clear Overdue Counts field, enter a value between 0–31 days.
1–31 days: Events clear automatically after the specified number of overdue days.
0 days: Overdue count banners are removed at midnight (agency local time).
Consider internal medication count policies before setting this value.
The system auto-saves when navigating away from the field.
5. Configure Clear Overdue Custody Exchanges
In the Clear Overdue Custody Exchanges field, enter a value between 0–31 days.
1–31 days: Custody exchanges clear automatically after the specified number of overdue days.
0 days: Overdue custody exchange banners are removed at midnight (agency local time).
Review DEA compliance and controlled substance tracking policies before configuring.
Select Save.
6. Review Retroactive Cleanup Confirmation
When enabling the feature for the first time:
The system performs an immediate one-time retroactive cleanup.
A confirmation message displays showing:
Number of overdue counts cleared
Number of overdue custody exchanges cleared
All cleared events:
Have overdue status removed from the database
Have related notifications canceled
7. Verify Configuration
Confirm the toggle remains ON.
Verify both day values are correct.
Navigate to Med Kits and confirm previously overdue events no longer display as overdue.
Monitor the system over time to confirm automatic clearing functions as expected.
Warning:
Turning OFF the Enable Clear Overdue Events toggle will revert overdue events back to their normal overdue status in the system.
Best Practices
Align day values with department SOPs and compliance requirements.
Avoid setting values too low if supervisory review of overdue events is required.
Coordinate with compliance officers before adjusting custody exchange settings.
Communicate configuration changes to shift supervisors and medication managers.
Periodically audit medication reporting to ensure clearing rules support policy.
Troubleshooting & FAQs
Why did historical overdue events disappear immediately after enabling?
The system performs a one-time retroactive cleanup when the feature is first activated.
Does clearing an overdue event delete the record?
No. The event record remains in the system. Only the overdue status and associated notifications are removed.
What happens if I set the value to 0?
Overdue banners are cleared at midnight in your agency’s local time zone.
Can I configure counts and custody exchanges differently?
Yes. Each field allows independent configuration (0–31 days).
What happens if the feature is turned off?
Previously cleared overdue events will revert to their overdue status.