Page Contents
- 1. About Field Service Management
- 2. Getting Started (Administrator)
- 3. Staff and Crews
- 4. Assets
- 5. Tickets
- 6. Work Orders
- 7. Service Desk (Dispatch)
- 8. My Work (Field Staff Guide)
- 9. Spares (Engineer Stock)
- 10. Service Charges
- 11. Delivery Runs and Staff Cash
- 12. Reports and Operations
- 13. Troubleshooting and FAQ
- 14. Status Reference
1. About Field Service Management
1.1 How the pieces fit together
A typical job flows like this:
- You sell a serviceable item on a Sales Invoice → FSM creates an Asset (the customer’s unit) with its warranty.
- The customer reports a problem → the office raises a Ticket. The ticket has an SLA deadline based on its priority.
- If someone must go on site, the office raises a Work Order from the ticket and assigns Staff (or a Crew).
- Each trip to site is a Visit. The engineer records the report, photos and parts in My Work.
- Spare parts are issued to the engineer from Spares; fitted parts leave stock and removed parts come back.
- Any Charges are decided (warranty, free or customer pays). The work order is closed, which resolves the ticket.
- Managers follow everything on the Service Desk, Reports and Operations pages.
1.2 Key terms
| Term | Meaning |
|---|---|
| Asset | A specific unit owned by a customer (for example one air conditioner with serial SN-1001). Created automatically from sales. |
| Ticket | A customer request or complaint. Numbered TKT-n. Has a priority and SLA deadlines. |
| Work Order (WO) | Field work to be done, usually raised from a ticket. Numbered WO-n. Can be on-site (customer address) or bench (at your branch). |
| Visit | One trip to do the work. A work order can have several visits. |
| Task | An assignment of one staff member to a ticket, work order or delivery. Shown in that person’s My Work. |
| Staff | People who do field work. A staff member with a login (role “Field Staff”) uses My Work. |
| Crew | A named group of staff that can be assigned to a work order in one step. |
| SLA | Service Level Agreement: “respond within” and “resolve within” hours for each priority. |
| Holding | Spare parts currently with an engineer (issued from the store but not yet fitted or returned). |
| Service charge | An amount for a visit fee, travel, part or other work, with who pays: Customer, Warranty, AMC or Free. |
| Delivery run | A list of invoices / delivery challans one staff member delivers on a date, grouped into stops. |
1.3 Who uses what
| Role | Typical user | Main screens |
|---|---|---|
| Administrator | Owner / admin | Add-ons, Users & Roles, FSM Settings |
| Service desk (Desk rights) | Office coordinator | Service Desk, Tickets, Work Orders, Assets, Spares, Charges, Reports, Operations, Staff, Crews |
| Field Staff | Engineer / technician / delivery staff | My Work (on phone or browser), My Spares |
1.4 Finding FSM in the menu
- Left menu → Field Service: Service Desk, My Work, Tickets, Work Orders, Assets, Charges, Staff, Spares, Settings.
- Top FSM bar: Service Desk · My Work · Tickets · Work Orders · Assets · Reports ▾ (SLA Performance, Staff Productivity, Ticket Aging, Service Revenue) · More ▾ (Charges, Operations, Staff, Crews, Settings, Compact / Comfortable spacing).
- Crews and Operations are reached from the More ▾ menu.
Note: Field Staff users only see My Work. Desk users see the office screens. What you see depends on the rights in your user role.
1.5 Not available in this release
- AMC (annual maintenance contracts), the Item Profiles screen and the Staff timer (Start/Stop time, planned start times) are switched off. Work is planned by date only.
- A service charge cannot be turned into a Sales Invoice from FSM. If the customer must pay, raise a normal Sales Invoice and then Waive the FSM charge.
- Assets cannot be added by hand; they come from sales invoices.
2. Getting Started (Administrator)
2.1 Enable the add-on
- Go to Settings → Add-ons.
- On Field Service Management, click Enable.
- The card shows Operational and “Field Service” appears in the left menu.
Enabling FSM creates default settings and a system role called Field Staff.
2.2 Disable the add-on
FSM can only be disabled when no work is open. Before clicking Disable, make sure there are:
- no active staff tasks (complete, reassign or retire them),
- no tickets in Open / In Progress / Waiting,
- no work orders that are not Closed or Cancelled,
- no service charges in “To be billed”.
Important: If disable fails with ADDON_ACTIVE_WORK_EXISTS, something above is still open. Open More ▾ → Operations to see open tickets, work orders and unbilled charges. History is always kept after disabling.
2.3 User rights
| Right | Gives access to |
|---|---|
| Field Service Settings (FSMSET) | FSM Settings. View = read only, Edit = save. |
| Field Service Desk (FSMDSK) | All office screens. View / Add / Edit control what the user can open, create and change. |
| Field Service My Work (FSMWRK) | My Work for staff. The user must also be linked to an active Staff member. |
2.4 FSM Settings
- Go to Field Service → Settings.
- Review each section and click Save Settings. You will see “Field Service settings were saved.”
| Setting | Default | What it does |
|---|---|---|
| Completed history days | 30 | How long staff can still see completed tasks in My Work (0–365). |
| Flag timer after (hours) | 12 | For the staff timer (off in this release). |
| Keep completed detail (days) | 730 | Cut-off used by the retention clean-up on Operations (90–3650). |
| Create Work Order before (days) | 7 | For AMC visits (off in this release). |
| Ticket SLA | Urgent 1/8 h · High 4/24 h · Normal 8/72 h · Low 24/168 h | Respond within / Resolve within hours per priority (1–720). Resolve cannot be shorter than respond. |
2.5 Make an item create assets
Only items with an FSM service profile (“track as asset”, optional default warranty) create assets when sold. In this release the Item Profiles screen is hidden, so ask your Output Books administrator or support to set the profile for each serviceable item.
Tip: For serial-numbered items, use the “identified” mode so every serial becomes its own asset.
3. Staff and Crews
3.1 Add a staff member
- Go to Field Service → Staff and click Add Staff.
- Enter Staff Name, Ledger Name and Contact Mobile (required). Email and address are optional.
- Click Save. The staff member is listed as Active.
Note: Staff are stored as Sales Rep type contacts but are kept out of the Manage → Sales Rep list on purpose. If a Sales Rep with the same name exists, you are asked whether to migrate that Sales Rep to Staff.
3.2 Give a staff member a login
- Go to Settings → Users and add a user.
- Choose the role Field Staff, then pick the staff member in the Field Staff picker.
- Enter email and password and save. When this user logs in, FSM opens on My Work.
3.3 Edit, copy, deactivate
- Use the row menu Edit ▾ → Edit / Copy / Deactivate / Delete.
- Deactivating keeps history, but new work cannot be assigned. It is blocked while the person still has an active task — reassign or retire the task first.
3.4 Crews
- Go to More ▾ → Crews and click New Crew.
- Enter the Crew name, tick at least two Members, and optionally choose a Lead.
- Click Save. To switch a crew off, use Edit and clear Crew is active.
When a crew is assigned to a work order, each active member gets their own task. Members who are already on the job or switched off are skipped and listed. Later changes to the crew do not move tasks already given out.
4. Assets
4.1 How assets are created
When a Sales Invoice is saved for a serviceable item, FSM creates one asset per unit (one per serial number for serialised items) and adds the sale warranty from the invoice date. Editing the invoice updates the assets; cancelling or deleting it moves the assets to Inactive (or Reconciliation Review if they already have service history). Assets are never deleted.
Important: Stock is checked as at the invoice date. If the sale is dated before the purchase that brought the item in, the invoice shows “Sorry, <item> is out of stock!”.
4.2 The Asset Register
- Go to Field Service → Assets.
- Use the tiles — Total Assets, Need Attention, With Open Tickets, In Service Workflow, With Company / OEM — as quick filters. Click a tile again to clear it.
- Use the status list (All statuses / Active / Inactive / Reconciliation Review) and the filter icon (customer, item, “Asset no / Invoice no” search).
- Click a row to open the asset.
If an invoice did not create its assets (for example the item profile was set later), click Review Missing, tick the invoices and click Reconcile Missing Assets. It is safe to run again.
4.3 Asset detail
The tiles show Asset status, Open issues, Warranty and Custody. Tabs: Overview, Contacts & site, Current issues, External service, Warranty, Audit trail.
Set the service site
- Open the Contacts & site tab and click Change site.
- Pick one of the customer’s addresses, or No service site (bench work).
- Enter an Audit reason (at least 3 characters) and click Save.
Note: Only the customer’s own addresses are listed. Add the address on the customer first if it is missing. Existing work orders keep the address they were created with.
Add a service contact
- On Contacts & site, click Add contact.
- Enter Name and Mobile (required), and optionally Role, Alternate phone, Email.
- Tick Primary service contact for the person engineers should call, then Save.
Change the asset status
- On Overview, click Change status.
- Choose New status, enter a Reason (3–500 characters) and click Save status.
Warranty
- If no warranty exists, the tab shows Record Initial Warranty: enter Start date, End date, notes and Audit reason, then Save Warranty version.
- To change one, choose Adjust terms (new dates) or Void Warranty. Each change is saved as a new version; earlier versions stay in the history.
Send an asset to an outside company (OEM / repair centre)
- Open External service and click Send to company.
- Enter Service company / OEM, Purpose (Service / repair or Replacement), Sent date, and optionally Expected back and Reference / RMA No.. Click Save.
- When it comes back, use the row menu Resolve ▾ → Returned / Replaced / Cancel, enter Resolution notes and Save.
Only one external record can be open per asset. The asset status does not change.
5. Tickets
5.1 Raise a ticket
- Go to Field Service → Tickets and click New Ticket (also available on the Service Desk).
- Choose the Customer and type What’s the problem?.
- Choose Priority: Low, Normal, High or Urgent.
- Optionally choose Send to (staff) and the On date. Leave Decide later to assign it later.
- Open More details to choose Which item (the asset), Where (address) and Notes.
- Click Save. The ticket opens as TKT-n with status Open.
Tip: For equipment rented from you, choose Rented from us in More details and pick the rental order and units instead of an asset.
5.2 SLA deadlines
Respond-by and resolve-by times are set from the priority when the ticket is created (see Settings). The badge shows On track, Due soon (less than 25% of the time left), Breached, Met or Missed. Adding a note, assigning staff, changing priority or raising a work order counts as the first response.
5.3 Working on a ticket
Open a ticket to see its cards (Customer & Item, Deadline, Assigned staff, Details) and tabs (Overview, Activity, Work Orders, Visits, Parts).
Use Actions ▾:
| Action | What it does |
|---|---|
| Assign staff | Choose Staff and On date, click Assign. The ticket appears in that person’s My Work. |
| Change priority | Pick the new priority, optional reason, Save. Deadlines are recalculated from the creation time. |
| Add a note | Type in Note for the office only and click Add note. Notes never appear on the service report. |
| New Work Order | Raises a work order linked to this ticket (same as the green Work Order button). |
| Close ticket / Cancel ticket | Enter a Reason and confirm. Cancel also retires the ticket’s staff tasks. |
| Reopen ticket | Only for Resolved or Closed tickets. Returns the ticket to Open. |
Note: A ticket cannot be closed while one of its work orders is still open, unless the ticket is already Resolved. Close or cancel the work order first.
5.4 How a ticket’s status changes
| Event | Ticket becomes |
|---|---|
| Created | Open |
| A work order is raised, or staff choose “Request field work” | Waiting |
| Staff choose “Resolve at desk”, or the last work order is Service Completed | Resolved (automatically) |
| All its work orders are cancelled, or staff choose “Handoff to Unassigned” | Open |
| Close / Cancel / Reopen from Actions | Closed / Cancelled / Open |
6. Work Orders
6.1 Create a work order
- From a ticket, click the green Work Order button — or go to Field Service → Work Orders → New Work Order.
- Type What needs doing? and choose the Priority.
- Check More details: the item and address come from the ticket. With an address it is an on-site work order; without one it is bench work at your branch.
- Optionally choose Send to to assign a person straight away. Click Save.
The customer’s address, phone and primary service contact are copied onto the work order when it is created.
6.2 Assign staff or a crew (plan a visit)
- Open the work order. In Timeline, click Add Visit.
- Choose One person (pick Staff) or A crew (pick Crew).
- Choose the Work date and click Assign & plan Visit (or Send crew).
- Visit 1 is Planned and the work order becomes Assigned. The staff see it in My Work.
6.3 Split into a child work order
Use Manage Work Order → Split into child when part of the job needs separate tracking (for example a second team). The child keeps the parent’s customer and ticket. A child cannot be split again.
6.4 Close a work order
The Manage Work Order card shows a “To close” checklist:
- Field work is Service Completed (the engineer finished with Fixed or No fault found).
- No assignments still open.
- Billing is settled (no charges “To be billed”).
When all three are ticked, click Close Work Order. A linked ticket is resolved automatically.
6.5 Cancel a work order
Click Manage Work Order → Cancel, enter a reason and confirm Cancel Work Order. Staff tasks are retired, the open visit is cancelled, unbilled charges are cancelled and the ticket returns to Open if no other field work remains. A closed work order cannot be cancelled.
6.6 Work order statuses
| Status | Meaning |
|---|---|
| Open | Created, nobody assigned yet. |
| Assigned | Staff assigned, visit planned. |
| In Progress | Work has started. |
| Waiting | A visit ended without finishing (waiting for parts, customer not available, needs another visit). |
| Service Completed | The work is done (Fixed / No fault found). Ready for charges and closing. |
| Closed | Finished and settled. |
| Cancelled | Not going ahead. |
7. Service Desk (Dispatch)
Field Service → Service Desk is the coordinator’s home page. The header has New Ticket, New Work Order and Plan Delivery. Tiles show open tickets, open work orders, overdue visits, parts to resolve and unbilled service.
7.1 Dispatch & Visits
- Open the Dispatch & Visits tab.
- Choose a Queue: Unassigned, Overdue, Today, Unscheduled, Upcoming (Completed in List view). Filter by Work type and Staff, then Apply.
- On an unassigned card, choose Staff and Work date, then Assign.
| Card button | Use it to |
|---|---|
| Save schedule | Change the work date of an assignment. |
| Carry +1 day | Move unfinished work to the next day (keeps the schedule history). |
| Reassign | Give the work to a different staff member. |
| Retire | Remove a staff member from the job. History is kept. |
Note: If someone else changed the same task, you will see “The Task changed; refresh Dispatch.” — click Refresh and try again.
7.2 Planner
The Planner tab shows staff rows by Week or Month. Drag a booking to another day to reschedule it, to another staff row to reassign it, or drag an unassigned card into a cell to assign it.
7.3 Field Day
The Field Day tab lists every staff member for a date: planned and completed work, customers, goods delivered, cash and bank collected and Cash in hand. When a staff member hands in their cash, click Submitted and confirm. (The Service Desk home page is shown in section 1.4.)
8. My Work (Field Staff Guide)
8.1 Your task list
Log in and open My Work. Tabs: Today, Overdue, Unscheduled, Upcoming, Completed. Buttons at the top: New Ticket, New Work Order, My Spares. Tap a task to open it.
8.2 Work order task — a normal visit
- Open the task. Check the customer, address, contact and item.
- In Visit N report, fill Diagnosis / reason and Work performed / attempt details. Click Save Visit N report at any time.
- Add photos with Take photo or Choose from gallery (JPEG, PNG or WebP, up to 10 per visit, 8 MB each).
- Record parts under Parts used on Visit N (see 8.4).
- Choose How did it go?: Fixed, No fault found, Waiting for parts, Needs another visit, Customer not available or Could not complete.
- Click Finish job & complete Task when the job is done, or Finish this Visit if you must come back.
| Button | When to use | Result |
|---|---|---|
| Finish this Visit | This trip is over but the job is not (for example waiting for parts). | Visit closes; your task stays open. Press New Visit when you go back. |
| Finish job & complete Task | The job is finished. | Visit and task complete. With Fixed / No fault found the work order becomes Service Completed and the ticket Resolved. |
| New Visit | You are going back for another trip. | Opens Visit 2, 3 … |
Note: Diagnosis is required for every outcome except Customer not available. If a colleague is still on the same visit, only the last person finishes the visit.
8.3 Ticket task — helpdesk outcome
- Open the ticket task and, if needed, save a visit report.
- Under Helpdesk outcome, choose a Named action:
- Resolve at desk — solved by phone; enter the Final internal comment.
- Request field work — someone must go on site; enter a reason. The office raises a work order.
- Handoff to Unassigned — you cannot take it; enter a reason. It returns to the office queue.
- Click Post Helpdesk outcome.
8.4 Parts on a visit
- Request a spare — ask the office for a part you do not have.
- Replacement Items — record the spare you fitted (from your holding) and the old part you removed, and what happened to the old part: Returned to company, Customer kept it or Scrapped.
- Fitting a part takes it out of company stock. A removed part “Returned to company” stays with you until you hand it back.
8.5 Deliveries
Delivery tasks list stops. For each stop tap Delivered or Not delivered (a reason is required). The task completes when no stops are pending. Cash you collect is recorded as a normal receipt from your login.
8.6 My Spares
My Spares shows Spares with you, My spare requests and My replacements. Use Return spares to send unused parts back, Hand back for removed parts, and Withdraw to cancel a request. The office confirms returns.
9. Spares (Engineer Stock)
Field Service → Spares tracks parts held by engineers. Header buttons: Adjust, Receive return, Record replacement, Issue spares. Tabs: Holdings, Movements, Replacements.
9.1 Issue spares to an engineer
- Click Issue spares (or Issue on a request in Spare requests).
- Choose the Staff, add the items and pick serial numbers for serialised parts.
- Click Issue spares. The parts appear in that person’s holding.
Note: Issuing does not change company stock. Stock is reduced only when the part is fitted on a visit.
9.2 Returns and removed parts
- Returns to confirm — returns sent by staff. Click Confirm received or Reject.
- Removed parts with Staff — old parts brought back from site. Click Receive to put them into company stock at your branch.
- Receive return — record a return directly at the desk (no confirmation step).
9.3 Requests, adjustments and history
- Spare requests — Issue or Decline each request.
- Adjust — add to or remove from a holding with a reason (one serial at a time).
- Movements — every issue, return, fit and adjustment. Replacements — every part fitted / removed, by unit and job.
10. Service Charges
10.1 Add a charge to a work order
- Open the work order, then Billing & Financials → Charges.
- Click Add Charge. Choose What for (Visit fee, Travel, Other) and Who pays.
- Enter the Amount (before tax). Under More details you can change the description, quantity and visit.
- Click Save.
| Who pays | Status | Notes |
|---|---|---|
| Customer pays | To be billed | Must be waived or cancelled before the work order can close (see 1.5). |
| Warranty | No bill needed | Only allowed if the asset has a valid warranty on the visit date. |
| Free (goodwill) | No bill needed | Requires Why is it free?. |
| AMC | — | Not available in this release. |
To charge a replaced part as a service, use Replaced parts → Charge customer on the same page. No item is sold and stock is not changed.
10.2 Waive or cancel charges
- Go to More ▾ → Charges.
- Under To be billed, click Waive or Cancel, type the reason and click OK.
- Work orders with nothing left to settle appear under Jobs ready to close.
11. Delivery Runs and Staff Cash
11.1 Plan a delivery run
- On the Service Desk, click Plan Delivery.
- Choose the Staff and Date.
- Search by Invoice / customer / PIN and tick the documents to deliver (sales invoices and delivery challans).
- For credit invoices, tick Collect and enter the amount to collect (up to the outstanding amount).
- Click Save & Assign. Documents at the same address are grouped into one stop.
No accounting is posted by the run. Collection is an instruction; the staff member records the actual receipt.
11.2 Settle staff cash
- Open Service Desk → Field Day for the date.
- Check the staff member’s Cash in hand.
- When the cash is handed over, click Submitted and confirm.
12. Reports and Operations
12.1 Reports
Open Reports ▾, choose a Period (Last 30 days, This month, Last month, Last 3 months, This year or Custom dates, up to 400 days) and use Export for CSV.
| Report | Shows |
|---|---|
| SLA Performance | Tickets by priority, on-time response and resolution %, and a late list. |
| Staff Productivity | Per staff and crew: completed tasks, jobs finished, first-time-fix % (jobs fixed in one visit). |
| Ticket Aging | Open tickets by age: 0-1, 2-3, 4-7, 8-30 and 30+ days. |
| Service Revenue | Charges billed, to bill, waived and free, by month, type and customer. |
12.2 Operations
More ▾ → Operations gathers everything that needs attention: open tickets, open work orders, overdue tasks, pending part returns and unbilled charges, plus:
- Sales Items missing Assets — tick invoices and click Reconcile Missing Assets to create missing assets.
- Old detail retention — enter days and click Preview days to see what can be cleared; Clear eligible detail permanently removes old completed detail (summary counts are kept). Use with care.
13. Troubleshooting and FAQ
13.1 Common messages
| Message | Why it appears | What to do |
|---|---|---|
| Sorry, <item> is out of stock! | The sale is dated before the purchase that brought the stock in. | Correct the invoice or purchase date. |
| Asset Register is empty after a sale | The item has no FSM service profile. | Ask support to set the item profile, then Review Missing → Reconcile Missing Assets. |
| Work Order WO-x is still open. Close or cancel it first, or resolve this Ticket. | Closing a ticket with open field work. | Close or cancel the work order first. |
| Resolve every Unbilled Service Charge before closing the Work Order. | A “Customer pays” charge is still To be billed. | Waive or cancel it on Charges. |
| Only a Service Completed Work Order can be closed. | The engineer has not finished the job. | The engineer must finish with Fixed or No fault found. |
| Complete every active field Task before closing the Work Order. | A staff task is still active. | Ask the engineer to complete it, or Retire it on the Service Desk. |
| Diagnosis or completion reason is required for this outcome. | Diagnosis was left empty. | Fill Diagnosis / reason. |
| The Task changed; refresh … / The Visit report changed; refresh … | Someone else updated the same record. | Refresh the page and repeat. |
| Reassign or retire this Worker’s active Tasks before deactivation. | Deactivating staff who still have work. | Reassign or retire their tasks first. |
| A Visit can hold up to 10 photos. / The photo is larger than 8 MB. | Photo limits. | Remove a photo or use a smaller image. |
| Collection amount cannot exceed the current invoice outstanding. | Collect amount too high. | Enter up to the outstanding amount. |
| ADDON_ACTIVE_WORK_EXISTS (disable) | Open FSM work exists. | See 2.2. |
13.2 Frequently asked questions
Why can’t I see a new staff member under Manage → Sales Rep?
By design. FSM staff are listed only under Field Service → Staff.
The engineer pressed “Finish this Visit” with Fixed — the task is still open.
Open the task and click Finish job & complete Task to close it.
Can one work order have several engineers?
Yes. Assign each person, or assign a crew. The visit closes when the last person finishes.
Why did the ticket become Resolved by itself?
Its last work order reached Service Completed. Review and click Close ticket.
Does issuing a spare reduce stock?
No. Stock is reduced when the part is fitted; a removed part received back is added to stock.
Can I charge the customer from FSM?
Not yet. Raise a normal Sales Invoice, then waive the FSM charge.
A delivered invoice disappeared from Plan Delivery.
Documents already in a pending or completed run are not offered again.
13.3 Contacting support
Please include the screen name, the record number (TKT-n, WO-n, AST-n, DL-n), the exact message shown, a screenshot and the time it happened.
14. Status Reference
| Record | Statuses |
|---|---|
| Ticket | Open · In Progress · Waiting · Resolved · Closed · Cancelled |
| Work order | Open · Assigned · In Progress · Waiting · Service Completed · Closed · Cancelled |
| Visit | Planned · In Progress · Completed · Cancelled |
| Visit outcome | Fixed · No fault found · Waiting for parts · Needs another visit · Customer not available · Could not complete |
| Task | Active · Completed · Retired |
| Asset | Active · Inactive · Reconciliation Review |
| Warranty | Active · Void (each change is a new version) |
| External service | Out · Returned · Replaced · Cancelled |
| Service charge | To be billed · No bill needed · Waived · Cancelled |
| Spare movement | Issued · Returned · Fitted · Adjusted · Removed · Handed back — Done / Pending / Rejected |
| SLA badge | On track · Due soon · Breached · Met · Missed |

























