> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/it/accademia-di-pianificazione/yoplanning-parametrage/parametrage-produit/les-forfaits-prepayes-bons-cadeaux-cheques-cadeaux/carnet-de-bons.md).

# Libro voucher

Vendita simultanea di più ingressi o sessioni dello stesso prodotto, a un prezzo unico: 1 codice, N utilizzi.

***

### Qual è lo scopo di un libretto di buoni sconto?

Un libretto di buoni consente di vendere in anticipo un numero prestabilito di utilizzi di un prodotto, a un prezzo fisso. Ad esempio: **10 utilizzi per 100 €**. Il cliente paga 100 €, riceve **un codice unico** e questo codice è **valido 10 volte** per il prodotto in questione.

Questa è la risposta a esigenze quali:

* Abbonamento per 10 lezioni di gruppo,
* libretto di 5 ingressi per la piscina / arrampicata / percorso avventura tra gli alberi,
* Abbonamento "20 discese" per un'attività,
* Pacchetto di sedute venduto a una tariffa preferenziale rispetto alla singola seduta.

> **Dalla versione 11.9 (agosto 2026).** In precedenza, questa esigenza veniva soddisfatta utilizzando impropriamente il **pacchetto prepagato**, il che comportava prezzi errati e un contatore di sessioni rimanenti impreciso. Il libretto di voucher è ora il meccanismo ufficiale: vedi Libretto di voucher o pacchetto prepagato?

***

### Principio operativo

Un quaderno non è una nuova tipologia di prodotto: è un **buono regalo multiuso**. Viene creato nella stessa sezione "Buono regalo" di un prodotto, con un campo aggiuntivo: **Usi inclusi**.

| Usi inclusi              | Risultato                                                   |
| ------------------------ | ----------------------------------------------------------- |
| `1` (valore predefinito) | Buono regalo classico: 1 codice, 1 utilizzo                 |
| `10`                     | Notebook: 1 codice, 10 utilizzi, venduto al prezzo indicato |

Punti chiave:

* **Il prezzo inserito è il prezzo dell'intero abbonamento**, non il prezzo di una singola sessione. "10 ingressi per 100 €" ha un prezzo di **100 €** e include 10 utilizzi.
* L'acquisto genera **un solo codice**, indipendentemente dal numero di utilizzi.
* Ogni volta che una prenotazione viene pagata con questo codice, il contatore di utilizzo rimanente **diminuisce**. Se la prenotazione viene annullata, l'utilizzo viene **rimborsato**.
* Il prezzo indicato nel libretto **sostituisce** il prezzo della sessione al momento della prenotazione, incluse eventuali tariffe scontate o stagionali.
* La **data di validità** si applica all'intero libretto: alla scadenza, gli utilizzi non utilizzati andranno persi.

***

### Crea un libretto di buoni sconto

1. **Accedi a Yoplanning.pro.**
2. Menu **Amministrazione** → **Prodotti**.
3. Apri il menu con i **tre puntini** nell'angolo in alto a destra del prodotto in questione, quindi **modifica il prodotto**.
4. Nella sezione **“Buono regalo”**, clicca su **Aggiungi un buono** e inserisci le seguenti informazioni:
   * il **nome** del voucher, così come verrà visualizzato dal cliente (ad esempio, "libretto di biglietti da 10 ingressi");
   * il **prezzo**: il prezzo del notebook completo (ad esempio 100 €);
   * la **validità** in numero di mesi (vuoto = nessuna scadenza);
   * **Utilizzi inclusi**: il numero di volte in cui viene utilizzato il notebook (ad esempio, 10). Valori accettati: da 1 a 999.
5. *(Opzionale)* Sezione **Multiprodotto**: inserisci un **tag prodotto** in modo che il notebook possa essere utilizzato su tutti i prodotti con quel tag, e non solo sul prodotto corrente.
6. Nella sezione **“Vendita online”**, seleziona l'opzione **vendita online di voucher** se desideri che il libretto sia acquistabile tramite il modulo di prenotazione.
7. **Salva.**

Una volta registrato, il buono compare nell'elenco dei buoni del prodotto con la dicitura **"10 utilizzi per buono"**.

