Maintenances — User Guide
Module: Fixed Equipment
Audience: IT administrators, facilities staff, asset managers, finance reviewers
Version: 1.0.0
Last updated: 2026-07-22
Overview
Maintenances lets you log service work performed on company assets — routine maintenance, repairs, upgrades, calibration, PAT testing, and vendor support. Each record captures who did the work (supplier), what was done, when it happened, and how much it cost.
Maintenance costs can affect depreciation calculations for the linked asset. You can also create maintenance records while processing audits or return orders for repair, so the service history stays tied to the original workflow.
Prerequisites
| Task | Permission |
|---|---|
| View the maintenances list | Fixed Equipment → Maintenances → View (or View own) |
| Add a maintenance record | Fixed Equipment → Maintenances → Create |
| Edit a maintenance record | Fixed Equipment → Maintenances → Edit |
| Delete a maintenance record | Fixed Equipment → Maintenances → Delete |
Setup before logging maintenance:
- Assets must exist in the register (physical assets, not licenses).
- Settings → Suppliers should list vendors who perform the work.
Step-by-step: View and filter maintenances
- Go to Fixed Equipment → Maintenances.
- Use the filters at the top:
- Maintenance type — e.g. Repair, Calibration
- From date / To date — filter by start date
- The table refreshes when you change a filter.
Expected result: A list of maintenance records with asset name, serial, location, type, title, dates, notes, and cost.
Step-by-step: Add a maintenance record (global list)
- On the Maintenances page, click Add.
- Complete the form:
- Asset (required) — select the equipment serviced
- Supplier (required) — vendor who performed the work
- Maintenance type (required) — see types below
- Title (required) — short description of the work
- Start date (required)
- Completion date (optional)
- Warranty improvement (optional) — check if the work extended warranty coverage
- Cost — amount paid for the service
- Notes — additional detail
- Click Submit.
Expected result: The record appears in the list. If the asset is on a depreciation schedule, future depreciation may recalculate to include this cost (see Depreciations guide).
Step-by-step: Add maintenance from an asset
- Open Fixed Equipment → Assets and click View on an asset.
- Open the Maintenances tab.
- Click Add and complete the same form (asset is pre-selected).
- Click Submit.
Expected result: The record appears on that asset's maintenance tab and in the global Maintenances list.
Step-by-step: Edit or delete
From the global list
- Find the row and click Edit in the row menu.
- Update fields and Submit, or click Delete to remove the record.
From the asset tab
- On the asset's Maintenances tab, use Edit or Delete on the row.
Bulk delete (global list only)
- Select checkboxes on multiple rows.
- Click Bulk delete and confirm.
Maintenance types
| Type | Typical use |
|---|---|
| Maintenance | Scheduled preventive service |
| Repair | Fix after failure or damage |
| Upgrade | Hardware or capability improvement |
| PAT test | Portable appliance testing (electrical safety) |
| Calibration | Measurement accuracy verification |
| Software support | Vendor software maintenance |
| Hardware support | Vendor hardware maintenance contract work |
Creating maintenance from other workflows
During an asset audit
When reviewing an audit request, you can create a maintenance record for a specific asset line. The system links that maintenance entry to the audit item and returns you to the audit screen after save.
From a return order (maintenance/repair)
For approved return orders marked return for maintenance/repair, each asset line shows a wrench button. Use it to create or edit the linked maintenance record. The cost can later be included when generating a customer estimate from the order.
How maintenance affects depreciation
When an asset has a depreciation profile assigned, maintenance costs recorded in a given month can increase the amount the system depreciates in remaining months. Depreciation recalculates when:
- The daily system job runs, or
- Someone opens Fixed Equipment → Depreciations
See the Depreciations user guide for full detail.
Column reference (global list)
| Column | Meaning |
|---|---|
| Asset name | Equipment that was serviced |
| Serial | Asset tag / serial number |
| Location | Where the asset is currently checked out or stored |
| Maintenance type | Category of service work |
| Title | Short description |
| Start date | When service began |
| Completion date | When service finished (if applicable) |
| Notes | Free-text detail |
| Warranty | Reserved column (not currently populated in the list) |
| Cost | Service cost in base currency |
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| Cannot see Add button | Missing Create permission | Ask admin to grant Maintenances → Create |
| Asset not in dropdown | Asset may be inactive or wrong type | Verify asset exists and is active in Assets list |
| Supplier missing | No suppliers configured | Add vendor under Settings → Suppliers |
| Depreciation unchanged | Calculation not refreshed | Open Depreciations page or wait for daily cron |
| Edit from audit did not re-link | Linking runs on first create only | Create once from audit context; edit from Maintenances menu afterward |
| Cost shows with currency symbol in edit box | Display formatting from server | Re-enter numeric cost if save fails |
Related guides
- Assets — asset register and detail tabs
- Depreciations — how maintenance cost adjusts depreciation