Prodotti e Servizi

Il catalogo Prodotti ti permette di gestire tutti gli articoli e i servizi che vendi. Avere un catalogo ben organizzato velocizza la creazione delle fatture e garantisce prezzi e IVA sempre corretti.

---

Elenco prodotti

Dalla sezione Prodotti nel menu laterale accedi all'elenco completo. Per ogni prodotto vedi:

• Codice — Identificativo univoco (generato automaticamente)
• Nome — Nome del prodotto o servizio
• Categoria — Tipo di prodotto
• Prezzo — Prezzo di vendita
• Stato — Attivo/Inattivo

---

Creare un nuovo prodotto

1. Clicca Nuovo prodotto nell'intestazione
2. Compila i dati nelle varie sezioni
3. Clicca Salva

Informazioni base

Campo	Descrizione
Codice	Generato automaticamente dal sistema
Nome	Nome del prodotto (obbligatorio)
Descrizione	Descrizione estesa per uso interno
Categoria	Tipo di prodotto (Servizi, Prodotti, Licenze, ecc.)
Unità	Unità di misura (pz, ora, kg, ecc.)
Barcode	Codice a barre (opzionale)
Attivo	Se disattivato, il prodotto non appare nelle selezioni

Prezzi

Campo	Descrizione
Prezzo di acquisto	Quanto paghi tu per questo prodotto (per calcolo margini)
Prezzo di vendita	Prezzo al cliente
Prezzo base	Prezzo alternativo (es. per listini diversi)
Prezzo IVA inclusa	Se attivo, i prezzi sono comprensivi di IVA
Aliquota IVA	IVA predefinita per questo prodotto

💡 Quando inserisci un prodotto in fattura, vengono usati automaticamente il prezzo di vendita e l'aliquota IVA configurati.

Magazzino

Se la categoria lo prevede, puoi gestire le giacenze:

Campo	Descrizione
Quantità in stock	Giacenza attuale
Scorta minima	Soglia sotto la quale riordinare

---

Categorie prodotto

Le categorie (o "Tipi prodotto") ti permettono di organizzare il catalogo e definire comportamenti comuni.

Gestire le categorie

1. Dall'elenco prodotti, clicca l'icona Categorie nell'intestazione
2. Puoi:
   • Creare nuove categorie
   • Modificare nome, codice e descrizione
   • Definire l'aliquota IVA predefinita per la categoria
   • Attivare/disattivare la gestione stock
   • Eliminare categorie non utilizzate

Categorie predefinite

Al setup vengono create categorie di esempio:

Codice	Nome	Descrizione
SRV	Servizi	Prestazioni professionali
PRD	Prodotti	Articoli fisici
LIC	Licenze	Software e licenze

---

Unità di misura

Le unità di misura indicano come viene venduto il prodotto:

Unità	Descrizione	Uso tipico
pz	Pezzi	Prodotti fisici, articoli
ora	Ore	Consulenze, servizi
gg	Giorni	Noleggi, consulenze
kg	Kilogrammi	Merce a peso
m	Metri	Materiali lineari
m²	Metri quadri	Superfici, pavimenti
m³	Metri cubi	Volumi, trasporti
lt	Litri	Liquidi

Puoi inserire qualsiasi unità personalizzata nel campo.

---

Stampa scheda prodotto

Puoi generare un PDF con i dati del prodotto:

1. Apri la scheda prodotto
2. Clicca Stampa PDF
3. Si apre l'anteprima del documento
4. Scarica o stampa

---

Uso nelle fatture

Quando crei una fattura:

1. Nella riga, seleziona un prodotto dal campo Prodotto
2. Vengono compilati automaticamente:
   • Descrizione
   • Prezzo unitario
   • Aliquota IVA (dalla categoria)
   • Flag "IVA inclusa"
3. Modifica la quantità
4. Il totale viene calcolato automaticamente

Puoi comunque modificare manualmente qualsiasi campo della riga.

---

Suggerimenti

• Crea categorie sensate — Raggruppa i prodotti per tipo di IVA o per reparto
• Usa nomi descrittivi — Il nome appare in fattura, rendilo chiaro per il cliente
• Imposta l'IVA corretta — Configura l'aliquota IVA nella categoria per evitare errori
• Prezzi IVA inclusa — Usa questa opzione se esponi prezzi al pubblico (B2C)
• Disattiva invece di eliminare — Per prodotti non più venduti, disattivali per mantenere lo storico | kit | Kit | Set di prodotti |

Gestione inventario

Se track_inventory: true, Lema:

1. Scala automaticamente le quantità quando si emette una fattura
2. Avvisa quando si raggiunge min_stock_level
3. Blocca (opzionale) la vendita se stock_quantity = 0

// Esempio movimento magazzino
const stockMovement = {
  product_id: "product-uuid",
  quantity: -5,              // Negativo = uscita
  type: "sale",              // sale, purchase, adjustment
  reference: "INV-2024-0042", // Riferimento documento
  notes: "Vendita fattura n. 42"
};

Listini prezzi

Per gestire prezzi differenziati:

interface PriceList {
  id: string;
  name: string;              // "Listino base", "Rivenditori", etc.
  currency: string;
  discount_percent?: number; // Sconto % su listino base
  prices: Array<{
    product_id: string;
    price: number;           // Prezzo specifico
  }>;
}

Importazione CSV

code,name,category,sale_price,unit,vat_rate
CONS-DEV,"Sviluppo software",SRV,95.00,ora,8.1
CONS-PM,"Project management",SRV,110.00,ora,8.1
HW-MOUSE,"Mouse wireless",PRD,29.90,pz,8.1
SW-OFF365,"Microsoft 365",LIC,12.50,mese,8.1

Best practices

1. Codici parlanti - Usa codici che identifichino categoria e prodotto
2. Prezzi IVA esclusa - I prezzi sono sempre al netto dell'IVA
3. Unità coerenti - Usa sempre la stessa unità per lo stesso tipo di prodotto
4. Descrizioni complete - Aiutano nella ricerca e nelle fatture
5. Review periodica - Disattiva prodotti non più venduti invece di eliminarli