HivebookDocs
08

Bons cadeaux

Paramétrer la carte vendue, suivre les bons émis.

ParamétrageBoutique → Produits → Ajouter / Modifier → Produit carte cadeauSuiviBoutique → Bons cadeaux

La Boutique décrit la carte cadeau : les montants acceptés, le document remis, les messages envoyés. Chaque vente émet ensuite un bon autonome, qui porte son propre solde et son propre coupon. Les deux vivent dans deux menus distincts, et c’est la distinction la plus utile à garder en tête.

1. Les deux objets à distinguer

ObjetOù il vitCe qu’il porteCombien
Produit Carte cadeauProduits, type Produit carte cadeauBornes de montant, document PDF, textes des notifications.Un par offre commerciale, rarement plus de deux.
Bon cadeau émisBons cadeauxMontant vendu, montant utilisé, solde, coupon, expiration, acheteur et destinataire.Un par vente, créé automatiquement.
Qui fait quoi. La Boutique paramètre la carte et conserve l’historique des bons. Le Manager vend le bon et le consomme au comptoir : voir Bons cadeaux dans le Manager. Le client achète en ligne par le Widget Carte cadeau, qui lit exactement les mêmes bornes de montant.

2. Le produit Carte cadeau

AccèsBoutique → Produits → Modifier → Type de produit → Produit carte cadeau

Choisissez le type Produit carte cadeau dans le sélecteur du type de produit. Hivebook adapte alors les onglets de la fiche produit : les attributs, l’expédition, les produits liés et l’onglet avancé disparaissent, l’inventaire reste accessible, et le bloc Tarif est conservé. Les champs propres à la carte sont regroupés sous Produit – Carte cadeau, en trois onglets : Général, PDF et Notifications.

Le prix du produit compte. Il n’existe pas de champ « montant de départ » : c’est le Tarif régulier du produit qui sert de montant. Montant libre désactivé, c’est le montant imposé du bon ; montant libre activé, c’est la valeur pré-remplie à l’ouverture du sélecteur. Un produit carte cadeau sans prix ne peut donc pas être vendu.
ChampRôleDéfaut
Montant libreAutorise l’acheteur à choisir le montant. Désactivé, le bon vaut toujours le tarif du produit.Désactivé
MinPlancher accepté en montant libre.10
MaxPlafond accepté en montant libre.500
TranchePas de progression du sélecteur de montant.1
Activer PDFGénère un document imprimable à l’activation du bon, et ouvre l’onglet PDF.Désactivé
Activer Solde restantAutorise la consommation en plusieurs fois : après un paiement partiel, un nouveau coupon est émis pour le reste.Désactivé
DescriptionTexte libre présenté avec la carte dans le parcours d’achat.—

Les trois champs Min, Max et Tranche n’apparaissent qu’avec le montant libre activé, et ce sont les mêmes valeurs que l’écran Manager → Cadeaux → Cartes : les modifier d’un côté les modifie de l’autre.

Montants suggérés. Les vignettes proposées au client ne se saisissent pas. Hivebook retient 25, 50 et 100 € lorsque ces valeurs tiennent entre le minimum et le maximum ; sinon il calcule trois propositions — le minimum, le milieu de la plage et le maximum — arrondies à la tranche. Élargir la plage change donc les vignettes affichées.
Exemple — carte « découverte ». Tarif régulier 50 €, montant libre activé, minimum 20 €, maximum 200 €, tranche 10 €, solde restant activé, PDF activé. Le client voit 25, 50 et 100 € en vignettes, peut saisir toute valeur multiple de 10 entre 20 et 200 €, et pourra consommer son bon en plusieurs visites.

3. Le PDF du bon

L’onglet PDF n’est visible qu’avec Activer PDF. Le document est composé une fois, au moment où le bon devient actif, puis recomposé à chaque nouveau solde. Il est stocké dans les fichiers du site et reste accessible depuis la fiche du bon.

ChampRôleDéfaut
TailleFormat du document : A3 à A6, B4, B5, Legal, Letter, Executive, Folio, Ledger ou Tabloid.A4
OrientationPortrait ou paysage.Portrait
Visuel RectoImage à placer dans le contenu avec la variable [visuel_recto].—
Visuel VersoImage à placer avec [visuel_verso].—
ContenuMise en page du bon, en éditeur enrichi, avec les variables ci-dessous. Un bloc de prévisualisation accompagne le champ.—
Choisir une image ne l’affiche pas. Les deux visuels ne sont que des réserves : si le contenu ne contient pas [visuel_recto] ou [visuel_verso], les images ne paraissent pas dans le document.

