> 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/yoplanning-academie/yoplanning-parametrage/parametrage-produit/les-forfaits-prepayes-bons-cadeaux-cheques-cadeaux/carnet-de-bons.md).

# Carnet de bons

Vendre en une seule fois plusieurs entrées ou séances sur un même produit, à un prix global : 1 code, N utilisations.

***

### À quoi sert un carnet de bons ?

Un **carnet de bons** permet de vendre d'avance un nombre défini d'utilisations sur un produit, à un prix forfaitaire. Par exemple : **10 entrées pour 100 €**. Le client paie 100 €, reçoit **un seul code**, et ce code est **valable 10 fois** sur le produit concerné.

C'est la réponse aux besoins de type :

* carte 10 séances de cours collectifs,
* carnet de 5 entrées piscine / escalade / accrobranche,
* abonnement « 20 descentes » sur une activité,
* pack séances vendu à tarif préférentiel par rapport à la séance à l'unité.

> **Depuis la version 11.9 (août 2026).** Auparavant, ce besoin était couvert en détournant le **forfait prépayé**, ce qui provoquait des tarifs erronés et un compteur de séances restantes faux. Le carnet de bons est désormais le mécanisme officiel : voir Carnet de bons ou forfait prépayé ?

***

### Principe de fonctionnement

Un carnet n'est pas un nouveau type de produit : c'est un **bon cadeau doté de plusieurs utilisations**. Il se crée dans la même section « Bon cadeau » d'un produit, avec un champ supplémentaire : **Utilisations inclues**.

| Utilisations inclues    | Résultat                                                |
| ----------------------- | ------------------------------------------------------- |
| `1` (valeur par défaut) | Bon cadeau classique : 1 code, 1 utilisation            |
| `10`                    | Carnet : 1 code, 10 utilisations, vendu au prix indiqué |

Points clés :

* **Le prix saisi est le prix du carnet entier**, pas le prix d'une séance. « 10 entrées à 100 € » se paramètre avec un prix de **100 €** et 10 utilisations inclues.
* L'achat génère **un seul code**, quel que soit le nombre d'utilisations.
* À chaque réservation payée avec ce code, le compteur d'utilisations restantes **diminue**. Si la réservation est annulée, l'utilisation est **recréditée**.
* Le tarif du carnet **remplace** le tarif de la session au moment de la réservation, y compris un tarif dégressif ou saisonnier.
* La **date de validité** porte sur le carnet entier : à l'échéance, les utilisations non consommées sont perdues.

***

### Créer un carnet de bons

