Fidélité client

Programme de fidélité intégré au Comptoir : cumul automatique de points à chaque vente, utilisation en réduction sur les ventes suivantes. Carte par client, scan possible en caisse.

Menu : Comptoir > Interface Comptoir (utilisation) · Données > Clients (gestion des cartes) · Outils > Options Commerciales > Fidélité (paramétrage global)

Conversion par défaut

1 point = 1 DH de réduction. Le caissier saisit le nombre de points à utiliser ; OMAG en déduit le montant équivalent à régler.

Activation du programme

Avant toute utilisation, activer la fidélité dans Options Commerciales → onglet Fidélité :

Paramètre	Description
Activer la fidélité	Toggle global. Affiche/masque les éléments fidélité partout (chip caisse, scan, onglet client, etc.)
Mode de paiement	Mode (de la table modep) utilisé pour matérialiser la consommation des points dans la comptabilité. Créer un mode dédié « Fidélité » dans le référentiel et le sélectionner ici

Mode de paiement requis

Si le mode de paiement n'est pas renseigné, l'utilisation des points en caisse est désactivée (cumul reste actif).

Carte de fidélité client

Ouvrir une fiche client (Données > Clients > Détail) — l'onglet Fidélité ⭐ apparaît si le programme est activé.

Champ	Description
N° carte fidélité	Numéro unique (texte). Le bouton ↻ génère un numéro auto au format FID{code_client}{timestamp}
Date de début	Date de début de validité (vide = pas de limite)
Date de fin	Date d'expiration (vide = illimité). Si expirée, le cumul et l'utilisation sont bloqués
Solde points actuel (lecture seule)	Affiche en temps réel le solde net (points gagnés − points utilisés)

Paramétrer les points par article

Sur la fiche article (Données > Articles > Prix et tarifs), une section Fidélité apparaît si le programme est activé :

• Points gagnés par unité : nombre de points crédités au client à chaque unité vendue. Accepte les décimales (ex. 0,5 point).
• Articles sans valeur (0) : ne génèrent pas de points.

Utilisation au Comptoir

Chargement du client par carte

Dans l'Interface Comptoir, un champ Scan carte fidélité est présent dans le header (visible si le programme est activé) :

1. Scanner ou saisir le numéro de carte
2. Touche Entrée
3. Le client est automatiquement chargé dans le ticket

Carte expirée

Si la carte est expirée, le client est tout de même chargé mais sans bénéfice fidélité (toast d'avertissement). Renouveler la validité depuis la fiche client.

Chip fidélité dans le header

Dès qu'un client avec carte valide est sélectionné, une chip ⭐ rose apparaît à côté du combo client :

Affiche : solde points + N° carte. La chip devient grise si la carte est expirée.

Cumul automatique des points

À chaque article ajouté au ticket :

• OMAG calcule points_ligne = article.pointe_fidelite × quantité
• À la validation du ticket : bonlivr.points_fidelite = SUM(lignes) → crédité automatiquement au client

Le ticket Z imprimé affiche les points gagnés en bas (+X points fidélité gagnés).

Utilisation des points en règlement

Dans le dialog Multi-règlement (Outils > Multi-règlements), si le client a un solde utilisable, un bouton « Utiliser fidélité (X pts) » apparaît :

1. Cliquer le bouton → dialog dédié
2. Saisir le nombre de points à utiliser (max = min(solde, reste à payer))
3. Bouton « Utiliser le maximum » pour pré-remplir
4. Ajouter → une ligne de règlement est créée avec le mode « Fidélité » et le montant équivalent
5. Valider la vente normalement → la consommation est enregistrée et le solde diminué

Conversion fixe

Pour cette version : 1 point = 1 DH. Le taux pourra être configurable dans une version future.

Cas d'usage

Cumul classique

1. Client présente sa carte → caissier scanne dans le champ Scan carte → solde affiché : 240 pts
2. Ajout des articles : 1 article à 5 pts/unité × 2 = 10 pts, autre article à 3 pts = 3 pts → total ticket : 13 points gagnés
3. Encaissement espèce → ticket validé
4. Nouveau solde du client : 253 pts (visible en rechargeant la fiche client)

Utilisation partielle

• Total à payer : 250 DH
• Client a 500 pts → souhaite utiliser 100 pts (= 100 DH)
• Multi-règlement : ligne « Fidélité » 100 DH + ligne « Espèce » 150 DH → validé
• Solde après : 500 − 100 = 400 pts

Refus de cumul si carte expirée

• Carte avec date_FV_fidelite au 31/12/2024 → on est en 2026 → expirée
• Caissier scanne → toast Carte FID00123 expirée — client chargé sans bénéfice fidélité
• Le ticket n'augmente pas le solde

Cycle complet émission carte → utilisation

1. Création client + saisie n° carte (bouton ↻ pour générer) + date début aujourd'hui + date fin = aujourd'hui + 2 ans
2. Premières ventes : cumul automatique
3. Client revient 3 mois plus tard → scanne sa carte → solde 750 pts → utilise 500 pts sur son prochain achat
4. Solde devient 250 pts

Règles de gestion

• Cumul : effectué uniquement à la validation du ticket (pas avant). Un ticket en attente ne cumule pas.
• Utilisation : possible uniquement si : carte active + non expirée + solde > 0 + mode de paiement fidélité configuré.
• Plafond : la consommation est plafonnée au minimum entre le solde et le reste à payer (pas de débit possible).
• Dévalidation : si un BL est dévalidé, les points crédités sont automatiquement annulés (suppression dans consommation_fidelite).
• Audit : chaque consommation est tracée dans la table consommation_fidelite (date, ticket, montant, utilisateur).
• Pas de transfert entre clients : un point appartient au client qui l'a gagné.

Voir aussi

• Interface Comptoir — usage en caisse
• Bons cadeau — autre forme de paiement virtuel
• Promotions — remises automatiques
• Articles — référentiel + points par unité
• Clients — fiches clients + cartes fidélité