Variables disponibles

GroupeVariables
Bon[code_promo], [montant], [expiration_date]
Acheteur[client_nom], [client_prenom], [client_email], [client_telephone]
Destinataire[destinataire_nom], [destinataire_prenom], [destinataire_email], [destinataire_telephone], [destinataire_message]
Visuels[visuel_recto], [visuel_verso] — PDF uniquement
[montant] est le solde, pas le montant vendu. Sur un bon consommé pour moitié, le nouveau document annonce le reste à utiliser. C’est le comportement attendu pour un bon réémis, mais évitez une formulation du type « votre bon d’une valeur de [montant] » qui deviendrait fausse à la deuxième impression. Les noms sont mis en majuscules par le rendu.

4. Les notifications de la carte

L’onglet Notifications porte deux messages, chacun disponible en e-mail et en SMS, chacun avec son propre interrupteur. Les textes acceptent les mêmes variables que le PDF, à l’exception des deux visuels. Chaque ligne du tableau ouvre un exemple complet, à choisir selon votre domaine d’activité, puis à copier et adapter.

MessageDéclencheurObjet et titre par défautExemple
Nouveau bon cadeauLe bon devient actif, c’est-à-dire à l’encaissement de la commande. Également à chaque usage du bouton de renvoi.« Votre bon cadeau Hivebook » · « Bon cadeau »
Solde restantUne commande n’a consommé qu’une partie du bon et un nouveau coupon vient d’être émis. Onglet visible seulement si Activer Solde restant est actif.« Votre carte cadeau dispose d’un nouveau solde de [montant] » · « Nouveau solde »

Les deux SMS sont pré-remplis et peuvent être conservés tels quels : « Vous avez reçu un bon cadeau de [montant]. Code : [code_promo]. Utilisable jusqu’au [expiration_date]. » et « Votre carte cadeau [code_promo] a encore [montant] valable jusqu’au [expiration_date]. Profitez-en vite ! » Les SMS dépendent du crédit Brevo paramétré dans Réglages → Hivebook → Services.

Le message part vers l’acheteur. E-mail et SMS sont adressés au client rattaché au bon, pas au destinataire : ce sont les coordonnées de la fiche client qui sont utilisées. Les champs du destinataire alimentent uniquement les variables du contenu. Un bon vendu sans fiche client — mention Invité — ne déclenche donc aucune notification ; remettez le PDF à la main dans ce cas.
Enveloppe graphique. L’en-tête, le pied de page et les couleurs des e-mails viennent de Réglages → Hivebook → Emails. Les champs du produit ne portent que l’objet, le titre et le corps du message.

5. La fiche d’un bon émis

AccèsBoutique → Bons cadeaux

La liste affiche le client et son e-mail, l’état en pastille colorée, le montant vendu — complété du solde en rouge lorsque le bon est partiellement consommé — la date de création, puis deux actions : télécharger le PDF et renvoyer l’e-mail, sous confirmation. Les deux actions disparaissent sur un bon en attente de paiement ou annulé. Un bon ne s’ajoute pas à la main : il naît d’une vente.

Onglet Général

ChampContenu
ProduitLa carte cadeau vendue, qui fournit le PDF et les notifications.
CouponLe code promo généré. C’est le code que le client utilise.
ÉtatAttente paiement, Actif, Utilisé, Expiré ou Annulé.
MontantValeur vendue, inchangée ensuite.
UtiliséCumul consommé sur les commandes.
SoldeReste utilisable. C’est cette valeur qui porte le coupon.
Date expirationTerme de validité, repris sur le coupon.
NoteCommentaire interne, visible aussi dans le Manager.
Lié à un remboursementCoché quand le bon a été émis comme avoir, et non vendu.

Onglets PDF, Client et Destinataire

