← Torna al Centro Assistenza

Gestione Magazzino

Gestisci i prodotti reali dei fornitori: anagrafica, categorie, importazione da fattura elettronica, schede tecniche/sicurezza e ricerca online con Gemini. Ogni prodotto è legato direttamente al fornitore.

Operazioni rapide

Come aggiungo un nuovo prodotto?
Seleziona il fornitore, inserisci descrizione e dati, clicca "+ Aggiungi".
Vedi guida
Come modifico un prodotto esistente?
Modifica inline categoria, UM, costo e rischio direttamente nella riga dell'elenco.
Vedi guida
Come importo prodotti da una fattura elettronica?
Carica l'XML (anche .p7m), controlla l'anteprima e conferma solo le righe desiderate.
Vedi guida
Come cerco informazioni online su un prodotto?
Dal dettaglio prodotto, clicca "Cerca online (Gemini)" per descrizione uso, DPI e schede.
Vedi guida
Come carico o scarico una scheda tecnica/sicurezza?
Dal dettaglio prodotto, carica il PDF o scarica quello già allegato.
Vedi guida
Come creo una categoria al volo senza uscire dalla pagina?
Clicca "+" accanto alla select Categoria nella riga del prodotto.
Vedi guida
Come filtro l'elenco prodotti?
Usa i filtri Fornitore, Stato e Categoria sopra l'elenco.
Vedi guida
Posso nascondere un prodotto senza eliminarlo?
Sì, usa "Nascondi": resta in archivio ma non appare negli elenchi operativi.
Vedi guida

📊 Panoramica e Filtri

In cima alla pagina trovi un riepilogo dei prodotti completi (con categoria assegnata) rispetto al totale, e tre filtri combinabili:

1

Filtro Fornitore

Seleziona un fornitore dal menu a tendina per vedere solo i suoi prodotti. Lascia "Tutti i fornitori" per vedere l'elenco completo.

2

Filtro Stato

Solo da completare (default): mostra solo i prodotti senza categoria assegnata, evidenziati in giallo. Tutti i prodotti: mostra l'elenco completo inclusi quelli già classificati.

3

Filtro Categoria

Seleziona una categoria per vedere solo i prodotti classificati in quella categoria. I filtri si applicano immediatamente al cambio della selezione.

💡 Prodotti incompleti: Le righe con sfondo giallo sono prodotti a cui manca la categoria. Assegna una categoria direttamente dalla select nella riga oppure crea una nuova categoria al volo col pulsante "+".

➕ Creare un nuovo prodotto

1

Seleziona il fornitore

Nel modulo "Nuovo Prodotto" in alto, scegli il fornitore dal menu a tendina. Se non ci sono fornitori, creane uno prima.

2

Inserisci i dati del prodotto

I campi disponibili sono:
Descrizione Prodotto (obbligatorio) — usa la descrizione esatta come sul catalogo del fornitore
Codice Fornitore — codice articolo del fornitore, usato per identificare il prodotto nelle fatture XML
UM — unità di misura (PZ, LT, KG, ecc.)
Costo UM (€) — costo unitario netto
Livello Rischio (1-10) — valutazione del rischio chimico/operativo del prodotto

3

Salva

Clicca + Aggiungi. Il prodotto viene creato e appare nell'elenco. La categoria potrà essere assegnata successivamente dalla riga dell'elenco o dal dettaglio prodotto.

⚠️ Codice fornitore: Inserire il codice fornitore corretto è fondamentale per l'importazione da fattura elettronica. Il sistema usa questo codice per riconoscere automaticamente i prodotti già presenti quando carichi una fattura XML.

✏️ Modificare un prodotto (inline)

Nell'elenco prodotti, ogni riga contiene campi modificabili direttamente senza aprire una scheda separata:

1

Modifica i campi nella riga

Puoi cambiare direttamente:
Categoria — seleziona dal menu a tendina o creane una nuova col pulsante "+" (vedi sotto)
UM — unità di misura
Costo UM (€) — costo unitario
Livello Rischio (1-10)

2

Salva

Clicca il pulsante Salva nella stessa riga. Il sistema aggiorna tutti i campi modificati in un'unica operazione.

3

Apri il dettaglio (facoltativo)