1. **Connectez-vous à Yoplanning.pro.**
2. Menu **Administration** → **Produits**.
3. Ouvrez le menu **trois petits points** en haut à droite du produit concerné, puis **éditez le produit**.
4. Dans la section **« Bon cadeau »**, cliquez sur **Ajouter un bon** et renseignez :
   * le **nom** du bon, tel qu'il sera vu par le client (ex. « Carnet 10 entrées ») ;
   * le **prix** : le prix du carnet complet (ex. 100 €) ;
   * la **validité** en nombre de mois (vide = pas d'expiration) ;
   * **Utilisations inclues** : le nombre d'utilisations du carnet (ex. 10). Valeurs acceptées : de 1 à 999.
5. *(Facultatif)* Section **Multi-produits** : renseignez un **tag produit** pour que le carnet soit utilisable sur l'ensemble des produits portant ce tag, et pas uniquement sur le produit courant.
6. Dans la section **« Vente en ligne »**, cochez l'option de **vente en ligne des bons** si vous voulez que le carnet soit achetable depuis votre module de réservation.
7. **Enregistrez.**

Une fois enregistré, le bon apparaît dans la liste des bons du produit avec la mention **« 10 utilisations par bon »**.

> **Le champ « Utilisations inclues » n'apparaît pas ?** Vous êtes probablement en train d'éditer un **forfait prépayé** (produit de type crédit). Le champ est réservé aux bons rattachés à un produit ; sur un forfait prépayé, il est masqué et forcé à 1.

***

### Vendre un carnet de bons

#### En ligne, depuis le module de réservation

Si la vente en ligne des bons est activée, le carnet est proposé comme n'importe quel bon cadeau. Le client :

1. choisit le carnet,
2. paie le prix du carnet,
3. reçoit son **billet avec un code unique**.

Le client peut acheter **plusieurs carnets** dans la même commande : il recevra alors un code par carnet.

#### Au comptoir

Le mode comptoir utilise le même module de réservation, connecté avec votre compte. La vente d'un carnet s'y fait exactement comme en ligne.

#### En vente manuelle depuis une commande

1. Ouvrez une commande existante, ou créez une **commande vierge** (menu **Commandes** → trois petits points → **Créer une commande vierge**) et renseignez les informations du client.
2. Cliquez sur **« Vendre un bon »**.
3. Sélectionnez le bon correspondant au carnet. Le champ de prix affiche alors **« Prix pour 10 utilisations »** : c'est bien le prix global du carnet.
4. Validez, encaissez et transmettez le **billet** au client.

> En vente manuelle, on vend **un carnet à la fois** : le champ Quantité est occupé par le nombre d'utilisations du carnet. Pour vendre deux carnets à un même client, répétez l'opération.

***

### Utiliser un carnet

#### Par le client, en ligne

1. Le client réserve son activité normalement sur votre module de réservation.
2. À la dernière étape, avant le paiement, il saisit le **code de son carnet** dans le champ prévu pour les codes.
3. Le tarif du carnet s'applique et le nombre d'utilisations correspondant est décompté.

#### Par vous, depuis le planning

1. Créez la commande avec les prestations habituelles.
2. À l'étape du paiement, cliquez sur **« Utiliser un bon »** sous le bouton *Ajouter un paiement*.
3. Renseignez le **code** du carnet (ou le nom du client qui le détient) et validez.

#### Ce qu'il faut savoir

* **Un code peut couvrir plusieurs participants d'une même commande**, dans la limite des utilisations restantes. Exemple : une famille de 3 personnes sur un carnet de 10 → 3 utilisations décomptées en une seule saisie du code.
* **Le même code ne peut pas être saisi deux fois sur une même commande.** Si vous devez ajuster, modifiez la commande plutôt que de ressaisir le code.
* **Le carnet s'utilise sur le produit auquel il est rattaché**, ou sur tout produit portant le tag renseigné dans la section Multi-produits.
* **Le tarif du carnet prime sur le tarif de la session**, y compris sur un tarif dégressif : le prix imputé est le prix unitaire du carnet (prix du carnet ÷ nombre d'utilisations).
* **En cas d'annulation** d'une réservation payée avec le carnet, les utilisations concernées sont rendues au carnet.

***

### Suivre les utilisations restantes

Le menu **Bons** de votre équipe liste tous les bons émis, carnets compris.

Pour chaque carnet, vous voyez :

* le **code**,
* le **client**,
* la **date d'expiration**,
* le **statut** : *Valide*, *Utilisé partiellement*, *Utilisé* ou *Expiré*,
* le compteur **« Restant : 7 / 10 »**.

Vous pouvez filtrer par client, produit, période ou statut, et rechercher directement un code. L'export de données remonte les colonnes **quantité initiale**, **quantité restante** et **valeur résiduelle**, utiles pour le suivi comptable des ventes prépayées.

> Le filtre de statut **« Utilisé »** se base sur le fait qu'au moins une utilisation a été consommée : un carnet entamé mais non épuisé y apparaît. Fiez-vous au compteur « Restant : X / Y » de la ligne pour connaître l'état réel.

***

### Carnet de bons ou forfait prépayé ?

Les deux se vendent d'avance, mais ne comptent pas la même chose.

|                     | **Carnet de bons**                                   | **Forfait prépayé / chèque-cadeau**                 |
| ------------------- | ---------------------------------------------------- | --------------------------------------------------- |
| Ce qui est décompté | Un **nombre d'utilisations**                         | Un **montant en euros**                             |
| Périmètre           | Le produit du bon (ou les produits portant son tag)  | N'importe quel produit vendu en ligne               |
| Tarif appliqué      | Le tarif du carnet, qui remplace celui de la session | Le tarif normal de la session, réglé avec le crédit |
| Compteur visible    | « Restant : 7 / 10 »                                 | Solde en euros                                      |
| Reliquat            | Utilisations non consommées, perdues à l'expiration  | Solde en euros non consommé                         |
| Cas d'usage type    | Carte 10 séances, carnet d'entrées, pack de cours    | Cagnotte, cadeau d'un montant libre, avoir client   |

**En pratique :** dès que vous vendez *un nombre de séances* sur une activité, utilisez un **carnet de bons**. Réservez le forfait prépayé aux cas où vous vendez *une somme d'argent* à dépenser librement.

***

### Erreurs courantes et solutions

| Message / symptôme                                                              | Cause                                                                         | Solution                                                                                                                  |
| ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **« Déjà utilisé »**                                                            | Le carnet n'a plus d'utilisation disponible                                   | Vérifiez le compteur dans le menu **Bons**. Vendez un nouveau carnet si besoin.                                           |
| **« Expiré »**                                                                  | La date de validité du carnet est dépassée                                    | La validité porte sur le carnet entier. Modifiez la date d'expiration du bon si vous souhaitez faire un geste commercial. |
| **« Ce bon d'achat ne correspond à aucun article de cette commande »**          | Le produit réservé n'est pas celui du carnet, et ne porte pas son tag produit | Vérifiez le produit du bon, ou renseignez un tag produit dans la section Multi-produits du bon.                           |
| **« La quantité du bon d'achat ne correspond pas à la quantité de l'article »** | La commande demande plus d'utilisations qu'il n'en reste sur le carnet        | Réduisez le nombre de participants sur la commande, ou complétez avec un autre moyen de paiement.                         |
| **Le champ « Utilisations inclues » est absent**                                | Vous éditez un forfait prépayé (produit crédit)                               | Créez le bon depuis la fiche du produit concerné, et non depuis un forfait prépayé.                                       |
| **Le carnet n'apparaît pas sur le site de réservation**                         | La vente en ligne des bons n'est pas activée sur le produit                   | Section **Vente en ligne** de la fiche produit : cochez la vente en ligne des bons.                                       |

***

### Bonnes pratiques

* **Annoncez clairement le contenu du carnet** dans son nom : « Carnet 10 entrées — adulte » est plus parlant que « Carnet ».
* **Fixez une validité cohérente** avec votre saison. Une validité vide signifie « sans expiration » : les utilisations restent dues indéfiniment.
* **Testez avant l'ouverture commerciale** : vendez-vous un carnet, consommez une utilisation, vérifiez le compteur « Restant » et le tarif appliqué sur la commande.
* **Communiquez sur les conditions** d'utilisation : périmètre des produits concernés, date d'expiration, absence de remboursement du non-consommé.


---

# 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/yoplanning-academie/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.