ChampContenu
Chemin du PDFEmplacement du fichier généré. Un encadré Téléchargement propose le document en colonne de droite.
ClientL’acheteur, sous forme de compte client. C’est lui qui reçoit les notifications.
Nom et PrénomLe bénéficiaire du bon.
Téléphone et EmailCoordonnées du bénéficiaire, reprises dans les variables du document.
MessageMot personnalisé saisi à la vente.
Changer l’état a des effets immédiats. Le champ État n’est pas une simple étiquette : chaque valeur déclenche le traitement décrit ci-dessous, y compris la suppression du coupon. Pour les gestes du quotidien, préférez les actions du Manager, qui posent les mêmes changements avec leurs garde-fous.

Côté commande, un encadré Bons cadeaux liés rappelle les bons émis, avec leur numéro, leur code de coupon et leur montant : voir Commandes & paiements.

6. Cycle de vie et coupon

Le bon est créé avec la commande, puis activé dès que celle-ci passe en traitement ou terminée. L’activation déclenche trois choses d’un coup : le coupon, le PDF et la notification.

ÉtapeCe que fait Hivebook
Vente enregistréeCréation du bon, état Attente paiement, montant et solde égaux, expiration calculée. Acheteur et destinataire sont repris de la commande ; sans destinataire saisi, les coordonnées de facturation sont recopiées.
Commande encaisséeÉtat Actif, génération du coupon et du PDF, envoi de la notification.
Utilisation partielleÀ la clôture de la commande, le montant consommé est ajouté à Utilisé et retiré du Solde. Avec Solde restant activé, un nouveau coupon du reste est émis, le PDF est recomposé et la notification de solde est envoyée. Sans cette option, le bon passe à Utilisé, solde perdu.
Solde épuiséÉtat Utilisé, coupon marqué comme consommé, solde ramené à zéro.
Terme dépasséUn contrôle automatique passe chaque heure et bascule les bons actifs échus en Expiré.
AnnulationLes états Annulé et Attente paiement suppriment le coupon : le code cesse immédiatement de fonctionner, même si le solde reste affiché.
SuppressionSupprimer le bon efface son coupon et son PDF. Supprimer ou mettre à la corbeille la commande supprime les bons qui en sont issus.
Propriété du couponValeur posée par Hivebook
Codecadeau_ suivi de douze caractères aléatoires, en minuscules.
Type de remiseRemise fixe sur le panier, du montant du solde.
Limite d’utilisationUne seule fois. Un usage partiel se poursuit avec un nouveau code, pas avec l’ancien.
ExpirationCelle du bon. Un bon réémis conserve la date d’origine.
Restriction de catégoriesAucune : le coupon d’un bon cadeau s’applique à tous les produits. La restriction de Réglages → Hivebook → Coupons ne porte que sur les codes promos créés dans le Manager.
Durée de validité. Un achat en ligne vaut un an. La date retenue court jusqu’à la fin de la journée indiquée : un bon expirant le 31 décembre reste utilisable toute cette journée. La date se corrige au besoin sur la fiche du bon, et le coupon suit.

7. Réglages liés

RéglageEmplacementEffet sur les bons
Remboursement en bon cadeauRéglages → Hivebook → RemboursementsAutorise l’avoir en bon cadeau et désigne le produit carte cadeau à émettre. Le bon créé est actif immédiatement, coché Lié à un remboursement, et c’est la notification de remboursement qui prévient le client — pas celle de la carte.
Conditions de paiementRéglages → Hivebook → PaiementsUne condition dont le type de vente est Bon cadeau ne s’affiche que sur ces ventes.
Enveloppe des e-mailsRéglages → Hivebook → EmailsHabillage commun aux notifications de bons.
Crédit SMSRéglages → Hivebook → ServicesSans crédit Brevo, les SMS activés ne partent pas.

8. Contrôles avant publication

  • Le produit est du type Produit carte cadeau et porte un tarif régulier.
  • Les bornes de montant ont été testées à l’exacte valeur du minimum et du maximum, dans le Widget.
  • La tranche produit bien les montants annoncés dans votre communication.
  • Le choix sur le solde restant est assumé : sans l’option, tout reliquat est perdu à la première utilisation.
  • Le contenu du PDF appelle les visuels et affiche code, montant et expiration.
  • Une vente de test a été menée jusqu’à l’encaissement : bon actif, coupon créé, PDF lisible, notification reçue.
  • Le coupon a été appliqué sur une commande réelle, puis le solde et l’état relus sur la fiche du bon.
  • Le produit carte cadeau des remboursements est renseigné si l’avoir en bon cadeau est autorisé.
Guide utilisateur Hivebook v3.0.0