Passenger Services Settings
Configure ticket layouts and passenger document types for bookings and ticketing.
1 What's on this page
The Passenger Services Settings page provides two configuration areas through a tabbed interface. Each tab manages a different aspect of the passenger services system.
Ticket Configurations
Define how e-tickets are generated, including operator details, e-ticket number format, optional fields (nationality, weight, dietary requirements), and ticket branding with logos.
Each configuration is versioned, allowing you to track changes over time. Set one configuration as the default for new bookings.
PAX Document Types
Manage categories for passenger documents (e.g., Passport, ID Card, Driver's Licence). Active document types appear in passenger profile forms and booking screens.
Who can access: Users with the Passenger Services Settings permission see both tabs. Users without this permission see an access notification instead.
Changes to ticket configurations affect how e-tickets are generated for new bookings. Changes to document types affect data entry options across passenger services.
2 Ticket configurations
The Ticket Configurations tab manages templates that control how e-tickets are generated. Each configuration defines the operator details, e-ticket number format, optional fields to include on tickets, and branding elements like logos.
2.1 Active and deactivated views
The page displays two radio button views:
- Active: Shows ticket configurations currently available for use. These appear in booking and ticketing screens.
- Deactivated: Shows configurations that have been removed from active use. Deactivated configurations no longer appear in dropdowns but remain in the system for historical reference.
Switching between views updates the table immediately. Each view has its own search, sort, and pagination controls.
2.2 Search and filter
A search box (top-left) filters ticket configurations as you type. The search applies to:
- Layout name
- Latest version code
- User name (updated by)
An information icon next to the search box displays these searchable fields. The search applies to the currently selected view (Active or Deactivated).
If no results match your search, an alert displays: "There are no [active/deactivated] ticket configurations for your search terms."
2.3 Add a ticket configuration
In the Active view, click the Add new ticket configuration button (top-right) to open the ticket configuration window. The window opens with a form organised into sections:
2.3.1 Basic details
- Configuration name: Enter a descriptive name for this configuration (e.g., "Standard Charter", "VIP Executive"). Maximum 20 characters. This field is required.
- Is default: Tick this checkbox to make this configuration the default for new bookings. Only one configuration can be the default at a time. If another configuration is already the default, a warning icon indicates it will be replaced.
- Operator: Enter the operator name as it should appear on the ticket.
2.3.2 E-ticket number details
These fields control how the e-ticket number is formatted:
- Operator code: A short code for the operator (e.g., "OC").
- Place of issue: Airport or city code where tickets are issued (e.g., "CPT" for Cape Town).
- Country: Select the issuer country from the searchable dropdown.
- Generate QR Code: Tick to include a QR code on generated tickets.
2.3.3 Additional ticket fields
Select which optional fields to include on tickets generated with this configuration:
- Nationality: Include passenger nationality.
- Dietary requirements: Include passenger dietary preferences.
- Comments: Include a comments field.
- Weight: Include passenger weight. When selected, choose the weight unit of measure (kg, lbs, etc.).
- Luggage weight: Include luggage weight. When selected, choose the luggage weight unit of measure.
The unit of measure dropdowns only appear when their corresponding weight field is selected.
2.3.4 Ticket logo
Upload a logo to appear on tickets generated with this configuration. The system provides tools to crop and position the logo.
Logos are stored with each version, allowing different logos across configuration versions.
2.3.5 Additional information
Add custom information groups to appear on tickets. Each group has:
- Group name: A title for the information section (maximum 30 characters).
- Details: The content to display under this group.
Click Add group to create the first information group, or Add another group to add more. Use the red trash icon to remove unwanted groups.
This section allows you to include terms and conditions, baggage allowances, check-in instructions, or other custom information relevant to your operation.
Click Submit to save the new configuration. While submitting, the button shows a loading indicator with text "Submitting..."
Cancel closes the window without saving. New configurations are added to the Active list.
2.4 Edit a ticket configuration
In the Active table, click the Edit button (blue pencil icon) next to a configuration to open the edit window. The window displays the configuration's current values.
When you save changes, the system creates a new version of the configuration. The version code increments automatically. Previous versions remain in the system for audit purposes.
The edit window has the same sections and fields as the add window (see above).
2.5 Active ticket configurations table
The Active table displays ticket configurations. Click any column header with a sort icon to sort by that column. Click again to reverse the sort order. Columns include:
- Edit: Blue button with pencil icon. Opens the configuration for editing.
- Name: The configuration display name. Sortable.
- Latest version: The most recent version code for this configuration. Sortable.
- Updated: Date the configuration was last modified (format: dd MMM yyyy). Sortable.
- Updated by: The user who last updated this configuration. Sortable.
- Is default: Shows a green check icon if this is the default configuration, or a red X icon if not.
- Deactivate: Yellow button with ban icon. Removes the configuration from active use and moves it to the Deactivated view.
If the table contains 16 or more configurations, pagination controls appear at the bottom. Select items per page (15, 30, or 60) from the dropdown above the table.
2.6 Deactivated ticket configurations table
The Deactivated table displays configurations that have been removed from active use. Columns include:
- Name: The configuration display name. Sortable.
- Latest version: The most recent version code. Sortable.
- Updated: Date the configuration was last modified. Sortable.
- Updated by: The user who last updated this configuration. Sortable.
- Activate: Green button with plus icon. Reactivates the configuration and moves it back to the Active view.
Deactivated configurations cannot be edited. To edit a deactivated configuration, activate it first, then use the Edit button in the Active view.
Pagination appears for tables with 16 or more items.
3 PAX document types
The PAX Document Types tab manages categories for passenger identity documents. These categories appear in passenger profile forms, booking screens, and throughout the passenger services system.
3.1 Active and deactivated views
The page displays two radio button views:
- Active: Shows document types currently in use. These appear in dropdowns when adding or editing passenger information.
- Deactivated: Shows document types that have been removed from active use. Deactivated types no longer appear in dropdowns but remain in the system for historical passenger records.
Switching between views updates the table immediately. Each view has its own search and pagination controls.
3.2 Search and filter
A search box (top-left) filters document types by name as you type. The search applies to the currently selected view (Active or Deactivated). An information icon next to the search box shows which fields are searchable.
If no results match your search, an alert displays: "There are no [active/deactivated] passenger document types for your search terms."
3.3 Add a PAX document type
In the Active view, click the Add PAX document type button (top-right) to open the document type window. The window opens with a simple form:
- Name: Enter the document type name (e.g., "Passport", "National ID Card", "Driver's Licence", "Birth Certificate"). This field is required.
Click Submit to save the new document type. The system validates that the name is not empty. While submitting, the button shows a loading indicator with text "Submitting..."
Cancel closes the window without saving. New document types are added to the Active list in alphabetical order.
3.4 Edit a PAX document type
In the Active table, click the Edit button (blue pencil icon) next to a document type to open the edit window. The window displays the current name.
Update the name and click Submit to save changes. The updated document type remains in the Active list.
Changes to document type names update the display in all areas where that type is used, including existing passenger records.
3.5 Active PAX document types table
The Active table displays document types in alphabetical order by name. Columns include:
- Edit: Blue button with pencil icon. Opens the document type for editing.
- PAX document type name: The document type display name.
- Deactivate: Red button with ban icon. Removes the document type from active use and moves it to the Deactivated view.
If the table contains 16 or more document types, pagination controls appear at the bottom. Select items per page (15, 30, or 60) from the dropdown above the table.
3.6 Deactivated PAX document types table
The Deactivated table displays document types that have been removed from active use. Columns include:
- PAX document type name: The document type display name. Sortable by clicking the column header.
- Activate: Green button with plus icon. Reactivates the document type and moves it back to the Active view.
Deactivated document types cannot be edited. To edit a deactivated type, activate it first, then use the Edit button in the Active view.
Pagination appears for tables with 16 or more items.
4 Permissions
Access to this page is controlled by a single permission:
- Passenger Services Settings: Required to view and edit both ticket configurations and PAX document types. Without this permission, users see an access notification.
This permission is typically assigned to administrators and operations managers responsible for configuring the passenger services system.