Quotations Settings

Configure quote templates, custom fields, route parameters, and trip item statuses for your quotation system.

Administrators use this page to manage quote configurations, define custom form fields, set route directory parameters, and maintain trip item status labels.

1 What's on this page

The Quotations Settings page provides four configuration areas accessed through tabs. Each tab controls a different aspect of the quotation system, from quote templates to custom workflow statuses.

Quote Configurations

Create and manage quote configuration templates that define default parameters for quotes, including currency, VAT rates, document numbering prefixes, distance units, and PDF formatting options.

Quote Fields

Define custom form fields that appear on quote forms, allowing you to capture additional information specific to your operation's quoting requirements.

Route Settings

Configure global route directory parameters including the distance unit used for route calculations and the currency for fixed costs.

Trip Item Statuses

Manage status labels with custom colours used to track the progress and state of trip items within the quotation and trip planning workflow.

2 Quote configurations

The Quote Configurations tab manages reusable quote templates that define default parameters for creating quotes. Each configuration includes currency settings, VAT rates, document numbering prefixes, aircraft base location, distance and time units, excess charge allowances, and PDF formatting options. Users select a configuration when creating a new quote, and the quote inherits all these parameters.

2.1 Active and deactivated views

Two radio button views control what you see:

  • Active: Shows quote configurations currently available when creating quotes. These appear in configuration selection dropdowns.
  • Deactivated: Shows quote configurations removed from active use. Deactivated configurations no longer appear in dropdowns but existing quotes using them are unaffected.

Switching views updates the table immediately. Each view has its own search, sort, and pagination controls.

2.3 Add a quote configuration

In the Active view, click the Add quote configuration button (top-right) to open the configuration window. The window is large (maximisable) and contains multiple sections. Required fields include:

Basic information
  • Default configuration: Checkbox to mark this as the default configuration selected when creating new quotes.
  • Quote Configuration Name: Internal name for this configuration (e.g., "International Charter - EUR", "Domestic - ZAR").
  • Company Name: Company name that appears on quote and invoice PDFs.
Transaction & Document Codes

The configuration includes a collapsible "Transaction & Document Codes" section with a table for managing document numbering. Each document type (Quote, Proforma Invoice, Cash Sale Invoice, Invoice, Credit Note) can be configured independently:

  • Prefix: Three-character prefix for each document type (e.g., "QTE", "PFI", "CSI", "INV", "CN").
  • Use Default System Codes: Checkbox to control the code generation method:
    • Enabled (checked): Uses Musket's default date-based code generation system (e.g., QTE20250113001).
    • Disabled (unchecked): Uses custom sequential numbering starting from a specified minimum number.
  • Min. Number: When "Use Default System Codes" is disabled, enter a starting number for sequential generation. Numbers are automatically padded to at least 3 digits with leading zeros. For example:
    • Prefix "QTE" with minimum 1: generates QTE001, QTE002, QTE003...
    • Prefix "QTE" with minimum 57: generates QTE057, QTE058, QTE059...
    • Prefix "QTE" with minimum 100: generates QTE100, QTE101, QTE102...
    • Prefix "QTE" with minimum 57687: generates QTE57687, QTE57688, QTE57689...

Information icon: Next to the "Code" column header, an information popover explains: "Tick 'Use Default System Code' to generate the automated codes using Musket's date based formatting. Else untick it, and provide a starting number - to generate codes using a simple numbering system - starting from your provided minimum number."

Operational parameters
  • Aircraft Base: Default base airport for aircraft positioning calculations.
  • Input STD & STA Format: Choose whether users enter scheduled times as UTC or Local time.
  • Input EET Format: Choose how users input estimated elapsed time (HH:mm or Decimal hours).
  • Distance unit: Unit for leg distances (kilometres, nautical miles, or statute miles).
  • Allow Excess Distance Per Leg: Checkbox to enable excess distance charges. If enabled, enter the excess distance threshold.
  • Allow Excess EET Per Leg: Checkbox to enable excess time charges. If enabled, enter the excess time threshold.
  • Default turnaround (minutes): Default ground time between consecutive legs.
