ticket holds everything related to a case – the description, status, costs, visits, notes and the full history. This article walks you through the most common tasks and shows you where to find each of them.
To open a ticket, click its number on the tickets list.
Permissions
What you can see and do depends on your permissions. Many features come with a permissions table: it gives the list section, the exact permission name and its description. If you are missing one, contact the administrator in your organisation.
Which tickets you can see
By default you see the tickets you are involved in – those you created and those where you are the responsible person or an observer. To see other people's tickets, you need the ShowOtherPeopleCases permission; you can also be added as an observer of a specific ticket.
Editing ticket details
Need to correct something? Click Edit and change the key ticket details in one place:
Title
Description
Location
Owner
Type
Priority
Category
Responsible person
Payment responsibility
Planned completion date
Permissions
Who sees a given button on a ticket depends on the permissions below:
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows the user to view and edit the Payment responsibility parameter. |
Ticket - Tickets |
| Allows the user to set the Planned completion date. |
Ticket - Tickets |
| Allows an external service to delegate a ticket to other external services. |
When the AlwaysCalculateSlaDeadline app setting is enabled, changing the priority, the category or the building section recalculates the Planned completion date from the SLA rules. With MultipleHelpdeskTicketSla also enabled, the Planned response date is recalculated at the same time. This applies to helpdesk tickets only. When the LimitedPlannedCompletion app setting is enabled (numeric type, 0 days by default), it limits the Planned completion date to a maximum of X days from the current date. The limit applies both when creating and editing a ticket – whether the date is picked from the calendar or typed in manually. It does not apply to tickets that already have a date beyond the limit. You enable this setting in the App settings submodule, Tickets section.
Location on the floor plan
If the ticket is pinned on a floor plan, the Location section shows the Marked on indicator with the plan name (e.g. Marked on: Level 2).
To see the exact pinned spot, click the Change button next to the Marked on indicator. This opens the Mark on floor plan window, where the current pin is visible on the plan. Users with the TicketFloorLocationEdit permission can also move the pin to a new spot and save it from this window.
If the ticket is not pinned yet, the Mark on floor plan button appears here instead.
Before you use this feature, make sure the relevant floor plans have already been uploaded to the system.
Who can see the location on the floor plan section – and what they can do there – is described in the table below:
Permission section | Permission name | Description |
Building - Buildings |
| Allows the user to see the Marked on indicator and view the pinned spot on the floor plan in the ticket view. |
Building - Buildings |
| Allows the user to move the pin and save a new spot on the floor plan. |
Changing the ticket status
The status shows the stage the ticket is at – keep it up to date as the work progresses. The table below describes every status you can set.
Status | Description |
New ticket / Open | The ticket is open. |
Accepted | The ticket has been approved. |
In progress | The ticket is being worked on. |
Offer / Cost | An offer has been added to the ticket. |
Cost acceptance | All approvers have accepted the offer. |
Report | A report has been uploaded to the ticket. |
Done | The Responsible person has completed all tasks covered by the ticket. |
Suspended | The ticket is suspended. |
Cancelled | The ticket has been cancelled. |
Closed | An authorised user has confirmed that all tasks related to the ticket are complete. |
Works approval / Closed | An authorised user has approved the works related to the ticket. |
Click the Status button to change it. You can also do this from the workflow bar in the ticket view.
Note – status transitions
The Status button offers every status except the one the ticket is currently in; statuses do not have to be set in the order shown in the table above, and there is no pair of statuses between which a change is blocked by design. In particular, a ticket in the In progress status can be moved back to New ticket / Open, either from the Status button or by clicking the New ticket / Open step on the workflow bar; this requires the Close permission. The list is narrowed down by the following conditions:
Closed, Cancelled and the remaining closing statuses are only offered to users with the
ServiceClosepermission and to users of an external service company. External service company users are offered closing statuses only.A Closed or Cancelled ticket cannot be edited; it first has to be reopened to New ticket / Open, which requires the
Reopenpermission.Accepted can only be set for a ticket in the New ticket / Open status, only by internal users with the
Closepermission, and only if that status is enabled for the given ticket type.Closed or Done may be removed from the list by additional conditions: the
RequireServiceVisitsetting is enabled and no visit has been added, works approval is still pending and the user does not have theWorksApprovalClosepermission, the ticket type is restricted to users with theAllowCloseAllTypespermission, or the cost is still awaiting acceptance.
The following options are available:
Set the Status
Once you change the status to Closed or Cancelled, editing is disabled. To make any changes, reopen the ticket.
Set the Resolve date
Add a Summary
Add a new signature
To add a signature, type your first and last name and sign using a touchpad or mouse. You can also save the signature as your default and reuse it later by clicking the Add profile signature button. To set up your signature, go to User settings in the drop-down menu next to your user name in the top right corner of the application
Who can change the ticket status depends on the permissions below:
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows the user to reopen tickets with the Closed or Cancelled status. |
Ticket - Tickets |
| Adds the Cancelled status to the list of available statuses. It does not depend on the current status of the ticket. |
Ticket - Tickets |
| Required to change the ticket status to Done, Report, Suspended, Closed, Cancelled and any status other than New ticket / Open. It is also required to accept a ticket in the New ticket / Open status and to move a ticket back to New ticket / Open from the workflow bar. Reopening a Closed or Cancelled ticket requires the |
Ticket - Tickets |
| Allows the user to close a ticket in any status. |
Ticket - Tickets |
| Gives the user access to the date picker used to set the resolve date. |
Ticket - Tickets |
| Gives the user access to the work time report in Reports → Quick reports. |
Ticket - Tickets |
| Allows the user to close a ticket whose cost exceeds the site's amount in a single step. |
The table below lists the app settings that affect how the Status button works.
App settings section | Setting name | Description |
Tickets |
| When enabled, the setting allows the user to add a signature. |
Tickets |
| When enabled, the setting activates the works approval feature. |
Buildings |
| When enabled, the setting allows the user to change the ticket status from New ticket / Open to Done. |
Tickets |
| When enabled, the setting prevents a ticket from being closed without a visit being added. This setting applies to the Tickets and Inspections modules. |
Tip
You can suspend a ticket without collecting a delay, as long as your organization has the OnHoldUpdatesTicketSLA application setting switched on. Set the status to Suspended and fill in the Suspended until field: the planned completion date then moves to the end of that day. With the setting off, which is the default, the date stays where it was and the time on hold counts as delay. Note that the new date is the end of the resume day, not the old deadline pushed back by the waiting time, so a short hold on a ticket with a distant deadline can shorten it.
Adding a label
Labels help you group and highlight cases – you attach them with the icon above the workflow bar. A label can be private (visible only to its author) or public (visible to everyone with edit access). Keep in mind that attaching some labels triggers a workflow, for example changing the status or the responsible person.
By navigating to Start → Labels, you can add a new label or edit an existing one.
Permission Section | Permission Name | Description |
Ticket |
| Allows visibility of a public label assigned to a ticket or inspection, without permission to manage or assign it. This permission is read-only and does not allow editing. |
Admin |
| Provides access to the label editing module, allowing users to create labels, edit their names and colors, and delete their own labels. Also allows users to pin and unpin labels on tickets, inspections, and user accounts. |
Admin |
| Extends LabelAccess to public (shared) labels, allowing users to edit and delete them. Without this permission, users can view public labels but cannot modify them. |
Linking a ticket
Click Link ticket to connect it with another one:
Link an existing ticket by entering its number and clicking Link.
Create a new linked ticket.
The Link ticket button is available only to users with the LinkedTicketView permission. You set this permission in User/Permissions, Ticket - Tickets section.
Report
Share a clear record of the work done in a few clicks. The Report button lets you:
Download the report, with the option to include photos
Upload a report scan
The visibility of the button and of the actions in the Report tab depends on the permissions described below:
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows the user to download the report. |
Ticket - Tickets |
| Allows the user to download the report for tickets in the Closed status. |
The table below lists the app settings that affect how the Download button works.
App settings section | Setting name | Description |
Tickets |
| When enabled, the setting allows several reports to be uploaded at once using the Report button. |
Tickets |
| When enabled, the setting excludes internal notes from the ticket report. |
Adding a cost
When a task requires chargeable work, the +Cost button lets you attach an offer with additional costs and decide who has to accept them. You can add costs in different currencies, depending on the building configuration. There are two cost acceptance paths – internal and tenant acceptance. The internal one covers the people configured in the Acceptance matrix entity, while whether a tenant is included is decided solely by the CostAccept permission.
Note
You can add only one cost for acceptance to a single ticket.
Once the required parameters have been entered, the Offer tab appears in the ticket edit view.
Who sees the +Cost button and can edit what sits behind it depends on the permissions below.
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows the user to see the +Cost button. |
Ticket - Tickets |
| Gives the user access to cost acceptance. |
Ticket - Tickets |
| Gives the user access to Master data → Tickets → Acceptance matrix and its features. |
Ticket - Tickets |
| Allows the user to set the payment responsibility for tickets as internal or tenant. |
Offer vs cost
These are two different things. The +Cost button adds an offer that goes through acceptance (shown as Cost value). The Cost tab is for direct, additional costs with no acceptance – these add up to Invoiced value.
Works approval
Works approval is the final sign-off before a ticket is closed – it is what makes completed work formally approved. Once it is confirmed, a works approved note appears in the History tab and the ticket status changes to Works approval / Closed.
Note
Works approval is available when the WorksApproval app setting is enabled.
The permissions related to works approval are listed in the table below:
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows a user who accepts the cost to approve the completion of works. In a more complex acceptance path, this permission is assigned to the first user who accepts the cost. For a user to be able to approve the works, the following conditions must be met:
|
Ticket - Tickets |
| Allows the user to close a ticket while skipping the works approval step. The user must also have the |
The table below lists the app settings that affect how the Works approval button works.
App settings section | Setting name | Description |
Tickets |
| When enabled, the setting activates the works approval feature. |
Tickets |
| When enabled, the setting changes the responsible person to the user who approves the ticket. |
History tab
The History tab is the complete record of the ticket – every action in order – so you can always see what happened and when.
Hover over the envelope icon to see the list of users notified about a note by email. The system sends notifications to the users assigned as Responsible person and Observers. The ticket owner is also notified, provided they are not the author of the note.
Note
A yellow padlock marks an internal note; a public note has no icon.
Only users with the PostDetails permission can see the list of users notified about a note. You set this permission in the User/Permissions entity, Ticket - Tickets section.
AI ticket summary
Short on time? Instead of scrolling through the whole note history, generate a concise AI-written ticket summary. Users in technical roles see the root cause and the actions taken, while other roles see the ticket status, costs and potential risks. Every summary is limited to the data the user has permission to see. If AI access is not enabled for your account, a Request access button is shown instead of the summary.
For this feature to be available, AI must be enabled on the instance. The number of notes required before a summary can be generated is 5 by default and is configurable per customer.
Adding a note
Notes keep everyone in the loop. Click +Note to add one – the Visibility, Description and Next step fields are always required, and attaching a file is optional.
Note
The Next step field is only visible when the HideNextStep app setting is disabled.
There are three note types in the system:
Note type | Description |
Internal | The note is visible to internal users only. |
Public | The note is visible to everyone with edit access to the ticket. |
Private | The note is visible to its owner only. |
The Next step parameter makes a submitted note redirect the ticket to the responsible person or the owner. The ticket disappears from the list of the person who redirected it and is pinned to the recipient's list.
To give external users access to internal or private notes, you have to change their permission profile. Access to internal notes does not apply to the tenant role.
External-service users are not offered public notes unless PublicNotesForExternalServices is switched on for your instance. Singu support switches it on. The setting applies to external services only and changes nothing for tenants or internal users.
The table below lists the permissions related to notes:
Permission section | Permission name | Description |
Tickets - Ticket |
| Allows the user to add public notes. |
Tickets - Ticket |
| Allows the user to view and add internal notes. |
Tickets - Ticket |
| Allows the user to view private notes. |
Tickets - Ticket |
| Allows the user to add private notes. |
The table below lists the app settings that affect how the +Note button works.
App settings section | Setting name | Description |
Tickets |
| When enabled, the setting allows external services to set a note as Public. |
Tickets |
| When enabled, the setting excludes internal notes from the ticket report. |
Tickets |
|
When enabled, the setting hides the Next step field when a note is added to a ticket. |
Information tab
The Information tab gives you the key ticket details in a single view:
Subject
Boards
Coordinator
Observer
Linked tickets
Boards show tasks from inspections and tickets visually, which keeps communication across the team clear. They also let you review key data and arrange it into readable lists.
Click the Add to board button to assign the ticket to a board as a note.
Managing observers
Observers are notified of every ticket update. Click Manage observers to add or remove them.
Who can manage observers depends on the permissions below.
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows the user to add observers and a coordinator to a ticket – only those who have the |
Ticket - Tickets |
| Allows the user to remove observers from a ticket. |
Ticket - Tickets |
| Allows the user to become an observer or coordinator of a ticket. |
Inspection - Inspections |
| Allows an observer who is a tenant to be added to a ticket. |
Adding a coordinator
The coordinator runs the ticket and stays up to date with every change. Click Add coordinator to appoint one. To remove a coordinator, click the Remove button in the Coordinator field.
Note
You can add only one coordinator to a ticket, whereas you can add multiple observers.
Actions tab
Actions are the individual jobs to be done within a ticket – each with a quantity and a unit price, so you can see the scope and the cost straight away. These are the same actions you use in the Visits tab. You can assign an action to a specific visit; it is then marked as completed. There is nothing to configure – the Actions tab is available in the ticket details right away.
Actions that were not defined during system configuration can be entered manually – select the Other option in the Action field.
Visits tab
In the Visits tab, technicians and external vendors record how each visit went: the date, the materials used and the work carried out.
Who can open this tab – and what they can do there – depends on the permissions below.
Permission section | Permission name | Description |
Ticket - Tickets |
| Gives the user access to the Visits tab. |
Ticket - Tickets |
| Allows the user to add or edit visits. |
Ticket - Tickets |
| Allows the user to remove visits. |
Ticket - Tickets |
| Gives the user access to the Visit actions entity and its features. |
Ticket - Tickets |
| Allows the user to edit the price for a single visit. |
Ticket - Tickets |
| Allows the user to add visits with future dates. |
Ticket - Tickets |
| Allows a user to be set as responsible for a visit. |
Ticket - Tickets |
| Gives the user access to the extended Visits list. Gives an external service access to the extended visits list, including all visits it has access to. Allows an external service to view visits of other external services, but with limited access to their data. |
Ticket - Tickets |
| Allows the user to add visits as an external service. |
The table below shows the app settings that affect how the Visits tab works.
App settings section | Setting name | Description |
Tickets |
| When enabled, the setting allows an external service to be assigned to an action linked to a visit added to a ticket or an inspection. |
Tickets |
| When enabled, the setting shows the Chargeable to tenant field on the new visit form. |
Documents tab
The Documents tab turns ticket data into official work order PDFs – in a single click. Documents are numbered and saved as ticket attachments. There is nothing to configure: the tab appears in the ticket details automatically.
Ticket report PDFs generated from Documents templates can also include additional configurable content blocks: survey answers (Form), requisitioned items from Inventory and the ticket's External no. The Form and Inventory blocks need no extra configuration and are available in the template builder right away, but they have to be added to a published template in order to appear on generated documents. The External no. block only appears in the template builder once the BuildingTicketShowExternalNo app setting is enabled.
Calendar
The Calendar tab lays the ticket's visits out on a timeline, so you can see what is scheduled at a glance. Visits added in the Visits tab appear here, provided the show in calendar option was selected when they were created. Switch the view with the Calendar and List buttons.
The +Entry button lets you add your own entries. If the activity is not related to the ticket, filling in the Description field is mandatory. In that case, describe the task in this field and set the time range for completing it.
When the CalendarFilteringSelect app setting is enabled, visits in the calendar can be filtered by user. You enable this setting in the App settings submodule, Tickets section.
Assets tab
The Assets tab holds the equipment linked to the ticket – the assets added when it was created.
When editing the asset list, you can:
Remove a selected asset by clicking the bin icon.
Add an asset to the ticket by clicking the +Asset button.
Because an asset is assigned to a defined category, the system fills that field in automatically. If you want to add an asset from a different category, select the right one from the drop-down list.
Besides category, you can use other filters such as name, model, serial no., inventory no. and location.
Warranty status follows an asset throughout the whole ticket lifecycle: it is shown when the ticket is created, in the Assets tab and in the notifications sent to vendors and responsible people. A separate app setting adds the asset list to the Excel files exported with tickets – which makes it easier to report warranty status for the assets being repaired.
You enable these settings in the App settings submodule, Tickets section.
Who can open the Assets tab – and what they can do there – depends on the permissions below.
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows the user to link an asset to an existing or a new ticket. |
Inspection - Inspections |
| Allows the user to remove assets from a ticket. |
Cost tab
The Cost tab is where additional ticket costs go – the ones that do not come from visit actions.
When the CostMarkup app setting is enabled, the Add cost form shows a Margin field – prefilled with the default value from CostMarkupDefaultValue. The Final cost is recalculated automatically, in real time. The Cost tab then shows the Original cost, Margin and Final cost of each item, and the tickets list shows the total Final cost. The margin value is configured separately for each instance in App settings.
When the TicketInvoiceAdding app setting is enabled, invoices can be added to tickets. You enable this setting in the App settings submodule, Tickets section.
Who can open the Cost tab – and what they can do there – depends on the permissions below.
Permission section | Permission name | Description |
Ticket - Tickets |
| Gives the user access to the Cost tab. |
Acct - Settlements |
| Gives the user access to the Cost type defined in Cost and revenue types. |
Offer tab
The Offer tab is where costs are accepted or rejected. Users with acceptance rights decide on the offer according to the path configured in the Acceptance matrix.
The tab also lets you edit the offer. Click the Restart button, then click the pen icon next to the offer amount.
Note
After being edited, the offer goes through the acceptance process again.
People with acceptance rights receive an email asking for their acceptance, and observers are informed that the cost has been accepted or rejected. The message also includes the approver's comments and recommendations, along with the list of approvers.
Who can open the Offer tab – and what they can do there – depends on the permissions below.
Permission section | Permission name | Description |
Ticket - Tickets |
| Gives the user access to view the Offer tab. |
Ticket - Tickets |
| Gives the user access to accept or reject a cost. |
Ticket - Tickets |
| Allows tenants to view the Offer tab. |
Ticket - Tickets |
| Allows the user to request cost acceptance. |
Ticket - Tickets |
| Allows the user to download an attachment added to the offer from the interface. It also attaches the file to the email notification. |
Ticket - Tickets |
| Allows the user to restart the acceptance. |
Ticket - Tickets |
| Allows the user to edit the offer. |
The table below lists the app settings that affect how the Offer tab works.
App settings section | Setting name | Description |
Tickets |
| When enabled, the setting allows the user to add recommendations to a cost. |
Tickets |
| When enabled, the setting forces the user to give a reason for rejecting a cost. |
Tickets |
| When enabled, the setting requires all users with acceptance rights to accept the offer or the additional works. |
Tickets |
| When enabled, the setting shows a message in the Offer tab informing users that acceptance is not required. |
Tickets |
| When enabled, the setting triggers cost acceptance notifications to observers. |
Acceptance tab
The Acceptance tab is visible only for the Notification of Work ticket type and replaces the Offer tab. It lets you manage additional works and verify the acceptance path for works approval. Users with acceptance rights decide on the additional works according to the path configured in the Acceptance matrix. Works approval can be based solely on a matrix that excludes costs.
When the AlwaysUsePriorityInAccept app setting is enabled, all users with acceptance rights have to accept the offer or the additional works. You enable this setting in the App settings submodule, Tickets section.
Users with acceptance rights receive an email notification that their acceptance is required. Observers receive an email notification that the additional works added to the ticket have been accepted or rejected. The email notification also includes the comments and recommendations added by the approver.
Who has access to the Acceptance tab and what actions they can perform there depends on the permissions below.
Permission section | Permission name | Description |
Ticket - Tickets |
| Allows the user to view the Acceptance tab and accept the ticket. |
Ticket - Tickets |
| Gives the user access to Master data → Tickets → Acceptance matrix and its features. |
Form tab
The form describes in detail the scope of work to be done within the ticket. It is usually presented as a set of questions.
In the Form tab you answer the questions or edit the answers – you can also print the form.
When you enable the MultipleForms app setting (App settings submodule, Tickets section), the Additional form on ticket option appears in the New form submodule. Selecting it lets you add a second form to the ticket.
Note
The answers given in the form are included in the ticket report.
Who has access to the Form tab and what actions they can perform there depends on the permissions below.
Permission section | Permission name | Description |
Surveys - Surveys/Forms |
| Gives the user access to the Form tab. |
Surveys - Surveys/Forms |
| Allows the user to edit the form after the ticket has been accepted in the Acceptance tab. |
Surveys - Surveys/Forms |
| Allows the user to edit an answer in the Form tab, excluding closed tickets. |
Surveys - Surveys/Forms |
| Allows the user to edit an answer in the Form tab regardless of the ticket status. |
Inventory tab
The Inventory tab connects the ticket with your virtual warehouse in Singu FM, so the parts used on the ticket go straight into the records.
The table below shows the options available in the Inventory tab.
Option | Description |
+Requisition | Add a requisition for parts. |
+GDN - Goods dispatch note | Add a goods dispatch note (GDN). |
Only users with the ServiceWarehouseAccess permission have access to this tab and its features. You set this permission in the User/Permissions entity, Ticket - Tickets section.
Frequently asked questions
Why can't I see a button, or change the status?
If you cannot see a button or change the status, it is usually a matter of permissions – you do not have access to that action. Ask the person who manages permissions in your organisation – your administrator – to grant it.
Why can't I see a particular ticket, or all tickets?
If you cannot see a ticket, it is usually because you are not involved in it. By default you only see the cases you created and those where you are the responsible person or an observer. Full visibility comes with the ShowOtherPeopleCases permission; you can also ask to be added as an observer.
What is the difference between an offer and a cost on a ticket?
An offer and a cost are two different things. You add an offer with the +Cost button and it goes through acceptance in the Offer tab (its value is the Cost value). The Cost tab is for direct, additional costs with no acceptance, which add up to the Invoiced value.
Why can't I accept an offer or add a cost?
If you cannot accept an offer or add a cost, check two things: whether you have the right permission (acceptance requires CostAccept, adding a cost – CostAcceptanceRequest) and whether an acceptance matrix is configured for that ticket. If something is missing, contact the person who manages permissions in your organisation.
How do I put a ticket on hold without breaching the SLA?
Set the status to Suspended and fill in the Suspended until field. Whether that protects the deadline depends on one application setting. With OnHoldUpdatesTicketSLA on, the planned completion date moves to the end of the day you entered, so the waiting time does not count as delay. With it off, the date stays as it was and the ticket keeps collecting delay while it waits. The response deadline is never paused in either case.
How do I add a cost to a ticket?
To add a cost, open the ticket and click +Cost to attach an offer. Once added, it goes to acceptance in the Offer tab.
What is the acceptance matrix?
The acceptance matrix is a setting that decides who has to accept a cost before it is approved. It is configured by an administrator in the Tickets module.
PostAdd is switched on but the user still cannot add a note. Why?
The usual cause is an exception set on that one account. A permission assigned directly to the user takes precedence over the role and can remove what the role grants, and the role listing does not show it. Ask whoever manages permissions at your organisation to check that account on the Users / Permissions tab.
Two other things are worth ruling out. A closed or cancelled ticket takes no notes until it is reopened. An external-service user also needs the PublicNotesForExternalServices setting, which Singu support switches on.
