Inspecta - Integrazioni e System Integrator
Cosa permette di fare Inspecta
Inspecta è il modulo di asset management pensato per la manutenzione industriale: mette a disposizione dei system integrator un set di API con cui costruire integrazioni verso l’anagrafica di macchine e impianti, la pianificazione della manutenzione e la gestione del magazzino ricambi.
In sintesi, tramite le API è possibile:
- Censire gli asset aziendali (macchine, impianti e attrezzature) e la struttura dello stabilimento.
- Creare e pianificare le attività di controllo e manutenzione.
- Assegnare e monitorare le attività eseguite dagli operatori tramite app.
- Gestire il catalogo dei ricambi e degli strumenti, organizzati per gruppi.
- Tenere sotto controllo i magazzini e ogni movimento di stock.
Le pagine seguenti riportano l’elenco sintetico delle API disponibili, organizzate per area funzionale, seguito da una descrizione più estesa di ciascun modulo.
Elenco delle API disponibili
Asset — Macchine e Impianti
| Funzione | Endpoint | Cosa permette di fare |
| Elenco macchine | GET /api/Asset/items | Consultare l’elenco delle macchine censite, con ricerca e paginazione. |
| Ricerca avanzata | POST /api/Asset/getitems | Filtrare il parco macchine con criteri di ricerca articolati. |
| Dettaglio macchina | GET /api/Asset/item | Aprire la scheda completa di una singola macchina. |
| Nuova macchina | POST /api/Asset/item | Censire una nuova macchina o impianto. |
| Modifica macchina | PUT /api/Asset/item | Aggiornare i dati di una macchina esistente. |
| Elimina macchina | DELETE /api/Asset/item | Rimuovere una macchina dall’anagrafica. |
| Elimina più macchine | DELETE /api/Asset/items | Rimuovere più macchine in un’unica operazione. |
Node — Struttura dell’Impianto
| Funzione | Endpoint | Cosa permette di fare |
| Elenco nodi | GET /api/Node/items | Consultare l’elenco dei nodi, con ricerca e paginazione. |
| Ricerca avanzata | POST /api/Node/getitems | Filtrare i nodi con criteri di ricerca articolati. |
| Aggiorna più nodi | PUT /api/Node/items | Aggiornare più nodi in un’unica operazione. |
| Dettaglio nodo | GET /api/Node/item | Aprire la scheda completa di un nodo. |
| Nuovo nodo | POST /api/Node/item | Creare un nuovo nodo (es. reparto o area). |
| Modifica nodo | PUT /api/Node/item | Aggiornare un nodo esistente. |
| Elimina nodo | DELETE /api/Node/item | Rimuovere un singolo nodo. |
| Elimina più nodi | DELETE /api/Node/items | Rimuovere più nodi in un’unica operazione. |
NodeOrganization — Alberatura e Riorganizzazione
| Funzione | Endpoint | Cosa permette di fare |
| Il mio albero | GET /api/NodeOrganization/tree | Visualizzare l’albero di nodi e macchine visibili in base ai propri permessi. |
| Albero completo | GET /api/NodeOrganization/tree/all | Visualizzare l’intero albero aziendale (funzione riservata). |
| Rami di un nodo | GET /api/NodeOrganization/children | Esplorare i figli diretti di un nodo, un ramo alla volta. |
| Albero dei magazzini | GET /api/NodeOrganization/warehouse/all | Visualizzare l’albero completo dei magazzini (funzione riservata). |
| Verifica spostamento | POST /api/NodeOrganization/canMove | Controllare in anticipo se uno spostamento è ammesso, prima di eseguirlo. |
| Sposta un elemento | POST /api/NodeOrganization/moveNode | Spostare un nodo o una macchina sotto un altro nodo. |
| Sposta più elementi | POST /api/NodeOrganization/moveNodes | Eseguire più spostamenti in un’unica operazione. |
| Ricalcola percorsi | PUT /api/NodeOrganization/updatePath | Riallineare l’albero dopo modifiche strutturali importanti. |
ScheduledActivity — Attività Pianificate
| Funzione | Endpoint | Cosa permette di fare |
| Elenco attività | GET /api/ScheduledActivity/items | Consultare le attività pianificate, con paginazione. |
| Attività per operatore | GET /api/ScheduledActivity/items/{user} | Vedere le attività assegnate a uno specifico operatore. |
| Ricerca avanzata | POST /api/ScheduledActivity/getitems | Filtrare le attività con criteri di ricerca articolati. |
| Ricerca per operatore | POST /api/ScheduledActivity/getitems/{user} | Filtrare le attività di un operatore con criteri avanzati. |
| Conteggio per modello | POST /api/ScheduledActivity/getitems/groupedbytemplate/count | Ottenere il numero di attività raggruppate per modello: utile per cruscotti e reportistica. |
| Dettaglio attività | GET /api/ScheduledActivity/item | Aprire la scheda completa di un’attività. |
| Nuova attività | POST /api/ScheduledActivity/item | Pianificare una nuova attività di manutenzione. |
| Modifica attività | PUT /api/ScheduledActivity/item | Aggiornare dati e stato di avanzamento di un’attività. |
| Elimina attività | DELETE /api/ScheduledActivity/item | Rimuovere una singola attività. |
| Elimina più attività | DELETE /api/ScheduledActivity/items | Rimuovere più attività in un’unica operazione. |
SparePartGroup — Gruppi Ricambi
| Funzione | Endpoint | Cosa permette di fare |
| Elenco gruppi ricambi | GET /api/SparePartGroup/items | Consultare l’elenco dei gruppi ricambi, con paginazione. |
| Ricerca avanzata | POST /api/SparePartGroup/getitems | Filtrare i gruppi ricambi con criteri di ricerca articolati. |
| Gruppi ricambi di un elemento | GET /api/SparePartGroup/items/{entity}/{guid} | Vedere i gruppi ricambi collegati a una specifica macchina o impianto. |
| Dettaglio gruppo ricambi | GET /api/SparePartGroup/item | Aprire la scheda completa di un gruppo ricambi. |
| Nuovo gruppo ricambi | POST /api/SparePartGroup/item | Creare un nuovo gruppo ricambi. |
| Modifica gruppo ricambi | PUT /api/SparePartGroup/item | Aggiornare un gruppo ricambi esistente. |
| Elimina gruppo ricambi | DELETE /api/SparePartGroup/item | Rimuovere un singolo gruppo ricambi. |
| Elimina più gruppi ricambi | DELETE /api/SparePartGroup/items | Rimuovere più gruppi ricambi in un’unica operazione. |
Tool — Strumenti e Ricambi
| Funzione | Endpoint | Cosa permette di fare |
| Elenco articoli | GET /api/Tool/items | Consultare l’elenco di strumenti e ricambi, con paginazione. |
| Ricerca avanzata | POST /api/Tool/getitems | Filtrare gli articoli con criteri di ricerca articolati. |
| Articoli di un magazzino | GET /api/Tool/items/warehouse/{warehouse} | Vedere gli articoli presenti in uno specifico magazzino. |
| Articoli di più magazzini | POST /api/Tool/items/warehouses | Vedere gli articoli presenti in un insieme di magazzini. |
| Articoli di un gruppo ricambi | GET /api/Tool/items/sparepartgroup/{sparepartgroup} | Vedere gli articoli di uno specifico gruppo ricambi. |
| Articoli per modello | GET /api/Tool/items/template/{template} | Vedere gli articoli suggeriti per un modello di attività. |
| Articoli per attività | GET /api/Tool/items/scheduled/{scheduled} | Vedere gli articoli suggeriti per una specifica attività pianificata. |
| Elenco da identificativi | GET /api/Tool/items/list | Recuperare gli articoli corrispondenti a un elenco di identificativi. |
| Dettaglio articolo | GET /api/Tool/item | Aprire la scheda completa di uno strumento o ricambio. |
| Nuovo articolo | POST /api/Tool/item | Creare un nuovo strumento o ricambio. |
| Modifica articolo | PUT /api/Tool/item | Aggiornare un articolo esistente. |
| Elimina articolo | DELETE /api/Tool/item | Rimuovere un singolo articolo. |
| Elimina più articoli | DELETE /api/Tool/items | Rimuovere più articoli in un’unica operazione. |
| Scarica modello Excel | GET /api/Tool/import/template | Scaricare il modello Excel per l’importazione massiva dei ricambi. |
| Verifica file da importare | POST /api/Tool/import/validate | Caricare e controllare il file prima dell’importazione, con riepilogo delle segnalazioni. |
| Conferma importazione | POST /api/Tool/import/execute/{token} | Completare l’importazione massiva dei ricambi già verificati. |
User — Utenti, Accessi e Preferenze
| Funzione | Endpoint | Cosa permette di fare |
| Elenco utenti | GET /api/User/items | Consultare l’elenco degli utenti, con paginazione. |
| Ricerca avanzata | POST /api/User/getitems | Filtrare gli utenti con criteri di ricerca articolati. |
| Dettaglio utente | GET /api/User/item | Aprire la scheda completa di un utente. |
| Nuovo utente | POST /api/User/item | Creare un nuovo utente. |
| Modifica utente | PUT /api/User/item | Aggiornare un utente esistente. |
| Elimina utente | DELETE /api/User/item | Rimuovere un utente. |
| Il mio profilo | GET /api/User/me | Recuperare i dati dell’utente attualmente collegato. |
| Reimposta password altrui | PUT /api/User/password | Consentire a un amministratore di reimpostare la password di un altro utente. |
| Cambia la propria password | PUT /api/User/password/me | Consentire all’utente collegato di modificare la propria password. |
| Preferenze personali | GET / POST / DELETE /api/User/preferences/{key} | Leggere, salvare o eliminare un’impostazione personale (dati cifrati). |
| Preferenze di un altro utente | GET / POST / DELETE /api/User/preferences/{userGuid}/{key} | Gestire le preferenze di uno specifico utente (funzione riservata agli amministratori). |
| Preferenze in chiaro | GET / POST /api/User/preferences-plaintext/{key} | Leggere o salvare un’impostazione temporanea, senza cifratura. |
Warehouse — Magazzini e Movimenti
| Funzione | Endpoint | Cosa permette di fare |
| Elenco magazzini | GET /api/Warehouse/items | Consultare l’elenco dei magazzini, con paginazione. |
| Ricerca avanzata | POST /api/Warehouse/getitems | Filtrare i magazzini con criteri di ricerca articolati. |
| Dettaglio magazzino | GET /api/Warehouse/item | Aprire la scheda completa di un magazzino. |
| Nuovo magazzino | POST /api/Warehouse/item | Creare un nuovo magazzino. |
| Modifica magazzino | PUT /api/Warehouse/item | Aggiornare un magazzino esistente. |
| Elimina magazzino | DELETE /api/Warehouse/item | Rimuovere un singolo magazzino. |
| Elimina più magazzini | DELETE /api/Warehouse/items | Rimuovere più magazzini in un’unica operazione. |
| Storico movimenti | GET /api/Warehouse/stock/handling | Consultare lo storico dei movimenti registrati per un ricambio. |
| Registra un movimento | POST /api/Warehouse/stock/handling | Registrare un carico, uno scarico o un utilizzo di un ricambio. |
| Trasferisci tra magazzini | POST /api/Warehouse/stock/transfer | Registrare lo spostamento di un ricambio da un magazzino a un altro. |
Approfondimento sui moduli
Asset – Macchine e Impianti
L’anagrafica digitale del parco macchine e impianti aziendale. Consente di censire ogni bene, con le sue caratteristiche tecniche, e di mantenerne sempre aggiornata la scheda: cosa serve per sapere in ogni momento quali macchine si hanno, come sono fatte e in che condizioni si trovano.
Node – Struttura dell’Impianto
Il modo in cui si organizza fisicamente l’azienda: stabilimenti, reparti, linee, aree. Ogni nodo è un contenitore dentro cui vivono macchine e altri nodi, così da rispecchiare la reale organizzazione del sito produttivo.
NodeOrganization – Alberatura e Riorganizzazione
Il motore che mette in relazione nodi e macchine, componendo l’albero dell’intero impianto. Da qui si consulta l’intera struttura, la si esplora un ramo alla volta e la si riorganizza in sicurezza (anche con operazioni massive) semplicemente spostando gli elementi.
ScheduledActivity – Attività Pianificate
Il cuore operativo della manutenzione: qui nascono, si assegnano e si monitorano gli interventi programmati. Alimenta il calendario e le liste di lavoro degli operatori, che eseguono i controlli direttamente tramite app, aggiornando in tempo reale lo stato di avanzamento.
SparePartGroup – Gruppi Ricambi
Il modo in cui si classifica il magazzino ricambi: famiglie e raggruppamenti omogenei, collegati alle macchine e agli impianti che li utilizzano. Rende immediato capire come sono organizzati e catalogati i ricambi aziendali.
Tool – Strumenti e Ricambi
La gestione operativa di utensili e ricambi: dove si trovano, a quale gruppo appartengono, per quali attività sono consigliati. Include ricerche mirate per magazzino, gruppo o modello di attività e un caricamento massivo da file Excel, per popolare rapidamente il catalogo ricambi.
User – Utenti, Accessi e Preferenze
La gestione delle persone che utilizzano il sistema: anagrafica, credenziali di accesso, cambio password e preferenze personali. Include le funzioni riservate agli amministratori per intervenire sugli account degli altri utenti.
Warehouse – Magazzini e Movimenti
L’anagrafica dei magazzini e il controllo dei movimenti dei ricambi: carichi, scarichi, utilizzi e trasferimenti tra magazzini. Permette di sapere sempre dove si trovano i ricambi e come si stanno muovendo.
Ulteriori informazioni
È disponibile un portale di documentazione interattiva (Swagger) con il dettaglio tecnico di ogni chiamata — parametri, formati di richiesta e risposta, codici di errore — utile ai system integrator in fase di sviluppo. Il link verrà indicato in questa sezione non appena disponibile.