Guide pratiche

Come Integrare MES e CMMS per Apertura Ticket Automatica

Il PLC rileva il fermo, il MES lo registra, il CMMS apre il ticket, il tecnico riceve la notifica push. Tutto in 30 secondi senza intervento umano. Vediamo come integrare MES e CMMS via API REST.

Ingenia 30 April 2026
Come Integrare MES e CMMS per Apertura Ticket Automatica

Nel modello di fabbrica 4.0 connessa, MES e CMMS non sono due sistemi isolati: parlano tra loro via API. Quando il PLC rileva un fermo macchina, il MES lo registra e apre automaticamente un ticket nel CMMS con tutti i dettagli, assegnandolo al tecnico responsabile e inviando notifica push. Tempo totale dall'evento alla notifica: 30 secondi. Vediamo come strutturare questa integrazione.

Cosa sono MES e CMMS

Per chi viene dai due mondi separati:

  • MES (Manufacturing Execution System): sistema che gestisce l'esecuzione della produzione — ordini di lavoro, fasi di lavorazione, raccolta dati PLC, OEE. Approfondisci nel nostro articolo MES vs ERP vs MRP.
  • CMMS (Computerized Maintenance Management System): sistema che gestisce la manutenzione — ticket, manutenzione preventiva, magazzino ricambi, MTBF/MTTR.

Senza integrazione, i due sistemi sono "isolati": il MES vede il fermo ma non avvisa il CMMS, il responsabile manutenzione lo scopre dal capoturno (che chiama 15-30 minuti dopo).

L'integrazione classica via API REST

L'approccio standard moderno usa API REST con autenticazione Bearer Token:

  1. Il MES ha un evento (es. fermo pressa A1).
  2. Manda chiamata HTTP POST a /api/mes/fermo del CMMS con payload JSON.
  3. Il CMMS verifica autenticazione, applica policy anti-flapping, apre ticket.
  4. Notifica push al tecnico.

Esempio chiamata:

POST /api/mes/fermo HTTP/1.1
Authorization: Bearer abcd1234...
Content-Type: application/json

{
  "codice_mes": "PRESSA-A1",
  "timestamp": "2026-05-01T14:23:45Z",
  "motivo": "Anomalia pressione iniezione",
  "durata_prevista_sec": 600
}

Risposta del CMMS:

HTTP/1.1 201 Created
{
  "success": true,
  "ticket_code": "#TCK/2026/000123"
}

I 4 endpoint essenziali

EndpointQuando usarlo
POST /api/mes/fermoNotifica fermo macchina (apre ticket)
POST /api/mes/ripartenzaNotifica ripartenza (chiude o annulla ticket auto-creato)
POST /api/mes/allarmeAllarme non bloccante (warning, non genera ticket)
GET /api/mes/testVerifica connettività e autenticazione

Il problema dell'anti-flapping

Senza protezioni, l'integrazione MES-CMMS ha un grosso problema: i micro-fermi di ciclo (sotto 30 secondi) generano centinaia di ticket spurii al giorno. Cause:

  • Pause di ciclo macchina (cambio formato veloce).
  • Sensori che fanno scattare false rilevazioni.
  • Glitch del PLC.

Soluzione: delay anti-flapping configurabile per macchinario:

  • Il CMMS attende X secondi dopo aver ricevuto il fermo.
  • Se entro il delay arriva il POST /api/mes/ripartenza, l'evento viene cancellato senza creare ticket.
  • Solo i fermi "veri" generano ticket.

Delay tipici:

  • Presse: 30-60 secondi.
  • Forni: 60-120 secondi.
  • Linee continue: 90-180 secondi.
  • Magazzini automatici: 120-300 secondi.

Mappatura macchinari

Punto critico: il MES e il CMMS devono parlare lo stesso linguaggio sui macchinari. Per ogni asset:

  • Il MES lo identifica con un codice_mes (es. "PRESSA-A1").
  • Il CMMS lo identifica con il proprio codice anagrafica (es. "MAC-2024-0042").
  • Serve tabella di mappatura tra i due codici.

Best practice: configurare il codice_mes nell'anagrafica macchinario del CMMS. Quando arriva chiamata API con codice_mes, il CMMS sa quale macchinario è.

Policy per macchinario

Per ogni macchinario, configurare:

  • Auto-apertura ON/OFF: alcuni macchinari critici sì, altri no.
  • Delay anti-flapping: secondi.
  • Priorità ticket auto-creati: di default Alta, configurabile.
  • Tecnico responsabile: pre-assegnato.
  • Template descrizione con placeholder: {motivo}, {timestamp}, {codice_mes}.
  • Chiusura automatica al ripristino: se la macchina riparte e il ticket non è ancora preso in carico, viene chiuso.

Sicurezza dell'integrazione

Le API REST devono essere protette:

  • Bearer Token: API Key univoca per azienda, generata da pannello admin CMMS.
  • HTTPS obbligatorio: niente chiamate in chiaro.
  • Rate limiting: per prevenire abusi.
  • IP whitelisting: solo l'IP del MES può chiamare le API.
  • Log completo: ogni chiamata registrata con IP, payload, status, timestamp.

In caso di compromissione token, rigenerazione immediata da pannello admin.

ROI dell'integrazione

Caso reale: PMI con 30 macchinari in produzione, 200 ticket/anno.

Senza integrazione MES-CMMS:

  • Tempo da fermo a notifica tecnico: ~20-30 minuti (segnalazione capoturno → telefonata → registrazione ticket → assegnazione).
  • Tempo da fermo a tecnico in azione: ~45-60 minuti.

Con integrazione MES-CMMS:

  • Tempo da fermo a notifica tecnico: 30 secondi.
  • Tempo da fermo a tecnico in azione: 5-10 minuti.

Risparmio: ~30-45 minuti per intervento. Su 200 interventi/anno con costo medio fermo 500 €/h = ~50.000 €/anno risparmiati.

Costo integrazione: setup ~3.000-8.000 € + canone modulo CMMS ~50-100 €/mese.

ROI: 1-3 mesi.

Documentazione per il fornitore MES

Per facilitare il fornitore MES che deve implementare le chiamate, il CMMS dovrebbe fornire:

  • PDF documentazione con tutti gli endpoint.
  • Esempi cURL di chiamata.
  • Mappatura macchinari pre-compilata.
  • Spiegazione anti-flapping.
  • Versione "con chiave" (canale sicuro) e "senza chiave" (email).

Come fa Manutentya

Il modulo Integrazione MES di Manutentya copre tutto quanto sopra: API REST documentate, anti-flapping configurabile, policy per macchinario, audit log completo, PDF documentazione per il fornitore MES.

Compatibile con PLCinCloud per integrazione nativa, e con qualsiasi MES standard (Siemens Opcenter, Rockwell FactoryTalk, SAP DMC) capace di chiamate HTTP REST.

Per approfondire l'apertura mobile dei ticket, leggi anche come usare i QR code in officina.

Richiedi una demo di Manutentya.

Pronto a trasformare il tuo business?

Raccontaci il tuo progetto. Ti risponderemo entro 24 ore.