> **Il campo "Usi inclusi" non viene visualizzato?** Probabilmente stai modificando un **piano prepagato** (prodotto di tipo credito). Questo campo è riservato ai voucher collegati a un prodotto; in un piano prepagato, è nascosto e il valore è impostato automaticamente a 1.

***

### Vendita di un libretto di buoni

#### Online, tramite il modulo di prenotazione

Se la vendita online dei buoni regalo è abilitata, il libretto viene offerto come qualsiasi altro buono regalo. Il cliente:

1. sceglie il notebook,
2. pagare il prezzo del notebook,
3. riceve il suo **biglietto con un codice univoco**.

Il cliente può acquistare **più notebook** nello stesso ordine: in tal caso riceverà un codice per ogni notebook.

#### Al bancone

Il servizio di sportello utilizza lo stesso modulo di prenotazione, collegato al tuo account. La vendita di un opuscolo avviene lì esattamente come online.

#### Disponibile per la vendita manuale tramite ordine

1. Apri un ordine esistente oppure crea un **ordine vuoto** (menu **Ordini** → tre puntini → **Crea un ordine vuoto**) e inserisci le informazioni del cliente.
2. Fai clic su **“Vendi un buono”**.
3. Seleziona l'opzione corretta corrispondente all'opuscolo. Nel campo del prezzo verrà visualizzato **"Prezzo per 10 utilizzi"**: questo è il prezzo totale dell'opuscolo.
4. Convalida, riscuoti il ​​pagamento e invia il **biglietto** al cliente.

> Nelle vendite manuali, si vende **un notebook alla volta**: il campo Quantità viene compilato con il numero di utilizzi consentiti per il notebook. Per vendere due notebook allo stesso cliente, ripetere la procedura.

***

### Usa un quaderno

#### Dal cliente, online

1. Il cliente prenota la sua attività normalmente tramite il tuo modulo di prenotazione.
2. Nell'ultimo passaggio, prima del pagamento, inserisce il **codice presente nel libretto** nell'apposito campo.
3. Si applica la tariffa per l'opuscolo e il costo viene detratto in base al numero di utilizzi.

#### Da te, dal programma

1. Effettua l'ordine con i servizi abituali.
2. Nella fase di pagamento, clicca su **“Utilizza un voucher”** sotto il pulsante *Aggiungi un pagamento*.
3. Inserisci il **codice** del notebook (o il nome del cliente che lo possiede) e conferma.

#### Cosa devi sapere

