# Premi fedeltà

> Il catalogo dei premi che i clienti ottengono spendendo i punti fedeltà: la tabella, il modulo in due o tre passi per creare un premio prodotto o un buono sconto, l'attivazione e la disattivazione e l'importazione da documenti.

Ultimo aggiornamento: 22 ottobre 2026. Fonte: https://narciso.io/docs/premi-fedelta/

Un **premio fedeltà** è ciò che un cliente con la carta può ottenere spendendo i suoi punti: un articolo in omaggio oppure un buono sconto. Qui si definisce il catalogo dei premi; i punti e il registro dei movimenti sono in [Punti fedeltà](https://narciso.io/docs/punti-fedelta/), il riscatto si fa in Cassa (vedi [Premi fedeltà in Cassa](https://narciso.io/docs/cassa-fedelta/)).

## Dove si trova e chi può usarlo

Si apre **Scartoffie ▸ Promozioni** e si sceglie la scheda **Premi Fedeltà** (stella). I premi appartengono alla **sede in cui si sta lavorando**.

La scheda è visibile a tutti i ruoli, ma **creare, modificare, disattivare e importare premi** è riservato a **Titolare e Responsabile**. Un Operatore che ci prova vede l'avviso giallo «Operazione riservata a Titolare o Responsabile.» e non cambia nulla.

## La tabella

La tabella ha il titolo «Premi Fedeltà» e il comportamento generale descritto in [Le tabelle dei dati](https://narciso.io/docs/tabelle-dati/). La ricerca («Cerca premio...») cerca nel nome e nella descrizione.

| Colonna | Che cosa mostra |
|---|---|
| **Foto** | La miniatura del premio. Senza foto compare un quadratino tratteggiato con un regalo |
| **Nome** | Il nome, in grassetto |
| **Categoria** | Un'etichetta grigia; «—» se vuota |
| **Tipo** | **Sconto** (verde) oppure **Oggetto** (ambra) |
| **Codice** | Un codice di 8 caratteri, assegnato dal programma **solo ai premi di tipo Sconto**; «—» per gli altri |
| **Dettaglio Sconto** | Per gli sconti «-20%» oppure «-5.00€»; per i premi Oggetto «🎁 Omaggio» |
| **Punti Richiesti** | «N Punti» |
| **Descrizione** | Il testo, troncato; passando il mouse si legge per intero |
| **Stato** | Un interruttore: verde se il premio è attivo, grigio se non lo è |

> **Nota.** Il codice di un premio di tipo Sconto identifica il premio. Non si scrive nella casella «Codice Sconto / Promo» della Cassa, che riconosce solo i codici delle [Promozioni](https://narciso.io/docs/promozioni/).

### Attivare e disattivare

Un clic sull'interruttore **Stato** (suggerimento «Disattiva premio» o «Attiva premio») cambia subito lo stato, senza selezionare la riga. Compare «Premio attivato» oppure «Premio disattivato»; se l'operazione fallisce compare «Errore nel cambiare lo stato del premio».

Un premio disattivato resta nella tabella con l'interruttore spento, non si può riscattare e non compare nell'elenco dei premi della Cassa. Si riattiva con un clic sullo stesso interruttore.

### Rimuovere

1. Si selezionano una o più righe.
2. Si preme **Rimuovi**.
3. Il browser chiede «Disattivare N premi?» (o «Disattivare 1 premio?»). Con **OK** i premi vengono **disattivati**: non si cancellano dal programma.
4. Compare «Premio disattivato» o «Premi disattivati»; se qualcuno non ci riesce, «1 premio non è stato disattivato» oppure «N premi non sono stati disattivati».

Lo storico dei riscatti già fatti resta consultabile in [Punti fedeltà](https://narciso.io/docs/punti-fedelta/).

## Creare un premio

Si preme **Aggiungi** e si sceglie **Crea da zero** (oppure **Importa esistenti**, vedi più sotto). Si apre il modulo «Nuovo premio», a passi. Quanti sono dipende dalla scelta:

| Tipo di premio | Passi |
|---|---|
| Prodotto scelto dall'inventario | **Tipo di premio** → **Punti e conferma** |
| Prodotto non in magazzino | **Tipo di premio** → **Dettagli** → **Punti e conferma** |
| Buono sconto | **Tipo di premio** → **Dettagli** → **Punti e conferma** |

In basso ci sono **Annulla** (chiude senza salvare e senza chiedere conferma), **Indietro**, **Avanti** e, nell'ultimo passo, **Crea** (nuovo premio) o **Salva** (modifica). La **X** in alto e il clic sullo sfondo scuro chiudono senza salvare. Si può tornare a un passo precedente cliccandolo nella barra dei passi.

### Passo «Tipo di premio»

**Tipologia di premio** (obbligatoria) ha due pulsanti:

- **Prodotto**: «Articolo omaggio in negozio»;
- **Buono Sconto**: «Sconto applicato in cassa».

Cambiare tipo **azzera** nome, categoria, foto e collegamenti già scelti.

**Se si sceglie Prodotto** compare «Prodotto da regalare dall'inventario», un campo di ricerca («Cerca prodotto in inventario o nuovo...»):

- mentre i prodotti si caricano si legge «Caricamento prodotti in corso...»; senza risultati, «Nessun prodotto trovato in inventario»;
- ogni prodotto mostra il prezzo e i punti che assegna;
- in cima all'elenco c'è **«Prodotto non in magazzino (Nuovo prodotto)»**, per un regalo che non è nell'inventario: apre il passo Dettagli;
- scelto un prodotto, il campo diventa un riquadro verde con nome, prezzo e punti e una **X** («Rimuovi selezione») per toglierlo.

Scegliendo un prodotto dell'inventario il programma compila da solo il nome del premio («Nome prodotto - Gratis»), la categoria, la foto e i **punti richiesti suggeriti**: i punti assegnati al prodotto oppure, se sono zero, il prezzo di vendita moltiplicato per 5 e arrotondato. Il prodotto scelto non viene bloccato né scaricato dal magazzino.

**Se si sceglie Buono Sconto**:

- **Tipo di sconto**: **Percentuale (%)** oppure **Importo fisso (€)**;
- **Valore sconto**: per la percentuale da 1 a 100, per l'importo a passi di 0,50.

Premendo **Avanti** il programma controlla il passo e mostra una notifica rossa:

| Messaggio | Quando |
|---|---|
| «Per continuare, scegli il prodotto da regalare.» | Tipo Prodotto senza prodotto scelto |
| «Per continuare, inserisci quanto vale lo sconto.» | Valore dello sconto vuoto o zero |
| «La percentuale di sconto non può superare 100.» | Percentuale oltre 100 |

### Passo «Dettagli» (solo buono sconto o prodotto non in magazzino)

| Campo | Regole |
|---|---|
| **Nome del premio** | Obbligatorio |
| **Categoria** | Facoltativa, testo libero |
| **Foto** | Facoltativa: **Sfoglia** per sceglierla dal computer; compaiono anteprima, nome del file e una **X** («Rimuovi foto»). Per un premio già salvato compare «Foto attuale» |
| **Applicabilità dello sconto** (solo buono sconto) | **Su tutto il conto finale**, **Su servizio specifico** oppure **Su prodotto specifico**. Le ultime due fanno comparire un campo di ricerca («Cerca servizio...» o «Cerca prodotto...») con prezzo e punti di ogni voce |
| **Descrizione o condizioni** | Facoltativa: per esempio «Valido su tutti i servizi dal lunedì al venerdì, non cumulabile.» |

Messaggi di controllo:

| Messaggio | Quando |
|---|---|
| «Per continuare, inserisci il nome del premio.» | Nome vuoto |
| «Per continuare, scegli dalla lista il servizio su cui vale lo sconto.» | «Su servizio specifico» senza servizio |
| «Per continuare, scegli dalla lista il prodotto su cui vale lo sconto.» | «Su prodotto specifico» senza prodotto |

### Passo «Punti e conferma»

| Campo | Regole |
|---|---|
| **Costo in punti** | Numero intero da almeno 1. Predefinito 100 |
| **Visibilità nel catalogo** | Interruttore **Attivo e visibile** / **Nascosto**. Un premio nascosto non si può riscattare |
| **Riepilogo del premio** | Riassume Nome, Tipologia (Prodotto omaggio, Sconto N% o Sconto N€), Applicazione (il prodotto scelto, «Tutto il conto», un servizio o un prodotto specifico) e Costo riscatto |

Se il costo è vuoto o inferiore a 1 compare «Inserisci quanti punti servono per questo premio (almeno 1).» Premendo **Crea** o **Salva** il programma ricontrolla tutti i passi e, se uno non è corretto, riporta a quel passo.

> **Nota.** Alla **creazione** un premio nasce sempre attivo, anche se nell'ultimo passo si è scelto «Nascosto». Per nasconderlo basta spegnere l'interruttore **Stato** nella tabella. In modifica la scelta viene rispettata.

### Dopo il salvataggio

La finestra si chiude e il premio compare, o si aggiorna, nella tabella. **Non compare nessuna notifica di conferma.** Ai premi di tipo Sconto il programma assegna un codice di 8 caratteri.

Se il salvataggio non riesce compare una notifica rossa e la finestra resta aperta, con il messaggio del programma oppure «Errore durante il salvataggio del premio». I messaggi più comuni:

| Messaggio | Significato |
|---|---|
| «Un premio sconto deve avere uno sconto maggiore di zero: indica una percentuale o un importo in euro.» | Lo sconto è a zero |
| «I punti richiesti per un premio devono essere almeno 1.» | Il costo in punti è zero |
| «Prodotto non trovato o non autorizzato» / «Servizio non trovato o non autorizzato» | Il prodotto o il servizio collegato non esiste più: se ne sceglie un altro |
| «Validazione fallita» | Un campo supera i limiti: nome tra 2 e 100 caratteri, descrizione al massimo 500, punti almeno 1, percentuale tra 0 e 100. Il messaggio non dice quale campo: si ricontrollano i valori |

### Procedure

**Creare un premio «prodotto in omaggio»**

1. **Aggiungi ▸ Crea da zero**.
2. Si lascia **Prodotto** e si cerca e sceglie il prodotto dall'inventario. **Avanti**.
3. Si controlla il **Costo in punti**. **Crea**.

**Creare un buono sconto**

1. **Aggiungi ▸ Crea da zero** e si sceglie **Buono Sconto**.
2. Si sceglie **Percentuale** o **Importo fisso** e si scrive il valore. **Avanti**.
3. Si scrive il nome e si sceglie l'applicabilità (tutto il conto, un servizio o un prodotto), eventualmente con categoria, foto e descrizione. **Avanti**.
4. Si imposta il costo in punti. **Crea**.

## Modificare un premio

Si seleziona la riga con un clic, si preme **Modifica**, si cambiano i campi e si preme **Salva**.

Per un premio «prodotto dall'inventario» il modulo non mostra Nome, Categoria, Foto e Descrizione, che derivano dal prodotto: per cambiarli occorre scegliere «Prodotto non in magazzino». Un premio di tipo Oggetto creato con l'importazione (senza prodotto collegato) richiede, alla modifica, di scegliere un prodotto o «Prodotto non in magazzino» prima di proseguire.

## Importare i premi da documenti

**Aggiungi ▸ Importa esistenti** apre la finestra dell'importazione guidata, con la descrizione: «Carica fogli o documenti che descrivono dei premi riscattabili con i punti fedeltà. L'Intelligenza Artificiale li legge e prepara i premi: prima di inserirli li rivedi e scegli quali importare.» Il funzionamento (caricamento, revisione con il file originale accanto, inserimento) è lo stesso descritto in [Importare clienti](https://narciso.io/docs/importare-clienti/).

Per ogni premio il programma cerca **nome** (obbligatorio), **descrizione**, **punti richiesti** (obbligatori, numero intero da almeno 1) e **categoria**. Ogni premio importato è di tipo **Oggetto** (un articolo da consegnare) e nasce attivo. I buoni sconto non si importano: si creano con **Crea da zero**.

L'importazione è riservata a Titolare e Responsabile.

## Problemi frequenti

| Situazione | Che cosa fare |
|---|---|
| Un premio non compare in Cassa | È disattivato, oppure è stato creato in un'altra sede: si controlla l'interruttore Stato e la sede in alto |
| Il cliente ha riscattato un premio ma non ha ricevuto lo sconto | Il riscatto toglie solo i punti: lo sconto o il regalo si danno a mano (vedi [Premi fedeltà in Cassa](https://narciso.io/docs/cassa-fedelta/)) |
| Il codice del premio non funziona nella casella codici della Cassa | È previsto: quella casella riconosce solo i codici delle [Promozioni](https://narciso.io/docs/promozioni/) |
| Ho scelto «Nascosto» ma il premio è attivo | Alla creazione il premio nasce sempre attivo: si spegne l'interruttore Stato nella tabella |
| Non riesco a salvare e il messaggio è «Validazione fallita» | Si controllano nome (2-100 caratteri), descrizione (massimo 500), punti (almeno 1) e valore dello sconto |

## Voci correlate

- [Punti fedeltà](https://narciso.io/docs/punti-fedelta/)
- [Premi fedeltà in Cassa](https://narciso.io/docs/cassa-fedelta/)
- [Promozioni](https://narciso.io/docs/promozioni/)
- [Servizi](https://narciso.io/docs/servizi/)
- [Prodotti](https://narciso.io/docs/prodotti/)