Documentation technique et fonctionnelle KWISATZ
Les monnayeurs automatiques
Un monnayeur automatique sécurise les paiements en espèces, compte les montants introduits, rend la monnaie et conserve un inventaire interne des pièces et billets. KWISATZ pilote l’encaissement et reçoit le résultat de l’appareil, tandis que le logiciel constructeur prend généralement en charge les opérations mécaniques et de maintenance.
Réponse directe
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 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.
3. Protection des données
4. Comprendre l’architecture
| Composant | Rôle |
|---|---|
| KWISATZ | Déclenche le paiement espèces, transmet le montant attendu, reçoit les montants versés et rendus, puis enregistre le règlement. |
| Connecteur ou composant fabricant | Traduit les demandes entre KWISATZ et le protocole de l’appareil : ActiveX, API, service ou échange de fichiers. |
| Logiciel constructeur | Gère les paramètres, l’état, le remplissage, la collecte, les diagnostics et la maintenance propres au matériel. |
| Monnayeur | Accepte les espèces, authentifie les billets et pièces, stocke les coupures et rend la monnaie. |
| Mode de règlement KWISATZ | Comptabilise le paiement dans le ticket, le financier et les statistiques de caisse. |
5. Interfaces documentées
| Interface | Mode de communication | Administration documentée |
|---|---|---|
| Glory CashInfinity | Interface directe par la couche Glory/BrueBox et son logiciel CashInfinity. | Inventaire, remplissage, sortie, collecte, cassettes, état et contrôle des coupures selon le modèle. |
| CashKeeper | Interface directe documentée. | Sortie de monnaie, réglage des bornes des stackers, billets autorisés, pièces de 1 centime et Broken Cent. |
| CashLogy | API et écran de pilotage du fabricant. | L’encaissement est automatique ; remplissage, vidage et maintenance passent par l’écran de pilotage appelé depuis KWISATZ. |
| CashDev / Smart Cashier | Échange de fichiers avec l’application Smart Cashier. | Répertoire d’échange historique C:\SMARTCASHIER avec sous-dossiers dédiés. |
| IMACASH / CashGuard | Échange de fichiers avec le produit tiers IMACASH. | Répertoire d’échange historique C:\IMACASH. |
| Autres interfaces historiques | Selon la version : CashSpeed, CacheLogik ou développements spécifiques. | Ne pas généraliser leur procédure sans documentation de l’installation. |
KWISATZ.INI ne doivent pas être modifiés
à partir de cette page. Utilisez l’interface standard ou une procédure du support,
car ces réglages sont dépendants du poste et de la version.
6. Prérequis avant installation
- version exacte de KWISATZ ;
- option ou sérialisation nécessaire ;
- constructeur, modèle et numéro de série ;
- version du firmware ;
- version du connecteur, de l’API ou de l’ActiveX ;
- logiciel fabricant correctement installé ;
- communication réseau, série ou fichiers fonctionnelle ;
- droits administrateur pour l’installation ;
- règlement Espèces correctement configuré ;
- vendeur et superviseur de test ;
- sauvegarde de la configuration du poste ;
- plan de retour au tiroir manuel en cas d’échec.
7. Configurer le périphérique dans KWISATZ
- Fermez la vente directe.
- Ouvrez Démarrage > Périphériques utilisés.
- Sélectionnez Monnayeur.
- Cochez Activée.
- Choisissez le type correspondant exactement au connecteur installé.
- Renseignez le fond de caisse à conserver.
- Désactivez les billets que l’appareil ne doit pas accepter.
- Définissez la gestion des pièces de 1 centime.
- Choisissez le règlement Broken Cent si nécessaire.
- Définissez les fonctions réservées au superviseur.
- Enregistrez avec F2.
- Relancez la vente directe.
| Paramètre | Utilisation |
|---|---|
| Activée | Active ou désactive l’utilisation du monnayeur sur le poste. |
| Type | Choisit le connecteur utilisé. « Aucun » signifie qu’aucun monnayeur n’est associé. |
| Fond de caisse | Définit le minimum de pièces et billets à conserver selon le comportement de l’interface. |
| Billets non acceptés | Empêche l’introduction des coupures cochées. |
| Gestion des pièces de 1 centime | Indique que l’appareil dispose et utilise cette coupure. |
| Règlement Broken Cent | Matérialise l’écart lorsqu’un centime ne peut pas être rendu exactement. |
| Fonctions réservées au superviseur | Protège les sorties, collectes, remplissages et réglages sensibles. |
8. Gérer les pièces de 1 centime et le Broken Cent
Certains appareils ne disposent pas de stacker pour les pièces de 1 centime. Pour solder un ticket, ils peuvent être contraints de rendre 2 centimes lorsqu’un seul centime serait normalement dû.
- Décochez la gestion des pièces de 1 centime si le matériel ne les gère pas.
- Créez ou identifiez le mode de règlement réservé au Broken Cent.
- Sélectionnez ce règlement dans la configuration du monnayeur.
- Testez des tickets dont le rendu attendu se termine par 1, 3, 6 ou 8 centimes.
- Contrôlez le montant encaissé, le montant rendu et l’écart enregistré.
- Contrôlez les statistiques et le ticket imprimé.
9. Fonction de caisse 143 — Fonctions monnayeur
La fonction 143 — Fonctions monnayeur donne accès aux opérations d’administration prévues par le connecteur. Le contenu varie selon le modèle.
| Paramètre documenté | Interface | Rôle |
|---|---|---|
| Sans paramètre ou fenêtre générale | Glory et interfaces selon version | Ouvre les fonctions disponibles : inventaire, remplissage, sortie, collecte ou état. |
-A20 |
CashKeeper documenté | Sortie directe de monnaie sans passage par les cassettes de stockage. |
-A25 |
Glory / CashKeeper selon version | Réglage des coupures autorisées et, pour CashKeeper, des bornes min/max des stackers. |
-A30 |
CashLogy | Ouvre l’écran de pilotage fabricant pour remplissage, vidage et maintenance. |
10. Encaisser un ticket en espèces
- Saisissez les produits.
- Appuyez sur Total.
- Sélectionnez le règlement Espèces lié au monnayeur.
- KWISATZ transmet le montant attendu au connecteur.
- Le client introduit pièces et billets.
- Contrôlez le montant affiché comme versé.
- L’appareil calcule et distribue le rendu éventuel.
- KWISATZ reçoit les montants réellement acceptés et rendus.
- Le ticket est finalisé uniquement après le résultat positif du monnayeur.
- Contrôlez l’impression et le retour à l’écran de vente.
11. Paiement partiel et paiement mixte
Les scénarios « espèces partielles puis carte bancaire » doivent être testés avec la version exacte du connecteur. Le comportement peut dépendre de la capacité du monnayeur à terminer ou annuler le cycle espèces.
- Créez un ticket de test à montant simple, par exemple 20 €.
- Lancez le paiement Espèces.
- Introduisez un montant inférieur au total.
- Vérifiez si l’interface autorise la clôture du dépôt partiel.
- Contrôlez le reste à payer dans KWISATZ.
- Réglez le solde par carte.
- Contrôlez les deux lignes de règlement et le total.
- Testez ensuite l’annulation du cycle avant validation.
- Vérifiez que les espèces introduites sont intégralement restituées ou comptabilisées.
12. Opérations techniques
| Opération | But | Contrôle KWISATZ |
|---|---|---|
| Inventaire | Lire le contenu en pièces et billets des unités. | Disponible notamment dans les fonctions Glory et dans l’intranet lorsqu’un Glory est déclaré. |
| Remplissage / réapprovisionnement | Ajouter des coupures aux recycleurs ou stackers. | Doit produire une trace et être effectué sous contrôle superviseur. |
| Sortie de monnaie | Distribuer un montant sans vente client. | Doit générer un ticket technique ou une opération tracée. |
| Collecte | Transférer les espèces des recycleurs vers les cassettes ou bacs de collecte. | Vérifier le ticket de prélèvement et la fin complète du cycle. |
| Vidage de cassette | Retirer le contenu d’une cassette sécurisée. | Ne pas fermer la fenêtre tant que l’appareil n’a pas confirmé la fin et que le prélèvement n’est pas enregistré. |
| Contrôle des coupures | Autoriser ou interdire certaines pièces et certains billets. | Réservé au superviseur et cohérent avec la configuration physique. |
13. Traçabilité des mouvements d’espèces
Les évolutions documentées font générer un ticket de caisse technique pour les remplissages, sorties de monnaie et collectes, plutôt qu’une ligne de règlement isolée.
Après chaque opération, contrôlez :
- le numéro et la date du ticket technique ;
- le vendeur ou superviseur ;
- la caisse et le centre ;
- le type d’opération ;
- le montant ;
- l’état final du monnayeur ;
- le prélèvement ou apport correspondant dans le financier de caisse.
14. Particularités Glory CashInfinity
L’interface Glory documentée gère notamment l’état, l’inventaire, l’encaissement, le rendu, les sorties, les collectes, les réapprovisionnements et le contrôle des coupures, selon les unités installées.
Réseau
- Vérifiez que le contrôleur Glory est sous tension.
- Contrôlez son adresse IP fixe.
- Vérifiez que la caisse se trouve sur le même réseau ou VLAN autorisé.
- Testez le ping.
- Testez l’accès à l’interface ou au service Glory prévu.
- Contrôlez le pare-feu, l’antivirus, les câbles et les doublons d’adresse IP.
- Relancez CashInfinity puis KWISATZ après correction.
Compteur de pièces incohérent
- Mettez la caisse hors encaissement.
- Ouvrez CashInfinity.
- Accédez aux actions ou tests du constructeur.
- Lancez une Collecte de vérification.
- Laissez le cycle contrôler tous les stackers sans interruption.
- Vérifiez les quantités recalculées.
- Retestez un rendu monnaie.
- Si l’écart persiste, faites intervenir la maintenance Glory.
15. Particularités CashKeeper
La documentation CashKeeper décrit :
- la gestion des pièces de 1 centime ;
- le règlement Broken Cent ;
- une sortie directe de monnaie avec la fonction 143 et
-A20; - le paramétrage des bornes minimum et maximum des stackers avec
-A25; - l’autorisation ou le rejet des billets ;
- la génération de tickets techniques pour remplissage, sortie et collecte.
16. Particularités CashLogy
L’encaissement est transmis automatiquement à l’interface CashLogy.
Les autres opérations sont sous-traitées à l’écran de pilotage fabricant,
accessible par la fonction 143 avec -A30 dans la version documentée.
Depuis cet écran, le fabricant peut proposer :
- remplissage ;
- vidage ;
- inventaire ;
- maintenance ;
- diagnostic des modules ;
- mise à jour des paramètres.
17. Interfaces par échange de fichiers
CashDev / Smart Cashier
Le répertoire historique est C:\SMARTCASHIER.
Les sous-répertoires documentés comprennent :
C:\SMARTCASHIER\CAISSE;C:\SMARTCASHIER\RETOURCAISSE.
IMACASH / CashGuard
Le produit tiers IMACASH permet à KWISATZ de communiquer en mode fichier
avec plusieurs types de monnayeurs, notamment CashGuard.
Le chemin historique par défaut est C:\IMACASH.
- Vérifiez l’existence des dossiers attendus.
- Vérifiez les droits de lecture, création, renommage et suppression.
- Contrôlez que le service tiers surveille le bon chemin.
- Testez une demande unitaire.
- Vérifiez le fichier de retour et les montants versé/rendu.
- Contrôlez qu’un fichier traité n’est pas relu une seconde fois.
18. Fond de caisse, collecte et décompte
Le stock interne du monnayeur et le financier de caisse doivent être rapprochés, mais ils ne représentent pas nécessairement la même notion :
| Valeur | Signification |
|---|---|
| Inventaire du monnayeur | Contenu physique ou logique déclaré par les unités de pièces et billets. |
| Fond de caisse | Montant minimum conservé pour assurer les rendus futurs. |
| Collecte / prélèvement | Espèces transférées ou retirées, avec une trace de mouvement. |
| Espèces théoriques KWISATZ | Résultat des tickets, apports et prélèvements enregistrés dans la caisse. |
| Décompte | Contrôle de fin de période et clôture du financier de caisse. |
19. Droits et sécurité
Réservez au superviseur :
- les sorties de monnaie sans vente ;
- les remplissages et réapprovisionnements ;
- les collectes et vidages de cassettes ;
- la modification des coupures autorisées ;
- les réglages minimum/maximum des stackers ;
- les diagnostics et opérations de maintenance ;
- la restitution forcée ou l’annulation technique ;
- l’ouverture des compartiments sécurisés.
20. Recette complète avant mise en production
- Tester un paiement exact en pièces.
- Tester un paiement exact en billets.
- Tester un paiement avec rendu monnaie.
- Tester une coupure interdite.
- Tester un ticket nécessitant un Broken Cent.
- Tester un paiement espèces partiel puis carte.
- Tester l’annulation avant et après introduction d’espèces.
- Tester un retour ou une contre-passation.
- Tester un manque de monnaie.
- Tester le réapprovisionnement sous contrôle superviseur.
- Tester une sortie de monnaie.
- Tester une collecte et un vidage de cassette.
- Vérifier chaque ticket technique.
- Comparer inventaire monnayeur et financier de caisse.
- Redémarrer le poste, le service et l’appareil.
- Retester un encaissement après redémarrage.
21. Diagnostic rapide
Le règlement Espèces n’ouvre pas le monnayeur
Le monnayeur accepte l’argent mais KWISATZ reste en attente
Le montant versé est affiché mais pas le montant rendu
Le monnayeur ne peut pas rendre une coupure
Glory indique des pièces qui ne sont plus présentes
La fonction de collecte se ferme avant la fin
CashLogy fonctionne mais les fonctions de maintenance sont absentes
-A30
lorsque cette méthode correspond à la version. Les opérations non commerciales
sont réalisées dans l’écran de pilotage CashLogy.
CashDev ou IMACASH ne répond pas
Le monnayeur est inaccessible après déplacement sur un autre réseau
Les périphériques disparaissent après une mise à jour Windows
Un retrait d’espèces n’est pas retrouvé
22. Actions interdites ou déconseillées
- modifier directement le stock logique du monnayeur ;
- ouvrir une cassette pour contourner un cycle logiciel ;
- fermer une opération avant sa confirmation ;
- désactiver les droits superviseur sans étude de fraude ;
- forcer un ticket comme payé après une erreur de communication ;
- réutiliser un ancien fichier de réponse CashDev ou IMACASH ;
- installer un connecteur d’une autre version sans recette complète ;
- supposer qu’un modèle récent est compatible avec l’ancien ActiveX ;
- exposer directement l’interface réseau du monnayeur sur Internet ;
- partager un seul appareil entre plusieurs caisses sans validation constructeur.
23. Liste de contrôle de mise en service
- Le modèle et la version du firmware sont identifiés.
- Le connecteur constructeur est compatible.
- Le périphérique est activé dans le bon poste KWISATZ.
- Le règlement Espèces est correctement associé.
- Le fond de caisse et les coupures sont définis.
- Le Broken Cent est testé si nécessaire.
- La fonction 143 est configurée pour le bon modèle.
- Les opérations sensibles sont réservées au superviseur.
- Les paiements exacts, rendus et mixtes sont validés.
- Les annulations et retours sont validés.
- Les sorties, remplissages et collectes sont tracés.
- Le décompte de caisse concorde avec les tickets techniques.
- Une procédure de panne et de maintenance est disponible.
24. Évolutions documentées
| Période | Évolution |
|---|---|
| 2016 | Correctifs Glory sur le rendu monnaie et sur le vidage de cassette afin de conserver le prélèvement KWISATZ. |
| 2017 | Fonctions 143 pour Glory, CashKeeper et CashLogy ; pièces de 1 centime, Broken Cent et génération de tickets techniques. |
| 2020–2021 | Développements CashDev, CashSpeed et interface fichier Smart Cashier. |
| 2022 | Ajout d’IMACASH pour piloter notamment CashGuard, avec contrôle des montants versé et rendu. |
| Versions récentes | Diagnostics réseau Glory, contrôle des stackers et tests renforcés après mises à jour de KWISATZ ou Windows. |
25. Sources documentaires
- MENUS_KWISATZ — Démarrage, Périphériques utilisés, onglet Monnayeur.
- Les fonctions de caisse KWISATZ — fonction 143.
- Suivi de développement KWISATZ — Glory, CashKeeper, CashLogy, CashDev et IMACASH.
- Base support KWISATZ — incidents CashInfinity, stock des stackers et réseau.
- Base support KWISATZ — paiements mixtes, droits superviseur, ActiveX et traçabilité des sorties.