Clients
Manage your customer database, track account balances, and access quotes and invoices.
1 What's on this page
The Clients page provides a complete view of your customer database with tools to manage client information, track financial accounts, and access related documents. You can filter between active and deactivated clients, search by multiple criteria, and navigate to detailed views.
Client List View
- Active/Deactivated toggle: Switch between viewing active and deactivated clients
- Search: Find clients by company name, address, point of contact, phone, or email
- Sortable columns: Click column headers to sort by company, address, POC, phone, email, or VAT number
- Pagination: Navigate through large client lists efficiently
Client Actions
- Add new client: Create client records with contact and financial details
- Edit: Update client information at any time
- Account: Access detailed financial account view with transactions
- Quotes & Invoices: Navigate to client-specific quotes and invoicing
- Activate/Deactivate: Control client visibility without deletion
Account Currency is required: Each client must have an assigned account currency before creation. This cannot be changed once the client has transactions.
Deactivation vs Deletion: Deactivating a client preserves all historical data and transactions while removing them from active workflows. This is the recommended approach for clients you no longer work with.
2 Primary Workflows
2.1 Create a new client
Adding a new client captures essential contact and financial details for future transactions.
Steps
- Click Add new client in the top-right corner of the page
- In the window that opens, complete the required fields:
- Company or Point of contact (at least one is required)
- Account Currency (required – select from the dropdown)
- Optionally fill in additional fields:
- Phone: Contact phone number
- Email: Contact email address
- Address: Physical or postal address
- VAT Number: Tax identification number
- Click Submit to save the client
Result
The new client appears in the Active Clients table. The window closes and the client list refreshes to include the new record.
Notes & rules
- Either Company or Point of contact must be provided – the system uses these to identify the client
- Account Currency cannot be changed after the client has transactions posted to their account
- Email validation: If provided, the email must be in a valid format
- Click Cancel to discard changes and close the window
2.2 Edit client details
Update client information as contact details or business details change.
Steps
- In the Active Clients table, locate the client you want to update
- Click the blue Edit button (pencil icon) in the first column
- The client detail window opens with "Edit client" as the header
- Modify any of the editable fields (Company, Point of contact, Phone, Email, Address, VAT Number)
- If no transactions exist for this client, you can also change the Account Currency
- Click Submit to save changes
Result
The client record updates immediately in the table. The window closes and changes are visible without needing to refresh the page.
Notes & rules
- Account Currency restriction: If the client has existing transactions, you'll see a warning preventing currency changes
- Required fields: At least one of Company or Point of contact must remain filled
- Click Cancel to discard edits and close the window
2.3 Search and filter clients
Quickly locate specific clients using search and view toggles.
Using the search field
The search field (top-left) accepts partial matches across multiple client fields. As you type, results filter automatically. Click the info icon next to the search field to see searchable terms.
Searchable Fields
- Company name
- Address
- POC (Point of Contact) name
- Phone number
View Toggle
- Active: Shows clients available for new transactions and quotes (default)
- Deactivated: Shows clients removed from active use but retained for historical records
Sorting results
Click any column header with a sort icon to reorder the table. Click again to reverse the sort direction. The active sort column displays an arrow indicating ascending or descending order.
Result
The table updates in real-time as you search or change views. If no clients match your criteria, a message displays: "There are no clients that match the provided search terms."
2.4 Access client account
Navigate to a client's financial account to view transactions, balances, receipts, and statements.
Steps
- In the Active Clients table, locate the client
- In the Account column (second column), click the green button with the invoice-dollar icon
- The page navigates to the Manage Client Account view for that client
What you'll see
The Manage Client Account page displays:
- Account balance summary: Current balance and period-specific totals
- Transaction history: All invoices, receipts, credit notes, and allocations
- Search and filters: Date range, transaction type, and status filters
- Add new receipt: Record payments received from the client
- Generate statement: Export account statements for the selected period
Returning to clients list
Click the Return to all clients button at the top of the account page to navigate back.
Notes & rules
- Permission required: If you lack access to client accounts, the button shows a "Not Authorized" state
- Account balance column: In the Active Clients table, the Account Balance column shows the current balance. Positive values indicate amounts owed to you; negative values indicate credit balances
2.5 Navigate to quotes and invoices
Access a client's quotes, proforma invoices, and invoicing history from their row.
Steps
- In the Active Clients table, locate the client
- In the third column, click the blue Quotes & Invoices button
- The page navigates to the Client-Specific Quotes view
What you'll see
The Client-Specific Quotes page displays:
- Quotes list: All quotes created for this client (draft, sent, accepted, declined)
- Create new quote: Tools to generate and send quotes to the client
- Convert to invoice: Process accepted quotes into proforma invoices
- Export and print: Generate quote and invoice documents
Returning to clients list
Use the browser back button or navigate through the main menu to return to the Clients page.
2.6 Deactivate or activate a client
Deactivating a client removes them from active workflows while preserving all historical data. This is the recommended approach for clients you no longer work with.
Deactivating a client
- In the Active Clients table, locate the client
- In the last column, click the red Deactivate button (ban icon)
- The client immediately moves to the Deactivated view
Reactivating a client
- Switch to the Deactivated view using the radio buttons
- Locate the client in the Deactivated Clients table
- In the last column, click the green Activate button (plus icon)
- The client immediately moves back to the Active view
Result
Deactivated clients no longer appear in client selection dropdowns throughout Musket (quotes, flights, OFPs, etc.). All historical transactions, quotes, and flights remain intact and accessible through reports and archives.
Notes & rules
- No confirmation required: Activation and deactivation happen instantly when you click the button
- Reversible: You can activate and deactivate clients as many times as needed
- Data preservation: No data is deleted during deactivation
- Edit restriction: You cannot edit deactivated clients. Activate them first if changes are needed
3 Feature Reference
3.1 Active Clients table
The main table displays client records with tools for immediate action.
| Column | Meaning | Editable? | Notes |
|---|---|---|---|
| Edit | Button to open the edit window for this client | - | Opens the same window as "Add new client" but pre-filled with client data |
| Account | Button to navigate to the client's financial account | - | Requires "Client Accounts" permissions; shows Not Authorized state if lacking access |
| Quotes & Invoices | Button to navigate to client-specific quotes and invoices | - | Opens the Client-Specific Quotes page filtered to this client |
| Company | Registered company name or trading name | ✓ | Sortable. Either Company or POC must be provided. Click column header to sort |
| Address | Physical or postal address | ✓ | Sortable. Optional field |
| POC | Point of Contact name | ✓ | Sortable. Either Company or POC must be provided. Shows "-" if empty |
| Phone | Contact phone number | ✓ | Sortable. Optional field |
| Contact email address | ✓ | Sortable. Optional field. Must be valid email format if provided | |
| VAT number | Tax identification or VAT registration number | ✓ | Sortable. Optional field. Shows "-" if empty |
| Account Balance | Current outstanding balance in the client's account currency | - | Positive = amount owed to you; Negative = client credit. Updates in real-time |
| Deactivate | Button to remove client from active workflows | - | Instantly deactivates the client; no confirmation required |
Deactivated Clients table
The Deactivated view shows a simplified table with these differences:
- Columns removed: Edit, Account, Quotes & Invoices, and Account Balance columns are hidden
- Last column changes: Deactivate button is replaced with a green Activate button
- Same search and sort: All other functionality remains identical
3.2 Client detail window
The client detail window appears when you click "Add new client" or "Edit" on an existing client.
Fields
| Field | Required? | Description | Validation |
|---|---|---|---|
| Company | Either this or POC | Registered company name or trading name | Must contain at least one non-whitespace character if provided |
| Point of contact | Either this or Company | Individual's name for personal clients | - |
| Phone | No | Contact phone number (any format) | - |
| No | Contact email address | Must be valid email format if provided | |
| Address | No | Physical or postal address (multi-line) | - |
| VAT Number | No | Tax identification or VAT registration number | - |
| Account Currency | Yes | Currency for all financial transactions with this client | Required. Cannot be changed once client has transactions |
Buttons
- Submit: Saves changes and closes the window. Changes "Submitting..." with a loading indicator while processing
- Cancel: Discards all changes and closes the window without saving
3.3 Filtering and pagination
The filter input component (below the search row) provides period selection and items-per-page controls when you have 16 or more clients.
Number of items per page
Choose how many clients display on each page (15, 30, or 45). This setting persists across sessions.
Pagination controls
When your filtered client list exceeds one page, pagination controls appear at the bottom of the table showing:
- Current page and total pages: e.g., "Page 2 of 5"
- Previous/Next buttons: Navigate between pages
- Page number buttons: Jump directly to a specific page
4 Rules & Validations
Client creation and editing
- Either Company or Point of contact is required – at least one must be filled when creating or editing
- Email validation: If provided, must be a valid email format
- Company must contain non-whitespace: Cannot be only spaces
- Account Currency is mandatory: Must be selected before submitting
Account Currency restrictions
- Cannot change currency after transactions exist: Once a client has invoices, receipts, or other transactions, the currency is locked to preserve financial integrity
- Warning displayed: If you try to change a locked currency, a red warning alert explains why it's blocked and lists existing transactions
Deactivation rules
- Instant action: No confirmation window – deactivation happens immediately
- Cannot edit while deactivated: Activate the client first to make changes
- Historical data intact: All transactions, quotes, and flights remain accessible through reports
- Removed from dropdowns: Deactivated clients don't appear in client selectors elsewhere in Musket
5 Permissions
The Clients page requires specific permissions to view and interact with features:
| Feature | Permission Required | Behaviour Without Permission |
|---|---|---|
| View clients page | Client Management: Clients (Full) | Page displays "Not Authorized" message with animation |
| Add new client | Client Management: Clients (Full) | Button hidden or disabled |
| Edit client | Client Management: Clients (Full) | Edit button hidden or disabled |
| Access client account | Client Management: Client Accounts (Any) | "Not Authorized" button shown; clicking displays permission message |
| Quotes & Invoices navigation | Client Management: Clients (Full) | Button hidden if lacking base permission |
| Deactivate/Activate client | Client Management: Clients (Full) | Button hidden or disabled |
Role-based access: Your system administrator assigns these permissions through Role Management. Contact your administrator if you need access to features you can't currently see or use.