Retainers with included hours, rollover and a cap
A monthly fee with included hours, unused hours that roll over up to a cap or expire, and extra hours at the rate of the day they were worked, billed exactly once per period.
The problem
Retainers exist in several time-tracking tools, usually as a pre-paid balance that hours are drawn from. Real support contracts are stricter: 10 hours included, unused hours roll over but only up to a cap, extra hours at €65, and the client signs an annex in September that changes all of it.
How Doktally solves it
- Retainer terms belong to the contract: amount, period, included hours, rollover policy and cap, excess rate.
- A preview before the draft: the amount, included and rolled-over hours, hours used, excess hours × the excess rate, and what the retainer adds to the invoice.
- Every period is billed once and shows its story: 11 of 11 h used (incl. 1 h rolled over), 22.5 of 10 h used, 12.5 excess hours billed on invoice 311.
- Annexes change terms from a period's first day, so a month is never billed under two contracts; when a retainer ends, its remaining hours expire.
- Support work covered by the retainer stays in reporting and is never billed again by the hour.

The result
Retainer invoices are right the first time, the client can see exactly how their hours were used, and a revenue chart shows what retainers really bring in.
Technologies
Java, Spring Boot, Billing, Contracts
- Published: 2026-11-03
- Project: Doktally — Invoicing, time billing and VAT for small businesses
- Case study