CMMS Synchronization

CMMS synchronization connects Rela-ai's predictive planning with the computerized maintenance management systems (CMMS) your organization already uses. The flow is bidirectional: work orders generated by the predictive engine are pushed to the external CMMS, and status changes that occur in that system are received back via webhook to keep both systems in sync.

The main benefit is integration with legacy systems without having to abandon them. Planning teams continue working in SAP PM or Maximo while Rela-ai adds the predictive layer on top.

Field mapping configuration allows the integration to adapt to the specific data structure of each CMMS without code changes.

What is it for?

• Eliminates double data entry between the corporate CMMS and Rela-ai.
• Enriches the existing CMMS with work orders generated by the predictive engine.
• Receives status updates (completed, cancelled, reassigned) from the external CMMS.
• Supports SAP PM, IBM Maximo, and custom connectors via REST API.
• Configurable field mapping to adapt to any data structure.

How does it work?

Connector configuration

Each tenant configures its CMMS connector with:

Work order push

When the predictive engine generates a work order or exceeds an intervention threshold:

1. The WO is serialized with the fields configured in the mapping.
2. It is sent to the external CMMS endpoint via HTTP POST.
3. The CMMS returns an external ID that is recorded in Rela-ai.
4. The WO status is marked as synchronized.

Receiving webhooks

The external CMMS can notify status changes by configuring the Rela-ai endpoint as the webhook destination:

POST /api/v1/cmms/webhook/{tenant_id}

Supported events include: work_order.completed, work_order.cancelled, work_order.updated.

Field mapping

{
  "work_order": {
    "id": "AUFNR",
    "title": "KTEXT",
    "priority": "PRIOK",
    "asset_id": "EQUNR",
    "scheduled_date": "GSTRP"
  }
}

Using it from the Dashboard

1. Go to Settings > Integrations > CMMS.
2. Select the system type (SAP PM, Maximo, custom).
3. Enter the CMMS credentials and base URL.
4. Configure the field mapping using the visual editor.
5. Click Test Connection to verify the integration.
6. Activate synchronization with the Active synchronization toggle.