Per modificare descrizione uso, DPI e schede tecniche/sicurezza, clicca 🏷️ Dettaglio nella riga del prodotto. Si apre il pannello dettaglio con tutti i campi avanzati. Vedi sezione Dettaglio →

⚡ Creare una categoria al volo

Senza uscire dalla pagina dei prodotti, puoi creare una nuova categoria direttamente dalla riga del prodotto:

1

Clicca "+" accanto alla select Categoria

Nella riga del prodotto, accanto al menu a tendina delle categorie, trovi il pulsante +. Cliccalo per aprire il popover.

2

Digita il nome e crea

Inserisci il nome della nuova categoria (max 50 caratteri) e premi Crea oppure Invio. La categoria viene creata via AJAX senza ricaricare la pagina.

3

Selezione automatica

La nuova categoria viene aggiunta a tutte le select Categoria della tabella (non solo alla riga corrente) e selezionata automaticamente nella riga da cui hai avviato il popover. Clicca poi Salva nella riga per confermare l'assegnazione.

💡 Nome duplicato: Se inserisci un nome di categoria già esistente, il sistema riconosce la categoria esistente e la seleziona senza crearne una duplicata.

🏷️ Dettaglio prodotto

Il pannello Dettaglio permette di gestire informazioni avanzate che non trovano spazio nella modifica inline:

1

Apri il dettaglio

Nell'elenco prodotti, clicca 🏷️ Dettaglio nella riga del prodotto. Si apre il pannello dettaglio in alto nella pagina, evidenziato con bordo arancione.

2

Compila i campi

I campi disponibili sono:
Descrizione uso — come e perché si usa questo prodotto (2-4 frasi)
DPI da utilizzare — elenco dei DPI consigliati (es. "Guanti, mascherina FFP2, occhiali")
Scheda tecnica — upload o download del file (vedi sotto)
Scheda sicurezza — upload o download del file (vedi sotto)

3

Ricerca online con Gemini (facoltativa)

Clicca 🔎 Cerca online (Gemini) per chiedere all'AI una proposta automatica di descrizione uso, DPI e link a schede tecnica/sicurezza trovate sul web. Vedi sezione Ricerca Gemini →

4

Salva

Clicca 💾 Salva Dettaglio per salvare tutti i campi compilati e gli eventuali file caricati. Clicca Chiudi per tornare all'elenco senza salvare.

🔎 Ricerca online con Gemini

Dal pannello Dettaglio prodotto, puoi usare l'intelligenza artificiale Gemini (con ricerca web attiva) per trovare automaticamente informazioni sul prodotto:

1

Clicca "Cerca online (Gemini)"

Il pulsante si trova nel riquadro blu in alto nel pannello Dettaglio. La ricerca parte dal nome commerciale e dal codice fornitore del prodotto reale.

2

Risultati proposti

Gemini può proporre:
Descrizione uso — riempie il campo solo se è vuoto (non sovrascrive mai testo già presente)
DPI consigliati — riempie il campo solo se è vuoto
Scheda tecnica trovata — mostra un'anteprima con link da verificare
Scheda sicurezza trovata — mostra un'anteprima con link da verificare

3

Verifica e conferma le schede

Le schede trovate online non vengono allegate automaticamente. Appare un riquadro giallo con il link all'anteprima: aprilo, verifica che sia la scheda corretta, poi clicca ✅ Confermo, allega questo file. Solo dopo la conferma umana il file viene scaricato e salvato.

4

Salva il dettaglio

Dopo aver verificato e confermato le proposte, clicca 💾 Salva Dettaglio per rendere definitive tutte le modifiche.

🚨 Sicurezza: Per le schede di sicurezza, la conferma umana è obbligatoria. Un allegato sbagliato è pericoloso. Verifica sempre che il PDF trovato online corrisponda esattamente al prodotto in anagrafica prima di confermare l'allegamento.
⚠️ Limiti della ricerca: Gemini cerca sul web pubblico. Se il prodotto ha un nome generico o il fornitore non pubblica schede online, la ricerca potrebbe non trovare risultati specifici. In quel caso, carica manualmente le schede dal sito del fornitore.

📋 Schede Tecniche e di Sicurezza

Ogni prodotto può avere due documenti allegati: la scheda tecnica e la scheda di sicurezza. Puoi caricarli manualmente o tramite la ricerca online Gemini.

1

Caricare una scheda manualmente

