Skip to content

Booking Policy screen

The Booking Policy screen is where admins configure the four rules that govern how members make bookings and report squawks within a syndicate: whether bookings need admin approval, the minimum booking duration, how far ahead members can book, and whether member-reported squawks need admin confirmation before they become active.

Three of these apply uniformly across every asset in the syndicate. Max Advance Booking Days is the one exception: it follows the default-and-per-asset cascade, so a multi-asset syndicate can override the window per asset.

  • Owner and admin — can change every field on this screen.
  • Members — do not see the Booking Policy screen. They experience the effects (pending status, duration validation, advance-window rejection) indirectly.

In the app:

  1. Open the syndicate.
  2. Go to Dashboard → Syndicate settings → Booking Policy.

Route: /syndicates/:syndicateId/settings/booking-policy.

The screen has two cards: Booking Policy and Maintenance Settings.

FieldDefaultNotes
Require booking approvalOffToggle. Subtitle: “New bookings need admin approval before being confirmed”. When on, a regular member’s booking starts as pending and an admin must approve or reject it. Admin and owner bookings skip the pending queue even when this is on.
Minimum booking duration (minutes)60Numeric. Blank falls back to the system default of 60. The validator rejects shorter time-slot bookings.
Max Advance Booking Days90Numeric. Blank falls back to the system default of 90. Cascades per asset — see Default and per-asset settings. A member trying to book further ahead is shown the window rule with the asset’s effective limit.
FieldDefaultNotes
Require admin confirmation for squawksOnToggle. Subtitle: “When enabled, squawks from members must be confirmed by an admin before they become active”. When on, a member-reported squawk enters the pending state. An admin must confirm it (possibly changing severity) before it takes effect on airworthiness. When off, a member-reported squawk is active immediately.

Settings are persisted on Save Policy. The requires_booking_approval and min_booking_duration_minutes fields live flat on the syndicate settings JSON. max_advance_booking_days lives inside the nested default_billing map.

  • Admin and owner bookings are never held for approval. Even with the toggle on, only regular-member bookings enter the pending queue. See Booking statuses.
  • Tentative (pencilled-in) bookings are not held for approval until confirmed. A tentative booking that a member later confirms enters the pending queue at confirmation time if approval is required. See Tentative bookings.
  • Changing Minimum Booking Duration does not retroactively invalidate existing bookings. The validator only runs on new bookings and edits.
  • Max Advance Booking Days is the only cascading field on this screen. On a multi-asset syndicate, the value on Booking Policy is the default — each asset can override in its own billing screen.
  • Squawk confirmation can be toggled at any time. Pending squawks from before the change keep their state; new squawks use the new rule.