← Torna al Centro Assistenza
Cos'è la Gestione Magazzino?
È la pagina centrale per gestire tutti i prodotti reali acquistati dai fornitori: detergenti, DPI, attrezzature, materiali di consumo. Ogni prodotto è classificato per categoria, ha un costo, un'unità di misura e un livello di rischio. Puoi importare i prodotti direttamente dalle fatture elettroniche dei fornitori, allegare schede tecniche/sicurezza e cercare informazioni online con Gemini.
💡 A cosa serve: Centralizza l'anagrafica prodotti, così puoi collegarli ai cantieri (foglio lavoro), alle richieste materiale degli addetti e ai preventivi per i clienti.
📐 Layout della pagina
La pagina è divisa in due colonne:
Colonna sinistra — Nuovo Prodotto
Form sticky con 4 sezioni colorate (Identificazione, Classificazione, Dati Commerciali, Sicurezza). Sempre visibile per creare nuovi prodotti.
Colonna destra — Elenco Prodotti
Toolbar con filtri (fornitore, stato, categoria), ricerca libera e tabella con tutti i prodotti. Per ogni prodotto puoi modificare categoria, UM, costo e rischio direttamente nella riga.
🗂️ Le 4 sezioni del form "Nuovo Prodotto"
🔖 Sezione 1 — Identificazione
Solo per Attrezzature (A) e DPI (D). Codice interno (auto-generato se vuoto) e Matricola/Targa.
🗂️ Sezione 2 — Classificazione
Tipologia articolo (P/A/D), Categoria (con creazione al volo), Fornitore e Descrizione Prodotto.
💶 Sezione 3 — Dati Commerciali
Codice fornitore, UM, costo UM, UM minima, pezzi per UM, costo UM minima (calcolato).
⚠️ Sezione 4 — Sicurezza
Livello Rischio (1-10, default 1). Usato per DPI e attrezzature soggette a normative.
➕ Creare un nuovo Prodotto
- Vai su Commerciale, Clienti e Magazzino → Gestione Magazzino.
- Nel form a sinistra, compila i campi delle 4 sezioni:
- Tipologia articolo *: Prodotto (P), Attrezzatura (A) o DPI (D). Se scegli A o D, appare la Sezione 1 (codice interno e matricola).
- Categoria: scegli da esistenti o crea al volo con il pulsante "+".
- Fornitore *: seleziona dall'elenco (se non c'è, creane uno in Fornitori Materiali).
- Descrizione Prodotto *: nome del prodotto (es. "Decalcificante WC gel 750ml").
- Codice Fornitore: codice usato dal fornitore (es. "DEC750").
- UM (sigla): unità di misura (es. "CAR" per cartone, "FLA" per flacone).
- Costo UM (€): costo per unità di misura (es. 12,00 € per cartone).
- UM minima (sigla): unità minima (es. "FLA" per flacone).
- Pezzi per UM: quanti pezzi minimi ci sono in un'UM (es. 12 flaconi per cartone).
- Costo UM minima (€): calcolato automaticamente (costo UM / pezzi per UM).
- Livello Rischio (1-10): default 1. Usato per DPI e attrezzature.
- Clicca "+ Aggiungi Prodotto". Il prodotto viene creato e appare nell'elenco a destra.
💡 Suggerimento: se non conosci il codice fornitore o l'UM minima, puoi lasciarli vuoti e completarli in seguito modificando la riga nell'elenco.
📥 Importare prodotti da Fattura Elettronica
Se ricevi fatture elettroniche (.xml o .xml.p7m) dai fornitori, puoi importare automaticamente i prodotti senza digitarli a mano.
- Nella toolbar in alto, clicca "📥 Importa da Fattura".
- Seleziona il file della fattura elettronica (.xml o .xml.p7m).
- Clicca "Carica e mostra anteprima". Il sistema estrae i prodotti dalla fattura e mostra un'anteprima con:
- Codice: codice fornitore.
- Descrizione: nome del prodotto.
- Q.tà: quantità fatturata.
- U.M.: unità di misura.
- Costo attuale: costo già presente in magazzino (se il prodotto esiste).
- Costo da fattura: costo estratto dalla fattura.
- Scostamento: differenza di prezzo (verde = calo, rosso = aumento).
- Esito: 🆕 Nuovo, 💶 Da aggiornare, ➖ Invariato.
- Spunta le righe che vuoi importare (di default sono spuntate tutte tranne le "Invariato").
- Clicca "✅ Conferma importazione". I prodotti vengono creati/aggiornati nel magazzino.
⚠️ Attenzione: se la fattura è già stata importata in passato, il sistema mostra un avviso. Puoi comunque procedere spuntando "Procedi comunque" (utile se vuoi aggiornare i prezzi).
💡
Nota: il fornitore viene identificato automaticamente dalla P.IVA del cedente nella fattura. Se il fornitore non esiste in anagrafica, l'importazione fallisce: crealo prima in
Fornitori Materiali.
🏷️ Dettaglio Prodotto e Ricerca Gemini
Per ogni prodotto puoi aprire la scheda dettaglio (pulsante "🏷️ Dettaglio" nella riga) per compilare informazioni aggiuntive:
- Descrizione uso: a cosa serve il prodotto.
- DPI da utilizzare: quali DPI servono per usarlo in sicurezza.
- Scheda tecnica: PDF/DOC del produttore (upload manuale o ricerca Gemini).
- Scheda sicurezza: scheda di sicurezza (upload manuale o ricerca Gemini).
🔎 Ricerca online con Gemini
Nella scheda dettaglio, clicca "🔎 Cerca online (Gemini)" per cercare automaticamente:
- Descrizione uso del prodotto.
- DPI necessari per l'utilizzo.
- URL della scheda tecnica (se trovata online).
- URL della scheda di sicurezza (se trovata online).
Il sistema propone i dati trovati: puoi accettarli (cliccando "✅ Confermo, allega" per le schede) o modificarli a mano.
💡 Suggerimento: la ricerca Gemini è utile per prodotti nuovi di cui non hai la documentazione. Per prodotti già noti, è meglio caricare le schede manualmente (più affidabile).
🔍 Filtri e Ricerca nell'elenco
Nella colonna destra trovi tre filtri e una ricerca libera:
- 🏭 Fornitore: filtra i prodotti per fornitore specifico.
- 📊 Stato: "⚠️ Solo da completare" (prodotti senza categoria) o "Tutti i prodotti".
- 🗂️ Categoria: filtra per categoria specifica.
- 🔍 Cerca nell'elenco: ricerca libera per nome, codice, fornitore, categoria (in tempo reale).
💡 Suggerimento: usa il filtro "⚠️ Solo da completare" per identificare rapidamente i prodotti importati da fattura che non hanno ancora una categoria assegnata.
✏️ Modificare un Prodotto nell'elenco
Nella tabella, per ogni prodotto puoi modificare direttamente nella riga:
- Categoria: seleziona dal menu a tendina (o crea al volo con "+").
- UM: unità di misura (es. "CAR", "FLA").
- Costo €: costo per unità di misura.
- Rischio: livello di rischio (1-10).
Clicca "Salva" per confermare le modifiche. Per modifiche più approfondite (descrizione uso, DPI, schede), clicca "🏷️ Dettaglio".
🗂️ Creare una Categoria al volo
Durante la creazione di un prodotto o la modifica di una riga, puoi creare una nuova categoria senza uscire dalla pagina:
- Clicca il pulsante "+" accanto al menu a tendina "Categoria".
- Si apre un popover con un campo per il nome della categoria.
- Digita il nome (es. "Bagni", "DPI", "Attrezzature").
- Clicca "Crea" (o premi Invio).
- La categoria viene creata e selezionata automaticamente.
💡 Nota: la categoria viene creata immediatamente e appare nel menu a tendina per tutti i prodotti. Non serve passare per una pagina separata.
👁️ Nascondere / Eliminare un Prodotto
- Nascondi/Riattiva: cliccando il pulsante nella colonna "Azioni", il prodotto viene nascosto dal magazzino (soft delete) o riattivato. Utile per prodotti temporaneamente non utilizzati.
- Elimina: rimuove definitivamente il prodotto dal database. Operazione NON reversibile.
⚠️ Attenzione: eliminare un prodotto può causare problemi se è collegato a richieste materiale, fogli lavoro o preventivi. Usa "Nascondi" invece di "Elimina" se non sei sicuro.
❓ Domande Frequenti
Qual è la differenza tra UM e UM minima?
L'UM (unità di misura) è come acquisti il prodotto dal fornitore (es. "CAR" = cartone). L'UM minima è come lo usi/consumi in cantiere (es. "FLA" = flacone). Il sistema calcola automaticamente il costo per UM minima dividendo il costo UM per i pezzi per UM (es. 12,00 € / 12 flaconi = 1,00 € per flacone).
Cosa sono le tipologie P, A, D?
P = Prodotto (detergente, materiale di consumo). A = Attrezzatura (aspirapolvere, carrello). D = DPI (guanti, mascherine). Solo A e D richiedono codice interno e matricola/targa (Sezione 1 del form).
Perché non riesco a importare la fattura?
Controlla tre cose: (1) il file è un XML valido (se è .p7m, il sistema prova a estrarre l'XML automaticamente, ma alcuni file .p7m sono già XML puro e vanno rinominati in .xml); (2) il fornitore della fattura esiste in anagrafica (identificato dalla P.IVA); (3) la fattura contiene almeno una riga prodotto con codice e quantità.
Posso avere due prodotti con lo stesso codice fornitore?
Sì, ma è sconsigliato: crea confusione durante l'importazione fatture. Il sistema identifica i prodotti univoci per combinazione fornitore + codice: se due prodotti hanno lo stesso codice, l'importazione aggiorna solo il primo trovato.
Come collego un prodotto a un cantiere?
Dalla pagina Foglio Lavoro Cantieri, puoi selezionare i prodotti dal magazzino e aggiungerli alla checklist del cantiere. Oppure, quando un addetto fa una richiesta materiale, tu la validi e selezioni il prodotto dal magazzino.
A cosa serve il Livello Rischio?
Il livello di rischio (1-10) è usato per DPI e attrezzature soggette a normative specifiche. Ad esempio, un DPI di livello 3 richiede controlli più frequenti. Il default è 1 (rischio minimo).
La ricerca Gemini è affidabile?
La ricerca Gemini è utile per prodotti nuovi di cui non hai la documentazione, ma va sempre verificata. Per prodotti già noti o critici (DPI, prodotti chimici), è meglio caricare le schede manualmente (più affidabile). Le schede trovate online vengono scaricate e allegate al prodotto, così restano disponibili anche se il link originale non è più attivo.