Trip Calendar¶

The Trip Calendar provides a visual timeline of your agency's activity, helping you manage deadlines and stay ahead of upcoming travel.

The calendar supports multiple views to suit different planning needs:

Month: A high-level overview of the entire month's schedule.
Week: A more granular view of daily activities and times.
List Month: A chronological layout of events for the current month, ideal for a quick summary.

Use the navigation buttons in the top-left to move between months/weeks or return to "Today."

Event Types¶

The calendar displays three primary types of events:

1. Trips (Timeline)¶

Trips are displayed as horizontal bars spanning from the start date to the end date. They provide a quick view of when your clients are traveling.

2. Bookings (Events)¶

Individual bookings (flights, hotels, tours) appear on their specific dates. If a booking has a specific time set, it will be displayed chronologically within the day.

3. Payment Milestones (Critical Actions)¶

Payment deadlines appear as red dots labeled with the amount due. These are high-priority items that require attention to avoid booking cancellations.

Critical Action

Payment milestones are highlighted to ensure deadlines are never missed. Always verify payment status when these indicators appear.

Interactive Details¶

Clicking any event on the calendar opens a detail modal with key information:

Trip/Booking/Payment Details: Direct summary of the item.
Client Information: Quick access to the client's name, email, and phone number.
Direct Links: One-click navigation to the full Trip or Client page for deeper management.

Integration¶

The calendar is directly linked to your trip data. Adding a new booking or payment milestone in a Trip view will automatically populate it on the calendar. Similarly, clicking an event on the calendar allows you to jump straight into editing that trip.

REST API Access¶

Calendar data is also available via the REST API at GET /api/calendar/events, enabling integration with external systems and mobile applications.

Query Parameters:

Parameter	Description
`start`	Filter events starting after this date (ISO)
`end`	Filter events ending before this date (ISO)
`type`	Filter by: `trip`, `booking`, `payment`, or `all`

See the API Documentation for full details and response examples.

Booking Calendar Visibility¶

Each booking has a show_on_calendar toggle (enabled by default). Set this to false if you want to exclude a specific booking from appearing on the calendar while keeping it in the trip record.