Buoni regalo in Maho: venderli, consegnarli e incassarli
Dal 26.1 il buono regalo è un tipo di prodotto del core: si crea dall'admin, si consegna per email con QR e si riscatta anche in parte.
Un buono regalo è il prodotto più semplice da vendere e il più complicato da tenere in ordine: un codice, un saldo, una scadenza, un destinatario che non è chi paga, e un rimborso che deve tornare sul buono invece che sulla carta. Fino alla 26.1 tutto questo voleva dire un’estensione di terze parti da installare, configurare e tenere allineata a ogni aggiornamento. Dal 26.1 il buono regalo è un tipo di prodotto del core di Maho, con il suo pannello in admin e il suo pezzo di checkout.
Questa guida riguarda il lavoro di chi gestisce il negozio: abilitare la funzione, creare il prodotto, seguire l’acquisto, il riscatto e il rimborso. Il codice del modulo non serve.
Abilitare i buoni regalo
Si parte da System > Configuration > Sales > Gift Cards. Le impostazioni principali, con lo scope su cui agiscono:
| Impostazione | Cosa fa | Scope |
|---|---|---|
| Enable Gift Cards | accende o spegne la funzione | Website |
| Code Length | quanti caratteri ha il codice generato, 16 per default | Global |
| Code Prefix | prefisso comune a tutti i codici, per esempio GC |
Global |
| Default Expiry (days) | giorni prima della scadenza, 0 significa nessuna scadenza |
Store View |
| Refund Expiration Extension (days) | quanti giorni aggiungere alla scadenza quando un rimborso torna su un buono scaduto o in scadenza, 30 per default, 0 disattiva l’estensione |
Store View |
| Allow Gift Message | messaggio personalizzato allegato al regalo | Store View |
| Show QR Code | mostra il QR sul buono e nella email | Store View |
| Show Barcode | mostra il codice a barre Code128 | Store View |
Nello stesso gruppo trovi il template della email di notifica e l’identità del mittente. Il QR e il codice a barre non chiamano servizi esterni: si generano dentro Maho, quindi il PDF del buono funziona anche su un server senza rete in uscita.
🎁 Nota sul pacchetto: il QR non è decorazione. È quello che trasforma un codice da sedici caratteri in qualcosa che si può stampare e far leggere alla cassa di un negozio fisico.
Creare il prodotto buono regalo
Il buono non è un coupon, è un prodotto, e si crea come tale.
- Vai in Catalog > Manage Products e premi Add Product.
- Scegli il tipo Gift Card.
- Nel tab Gift Card decidi come si sceglie l’importo:
- Fixed Amount(s): il cliente sceglie da un elenco, per esempio
25,50,100,250; - Custom Amount: il cliente scrive una cifra dentro un minimo e un massimo;
- Combined: entrambe le strade.
- Fixed Amount(s): il cliente sceglie da un elenco, per esempio
- Se il prodotto deve comportarsi diversamente dal resto del catalogo, sovrascrivi qui la durata del buono e la possibilità di lasciare un messaggio: ogni campo ha l’opzione Use Config per ereditare il valore di sistema.
- Imposta il Price al valore più basso disponibile, perché è quello che lo storefront mostra come “da”, e la Tax Class secondo il trattamento fiscale che vale per i buoni nel tuo paese.
Il resto è un prodotto normale: stato, visibilità, siti, tassa. La quantità si gestisce come per qualsiasi altro articolo.
Come lo compra il cliente
Aggiunto al carrello, il buono chiede quattro cose: l’importo, il nome e la email di chi lo riceve, il nome di chi lo manda e, se è attivo, un messaggio. C’è anche una data di consegna: se la lasci vuota la email parte subito, altrimenti parte in quel giorno, con un cron che si occupa degli invii programmati.
Nel carrello il buono compare come riga a sé, con il destinatario e la data. È un regalo, quindi non entra nel conteggio della spedizione come un prodotto fisico.
🎁 Nota sul pacchetto: la data di consegna è l’unico campo di questa guida che dipende dal cron. Se il server non lo esegue, i regali programmati restano in coda. Il resto funziona comunque.
Come si riscatta
Il codice si inserisce in due punti: nel riepilogo del carrello e nel passo pagamento del checkout. In entrambi i casi il buono compare nell’elenco degli applicati, con il suo saldo e il pulsante per toglierlo.
Le regole sono tre.
- Riscatto parziale: se il buono vale più dell’ordine, si scala solo quello che serve e il resto rimane sul buono per la volta dopo.
- Più buoni sullo stesso ordine: l’ordine può usare più codici insieme.
- Copertura totale: quando i buoni coprono tutto il totale, Maho attiva da solo il metodo di pagamento “Free”. Il buono non è un metodo di pagamento, è un pagamento anticipato che scala il dovuto, quindi l’ordine si chiude senza chiedere altro al cliente.
Il saldo, senza svuotare il carrello
Chi ha un buono in mano vuole sapere quanto vale prima di comprare. La pagina del carrello ha un controllo del saldo che non richiede di applicare il codice all’ordine: si scrive il codice, si legge saldo e scadenza. Le richieste sono limitate a dieci al minuto, perché un modulo libero che risponde “codice inesistente” o “saldo zero” è anche un modo per capire quali codici esistono.
Il lavoro in admin
Due griglie, sotto Sales > Gift Cards:
- Manage Gift Cards: codice, stato (Active, Used, Expired, Disabled), saldo, saldo iniziale, scadenza, data di creazione. Dalla griglia puoi aprire la scheda, cancellare in massa, cambiare lo stato in massa, stampare il PDF e inviare di nuovo la email di notifica.
- Gift Card History: tutte le transazioni, con il saldo prima e dopo e il commento lasciato dall’operatore.
I buoni si possono anche creare a mano, senza una vendita: Add New Gift Card, codice lasciato vuoto per farlo generare, saldo, destinatario, scadenza e un commento interno. Serve per i premi, per le sostituzioni e per i rimborsi che il cliente vuole tenere in negozio.
🎁 Nota sul pacchetto: il codice si può lasciare vuoto ma non si può cambiare dopo il salvataggio. Se stai importando buoni acquistati altrove, controlla il codice prima di premere Save.
Rimborsi e scadenze
Un rimborso può tornare sul buono che ha pagato l’ordine, e il saldo si ricarica con una voce nella storia. Se il buono nel frattempo è scaduto, l’impostazione Refund Expiration Extension gli restituisce un margine di giorni, così il cliente non riceve indietro un codice che non può usare. Le scadenze si gestiscono con il cron del modulo, che passa i buoni allo stato Expired.
Come si incastra con il resto
Il buono convive con i coupon: sono cose diverse, il coupon sconta, il buono paga. In fattura e in nota credito il totale dei buoni ha una riga sua, e l’ordine conserva il codice usato, quindi la ricostruzione di un rimborso non richiede di cercare altrove.
Se il negozio vende online e in un punto vendita, il PDF con QR e codice a barre è la parte da stampare: il codice è lo stesso, il canale cambia.
🎁 Nota sul pacchetto: un buono mai usato è un ricavo già incassato. Non è un errore contabile, è la ragione per cui i buoni piacciono a chi tiene la cassa.
Testo preparato con l'aiuto dell'AI e verificato sulla fonte prima della pubblicazione. Può contenere errori: se ne trovi uno, segnalalo.Leggi il Manifesto
Il tuo negozio vende ancora?
Raccontaci da dove parti: ti rispondiamo con una prima valutazione, senza impegno.
Chiedi l'analisi del negozio