Scheduling settings
Default rental duration, buffers, reminders, availability, rental limits, and stock-check policy.
Overview
Scheduling preferences set defaults for new rentals, prep/cleanup buffers, collection/return reminders, and the daily availability window.
Where it lives
Route: /admin/settings/scheduling (admin.settings.scheduling)
Open Admin → Preferences → Scheduling. Requires admin access.
Key settings
| Setting | Default |
|---|---|
| Default rental duration (days) | 1 |
| Buffer before / after (minutes) | 0 |
| Collection / return reminder (days before; 0 disables) | 1 |
| Default start / end time | 09:00 / 17:00 |
| Weekend availability | Off |
Assignment lifecycle
Vehicle assignments react to the rental they belong to. Each response is individually switchable:
| Setting | Default | Effect |
|---|---|---|
| Cancel assignments when a rental is cancelled | On | Assignments on a cancelled, lost, or expired rental are marked cancelled (kept for history, not deleted). |
| Flag assignments for review when rental dates change | On | Moving the rental hire window flags every live assignment as Needs review rather than silently rewriting its advisory window. |
| Move assignments to in progress on dispatch | Off | Opt-in. When enabled, an order reaching Dispatched or On Hire marks its assignments as in progress. |
| Flag assignments for review when a vehicle is withdrawn from service | On | Deactivating a vehicle, or making it unbookable, flags the assignments that still book it. |
Flags show as badges on the rental's Vehicles tab and are exposed on the API
assignment payload as cancelled_at, started_at, review_flagged_at, and
review_reason.
Availability engine
Controls how availability is calculated and when shortages are raised.
| Setting | Effect |
|---|---|
| Snapshot resolution | Hourly, half-daily, or daily availability snapshots. |
| Demand date source | Calculate demand from operational dates or charge dates. |
| Demand release point | When demand is released: off hired, returned, or checked. |
| Default turnaround hours | Turnaround allowed between hires (0–8760). |
| Snapshot past / future horizon (days) | How far back and forward snapshots are kept. |
| Overdue check interval (minutes) | How often overdue hires are checked (1–1440). |
| Daily summary retention (years) / Availability event retention (months) | How long summaries and availability events are kept. |
| Async recalculation item threshold | Catalogue item count above which recalculation runs asynchronously. |
| Recalculation lock timeout (ms) | How long a recalculation waits for its lock. |
| Shortage notification roles | Comma-separated roles notified of shortages. |
| Require shortage acknowledgement | Shortages must be acknowledged. |
| Require overbooking approval | Overbooking needs approval. |
| Warn about shortages at quote | Show shortage warnings while quoting. |
Rental lifecycle limits
| Setting | Effect |
|---|---|
| Maximum quote versions | Cap on versions per quote (1–200). |
| Maximum quote alternatives | Cap on alternatives per quote (1–50). |
| Quote expiry warning (days) | Days before expiry that a quote is flagged (0–90). |
| Rental number padding / scope | Padding and warehouse or global scope for existing rental numbers. |
Stock checks
Policy for stock checks:
| Setting | Effect |
|---|---|
Close mode (close_mode) |
Review before applying parks discrepancies for per-row resolution; Apply automatically resolves eligible discrepancies when closing. |
Write off missing stock automatically (auto_write_off_missing) |
When off, missing-barcode discrepancies stay open for manual resolution. |
Use blind counts by default (blind_count_default) |
New checks hide expected quantities from counters. |
| Require supervisor sign-off | A supervisor must sign off before a check can be closed. |
At a glance
Set defaults for rental durations, buffer times, reminders, and availability windows.
| Setting | Description | Default |
|---|---|---|
| Default Duration (days) | Duration in days for new rentals | 1 |
| Buffer Before (minutes) | Prep time before a rental | 0 |
| Buffer After (minutes) | Cleanup time after a rental | 0 |
| Collection Reminder (days before) | Days before collection to send reminders | 1 |
| Return Reminder (days before) | Days before return to send reminders | 1 |
| Default Start Time | Default daily start time | 09:00 |
| Default End Time | Default daily end time | 17:00 |
| Allow weekend availability | Whether weekends are available for scheduling | Off |
The same page also holds availability, quote lifecycle, stock-check and workflow limits — see the full guide.