Documentation technique et fonctionnelle KWISATZ
Les plateformes de fidélité
KWISATZ peut communiquer avec une plateforme de fidélisation externe afin de centraliser les clients, les points, les cagnottes et les bons dans un environnement multi-magasins. La documentation fournie décrit principalement les interfaces ADELYA et ZEROSIX.
Réponse directe
Conseil pour les paramètres et configurations
1. Repères de version
Les références de version ci-dessous sont conservées comme repères documentaires. Les menus, options et comportements doivent être contrôlés sur la version et la sérialisation réellement installées ; une évolution plus récente peut avoir modifié le fonctionnement.
2. 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.
3. 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.
4. Distinguer KWISATZ des opérations externes
Un enregistrement dans KWISATZ ne prouve pas automatiquement qu’une opération a été exécutée dans un système externe : débit ou remboursement TPE, mouvement physique d’espèces, envoi de SMS ou d’e-mail, ou action réalisée sur une plateforme.
5. Fidélité locale ou fidélité externe
| Mode | Source de référence | Fonctionnement |
|---|---|---|
| Fidélité KWISATZ | Base clients et paramètres du dossier KWISATZ. | Les règles du dossier KWISATZ calculent les avantages locaux. |
| Plateforme externe | Compte cloud du prestataire. | KWISATZ échange avec la plateforme selon l’interface activée ; la plateforme calcule la situation qu’elle gère. |
| Ticket dématérialisé | Service d’envoi ou d’archivage du ticket. | Service distinct ; sa présence ne prouve pas l’existence d’une cagnotte ou d’un programme de fidélité complet. |
6. Prérequis
- compte opérationnel auprès du prestataire ;
- programme commercial défini et documenté ;
- option KWISATZ active sur les caisses qui communiquent réellement ;
- version compatible avec l’interface et les fonctions utilisées ;
- connexion Internet stable et sécurisée ;
- URL et secret fournis pour le compte du commerçant ;
- modes de règlement, catégories et articles techniques contrôlés ;
- touches de caisse programmées et testées ;
- client et ticket de recette identifiables ;
- procédure anti-doublon et règles de protection des données.
7. Comprendre le flux d’une transaction
- Le client présente sa carte, son téléphone ou son identifiant.
- KWISATZ interroge la plateforme.
- La fiche locale est retrouvée, associée, créée ou actualisée selon le cas.
- L’opérateur saisit le ticket normalement.
- Un avantage peut être proposé au moment du Total.
- Le ticket est encaissé.
- KWISATZ transmet la transaction à la plateforme.
- La plateforme recalcule les points, vouchers ou la cagnotte.
- La nouvelle situation est renvoyée lorsque l’échange aboutit.
- Les informations disponibles peuvent être affichées ou imprimées selon la version.
8. Configurer ADELYA
L’interface ADELYA historique utilise des paramètres techniques dans la section COMMUN de PREFERENCES.ini. Leur présence et leur nom doivent être contrôlés sur la version installée.
| Paramètre | Rôle |
|---|---|
FIDELITE_ADELYA_ACTIVEE |
Active ou désactive l’interface. |
FIDELITE_ADELYA_URL_BASE |
Adresse du service fournie et validée pour le compte. |
FIDELITE_ADELYA_URL_APIKEY |
Clé API secrète du compte. |
FIDELITE_ADELYA_URL_USER |
Identifiant technique lorsque la configuration l’utilise. |
FIDELITE_ADELYA_URL_PASSWORD |
Mot de passe technique lorsque la configuration l’utilise. |
FIDELITE_ADELYA_RADICAL_CARTE_01 |
Radical de carte défini pour le programme. |
FIDELITE_ADELYA_RADICAL_CARTE_02 |
Radical de carte défini pour le programme. |
FIDELITE_ADELYA_CODE_REGLEMENT |
Code du règlement utilisé pour les opérations de carte. |
FIDELITE_ADELYA_CODE_CATEGORIE_CLIENT |
Catégorie appliquée aux fiches associées selon la configuration. |
PREFERENCES.ini. Ce repère interne ne doit pas être modifié directement. Faites analyser et valider le réglage par un technicien KWISATZ après sauvegarde et relevé de la configuration.9. Configurer les fonctions ADELYA
Ajoutez au clavier tactile la fonction 167 — ADELYA — Créer une carte.
La procédure de création documentée demande :
- la lecture ou la saisie du code-barres de la carte ;
- le nom du client ;
- éventuellement son adresse e-mail ;
- la validation de l’envoi vers la plateforme.
10. Utiliser une carte ADELYA
Identifier le client
- Scannez la carte dans la vente directe.
- KWISATZ reconnaît son radical.
- La plateforme est interrogée.
- Les informations administratives et le solde sont récupérés.
- La fiche locale est actualisée avec les données de la plateforme.
- La catégorie client ADELYA est appliquée selon la configuration.
Lorsque la carte n’est pas lisible, utilisez uniquement la recherche ou la procédure de secours réellement configurée.
Recharger la carte
La documentation prévoit les articles techniques suivants :
CARTE025;CARTE050;CARTE100.
La documentation historique associe ces articles techniques à des montants de recharge. Testez chaque code et sa valeur avant utilisation.
Payer avec la carte
- Sélectionnez le client ADELYA.
- Saisissez les produits.
- Utilisez le mode de règlement configuré pour ADELYA.
- Saisissez le montant à débiter.
- Finalisez le ticket.
- Contrôlez le nouveau solde.
11. Configurer ZEROSIX
Dans les versions documentées, la configuration se trouve dans les préférences de Vente directe, section Plateforme ZEROSIX — Fidélité cloud. Le chemin exact doit être vérifié sur la version installée.
| Zone | Utilisation |
|---|---|
| Activer | Active la fidélité ZEROSIX. |
| URL | Adresse API fournie pour le compte du commerçant. |
| Token | Secret du compte à protéger et à tester. |
| Type de programme | Cycle ou Cagnotte selon le programme réellement souscrit. |
| Bon voucher — mode de règlement associé | Règlement utilisé pour comptabiliser le bon. |
| Reprise voucher par vente négative | Mode alternatif de reprise à valider avec la version et la comptabilité. |
| Recherche client — nombre minimum de caractères | Limite les recherches trop larges ; la documentation historique indique 3 par défaut. |
| Connexion — Timeout | Temporisation de connexion ; la documentation historique indique 10 secondes par défaut. |
12. Choisir le programme ZEROSIX
| Programme | Accumulation | Utilisation |
|---|---|---|
| Cycle | Le programme cumule des points et peut générer des vouchers selon ses règles. | Utilisation d’un bon disponible au moment prévu par la plateforme. |
| Cagnotte | Le programme gère une valeur disponible selon ses propres règles. | Utilisation totale ou partielle lorsque la version KWISATZ et le compte le permettent. |
13. Configurer les fonctions ZEROSIX
Ajoutez la fonction 212 — Fonction ZEROSIX au clavier tactile.
| Paramètre | Fonction |
|---|---|
-A1 |
Ouvre les opérations de gestion ou de recherche documentées. |
-A2 |
Ouvre la liste des vouchers utilisables selon la configuration. |
14. Rechercher et associer un client ZEROSIX
La recherche peut porter sur le début du nom ou du numéro de téléphone. Le nombre minimum de caractères évite de renvoyer une liste trop importante.
Client déjà associé
La liaison utilise un identifiant cloud mémorisé dans la fiche. CLOUD_ID est un champ interne utile au diagnostic ; ne le modifiez pas directement.
Client présent uniquement chez ZEROSIX
La sélection peut créer une fiche KWISATZ locale associée à l’identifiant cloud.
Client présent dans les deux systèmes mais non associé
Utilisez la fonction d’association afin d’éviter une nouvelle fiche.
Client présent uniquement dans KWISATZ
Utilisez la procédure prévue pour créer le contact sur la plateforme puis contrôlez l’association.
Client nouveau dans les deux systèmes
Créez la fiche depuis la fenêtre ZEROSIX lorsque la procédure le prévoit, puis contrôlez les deux fiches.
15. Saisir et transmettre un ticket ZEROSIX
- Recherchez et sélectionnez le client.
- Vérifiez son nom et sa situation fidélité.
- Saisissez le ticket normalement.
- Au Total, contrôlez les vouchers ou la cagnotte proposés.
- Utilisez un avantage si le client le souhaite.
- Encaissez le solde restant.
- Finalisez le ticket.
- KWISATZ tente de transmettre la transaction à ZEROSIX.
- La plateforme recalcule la situation lorsque la transmission aboutit.
- Contrôlez le retour, le solde sur la plateforme et les informations disponibles.
16. Utiliser les vouchers et la cagnotte
Voucher — Programme Cycle
ZEROSIX peut transformer automatiquement les points en bons lorsqu’un seuil est atteint. À l’appel du Total, KWISATZ propose les bons disponibles.
- Ouvrez la liste des vouchers.
- Sélectionnez le bon voulu.
- Validez son utilisation.
- Contrôlez sa reprise comme règlement ou vente négative selon la configuration.
- Vérifiez le solde du ticket et la disparition du bon utilisé.
Cagnotte — Programme Cagnotte
Le suivi de développement documente, à partir de la branche 3.56, l’utilisation directe de la cagnotte sur les versions compatibles. Vérifiez la révision installée avant de l’annoncer en production.
- Vérifiez le montant disponible.
- Saisissez le montant à utiliser.
- Contrôlez qu’il ne dépasse ni le solde du ticket ni la cagnotte.
- Encaissez le reste par un autre règlement si nécessaire.
- Contrôlez le nouveau solde renvoyé par ZEROSIX.
17. Architecture multi-caisses et multi-magasins
Une plateforme externe peut centraliser la situation fidélité pour plusieurs magasins. Chaque caisse concernée communique avec le compte commun selon l’architecture et la licence validées.
- Recensez les caisses qui recherchent des clients cloud.
- Recensez celles qui cumulent ou consomment la fidélité.
- Activez le module sur les licences concernées.
- N’équipez pas inutilement un Back-Office sans rôle d’encaissement.
- Testez un même client sur deux caisses.
- Vérifiez la mise à jour du solde après chaque transaction.
18. Promotions, familles et exclusions
Les règles de points, exclusions et promotions dépendent du programme configuré sur la plateforme. KWISATZ transmet les informations prévues par l’interface et la version.
- contrôlez les codes articles transmis ;
- contrôlez les familles ou catégories utilisées pour les exclusions ;
- testez une ligne en promotion et une ligne hors promotion ;
- vérifiez le ticket reçu sur la plateforme ;
- comparez les points calculés avec la règle attendue ;
- utilisez une version récente avant d’analyser une incohérence historique.
19. Sécurité et données clients
- protéger les tokens, clés API et mots de passe ;
- masquer les secrets dans les captures et journaux transmis ;
- limiter les droits sur
PREFERENCES.ini; - utiliser des connexions chiffrées fournies par la plateforme ;
- ne transmettre que les données nécessaires au programme ;
- documenter la plateforme comme destinataire ou sous-traitant selon le contrat ;
- informer le client de l’utilisation de ses données et respecter ses choix ;
- prévoir une procédure d’exercice des droits et de suppression ;
- ne pas partager de données réelles dans un environnement de démonstration.
20. Recette avant mise en production
- Tester l’accès API depuis chaque caisse pilote.
- Rechercher un client existant sur la plateforme.
- Créer un client nouveau.
- Associer deux fiches existantes.
- Vérifier le champ
CLOUD_ID. - Réaliser un ticket sans avantage.
- Contrôler son apparition sur la plateforme.
- Contrôler les points ou la cagnotte après encaissement.
- Tester un voucher ou un paiement par cagnotte.
- Tester un règlement partiel.
- Tester une promotion et une famille exclue.
- Tester une indisponibilité simulée sur une caisse pilote sans perturber la production.
- Vérifier l’état de la première tentative avant toute nouvelle transmission.
- Contrôler le financier, le ticket imprimé et le journal de la plateforme.
21. Diagnostic rapide
La recherche ZEROSIX ne contacte pas la plateforme
Erreur lors de l’appel à « create contact »
La recherche renvoie trop de clients
Le client est dupliqué dans KWISATZ
Le ticket n’apparaît pas sur ZEROSIX
Le ticket apparaît deux fois sur la plateforme
Les points sont absents sur un produit en promotion
Le voucher n’est pas proposé au Total
La cagnotte n’est pas utilisable directement
La carte ADELYA n’est pas reconnue
Le solde ADELYA ne change pas après une recharge
22. Liste de contrôle de mise en service
- Le compte du prestataire est opérationnel.
- La licence est active sur chaque caisse concernée.
- L’URL et le secret API sont validés.
- Le programme Cycle ou Cagnotte est correct.
- Les modes de règlement sont configurés.
- Les touches 167 ou 212 sont testées.
- Les clients existants sont recherchés avant création.
- Les associations CLOUD_ID sont contrôlées.
- Un ticket est transmis une seule fois.
- Les points, vouchers ou soldes concordent.
- Les promotions et exclusions sont testées.
- Les secrets et données clients sont protégés.
23. Évolutions ZEROSIX documentées à vérifier
| Évolution | Information |
|---|---|
| Programme Cycle ou Cagnotte | Choix documenté dans la branche 3.56. |
| Recherche client | Nombre minimum de caractères ajouté dans les préférences. |
| Temporisation de connexion | Réglage documenté, avec 10 secondes comme valeur historique par défaut. |
| Cagnotte directe | Développement et tests documentés en juin 2025 dans la branche 3.56. |
| Promotions et identifiants de ticket | Correctifs successifs documentés ; relever la version exacte pour tout diagnostic. |
24. Sources documentaires
- Tutoriel KWISATZ — paramétrage et utilisation des interfaces ADELYA et ZEROSIX.
- Tutoriel KWISATZ — création, recherche et association des clients ZEROSIX.
- Fonctions de caisse KWISATZ — 167 ADELYA et 212 ZEROSIX.
- Suivi de développement KWISATZ — programme Cycle/Cagnotte, temporisation et cagnotte directe.
- Base support KWISATZ — URL/token, association cloud, identifiants de ticket, promotions et licences multi-caisses.