Maintenance Codes

Maintenance codes classify the work recorded on Repair Work Orders across four dimensions. Together, they provide a consistent vocabulary for analysing maintenance activity in reports.

The four dimensions are:

Dimension	What it captures	Example
Repair Type	The category of repair performed	Mechanical, Electrical, Body
Work Completed	The specific work that was done	Replace filter, Adjust brakes
Repair Reason	Why the work was needed	Wear and tear, Scheduled service
Repair Cause	What caused the issue	Age/deterioration, Operator error

Repair Type is configured separately in the Repair Types & Questionnaires page — see Repair Types. This article covers Work Completed, Repair Reason, Repair Cause, and the Maintenance Code Mappings that link all four together.

Before creating new codes or mappings, check whether what you need already exists. Type into the relevant field on a Work Order or search the Maintenance Code Mappings table in the Maintenance Codes page.

The Maintenance Codes Page

The Maintenance Codes page is the central place for managing all code elements and mappings.

Navigate to: System Administrator Menu → Configuration → Maintenance Codes

The page has two sections:

Maintenance Code Mappings — the full list of mappings that link a Repair Type to a Work Completed, Repair Reason, and Repair Cause. These are what appear as selectable options on a Repair Work Order.
Maintenance Code Elements — the full list of individual Work Completed, Repair Reason, and Repair Cause code records.

Creating Code Elements

Each of Work Completed, Repair Reason, and Repair Cause is a separate record. Create them before building mappings.

Work Completed

From the Maintenance Codes page, select New Work Completed in the Maintenance Code Elements panel.
Enter a Work Completed name.
Save the record.

Repair Reason

From the Maintenance Codes page, select New Repair Reason in the Maintenance Code Elements panel.
Enter a Repair Reason name.
Save the record.

Repair Cause

From the Maintenance Codes page, select New Repair Cause in the Maintenance Code Elements panel.
Enter a Repair Cause name.
Save the record.

Creating a Maintenance Code Mapping

A Maintenance Code Mapping links a Repair Type to a Work Completed, Repair Reason, and Repair Cause. When a technician selects a Repair Type on a Repair Work Order, the available mappings are filtered to those linked to that type.

From the Maintenance Codes page, select New Maintenance Code Mapping in the Maintenance Code Mappings panel.
Select the applicable Repair Type.
Select or create the applicable Work Completed, Repair Reason, and Repair Cause.
Save the record.

Note: Not all four fields need to be populated on every mapping — you can leave fields blank if your organisation does not use all dimensions.

Bulk Importing Codes

If you have a large number of codes to add, the Maintenance Code Element Import tool lets you import Work Completed, Repair Cause, Repair Reason, and Repair Type codes from CSV files in a single operation.

Navigate to: System Administrator Menu → Configuration → Maintenance Codes, then select the import tool.

[VERIFY] Confirm the exact button or link label that opens the Maintenance Code Element Import from the Maintenance Codes page.

The import tool provides separate CSV importers for each code type:

Import Work Completed Codes
Import Repair Cause Codes
Import Repair Reason Codes
Import Repair Type Codes

A separate Maintenance Code Mapping Import is also available for bulk-creating mappings once your code elements are in place.