* **Un singolo codice può coprire più partecipanti nello stesso ordine**, fino al limite degli utilizzi rimanenti. Esempio: una famiglia di 3 persone su un carnet da 10 → 3 utilizzi detratti con un singolo codice.
* **Non è possibile inserire lo stesso codice due volte nello stesso ordine.** Se è necessario apportare una modifica, modificare l'ordine anziché reinserire il codice.
* **Il notebook si utilizza sul prodotto a cui è attaccato** oppure su qualsiasi prodotto che riporti l'etichetta specificata nella sezione Multi-prodotto.
* **Il prezzo dell'abbonamento ha la precedenza sul prezzo della singola sessione**, inclusa una tariffa a scaglioni: il prezzo applicato è il prezzo unitario dell'abbonamento (prezzo dell'abbonamento ÷ numero di utilizzi).
* **In caso di cancellazione** di una prenotazione pagata con il libretto, gli utilizzi in questione vengono rimborsati dal libretto stesso.

***

### Monitorare gli utilizzi rimanenti

Il menu **Voucher** della tua squadra elenca tutti i voucher emessi, inclusi i libretti.

Per ogni notebook, vedi:

* il **codice**,
* il **cliente**,
* la **data di scadenza**,
* lo **stato**: *Valido*, *Parzialmente usato*, *Usato* o *Scaduto*,
* il contatore **“Rimanente: 7 / 10”**.

È possibile filtrare per cliente, prodotto, periodo o stato e cercare direttamente un codice. L'esportazione dei dati recupera le colonne **quantità iniziale**, **quantità rimanente** e **valore residuo**, utili a fini contabili relativi alle vendite prepagate.

> Il filtro di stato **“Usato”** si basa sul fatto che è stato effettuato almeno un utilizzo: verrà visualizzato un notebook avviato ma non ancora esaurito. Fare riferimento al contatore “Rimanente: X / Y” per la riga corrispondente e determinare lo stato effettivo.

***

### Libretto di buoni o piano prepagato?

Entrambi vengono venduti in anticipo, ma non hanno lo stesso valore.

|                     | **Libretto di buoni**                                                    | **Pacchetto prepagato / buono regalo**                             |
| ------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| Cosa viene detratto | **Numerosi usi**                                                         | Un **importo in euro**                                             |
| Perimetro           | Il prodotto del buono (o i prodotti che recano la sua etichetta)         | Qualsiasi prodotto venduto online                                  |
| Prezzo applicato    | Il prezzo dell'opuscolo, che sostituisce il prezzo della sessione        | La tariffa standard della sessione, pagata con carta di credito    |
| Contatore visibile  | "Punteggio rimanente: 7/10"                                              | Saldo in euro                                                      |
| Resto               | Gli articoli non utilizzati vengono persi alla scadenza.                 | Saldo non speso in euro                                            |
| Caso d'uso tipico   | Abbonamento da 10 sessioni, libretto di iscrizione, materiale didattico. | Rimborso in contanti, regalo di qualsiasi importo, credito cliente |

**In pratica:** Non appena vendi *un certo numero di sessioni* per un'attività, utilizza un **carnet di buoni**. Riserva il pacchetto prepagato ai casi in cui vendi *una somma di denaro* da spendere liberamente.

***

### Errori comuni e relative soluzioni

| Comunicazione/sintomo                                                              | Causa                                                                                          | Soluzione                                                                                                          |
| ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **"Già utilizzato"**                                                               | Il notebook non è più disponibile per l'uso.                                                   | Controlla il contatore nel menu **Buoni**. Vendi un nuovo libretto se necessario.                                  |
| **" Scaduto "**                                                                    | La data di scadenza dell'opuscolo è superata.                                                  | La validità si applica all'intero libretto. Modifica la data di scadenza del buono se desideri offrire uno sconto. |
| **Questo buono non corrisponde ad alcun articolo di questo ordine**                | Il prodotto prenotato non è quello contenuto nel notebook e non reca l'etichetta del prodotto. | Seleziona il prodotto sul buono oppure inserisci il codice prodotto nella sezione "Multiprodotto" del buono.       |
| **"La quantità del buono non corrisponde alla quantità dell'articolo"**            | Il comando richiede più utilizzi di quelli rimasti nel notebook                                | Riduci il numero di partecipanti all'ordine oppure aggiungi un altro metodo di pagamento.                          |
| **Il campo "Usi inclusi" è mancante.**                                             | Stai modificando un piano prepagato (prodotto a credito)                                       | Crea il voucher dalla pagina dei dettagli del prodotto, non da un piano prepagato.                                 |
| **Il registro delle prenotazioni non è presente sul sito web delle prenotazioni.** | Per questo prodotto non è abilitata la vendita online di buoni regalo.                         | Sezione **Vendita online** della scheda prodotto: selezionare la casella per la vendita online dei buoni.          |

***

### migliori prassi

* **Indicare chiaramente il contenuto dell'opuscolo** nel suo nome: "Opuscolo con 10 voci - adulti" è più descrittivo di "Opuscolo".
* **Imposta un periodo di validità coerente** con la tua stagione. Un periodo di validità vuoto significa "nessuna scadenza": gli utilizzi restano validi a tempo indeterminato.
* **Test prima dell'apertura commerciale**: venditi un libretto, effettua una transazione, controlla il contatore "Rimanente" e il prezzo applicato all'ordine.
* **Comunicare le condizioni** di utilizzo: ambito dei prodotti interessati, data di scadenza, nessun rimborso per i prodotti non utilizzati.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.yoplanning.support/it/accademia-di-pianificazione/yoplanning-parametrage/parametrage-produit/les-forfaits-prepayes-bons-cadeaux-cheques-cadeaux/carnet-de-bons.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
