Odoo 19 Maintenance Module:
Equipment Management

Your Maintenance Crew Is Firefighting. Your Equipment Knows When It Will Fail — You're Just Not Listening.

Every manufacturing plant has the same story: a critical CNC machine goes down at 2 PM on a Thursday, the production line stops, and a maintenance technician scrambles to find the right spare part while a supervisor calls the vendor. The repair takes 6 hours. The lost production costs $40,000. A week later, the post-mortem reveals the machine's vibration readings had been deteriorating for three weeks — but nobody was tracking them.

Odoo 19's Maintenance module closes this gap. It gives you a centralized equipment registry, automated preventive maintenance schedules, a structured corrective request workflow, and built-in MTBF/MTTR tracking that turns your reactive maintenance operation into a predictive one. And unlike standalone CMMS tools, it's natively integrated with Manufacturing, Inventory, and Purchase — so when a machine needs a spare part, the procurement chain activates automatically.

This guide walks through the full setup: registering equipment, configuring preventive schedules, handling corrective requests, reading MTBF/MTTR dashboards, connecting equipment to manufacturing work centers, and managing spare parts inventory. Every configuration shown is from production Odoo 19 instances running real manufacturing operations.

How to Build a Complete Equipment Registry in Odoo 19 Maintenance

The equipment registry is the foundation of everything. Every maintenance request, every schedule, and every KPI ties back to an equipment record. Getting this right means getting the hierarchy, categories, and metadata right from day one.

Enable the Maintenance Module

Navigate to Apps, search for "Maintenance," and install the module. If you're running Manufacturing, also install MRP Maintenance (mrp_maintenance) for work center integration.

# Install maintenance + MRP integration
./odoo-bin -c /etc/odoo/odoo.conf \
  -d production_db \
  -i maintenance,mrp_maintenance \
  --stop-after-init

Equipment Categories

Before adding individual machines, define your category taxonomy. Categories in Odoo 19 serve as templates — each category carries default maintenance team assignments, default technicians, and a color for Kanban views. A well-designed category tree reduces per-equipment setup time by 70%.

<odoo>
  <data noupdate="1">
    <record id="equip_cat_cnc" model="maintenance.equipment.category">
      <field name="name">CNC Machines</field>
      <field name="technician_user_id" ref="base.user_admin"/>
      <field name="color">4</field>
      <field name="alias_name">maint-cnc</field>
    </record>

    <record id="equip_cat_conveyor" model="maintenance.equipment.category">
      <field name="name">Conveyors</field>
      <field name="color">2</field>
      <field name="alias_name">maint-conveyor</field>
    </record>
  </data>
</odoo>

Registering Equipment

Each equipment record captures identity, location, ownership, and vendor information. The critical fields that most teams skip on initial setup — and regret later — are serial number, effective date, warranty expiration, and assigned work center.

Equipment = self.env['maintenance.equipment']

Equipment.create({
    'name': 'CNC Haas VF-2SS #001',
    'category_id': self.env.ref(
        'my_module.equip_cat_cnc'
    ).id,
    'serial_no': 'HAAS-VF2SS-2024-001',
    'model': 'VF-2SS',
    'partner_id': self.env.ref(
        'my_module.vendor_haas'
    ).id,
    'effective_date': '2024-06-15',
    'warranty_date': '2027-06-15',
    'location': 'Building A — Bay 3',
    'note': 'Spindle: 12,000 RPM. Coolant: flood + TSC.',
    'period': 30,       # Preventive every 30 days
    'color': 4,
})

Equipment.create({
    'name': 'Conveyor Belt — Assembly Line 1',
    'category_id': self.env.ref(
        'my_module.equip_cat_conveyor'
    ).id,
    'serial_no': 'CONV-AL1-2023-007',
    'effective_date': '2023-01-10',
    'location': 'Building B — Line 1',
    'period': 90,       # Preventive every 90 days
})

Corrective Maintenance Requests: From Breakdown to Resolution in a Structured Workflow