Nel pannello Dettaglio prodotto, sotto i campi "Scheda tecnica" e "Scheda sicurezza", trovi il campo file. Seleziona il PDF dal tuo computer e clicca 💾 Salva Dettaglio. Il file viene salvato associandolo univocamente al prodotto tramite il suo ID interno.

2

Scaricare una scheda

Se una scheda è già allegata, appare il link 📄 Nome File sotto il campo corrispondente. Cliccandolo, il browser scarica direttamente il file originale. Il download è protetto dai permessi di accesso al modulo Magazzino.

3

Sostituire o rimuovere

Per aggiornare una scheda, carica un nuovo file nello stesso campo: il precedente viene sovrascritto automaticamente. Per rimuovere una scheda senza sostituirla, lascia vuoto il campo file e salva.

💡 Formati supportati: PDF, DOC e DOCX. Il PDF è raccomandato per compatibilità universale su tutti i dispositivi mobili usati in cantiere.
⚠️ Sicurezza: Le schede di sicurezza sono documenti normativamente rilevanti. Assicurati di caricare sempre la versione più recente fornita dal produttore. Il sistema non verifica automaticamente la data del documento: la responsabilità dell'aggiornamento è dell'operatore.

📥 Importare prodotti da Fattura Elettronica

Puoi importare prodotti direttamente dalla fattura elettronica XML del fornitore (anche firmata .p7m). Il flusso è in due passi con revisione umana obbligatoria.

1

Carica il file della fattura

Clicca 📥 Importa da Fattura nella toolbar in alto. Seleziona il file XML o .xml.p7m e clicca Carica e mostra anteprima. Il sistema estrae automaticamente l'XML dai file firmati .p7m.

2

Controlla l'anteprima

Il sistema riconosce il fornitore dalla P.IVA e mostra una tabella con tutte le righe prodotto della fattura. Ogni riga indica lo stato:
🆕 Nuovo prodotto — non esiste in anagrafica, verrà creato
💶 Prezzo da aggiornare — prodotto esistente con costo cambiato
➖ Invariato — stesso prezzo, deselezionato di default

3

Seleziona le righe da importare

Spunta solo le righe che vuoi importare. Le righe "Invariato" sono deselezionate di default. Puoi selezionare/deselezionare liberamente. Le righe di sola referenza (DDT, conferme d'ordine) vengono scartate automaticamente.

4

Conferma l'importazione

Clicca ✅ Conferma importazione righe selezionate. Il sistema crea i nuovi prodotti e aggiorna i prezzi di quelli esistenti. Al termine viene mostrato il riepilogo: quanti creati, aggiornati, invariati ed eventuali errori.

⚠️ Fattura già importata: Se il sistema rileva che lo stesso file è già stato importato in precedenza, mostra un avviso. Puoi comunque procedere spuntando "Ho capito, importa comunque": verranno aggiornati solo i prezzi eventualmente cambiati, senza creare doppioni.
💡 Aggregazione automatica: Se lo stesso codice fornitore compare su più righe della stessa fattura, il sistema aggrega automaticamente le quantità e calcola il costo unitario netto medio (somma PrezzoTotale / somma Quantità), tenendo conto correttamente di eventuali sconti/maggiorazioni di riga.
🚨 Fornitore mancante: Se la P.IVA della fattura non corrisponde a nessun fornitore in anagrafica, l'importazione viene bloccata. Crea prima il fornitore in Fornitori Materiali/Attrezzature, poi ripeti l'importazione.

👁️ Nascondere / Riattivare / Eliminare un prodotto

1

Nascondere un prodotto

Nella colonna Azioni dell'elenco, clicca Nascondi. Il prodotto resta in archivio ma non appare più negli elenchi operativi (ordini, validazione richieste, fogli lavoro). I dati storici non vengono influenzati.

2

Riattivare un prodotto

Per rendere nuovamente visibile un prodotto nascosto, filtra per "Tutti i prodotti" e clicca Riattiva nella riga del prodotto.

3

Eliminare un prodotto

Nella colonna Azioni, clicca Elimina. Il sistema chiede conferma: l'operazione è irreversibile. Preferisci sempre "Nascondi" rispetto a "Elimina" quando possibile.

💡 Quando usare "Nascondi": Per prodotti temporaneamente non disponibili, stagionali o in fase di dismissione graduale. È reversibile e non cancella nessun dato.