Skip to main content

Reservation Management

The reservation module handles all booking operations including creation, modification, cancellation, and group bookings.

Overview​

Reservations can be created from multiple sources:

  • Direct bookings (phone, walk-in)
  • Online booking engine
  • OTA channels (via Channel Manager)
  • Corporate/Travel Agent portals

Reservation Lifecycle​

Creating Reservations​

Required Information​

  • Arrival and departure dates
  • Room type
  • Guest details (name, contact)
  • Rate plan

Optional Information​

  • Special requests
  • Preferences
  • Accompanying guests
  • Payment method

Availability Check​

Before confirming a reservation:

  1. System checks inventory for requested dates
  2. Validates against overbooking limits
  3. Confirms rate availability
  4. Applies any restrictions

Reservation Types​

Individual Reservations​

Single guest or room booking with one folio.

Group Reservations​

Multiple rooms under one group master:

  • Group master with summary billing
  • Individual reservations linked to group
  • Block allocation and pickup tracking
  • Rooming list management

Company/TA Reservations​

Corporate or travel agent bookings:

  • Negotiated rates applied
  • Billing to company/TA
  • Commission tracking

Modification​

Allowed Modifications​

  • Date changes (subject to availability)
  • Room type upgrades/downgrades
  • Add/remove rooms
  • Guest information updates
  • Special requests

Restricted Modifications​

  • Changes within cancellation penalty period
  • Rate plan changes after check-in
  • Name changes may require manager approval

Cancellation​

Cancellation Policies​

cancellation_policies:
  - name: "Flexible"
    rules:
      - days_before: 1
        charge_percent: 0
      - days_before: 0
        charge_percent: 100

  - name: "Non-Refundable"
    rules:
      - days_before: 999
        charge_percent: 100

  - name: "Moderate"
    rules:
      - days_before: 3
        charge_percent: 0
      - days_before: 1
        charge_percent: 50
      - days_before: 0
        charge_percent: 100

Cancellation Process​

  1. Retrieve reservation
  2. Calculate cancellation charges
  3. Process refund if applicable
  4. Update inventory
  5. Send cancellation confirmation

No-Show Handling​

When a guest doesn't arrive:

  1. Mark reservation as No-Show after cutoff time
  2. Apply no-show charges
  3. Release room for sale
  4. Process virtual payment if guaranteed

Waitlist Management​

When no inventory available:

  1. Add guest to waitlist
  2. Set priority and expiry
  3. Notify when room becomes available
  4. Convert to confirmed reservation

API Reference​

See Reservations API for detailed endpoint documentation.