Prodotti

Il catalogo prodotti elenca gli articoli che il tuo internet café o gaming center vende. Include cibo, bevande, snack, accessori e qualsiasi altro bene fisico offerto ai clienti. Ogni prodotto ha un prezzo definito, una categoria, un'aliquota fiscale e un livello di scorta. I prodotti si integrano con il sistema ordini, permettendo ai cassieri di creare ordini, tracciare le vendite e gestire le scorte.

I prodotti sono gestiti nella scheda Prodotti della pagina Magazzino nella barra di navigazione principale. La scheda offre una vista a tabella e una vista a griglia. Le schede della griglia mostrano la foto del prodotto, il prezzo e un badge Disponibile o Esaurito.

Campi del Prodotto

Ogni record prodotto contiene le seguenti informazioni:

Campo	Descrizione
`name`	Il nome del prodotto visualizzato nell'interfaccia ordini. Deve essere univoco (senza distinzione maiuscole/minuscole).
`category`	Un'etichetta di testo che raggruppa prodotti correlati (ad esempio "Bevande", "Snack", "Accessori"). Utilizzata per filtraggio e reportistica.
`unit`	L'unità di misura per il tracciamento scorte (ad esempio "pezzo", "kg", "litro", "lattina", "bottiglia").
`barcode`	Un valore di codice a barre opzionale per l'integrazione con scanner. I cassieri possono scansionare il codice a barre di un prodotto per aggiungerlo rapidamente a un ordine.
`sale_price`	Il prezzo di vendita in unità minori di valuta (ad esempio centesimi). L'importo addebitato al cliente per unità.
`vat_rate`	La percentuale IVA (Imposta sul Valore Aggiunto) applicata a questo prodotto (ad esempio 18 per IVA al 18%). Utilizzata per calcolare la componente fiscale di ogni vendita.
`stock`	Il livello di scorta corrente come quantità decimale. Aggiornato automaticamente quando vengono effettuati ordini e quando vengono registrate ricevute di magazzino. Lo stock non viene modificato sul prodotto stesso. Usa la scheda Stato Magazzino della pagina Magazzino.
`min_stock`	La soglia di riordino. Quando il livello di scorta scende al di sotto o al limite di questo valore, il prodotto viene segnalato come critico nella scheda Stato Magazzino. Zero significa nessuna soglia.
`description`	Una descrizione testuale opzionale per dettagli aggiuntivi sul prodotto.
`photo`	Una foto opzionale del prodotto mostrata nella vista a griglia e nel menu della caffetteria.

Rimuovere un Prodotto dalla Vendita

Un prodotto che non deve più essere offerto viene rimosso con l'azione Rimuovi dalla Vendita nella scheda Prodotti. Una conferma spiega che questo elimina il prodotto dal catalogo e non può essere annullato. Gli ordini passati che includevano il prodotto mantengono gli snapshot delle loro righe, così i dati storici di vendita vengono conservati.

Tracciamento Scorte

HandyCafe mantiene un conteggio corrente delle scorte per ogni prodotto. Questo valore viene aggiornato automaticamente dal sistema in risposta a:

Vendite: Quando un prodotto viene venduto tramite un ordine, le scorte diminuiscono della quantità ordinata.
Ricevute di magazzino: Quando nuove scorte vengono ricevute e registrate nella scheda Ricevuta di Magazzino della pagina Magazzino, le scorte aumentano di conseguenza.
Rettifiche manuali: La scheda Stato Magazzino offre le azioni Correggi stock, Spreco e Conteggio per contabilizzare deperimento, rottura, errori di conteggio o altre discrepanze.

Le scorte non possono essere modificate nell'editor dei prodotti. Tutte le variazioni di scorta passano dalla scheda Stato Magazzino, così ogni cambiamento finisce nella cronologia dei movimenti.

Registro Scorte Prodotto

Ogni variazione del livello di scorta di un prodotto viene registrata nel registro scorte prodotto, creando una traccia di controllo completa:

Motivo	Descrizione
`sale`	Scorte diminuite a causa di un ordine cliente. Collegato al record dell'ordine specifico.
`purchase`	Scorte aumentate a causa di un acquisto di inventario. Collegato alla voce di inventario specifica.
`adjustment`	Scorte rettificate manualmente da un cassiere o amministratore.
`waste`	Scorte diminuite a causa di deperimento, rottura o svalutazione.
`return`	Scorte aumentate a causa di un reso cliente o annullamento ordine.

Ogni voce del registro registra la variazione di quantità (positiva per gli aumenti, negativa per le diminuzioni), il nuovo livello di scorta dopo la variazione, chi ha effettuato la variazione e una nota opzionale che spiega il motivo.

Categorie Prodotto

I prodotti sono raggruppati per categoria utilizzando un campo di testo libero. Le categorie comuni includono:

Bevande (bibite, acqua, bevande energetiche)
Bevande Calde (caffè, tè, cioccolata calda)
Snack (patatine, caramelle, barrette di cioccolato)
Cibo (panini, wrap, pasti caldi)
Accessori (cuffie, chiavette USB, tappetini per mouse)

Le categorie sono utilizzate per il filtraggio nell'interfaccia ordini. I cassieri possono passare rapidamente tra le categorie per trovare il prodotto giusto. Le categorie servono anche per il raggruppamento nei report di vendita.

Non esiste un'interfaccia separata di gestione categorie. Le categorie vengono create implicitamente quando assegni un nome di categoria a un prodotto. Per rinominare una categoria, aggiorna il campo categoria su tutti i prodotti che usano il vecchio nome.

Creare un Prodotto

Per aggiungere un nuovo prodotto al catalogo:

Apri la pagina Magazzino dalla barra laterale e passa alla scheda Prodotti.
Clicca il pulsante Nuovo Prodotto.
Inserisci il nome (deve essere univoco).
Seleziona o digita una categoria.
Scegli l'unità di misura.
Imposta il prezzo di vendita (l'importo addebitato ai clienti).
Imposta l'aliquota IVA.
Opzionalmente inserisci un codice a barre per il supporto scanner e aggiungi una foto.
Clicca Salva.

Le scorte iniziali non vengono impostate qui. Registra la quantità di apertura con una ricevuta di magazzino o con l'azione Conteggio nella scheda Stato Magazzino. Un prodotto può anche essere creato direttamente da una riga di ricevuta quando una consegna contiene un articolo non ancora presente nel catalogo.

Modificare un Prodotto

Seleziona un prodotto dall'elenco per aprire il suo editor. Puoi aggiornare qualsiasi campo inclusi nome, prezzo, categoria, aliquota IVA, codice a barre e foto. Le modifiche hanno effetto immediato. Se aggiorni il prezzo, il nuovo prezzo si applica a tutti gli ordini futuri. L'azione Rimuovi dalla Vendita elimina il prodotto dal catalogo dopo una conferma.

Gli ordini passati non sono influenzati dalle variazioni di prezzo. Ogni articolo dell'ordine conserva il unit_price al momento della vendita come snapshot.

Integrazione con gli Ordini

Quando un cassiere crea un ordine e aggiunge un prodotto:

Il prezzo di vendita corrente del prodotto e l'aliquota IVA vengono copiati nell'articolo dell'ordine come snapshot.
Il totale riga viene calcolato come prezzo_unitario * quantita.
Quando l'ordine viene completato, il livello di scorta del prodotto viene decrementato della quantità ordinata.
Viene creata una voce nel registro scorte con motivo = 'sale' collegata all'ordine.

Se l'ordine viene successivamente annullato o rimborsato, le scorte possono essere ripristinate tramite una voce di reso nel registro scorte.