Financial parameters
  • Quote Currency: Currency for quote amounts and totals.
  • Include Aircraft Discount: Checkbox to enable discount calculations. If enabled, enter the default discount percentage.
  • Show discount on quote/invoice: Checkbox to display discount line items on PDFs even when discount is zero.
  • Include VAT: Checkbox to enable VAT calculations. If enabled, enter the VAT percentage.
  • VAT number: Enter your organisation's VAT registration number (appears on invoices and quotes when VAT is included).
PDF formatting options
  • Checkboxes to control which columns and sections appear on quote and invoice PDFs (first departure date, local times, distance, cost, excess EET, route totals, exchange rates).
  • Options to upload header and footer images for branded PDFs.
  • Fields for address and contact details, banking details, and terms and conditions text.
  • Quote attachments: Upload documents that automatically attach to all quotes using this configuration (e.g., standard terms and conditions, insurance certificates).

The window includes additional advanced options for custom document numbering sequences and exchange rate display. Click Submit to save the configuration. While submitting, the button shows a loading indicator.

Cancel closes the window without saving. New configurations appear in the Active table and become available in quote creation dropdowns immediately.

2.4 Quote configurations table

The Active table displays configurations in sortable rows. Columns include:

  • Edit: Blue pencil button that opens the configuration window with all current values pre-filled.
  • Name: Configuration name. Click the column header to sort alphabetically.
  • Default: Shows whether this is the default configuration.
  • Quote No. Prefix: Three-character quote prefix.
  • Invoice No. Prefix: Three-character invoice prefix.
  • Aircraft Base: Default base airport code.
  • Dist. Unit: Distance unit (km, nm, or sm).
  • Excess Dist. p/leg: Excess distance threshold if configured.
  • Quote currency: Currency symbol.
  • VAT %: VAT percentage if enabled.
  • Deactivate: Red button with ban icon to remove the configuration from active use.

Note: The table shows prefix values but not the code generation method. To see whether a configuration uses system default codes or custom sequential numbering, edit the configuration and view the Transaction & Document Codes table.

Pagination: If more than 15 configurations exist, the table paginates. Use the dropdown (top-left) to show 15, 30, or 60 items per page.

The Deactivated table shows selected columns and an Activate button (green plus icon) to restore configurations to active use.

2.5 Edit a quote configuration

Click the Edit button in any row to open the configuration window with all current values pre-filled. Modify any fields as needed, including document prefixes and code generation settings in the Transaction & Document Codes table.

Click Submit to save changes. Changes apply to new quotes created with this configuration. Existing quotes retain their original parameters even if the configuration is modified.

2.6 Deactivate a quote configuration

In the Active table, click the Deactivate button (red ban icon) to remove the configuration from active use.

3 Quote fields

The Quote Fields tab manages custom form fields that appear on quote forms. These fields allow you to capture additional information specific to your operation's requirements. Each field has a name, label, data type (text, number, date, dropdown, checkbox), and optional validation rules.

3.1 Active and deactivated views

Two radio button views control what you see:

  • Active: Shows fields currently appearing on quote forms in their defined order.
  • Deactivated: Shows fields removed from quote forms. Data entered in deactivated fields remains stored but the fields no longer appear on forms.

Switching views updates the table immediately. Each view has its own search and pagination controls.

3.3 Add a quote field

In the Active view, click the Add field button (top-right) to open the field window. Configure these properties:

  • Name: Internal field name (e.g., "client_reference", "special_requirements").
  • Label: Display label shown to users on the form (e.g., "Client Reference", "Special Requirements").
  • Type: Field type (text box, text area, number, date, dropdown, checkbox, etc.).
  • Required: Checkbox to make this field mandatory on quote forms.
  • Display order: Numeric value controlling the field's position on the form. Lower numbers appear first.

For dropdown fields, additional configuration allows you to define the list of selectable options.

Click Submit to save the field. It appears on quote forms immediately in the specified display order.

