Rela AIRela AI Docs
Manutenzione

Sincronizzazione CMMS

Sincronizzazione bidirezionale con sistemi CMMS esterni come SAP PM, Maximo o integrazioni personalizzate per unificare la pianificazione predittiva con i sistemi legacy esistenti.

Sincronizzazione CMMS

La sincronizzazione CMMS collega la pianificazione predittiva di Rela-ai con i sistemi di gestione della manutenzione computerizzata (CMMS) già in uso nella tua organizzazione. Il flusso è bidirezionale: gli ordini di lavoro generati dal motore predittivo vengono inviati al CMMS esterno, e le modifiche di stato che avvengono in quel sistema vengono ricevute tramite webhook per mantenere entrambi i sistemi sincronizzati.

Il vantaggio principale è l'integrazione con i sistemi legacy senza doverli abbandonare. I team di pianificazione continuano a lavorare in SAP PM o Maximo mentre Rela-ai aggiunge il livello predittivo sopra.

La configurazione del mapping dei campi consente di adattare l'integrazione alla struttura dati specifica di ogni CMMS senza modifiche al codice.

A cosa serve?

  • Elimina la doppia immissione di dati tra il CMMS aziendale e Rela-ai.
  • Arricchisce il CMMS esistente con ordini di lavoro generati dal motore predittivo.
  • Riceve aggiornamenti di stato (completato, annullato, riassegnato) dal CMMS esterno.
  • Supporta SAP PM, IBM Maximo e connettori personalizzati tramite API REST.
  • Mapping dei campi configurabile per adattarsi a qualsiasi struttura dati.

Come funziona?

Configurazione del connettore

Ogni tenant configura il proprio connettore CMMS con:

ParametroDescrizione
Tipo di sistemaSAP PM, Maximo o custom
URL baseEndpoint del CMMS esterno
CredenzialiAPI key, OAuth2 o basic auth a seconda del sistema
Mapping dei campiEquivalenza tra i campi di Rela-ai e il CMMS esterno

Push degli ordini di lavoro

Quando il motore predittivo genera un ordine di lavoro o supera una soglia di intervento:

  1. L'OL viene serializzato con i campi configurati nel mapping.
  2. Viene inviato all'endpoint del CMMS esterno via HTTP POST.
  3. Il CMMS restituisce un ID esterno che viene registrato in Rela-ai.
  4. Lo stato dell'OL viene contrassegnato come sincronizzato.

Ricezione dei webhook

Il CMMS esterno può notificare le modifiche di stato configurando l'endpoint di Rela-ai come destinazione webhook:

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

Gli eventi supportati includono: work_order.completed, work_order.cancelled, work_order.updated.

Mapping dei campi

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

Utilizzo dalla Dashboard

  1. Vai a Impostazioni > Integrazioni > CMMS.
  2. Seleziona il tipo di sistema (SAP PM, Maximo, custom).
  3. Inserisci le credenziali e l'URL base del CMMS.
  4. Configura il mapping dei campi usando l'editor visuale.
  5. Clicca su Testa Connessione per verificare l'integrazione.
  6. Attiva la sincronizzazione con il toggle Sincronizzazione attiva.
La cronologia delle sincronizzazioni (successi ed errori) è disponibile in Impostazioni > Integrazioni > CMMS > Cronologia.
I campi obbligatori del CMMS esterno devono essere mappati prima di attivare la sincronizzazione. Un OL privo dei campi richiesti verrà rifiutato dal sistema esterno.

Benefici chiave

  • Nessuna doppia digitazione — gli ordini fluiscono in entrambe le direzioni.
  • Mapping configurabile per tenant: si adatta al tuo CMMS.
  • Retry automatico con idempotenza — nessun ordine duplicato.
  • Audit trail di ogni sync con timestamp e attore.
  • Compatibile con SAP PM, Maximo, Fiix e connettori custom.

In questa pagina