Smarter Deduction Claims: Urgency Prioritisation & Stale Drafts
Smarter Deduction Claims: Urgency Prioritisation & Stale Drafts
Available from: v0.1.359
The Deduction Claims Index now ranks every claim by business urgency so that the issues most likely to cost you a deduction — or trigger a dispute — always appear at the top of the list.
The Problem It Solves
Deposit deduction claims are time-sensitive. Miss the acknowledgement window, leave a draft sitting unfinished after a tenancy ends, or fail to correct an over-deduction, and the landlord either loses the right to claim or faces an automatic dispute. A list sorted only by "last updated" gave no signal about which claims needed action today.
How Urgency Scoring Works
Every claim now receives an urgencyScore when the claims list is fetched. The default sort order is urgency_desc — highest urgency first.
Priority Tiers
Priority 1 · Critical — Over-Deducting
Claims where the proposed deduction exceeds the permitted amount surface at the very top. These require immediate correction before the claim can proceed; leaving them unaddressed is the fastest path to a formal dispute.
Priority 2 · High — Draft for an Ended Tenancy
If a claim is still in draft status but the associated tenancy has already ended, the landlord is actively at risk. The clock has run out on the tenancy, and an unsubmitted draft provides no legal protection. These claims appear directly below over-deducting claims.
Priority 3 · Medium — Proposed, Unacknowledged Beyond 7 Days
Once a claim is proposed, the tenant has a 10-day window to acknowledge it. Claims that have been in proposed state for more than 7 days without acknowledgement are surfaced here — giving agents time to follow up before the window closes and the claim automatically escalates.
Everything Else
All remaining claims continue to sort by updatedAt descending within this final tier.
New Stat Card: Stale Drafts
Alongside the existing Total Claims, In Progress, Over-Deducting, and Disputed stat cards, a new Stale Drafts card now appears on the index.
Stale Drafts counts any draft claim that has not been updated in 7 or more days. It acts as a housekeeping signal — if the number is climbing, there is unfinished work that may soon become urgent.
┌─────────────┐ ┌─────────────┐ ┌────────────────┐ ┌───────────────┐ ┌──────────────┐
│ Total │ │ In Progress │ │ Over-Deducting │ │ Disputed │ │ Stale Drafts │ ← NEW
│ Claims │ │ │ │ │ │ │ │ (7+ days) │
└─────────────┘ └─────────────┘ └────────────────┘ └───────────────┘ └──────────────┘
What You Need to Do
Nothing. The urgency sort is now the default. When you open the Deduction Claims Index, claims are already ordered by urgency. You can still re-sort the list if needed, but the recommended workflow is to work top-to-bottom — the platform surfaces the highest-risk items first.
Tips for Working the Urgency Queue
- Start with Priority 1 (red). Correct the deduction amount before doing anything else.
- Check Priority 2 daily. Once a tenancy ends, the window for a valid claim is limited. Submit or abandon the draft.
- Act on Priority 3 before day 9. If a proposed claim hasn't been acknowledged by day 7, send a follow-up. You have one day of buffer before the 10-day window closes.
- Review Stale Drafts weekly. A growing stale count usually means claims were started and forgotten — triage them before they graduate to Priority 2.