Integrazione MES per Apertura Ticket Automatica

Integrazione MES per apertura ticket automatica

Il modulo Integrazione MES di Manutentya espone API REST per ricevere notifiche dal sistema MES (Manufacturing Execution System) del cliente e aprire automaticamente ticket di manutenzione al verificarsi di fermi macchina, allarmi o anomalie. È il modulo che chiude il cerchio Industria 4.0: il PLC rileva il problema, il MES lo registra, Manutentya genera il ticket e notifica il tecnico — tutto in pochi secondi senza intervento umano.

Endpoint disponibili

Sicurezza

Tutte le API sono protette da Bearer Token (API Key univoca per azienda):

• Generazione API Key dal pannello admin Manutentya.
• Rigenerazione on-demand (in caso di compromissione).
• Header HTTP Authorization: Bearer {API_KEY} obbligatorio.
• Log completo di tutte le chiamate: IP sorgente, payload ricevuto, status di risposta, timestamp.

Anti-flapping

Problema classico nell'integrazione MES: i fermi micro (sotto 30 secondi) di ciclo macchina generano falsi positivi. Senza protezione, l'azienda riceverebbe centinaia di ticket spurii al giorno.

Soluzione anti-flapping di Manutentya:

• Delay configurabile per macchinario: il ticket viene aperto solo se il fermo dura più di X secondi (es. 60 secondi).
• Se il MES manda ripartenza entro il delay → l'evento viene cancellato senza creare il ticket.
• Solo i fermi "veri" generano ticket.

Il delay si configura per ciascun macchinario in base alla sua tipologia (presse: 30 sec, forni: 120 sec, linee continue: 60 sec).

Policy per macchinario

Per ogni macchinario nell'anagrafica, configura:

• codice_mes: stringa di mappatura tra il codice del MES e il macchinario Manutentya.
• Auto-apertura on/off: alcuni macchinari potrebbero non richiedere ticket automatico.
• Delay anti-flapping in secondi.
• Priorità dei ticket auto-creati.
• Template descrizione con placeholder: {motivo}, {timestamp}, {codice_mes}, {durata_fermo}.
• Chiusura automatica: se la macchina riparte e il ticket non è ancora preso in carico, viene chiuso automaticamente con motivazione "Risolto autonomamente".

Esempio chiamata fermo

POST /api/mes/fermo HTTP/1.1
Authorization: Bearer {API_KEY}
Content-Type: application/json

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

Risposta:

HTTP/1.1 201 Created
{
  "success": true,
  "ticket_id": 12345,
  "ticket_code": "#TCK/2026/000123",
  "anti_flapping_delay_sec": 60,
  "ticket_will_open_at": "2026-05-01T14:24:45Z"
}

Documentazione PDF per fornitore MES

Manutentya genera automaticamente un PDF stampabile con:

• Tutti gli endpoint disponibili.
• Esempi curl di chiamata.
• Mappatura macchinari con codice MES.
• Policy configurate per macchinario.
• Logica anti-flapping spiegata.

Due versioni:

• Con chiave: include l'API Key, da consegnare via canale sicuro al fornitore MES.
• Senza chiave: senza API Key, sicura da inviare via email per documentazione.

Riduce il tempo di onboarding integrazione da giorni a ore.

Compatibilità con MES standard

Compatibile con qualsiasi MES che possa fare chiamate HTTP REST:

• PLCinCloud (integrazione nativa).
• Siemens Opcenter.
• Rockwell FactoryTalk.
• SAP DMC.
• Custom ERP/MES con webhook.

Caso d'uso completo

1. Pressa di iniezione si ferma per anomalia pressione (rilevata dal PLC).
2. Il MES invia POST /api/mes/fermo a Manutentya.
3. Anti-flapping attende 60 secondi: la pressa non riparte.
4. Manutentya apre ticket #TCK/2026/000123 con priorità Alta, descrizione "Anomalia pressione iniezione - PLC PRESSA-A1 - 14:23:45".
5. Notifica push al tecnico responsabile della pressa.
6. Tecnico apre la PWA, vede il ticket, scansiona QR sulla pressa, attiva START FASE, accetta DPI, interviene.
7. Dopo 30 minuti, pressa risolta. Tecnico chiude il ticket con firma digitale.
8. PDF scheda intervento generato e archiviato per fatturazione.

Tempo totale dall'evento al tecnico in azione: 2-5 minuti. Senza integrazione MES sarebbero stati 30-60 minuti tipici (operatore segnala, capoturno chiama tecnico, tecnico arriva, ecc.).

Modulo opzionale, attivabile a richiesta. Si combina perfettamente con la gestione ticket e con le soluzioni MES PLCinCloud per Industria 4.0 completa.