3.4 Quote fields table

The Active table displays fields in their form display order. Each row includes:

  • Reorder handle: Drag icon for changing field order. Drag rows up or down to reposition fields on the form.
  • Edit: Blue pencil button to modify field properties.
  • Name: Internal field name.
  • Label: User-facing label displayed on forms.
  • Type: Field data type (text, number, date, etc.).
  • Required: Checkmark if field is mandatory.
  • Display order: Numeric position in the form.
  • Deactivate: Red button to remove field from quote forms.

Pagination: If more than 15 fields exist, the table paginates. Use the dropdown to show 15, 30, or 60 items per page.

3.5 Reorder quote fields

In the Active table, use the drag handle (vertical arrows icon) on the left of each row to reorder fields. Click and hold the handle, then drag the row up or down to the desired position.

Release the mouse button to drop the field in its new position. The display order updates automatically and the form layout changes immediately to reflect the new order.

3.6 Edit a quote field

Click the Edit button to modify an existing field. You can change the label, type, required status, and display order. Changing the field type may affect existing data stored in that field.

4 Route settings

The Route Settings tab configures global parameters for the route directory used in quote calculations. This includes the distance unit for route distance measurements and the currency for fixed costs associated with routes. These settings apply across the entire quotation system.

4.1 View route settings

The Route Settings tab displays the current configuration in a simple table with two rows:

  • Routes distance unit: The unit used for route distance calculations (kilometres, nautical miles, or statute miles).
  • Fixed cost currency: The currency symbol for fixed costs in the route directory.

If no route settings have been defined, an information alert displays: "No route settings have been defined."

4.2 Add or edit route settings

Click the Add route settings or Edit route settings button (top-right) to open the route settings window. The window contains two fields:

  • Routes distance unit: Dropdown to select the unit (km, nm, or sm). This field is required.
  • Fixed cost currency: Dropdown to select the currency. Choose from active currencies configured in the system.

Click Submit to save the settings. Changes apply immediately to route calculations and quote generation.

5 Trip item statuses

The Trip Item Statuses tab manages status labels with custom colours used to track trip items within the quotation and trip planning workflow. Each status has a name (e.g., "Confirmed", "Pending", "Cancelled") and a colour displayed as a visual indicator. Operations staff assign these statuses to trip items to communicate workflow state.

5.1 Active and deactivated views

Two radio button views control what you see:

  • Active: Shows statuses currently available when managing trip items. These appear in status selection dropdowns.
  • Deactivated: Shows statuses removed from active use. Deactivated statuses no longer appear in dropdowns but existing trip items retain their status.

Switching views updates the table immediately. Each view displays its own set of statuses.

5.2 Add a trip item status

In the Active view, click the Add trip item status button (top-right) to open the status window. Configure these fields:

  • Status: The status name (e.g., "Confirmed", "Pending Approval", "Cancelled", "Completed").
  • Colour: Select a colour using the colour picker. This colour appears as a visual indicator next to trip items with this status. Choose colours that provide clear visual distinction between statuses.

Click Submit to save the status. It becomes available in trip item status dropdowns immediately.

5.3 Trip item statuses table

The Active table displays statuses in rows with these columns:

  • Edit: Blue pencil button to modify the status name or colour.
  • Status: The status label text.
  • Colour: A wide column filled with the status colour, providing a clear preview of how the status appears in the system. Text colour automatically adjusts for visibility.
  • Deactivate: Red button with ban icon to remove the status from active use.

The Deactivated table shows the Status and Colour columns plus an Activate button (green plus icon) to restore statuses to active use.

5.4 Edit a trip item status

Click the Edit button to modify a status. Change the status name or colour as needed. Click Submit to save.

Changes apply immediately to status displays throughout the system. Existing trip items using this status reflect the updated name and colour.

5.5 Deactivate a trip item status

Click the Deactivate button to remove a status from active use. The status moves to the Deactivated view.

Navigation
Settings

Theme


Other settings coming soon...

An unhandled error has occurred. Reload 🗙
Interactive features loading...