The four period states
| Status | Meaning |
|---|---|
| OPEN | Active period. Eligible billable time flows into usage when the retainer recalculates. |
| OVER_LIMIT | Same as OPEN but used hours have exceeded the available allocation. Overage starts accruing. |
| CLOSED | Locked. Used for invoicing. No further usage flows in. Rollover to the next period is computed at close. |
| REOPENED | A previously closed period that's been unlocked. Draft invoices on it have been voided. Behaves like OPEN until closed again. |
Closing a period
- Open the contract's Billing & retainer → Retainer view.
- Verify the Used / Included / Overage tiles look right.
- Click Close period. This locks the period, computes rollover into the next period, and sets close timestamps.
- Click Draft invoices to generate Drafts for the recurring retainer fee (with discount if applicable) and billable overage when present.
- Review the draft invoices in the Invoices module before sending.
If an open period is already over its allocation, Draft overage invoice can prepare the overage Draft while the period remains open. The period still needs to be closed at its boundary to lock usage and calculate rollover.
Invoice boundary: Drafting never sends an invoice and never collects money. Send the reviewed Draft from Invoices and use Record payment when payment arrives.
Reopening a closed period
Reopening is the safety mechanism for backdating plan changes or fixing usage errors. It's deliberately conservative.
- Open Billing & retainer → Retainer, then open the history drawer.
- Select the closed period and click Reopen.
- Confirm the prompt — any draft invoices linked to the period will be voided.
Hard refusal: If any invoice on the period is past DRAFT — sent, partially paid, paid, overdue — reopen is refused with a list of the offending invoices. You'll need to void or cancel those invoices first. The system never silently reverses a real financial event.
What happens after reopen
- Status flips from CLOSED → REOPENED.
- Close timestamps are cleared; reopen timestamps and the actor are recorded.
- Voided invoice IDs are written to the audit trail.
- The system re-runs rollover and recalculation on the period and every open period after it. Subsequent periods may now see different rollover-in numbers — that's expected.
- Once you've made the fix, close the period again to lock it and regenerate invoices.
Adjustments: manual hour credits and debits
Adjustments are how you correct hour totals without touching time entries. Use them to:
- Credit a customer for non-billable goodwill ("we're giving you 4h back this month").
- Debit hours for an internal correction.
Each adjustment captures a reason, an actor, and a "client-visible" flag. Visible adjustments show in the customer portal; internal ones don't.
Recalculation
Use Recalculate on an open period to rescan time entries against the contract's scope, regenerate usage lines, refresh used / remaining / overage, and update the forecast. This is useful immediately after correcting an entry or its approval status.