Documentation coupons et avantages KWISATZ
Créer et utiliser des coupons de réduction
La fonction de caisse 193 permet d’appliquer un avantage sous forme de réduction globale calculée sur le montant TTC du ticket, avec un taux et un plafond, ou d’offrir la ligne de vente active. KWISATZ matérialise l’avantage avec des articles négatifs afin de préserver la ventilation de TVA et les statistiques.
Réponse directe
-NUM01 -MODE0 -TX5 -MAX10.
Saisissez les articles, puis appuyez sur la touche.
KWISATZ ajoute une ou plusieurs lignes négatives
ZCOUPON ventilées selon les taux de TVA du ticket.
Conseil technicien général
1. Licence et disponibilité
La dépendance de licence mentionnée dans ce document provient des sources. Sa disponibilité peut varier selon la version, la sérialisation, le partenaire ou l’installation ; faites-la valider techniquement avant de modifier l’environnement.
2. Distinguer abonnements et fidélité
Les abonnements correspondent à des prestations disponibles et consommables dans les tickets lorsque le client est sélectionné. Ils ne doivent pas être confondus avec les points ou passages de fidélité. Un devis, une facture, un rendez-vous ou un mouvement financier ne constitue pas, à lui seul, une consommation d’abonnement.
3. Protection des données
4. Comprendre les différents avantages
| Mécanisme | Usage | Traçabilité |
|---|---|---|
| Coupon fonction 193, mode 0 | Réduction globale en pourcentage, éventuellement plafonnée. | Lignes négatives ZCOUPONxxyy. |
| Coupon fonction 193, mode 1 | Offre de la ligne active. | Ligne négative de type ZKADO. |
| Remise ticket classique | Remise globale par la fonction de remise. | Remise portée par le ticket ou ses lignes selon le mécanisme. |
| Article offert, fonction 010 | Met la ligne active à zéro selon le mode de l’article offert. | La vente elle-même est marquée comme offerte. |
| Promotion | Prix ou avantage automatique pendant une période et sous conditions. | Opération commerciale et lignes de vente. |
| Voucher de plateforme | Bon généré et contrôlé par Loyalty, ZEROSIX ou une autre interface. | Code externe, statut et lignes ou règlement générés. |
| Article négatif manuel | Réduction fixe exceptionnelle encadrée. | Ligne produit négative, sans contrôle unique natif général. |
5. Fonction 193 — Coupon de réduction
La fonction a été introduite en décembre 2019 comme alternative à la remise sur ticket classique. Certaines évolutions utilisent ensuite le libellé Coupon avantage.
Mode réduction globale
Le montant de la remise est calculé à partir d’un taux appliqué au TTC du ticket, puis limité par le plafond défini.
Montant théorique = TTC du ticket × taux / 100
Montant appliqué = minimum(montant théorique, plafond)
Mode produit offert
La ligne active est contre-passée par une ligne négative, sans modifier la ligne positive d’origine.
Licence
Les sources historiques associent cette fonction au Pack caisse (fonctions avancées). Vérifiez la sérialisation de la version réellement installée.
6. Paramètres de la fonction
| Paramètre | Obligation | Effet |
|---|---|---|
-NUM[code] |
Optionnel | Distingue les coupons dans les statistiques et dans le code des articles générés. |
-MODE0 |
Valeur par défaut | Applique une réduction globale et crée des lignes ZCOUPON. |
-MODE1 |
Selon besoin | Offre la ligne active avec une contrepartie négative de type ZKADO. |
-TX[taux] |
Nécessaire en mode 0 | Taux de réduction appliqué au montant TTC du ticket. |
-MAX[montant] |
Fortement recommandé | Montant maximal que le coupon peut déduire. |
Exemples
Coupon 5 %, maximum 10 €
-NUM01 -MODE0 -TX5 -MAX10
Coupon 10 %, maximum 20 €
-NUM02 -MODE0 -TX10 -MAX20
Offrir la ligne active avec le coupon 03
-NUM03 -MODE1
-NUM stable.
Ne réaffectez pas le même numéro à une opération différente,
sinon les statistiques historiques deviendront ambiguës.
7. Créer une touche sur le clavier tactile
- Ouvrez la configuration du clavier tactile.
- Choisissez le clavier et la dalle concernés.
- Ajoutez un bouton de fonction.
- Sélectionnez 193 — Coupon de réduction.
- Renseignez les paramètres.
- Donnez un libellé explicite, par exemple « COUPON 5 % MAX 10 € ».
- Ajoutez une couleur ou une icône distincte des remises manuelles.
- Limitez son accès aux profils autorisés.
- Enregistrez et rafraîchissez les dalles si nécessaire.
- Testez sur un dossier ou poste de recette.
Convention de numérotation conseillée
| Code | Campagne |
|---|---|
| 01 à 09 | Coupons permanents ou institutionnels. |
| 10 à 29 | Campagnes saisonnières. |
| 30 à 49 | Coupons partenaires. |
| 50 à 69 | Service client et gestes commerciaux. |
| 70 à 89 | Coupons Web ou campagnes ponctuelles. |
| 90 à 99 | Tests et opérations internes, jamais en production sans contrôle. |
8. Utiliser un coupon en caisse
Réduction globale
- Saisissez tous les articles concernés.
- Vérifiez les prix et promotions déjà appliqués.
- Contrôlez les conditions du coupon présenté.
- Appuyez une seule fois sur la touche 193 configurée.
- Vérifiez la ou les lignes négatives ajoutées.
- Contrôlez le total TTC après avantage.
- Totalisez et encaissez.
- Conservez ou invalidez le support physique selon la procédure.
Produit offert
- Saisissez le produit à offrir.
- Placez la ligne correspondante comme ligne active.
- Contrôlez que la quantité est celle autorisée.
- Appuyez sur la touche configurée avec
-MODE1. - Vérifiez la ligne négative
ZKADO. - Contrôlez le total et le ticket imprimé.
9. Vérifier le calcul et le plafond
Exemple sans plafond atteint
Total TTC avant coupon : 87,00 €
Taux : 5 %
Calcul : 87,00 × 5 % = 4,35 €
Plafond : 10,00 €
Coupon appliqué : -4,35 €
Exemple avec plafond atteint
Total TTC avant coupon : 300,00 €
Taux : 5 %
Calcul : 300,00 × 5 % = 15,00 €
Plafond : 10,00 €
Coupon appliqué : -10,00 €
Contrôles
- le taux est interprété comme attendu ;
- le plafond utilise la devise locale ;
- les arrondis de TVA sont cohérents ;
- le total ne devient pas négatif ;
- un deuxième appui n’applique pas un avantage non autorisé ;
- le coupon n’inclut pas des lignes exclues par la politique commerciale.
10. Ventilation entre plusieurs taux de TVA
Lorsque le ticket contient plusieurs taux de TVA, KWISATZ répartit l’avantage et insère plusieurs articles négatifs.
Codification
ZCOUPONxxyy
xx = numéro du coupon, 00 si -NUM absent
yy = code TVA rattaché à la ligne négative
Exemple
Coupon numéro 01
Part de remise rattachée au code TVA 01 : ZCOUPON0101
Part de remise rattachée au code TVA 02 : ZCOUPON0102
Si l’article technique existe dans la base, son libellé est utilisé. Sinon KWISATZ emploie un libellé générique de coupon de réduction.
Pourquoi plusieurs lignes ?
- conserver la cohérence entre HT, TVA et TTC ;
- ne pas attribuer toute la remise à un seul taux ;
- produire des journaux de TVA cohérents ;
- permettre un suivi statistique du coupon par taux.
11. Mode 1 — Offrir le produit actif
Depuis février 2023, -MODE1
permet d’offrir la ligne active.
Différence avec la fonction 010
| Fonction 010 — Article offert | Fonction 193 — Mode 1 |
|---|---|
| La ligne est marquée comme offerte selon le mécanisme de la fonction. | La ligne positive est conservée intacte. |
| La valorisation dépend du traitement de l’offert. | Une ligne négative de type ZKADO contre-passe la valeur. |
| Statistiques d’offerts classiques. | Avantage valorisé sous forme de coupon négatif. |
Cas d’usage
- coupon « un produit offert » ;
- geste commercial sur un article identifié ;
- avantage partenaire ;
- campagne où l’article vendu doit rester visible à son prix normal.
12. Articles techniques ZCOUPON et ZKADO
ZCOUPON
Les articles ZCOUPONxxyy
représentent les parts négatives d’une réduction globale.
ZKADO
Les articles de type ZKADO
représentent notamment une contrepartie négative
lors de l’offre de la ligne active.
Pourquoi créer les fiches correspondantes ?
- personnaliser le libellé imprimé ;
- rattacher la famille ou le rayon statistique ;
- contrôler les comptes de vente ;
- harmoniser les tickets ;
- faciliter les états FastReport ;
- éviter des libellés génériques peu explicites.
Contrôles des fiches
- article non stockable ;
- code et TVA conformes au mécanisme ;
- prix non utilisé comme prix fixe du coupon ;
- pas de promotion ni remise parasite ;
- pas d’export e-commerce indésirable ;
- famille comptable validée ;
- libellé compréhensible pour le client.
ZCOUPONxxyy
si vous attendez que KWISATZ retrouve automatiquement la fiche.
13. Définir les conditions commerciales
La fonction 193 décrit le calcul, mais les conditions du coupon relèvent de la campagne.
Conditions à documenter
- date de début et date de fin ;
- magasins participants ;
- client identifié ou coupon anonyme ;
- minimum d’achat ;
- articles, familles ou marques exclus ;
- services et frais exclus ;
- nombre d’utilisations par personne ;
- cumul avec promotions et fidélité ;
- application sur produits déjà remisés ;
- utilisation sur retours et avoirs ;
- sort en cas de remboursement ;
- plafond par ticket ou par client.
Contrôles natifs non documentés
Ces contrôles doivent être réalisés par :
- une procédure vendeur ;
- un profil superviseur ;
- une plateforme de fidélité ;
- un voucher sécurisé ;
- une opération spéciale mieux adaptée ;
- un développement spécifique validé.
14. Cumul avec promotions, remises et opérations spéciales
Risque de cumul
La fonction 193 est une alternative à la remise globale, mais aucun blocage général de cumul avec les promotions ou une autre remise n’est documenté dans ses paramètres.
Règle liée aux opérations spéciales
La préférence Opérations spéciales — Désactiver si promotion en cours permet d’exclure les articles bénéficiant d’un tarif promotionnel du calcul des avantages liés aux opérations spéciales.
Politique recommandée
- Décidez si le coupon est cumulable.
- Testez un produit en promotion.
- Testez une remise ligne.
- Testez une remise globale.
- Testez un tarif client spécial.
- Testez une reprise de fidélité.
- Testez deux coupons successifs.
- Bloquez ou protégez les scénarios interdits.
15. Coupon d’un montant fixe
Solutions possibles
| Solution | Usage | Risque |
|---|---|---|
| Article négatif dédié | Réduction fixe exceptionnelle, par exemple -5 €. | Pas de contrôle natif général d’unicité ou d’éligibilité. |
| Voucher de plateforme | Bon de valeur contrôlé par Loyalty ou ZEROSIX. | Dépend de l’interface et de la connexion. |
| Chèque cadeau ou bon sécurisé | Valeur émise et reprise avec contrôle de statut. | Ce n’est plus une simple remise commerciale. |
| Développement spécifique | Minimum d’achat, code unique, date, usage et exclusions. | Recette et maintenance nécessaires. |
16. Coupons papier, codes-barres et usage unique
Limite de la touche 193
La fonction applique les paramètres fixés sur le bouton. Elle ne lit pas automatiquement un numéro unique, ne marque pas un support comme utilisé et ne contrôle pas sa date dans le mécanisme documenté.
Coupon papier simple
- Le vendeur contrôle visuellement la date et les conditions.
- Il applique la touche correspondante.
- Il tamponne, déchire ou conserve le support selon la procédure.
- Il classe les coupons pour rapprochement.
Coupon avec code-barres
Un code-barres peut appeler une touche, un article négatif ou une interface spécifique selon le projet. Cela ne garantit pas l’usage unique sans registre ou plateforme.
Usage réellement sécurisé
- voucher ZEROSIX ou Loyalty ;
- avoir sécurisé KWISATZ ;
- chèque cadeau vendu avec statut ;
- développement de table de coupons uniques ;
- API de campagne contrôlant chaque code.
17. Coupons des plateformes de fidélité
Loyalty
La fonction de caisse 209
regroupe les actions de la plateforme Loyalty :
-A1: sélection d’un client ;-A2: gestion des coupons ;-A3: actualisation d’une fiche ;-A4: création d’une fiche.
ZEROSIX
ZEROSIX peut transmettre des vouchers en valeur ou en pourcentage. En mode reprise par vente négative, KWISATZ ajoute :
ZCOUPON01XXpour un voucher exprimé en euros ;ZCOUPON02XXpour un voucher exprimé en pourcentage ;XXcorrespond au code TVA rattaché.
Le règlement associé peut être présent avec un montant nul afin d’imprimer et de conserver le code utilisé, tandis que la réduction est déjà matérialisée par les lignes négatives.
Exclusions fidélité
Les préférences ZEROSIX peuvent signaler les ventes en promotion ou remisées afin que la plateforme les exclue du calcul d’avantages.
18. Coupons provenant du site e-commerce
Les interfaces MCOMM ont reçu des évolutions pour lire les coupons de réduction dans les commandes classiques et Click & Collect.
Cas documentés
- coupons exprimés en montant ;
- coupons exprimés en pourcentage ;
- coupon offrant les frais de port sur une première commande ;
- reprise dans les commandes PrestaShop ;
- transmission dans le ticket ou le document importé.
Contrôles
- Comparer le code du coupon sur le site et dans KWISATZ.
- Comparer le total avant et après réduction.
- Contrôler la TVA des articles et des frais de port.
- Vérifier que le coupon n’est pas ajouté une seconde fois en caisse.
- Vérifier le statut prépayé.
- Contrôler le remboursement en cas d’annulation.
19. Coupons et fidélité KWISATZ
La réduction peut influencer :
- le chiffre d’affaires pris en compte ;
- les points acquis ;
- le nombre de passages ;
- les droits repris ;
- les bonus articles ;
- les campagnes des plateformes externes.
Questions à trancher
- le client gagne-t-il des points sur le montant avant ou après coupon ?
- les produits offerts génèrent-ils des points ?
- une vente avec coupon participe-t-elle à une opération spéciale ?
- un voucher externe peut-il être cumulé avec les points internes ?
- le coupon est-il réservé aux clients identifiés ?
20. Retours, annulations et remboursements
Annulation avant encaissement
Supprimez la ligne de coupon ou annulez l’action selon la procédure, puis vérifiez que les lignes positives conservent leurs valeurs d’origine.
Retour après vente
Le montant remboursé doit tenir compte du prix réellement payé, donc de la quote-part du coupon.
Coupon de produit offert
Un produit entièrement offert ne doit pas générer un remboursement en espèces de sa valeur normale lors d’un retour.
Voucher externe
L’annulation doit être répercutée à la plateforme si le code a été consommé ou si l’avantage doit être réémis.
21. Imprimer les informations du coupon
Titre coupon
Dans les mentions d’impression du centre d’encaissement, l’item Titre coupon définit une ligne à imprimer pour chaque coupon auquel le client a droit.
Ticket de vente
Vérifiez que le ticket présente :
- le libellé du coupon ;
- le montant négatif ;
- les éventuelles ventilations de TVA ;
- le code de campagne utile ;
- le total avant ou après avantage selon le modèle ;
- les conditions nécessaires pour un coupon futur.
Coupon à émettre après achat
22. Statistiques et contrôle de campagne
Rôle de -NUM
Le paramètre -NUM distingue les coupons
de 5 %, 10 % ou les différentes campagnes
dans les statistiques.
Indicateurs utiles
- nombre de tickets utilisant chaque code ;
- montant total des réductions ;
- panier moyen avant et après coupon ;
- taux d’utilisation ;
- répartition par magasin et vendeur ;
- répartition par taux de TVA ;
- produits offerts par campagne ;
- tickets avec plusieurs coupons ;
- retours liés aux tickets remisés ;
- marge avant et après avantage ;
- nouveaux clients et clients récurrents ;
- coupons Web, fidélité et coupons manuels.
État personnalisé
Un état FastReport peut rechercher les lignes
dont le code commence par ZCOUPON ou ZKADO,
puis les grouper par numéro de coupon, magasin, vendeur,
date, TVA ou client.
23. Autorisations et prévention des abus
- réserver les touches coupons aux profils autorisés ;
- protéger les coupons de geste commercial par superviseur ;
- limiter le nombre de touches visibles ;
- nommer clairement taux et plafond ;
- contrôler les doubles appuis ;
- conserver les supports papier utilisés ;
- vérifier les coupons partenaires ;
- journaliser les usages par vendeur ;
- examiner les annulations après coupon ;
- retirer les touches à la fin de la campagne ;
- ne pas publier les paramètres techniques internes ;
- tester le coupon sur les caisses de secours.
Fin de campagne
- Retirez ou désactivez la touche.
- Conservez la définition de la campagne.
- Archivez le code
-NUM. - Éditez les statistiques finales.
- Contrôlez les supports restant en circulation.
- Ne réutilisez pas immédiatement le même numéro.
24. Recette avant mise en production
- Créer un coupon 5 % plafonné à 10 €.
- Tester un ticket à 20 €.
- Tester un ticket à 300 € pour atteindre le plafond.
- Tester un ticket avec deux taux de TVA.
- Vérifier les codes ZCOUPON créés.
- Créer les fiches ZCOUPON avec des libellés personnalisés.
- Tester sans fiche technique et contrôler le libellé générique.
- Tester le mode 1 sur la bonne ligne.
- Tester le mode 1 avec quantité supérieure à un.
- Tester un produit déjà en promotion.
- Tester une remise de ligne.
- Tester une remise globale.
- Tester deux coupons successifs.
- Tester un ticket avec fidélité.
- Tester une reprise de points ou voucher.
- Tester un ticket Web déjà remisé.
- Annuler le coupon avant encaissement.
- Retourner un article d’un ticket avec coupon.
- Retourner un produit offert.
- Contre-passer le ticket complet.
- Contrôler Ticket Z et TVA.
- Contrôler marge et statistiques.
- Tester les droits vendeur et superviseur.
- Retirer la touche puis rafraîchir les dalles.
25. Diagnostic rapide
La fonction 193 n’apparaît pas
Le coupon ne crée aucune ligne
-TX, le mode, le total du ticket
et la syntaxe des paramètres.
La remise est supérieure au plafond
-MAX, le séparateur décimal,
l’absence de plusieurs appuis et l’existence d’une deuxième remise.
Le coupon applique 5 € au lieu de 5 %
-TX5 signifie 5 %.
Contrôlez le total, le plafond et les autres lignes négatives.
Le libellé du coupon est générique
ZCOUPONxxyy correspondant au numéro
et au code TVA utilisés.
Le ticket contient plusieurs lignes ZCOUPON
La TVA paraît incorrecte
Le mauvais produit a été offert
Le produit offert reste valorisé dans certaines statistiques
Le coupon s’applique sur des produits en promotion
Le même coupon est appliqué deux fois
Le code-barres du coupon peut être rescanné
Le coupon de montant fixe ne fonctionne pas avec -TX
Le voucher ZEROSIX réduit deux fois le ticket
ZEROSIX comptabilise deux fois les lignes ZCOUPON
Le coupon Web est absent de la commande
Le coupon Web est appliqué une seconde fois au retrait
Les statistiques comptent plusieurs coupons sur un ticket
xx
du code ZCOUPON.
Le coupon continue après la fin de campagne
Le remboursement est supérieur au montant payé
26. Actions à éviter
- créer une touche sans plafond ni autorisation ;
- réutiliser un numéro de coupon pour une autre campagne ;
- supposer que la touche contrôle une date ou un usage unique ;
- appliquer deux fois le même coupon ;
- offrir une ligne sans contrôler le curseur ;
- remplacer la ventilation TVA par un article unique ;
- appliquer un coupon Web déjà inclus ;
- cumuler voucher financier et vente négative ;
- rembourser le prix catalogue d’un produit offert ;
- laisser la touche active après la campagne ;
- modifier directement les lignes ZCOUPON en base ;
- présenter un simple code-barres comme un bon sécurisé.
27. Liste de contrôle
- Le type d’avantage est défini.
- Le code
-NUMest unique et documenté. - Le taux
-TXest correct. - Le plafond
-MAXest défini. - Le mode 0 ou 1 est explicitement indiqué.
- Les fiches ZCOUPON et ZKADO sont contrôlées.
- La ventilation multi-TVA est testée.
- Les cumuls avec promotions et remises sont décidés.
- Les minimums et exclusions sont documentés.
- Les droits vendeur et superviseur sont limités.
- Les coupons papier sont neutralisés après usage.
- Les coupons uniques utilisent un mécanisme sécurisé.
- Les vouchers externes sont rapprochés.
- Les commandes Web ne reçoivent pas une seconde remise.
- Les retours utilisent le prix net payé.
- Les statistiques regroupent les lignes multi-TVA.
- La touche est retirée à la fin de la campagne.
28. Évolutions KWISATZ documentées
| Période | Évolution |
|---|---|
| Avril 2017 | Regroupement des fonctions Loyalty sous la fonction 209, dont -A2 pour la gestion des coupons. |
| Décembre 2019 | Création de la fonction 193 avec -NUM, -TX et -MAX, ventilation TVA et articles ZCOUPONxxyy. |
| Janvier 2021 | Lecture des coupons PrestaShop dans les commandes classiques et Click & Collect, avec détection montant ou pourcentage. |
| Février 2023 | Ajout de -MODE0 et -MODE1 ; le mode 1 offre la ligne active par une contrepartie ZKADO. |
| Avril 2023 | Prise en charge des coupons ZEROSIX en pourcentage et des vouchers par articles négatifs ventilés par TVA. |
| Avril 2023 | Correction de la remontée des coupons offrant les frais de port lors de la première commande PrestaShop. |
| Janvier 2025 | Exclusion des lignes ZCOUPON de certains exports ZEROSIX afin d’éviter une double comptabilisation en mode vente négative. |
29. Sources documentaires
- MENUS_KWISATZ — fonction 193 et paramètres
-NUM,-MODE,-TXet-MAX. - LesFonctionsDeCaisses — Coupon de réduction et fonctions Loyalty / ZEROSIX.
- Tutoriels KWISATZ — exemple de coupon 5 % plafonné à 10 €, ventilation TVA et articles
ZCOUPONxxyy. - Suivi de développement KWISATZ — création de la fonction en décembre 2019 et dépendance Pack caisse (fonctions avancées).
- Suivi de développement KWISATZ — ajout du mode produit offert en février 2023.
- Suivi de développement KWISATZ — coupons PrestaShop, Loyalty et ZEROSIX.
- Base support — limites des réductions fixes automatiques, articles négatifs et besoin éventuel de développement spécifique.