Work Order Statuses

Purpose

Work Order statuses are the lifecycle states of a work order. The statuses themselves (the open status, Close / Invoice, Cancel and Estimate) are set up by the system and are not edited here. Sub-statuses give finer tracking within those states and are managed on this page.

The page

Administration > Service & Faults > Work Order Statuses lists every sub-status. Click a row to open it. New Sub Status on the toolbar adds one.

Sub Statuses

Overview

Sub-statuses provide detailed tracking within work order statuses. Each sub-status must be associated with one or more statuses and can have special flags for automatic assignment.

Creating a Sub-Status

  1. Click the New Sub Status button in the toolbar
  2. Enter the sub-status name
  3. Select which statuses this sub-status can be used with by checking the boxes
  4. Click Save

Editing a Sub-Status

  1. Click the sub-status row
  2. Update the name if needed
  3. Pick a Colour if you want one (see below)
  4. For Open sub-statuses only, you can set special flags (see below)
  5. Click Save

Note: When editing, you cannot change which statuses are associated. This is only set during creation.

Delete is at the left of the window, for a sub-status that is not locked. A sub-status in use by work orders cannot be deleted.

Colour

A sub-status can be given a colour. Wherever the sub-status is shown - the work order list, the overview, the status dropdown on a work order and reports - its name then appears as a pill in that colour, which makes statuses easier to tell apart at a glance.

  1. Open the sub-status
  2. Click the Colour field and pick a colour from the palette
  3. Click Save

To remove a colour, click the Colour field and choose No colour. Sub-statuses without a colour are shown in a plain grey pill.

Other pages you already have open pick up a colour change the next time they are loaded.

See Colours for the colours available and where they appear.

Default and Allocated Flags

What They Do

  • Default: This sub-status is automatically assigned to new unallocated work orders
  • Allocated: This sub-status is automatically assigned when a work order is allocated to a technician

Requirements

  • Only sub-statuses associated with "Open" (normal) statuses can have these flags
  • Only ONE sub-status can be Default at a time
  • Only ONE sub-status can be Allocated at a time
  • You cannot switch these flags off - you can only move them to a different open sub-status

Setting a Flag

  1. Open an open sub-status
  2. Switch on Default or Allocated (side by side under the name and colour)
  3. Click Save
  4. The system automatically removes the flag from the previous sub-status and sets it on this one

Deletion Protection

  • You cannot delete a sub-status that has the Default flag set
  • You cannot delete a sub-status that has the Allocated flag set
  • To delete, first move the flag to another open sub-status

Locked Sub-Statuses

Some sub-statuses display a 🔒 (lock) icon. A locked sub-status cannot be renamed or deleted - the only thing you can change is its Colour. Sub-statuses are locked for two main reasons:

System-Required Statuses

Certain sub-statuses are required for core system functionality and must not be modified or removed. These ensure the system operates correctly across all accounts.

API Integration Statuses

Sub-statuses that are hardcoded in custom API integrations are locked to prevent breaking external system connections. These integrations rely on specific sub-status IDs to function correctly.

Important: If you need to modify a locked sub-status, contact your system administrator. Changes to locked statuses may require code updates to maintain API integrations.

Sub-Status Types

Open Sub-Statuses: Associated only with normal statuses (no close/invoice/cancel/estimate)

  • Can have Default and Allocated flags
  • Used for active work order tracking
  • Examples: "New", "In Progress", "Awaiting Parts"

Closed Sub-Statuses: Associated with close/invoice, cancel, or estimate statuses

  • Cannot have Default or Allocated flags
  • Used for completed work order tracking
  • Examples: "Completed", "Invoiced", "Cancelled"

Grid Columns

  • Name: The sub-status name, shown in its colour if it has one
  • Associated Statuses: Which statuses this sub-status can be used with
  • WO Count: Number of work orders currently using this sub-status
  • Default: Shows ✓ if this is the default sub-status
  • Allocated: Shows ✓ if this is the allocated sub-status
  • Locked: Shows 🔒 if the sub-status is locked (system-required or used by API integrations)

Business Rules

Automatic Sub-Status Assignment

When work orders are created or updated, the system automatically assigns sub-statuses based on:

  1. If the work order is not allocated → uses the Default sub-status
  2. If the work order is allocated → uses the Allocated sub-status

This ensures consistent tracking across all work orders without manual intervention.

Status Selection Logic

When selecting or deselecting statuses during sub-status creation:

  • If you select a Close or Invoice status, all other Close/Invoice statuses are automatically selected
  • If you deselect a Close or Invoice status, all other Close/Invoice statuses are automatically deselected
  • This ensures consistency in sub-status behavior for completed work orders