When equipment fails unexpectedly, speed matters. Odoo 19's corrective maintenance workflow gives you a Kanban pipeline that tracks every request from creation through diagnosis, repair, and closure — with full time tracking at each stage.

Creating Corrective Requests

Any user with Maintenance / User access can create a corrective request. There are three input channels:

• Manual — Maintenance → Maintenance Requests → Create, set type to "Corrective."
• Email — Send to the category's email alias. Odoo parses the subject and body into a request.
• Programmatic — Triggered from manufacturing work orders when an operator flags a machine issue mid-production.

class MrpWorkorder(models.Model):
    _inherit = 'mrp.workorder'

    def action_report_equipment_issue(self):
        """Operator clicks 'Report Issue' during production."""
        self.ensure_one()
        return {
            'type': 'ir.actions.act_window',
            'name': 'Report Equipment Issue',
            'res_model': 'maintenance.request',
            'view_mode': 'form',
            'target': 'new',
            'context': {
                'default_equipment_id': (
                    self.workcenter_id.equipment_ids[:1].id
                ),
                'default_maintenance_type': 'corrective',
                'default_name': (
                    f'[URGENT] {{self.workcenter_id.name}}'
                    f' — reported during '
                    f'{{self.production_id.name}}'
                ),
                'default_description': (
                    f'Work order: {{self.name}}\n'
                    f'Product: '
                    f'{{self.product_id.display_name}}\n'
                    f'Reported by operator at '
                    f'{{fields.Datetime.now()}}'
                ),
            },
        }

The Kanban Pipeline

The default Kanban stages in Odoo 19 Maintenance are: New Request → In Progress → Repaired → Scrap. For most manufacturing operations, we recommend adding two stages:

Priority and SLA Tracking

Odoo 19 supports a star-based priority system (0–3 stars). Extend it with custom SLA deadlines: map priority 0 to 72 hours, priority 1 to 24 hours, priority 2 to 8 hours, and priority 3 (critical) to 2 hours. Add a computed sla_deadline field on maintenance.request and a boolean sla_breached that flips when the deadline passes while the request is still open.

SLA_HOURS = {'0': 72, '1': 24, '2': 8, '3': 2}

@api.depends('priority', 'request_date')
def _compute_sla_deadline(self):
    for req in self:
        if req.request_date and req.priority:
            hours = self.SLA_HOURS.get(req.priority, 72)
            req.sla_deadline = (
                req.request_date + timedelta(hours=hours)
            )
        else:
            req.sla_deadline = False

Connecting Equipment to Manufacturing Work Centers for Production-Aware Maintenance

The mrp_maintenance bridge module links equipment records to MRP work centers. This connection enables production-aware scheduling — Odoo won't schedule preventive maintenance during active production runs, and it can automatically block work orders when a machine is under repair.

Linking Equipment to Work Centers

# In mrp.workcenter (via mrp_maintenance module)
# The field already exists after installing mrp_maintenance:
#   equipment_ids = fields.Many2many(
#       'maintenance.equipment'
#   )

# To assign via code:
workcenter = self.env.ref('mrp.workcenter_cnc_bay3')
equipment = self.env.ref(
    'my_module.equip_cnc_haas_001'
)
workcenter.equipment_ids = [
    (4, equipment.id)
]

# Now maintenance requests for this equipment
# will show the linked work center, and the
# work center's capacity planning considers
# equipment availability.

Blocking Work Orders During Repair

When a work center's equipment has an open corrective request, production planning needs to know. Add a computed has_active_repair boolean on mrp.workcenter that searches for open corrective requests linked to the work center's equipment. Then inherit the work center form view to display a warning banner:

<xpath expr="//sheet" position="before">
  <div class="alert alert-warning"
       role="alert"
       invisible="not has_active_repair">
    <strong>Equipment under repair.</strong>
    Production capacity may be reduced.
    <button name="action_view_repairs"
            type="object"
            class="btn btn-link">
      View Repairs
    </button>
  </div>
</xpath>

4 Maintenance Module Pitfalls That Sabotage Your Equipment Reliability Program

Optimization Metadata