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.

Fiche : PER-MON-001 Module : Vente directe / Monnayeur Public : intégrateur ou technicien Risque : critique Catégorie : Périphériques, impression et monétiqueMise à jour : 6 août 2026

Réponse directe

Ouvrez Démarrage > Périphériques utilisés > Monnayeur, cochez Activée, choisissez le type de matériel, puis configurez le fond de caisse, les billets acceptés, les pièces de 1 centime, le règlement Broken Cent et les opérations réservées au superviseur. Testez ensuite l’ensemble du cycle espèces avant la reprise de la caisse.
Le monnayeur intervient directement dans l’encaissement fiscal et le stock physique d’espèces. Toute installation, mise à jour, vidage, sortie ou correction doit être effectuée hors transaction client, avec un superviseur et une trace de contrôle.

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.
Un changement de matériel peut sembler transparent, mais la compatibilité du composant logiciel fabricant reste obligatoire. Un ActiveX, une API ou un service incompatible peut bloquer complètement l’encaissement, même si le monnayeur est neuf et fonctionnel.

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.
Les chemins techniques enregistrés dans 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.
Après une mise à jour de Windows ou de KWISATZ, contrôlez d’abord les pilotes, services et composants constructeur. Un périphérique absent dans Windows ne peut pas être réparé uniquement depuis KWISATZ.

7. Configurer le périphérique dans KWISATZ

  1. Fermez la vente directe.
  2. Ouvrez Démarrage > Périphériques utilisés.
  3. Sélectionnez Monnayeur.
  4. Cochez Activée.
  5. Choisissez le type correspondant exactement au connecteur installé.
  6. Renseignez le fond de caisse à conserver.
  7. Désactivez les billets que l’appareil ne doit pas accepter.
  8. Définissez la gestion des pièces de 1 centime.
  9. Choisissez le règlement Broken Cent si nécessaire.
  10. Définissez les fonctions réservées au superviseur.
  11. Enregistrez avec F2.
  12. 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û.

  1. Décochez la gestion des pièces de 1 centime si le matériel ne les gère pas.
  2. Créez ou identifiez le mode de règlement réservé au Broken Cent.
  3. Sélectionnez ce règlement dans la configuration du monnayeur.
  4. Testez des tickets dont le rendu attendu se termine par 1, 3, 6 ou 8 centimes.
  5. Contrôlez le montant encaissé, le montant rendu et l’écart enregistré.
  6. Contrôlez les statistiques et le ticket imprimé.
Le Broken Cent doit être isolé dans un mode de règlement dédié afin que les écarts soient identifiables et ne soient pas confondus avec une différence de caisse.

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.
N’attribuez pas un paramètre d’une interface à un autre constructeur. La fonction 143 dépend du type de monnayeur actif et de la version du connecteur.

10. Encaisser un ticket en espèces

  1. Saisissez les produits.
  2. Appuyez sur Total.
  3. Sélectionnez le règlement Espèces lié au monnayeur.
  4. KWISATZ transmet le montant attendu au connecteur.
  5. Le client introduit pièces et billets.
  6. Contrôlez le montant affiché comme versé.
  7. L’appareil calcule et distribue le rendu éventuel.
  8. KWISATZ reçoit les montants réellement acceptés et rendus.
  9. Le ticket est finalisé uniquement après le résultat positif du monnayeur.
  10. Contrôlez l’impression et le retour à l’écran de vente.
Dans l’interface Glory documentée, KWISATZ utilise les montants « in » et « out » retournés par l’interface, et non une simple estimation locale.
Ne finalisez pas manuellement un ticket en espèces lorsque l’appareil affiche encore une opération en cours, une erreur ou une demande de restitution.

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.

  1. Créez un ticket de test à montant simple, par exemple 20 €.
  2. Lancez le paiement Espèces.
  3. Introduisez un montant inférieur au total.
  4. Vérifiez si l’interface autorise la clôture du dépôt partiel.
  5. Contrôlez le reste à payer dans KWISATZ.
  6. Réglez le solde par carte.
  7. Contrôlez les deux lignes de règlement et le total.
  8. Testez ensuite l’annulation du cycle avant validation.
  9. Vérifiez que les espèces introduites sont intégralement restituées ou comptabilisées.
N’utilisez pas une séquence de contournement non documentée pour forcer un paiement mixte. Une manipulation incohérente peut désynchroniser le ticket et le stock physique d’espèces.

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.
N’ouvrez pas physiquement une cassette ou un compartiment pour contourner une fonction logicielle. Utilisez les opérations prévues afin de conserver la trace du mouvement.

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.
La traçabilité de l’ouverture physique d’un coffre ou d’une cassette dépend aussi du firmware et du logiciel constructeur. KWISATZ ne peut journaliser que les opérations qui passent par son interface ou lui sont retournées.

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

  1. Vérifiez que le contrôleur Glory est sous tension.
  2. Contrôlez son adresse IP fixe.
  3. Vérifiez que la caisse se trouve sur le même réseau ou VLAN autorisé.
  4. Testez le ping.
  5. Testez l’accès à l’interface ou au service Glory prévu.
  6. Contrôlez le pare-feu, l’antivirus, les câbles et les doublons d’adresse IP.
  7. Relancez CashInfinity puis KWISATZ après correction.
Si l’interface Glory est inaccessible depuis le navigateur ou le logiciel constructeur, KWISATZ ne pourra pas rétablir la communication à lui seul.

Compteur de pièces incohérent

  1. Mettez la caisse hors encaissement.
  2. Ouvrez CashInfinity.
  3. Accédez aux actions ou tests du constructeur.
  4. Lancez une Collecte de vérification.
  5. Laissez le cycle contrôler tous les stackers sans interruption.
  6. Vérifiez les quantités recalculées.
  7. Retestez un rendu monnaie.
  8. Si l’écart persiste, faites intervenir la maintenance Glory.
Ne modifiez pas manuellement le stock logique du monnayeur pour le faire correspondre au stock physique. KWISATZ dépend de l’état annoncé par 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.
Les valeurs minimum et maximum des stackers doivent correspondre aux capacités du matériel et au fonds de roulement décidé par le magasin.

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.
KWISATZ dépend du composant logiciel CashLogy et de la compatibilité de son interface. Après remplacement du matériel ou mise à jour, testez obligatoirement les montants acceptés, rendus, annulés et retournés.

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.

  1. Vérifiez l’existence des dossiers attendus.
  2. Vérifiez les droits de lecture, création, renommage et suppression.
  3. Contrôlez que le service tiers surveille le bon chemin.
  4. Testez une demande unitaire.
  5. Vérifiez le fichier de retour et les montants versé/rendu.
  6. Contrôlez qu’un fichier traité n’est pas relu une seconde fois.
Un antivirus, une synchronisation cloud ou un logiciel de sauvegarde peut verrouiller les fichiers d’échange. Excluez un dossier uniquement après diagnostic et validation de la politique de sécurité.

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.
Ne validez pas un décompte en vous fondant uniquement sur l’inventaire affiché. Vérifiez les collectes en cours, les cassettes, les tickets techniques et les espèces sorties.

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.
Ne désactivez pas une demande de mot de passe superviseur pour contourner une difficulté de rendu monnaie. Analysez la configuration et le stock du monnayeur avant de modifier une règle de sécurité.

20. Recette complète avant mise en production

  1. Tester un paiement exact en pièces.
  2. Tester un paiement exact en billets.
  3. Tester un paiement avec rendu monnaie.
  4. Tester une coupure interdite.
  5. Tester un ticket nécessitant un Broken Cent.
  6. Tester un paiement espèces partiel puis carte.
  7. Tester l’annulation avant et après introduction d’espèces.
  8. Tester un retour ou une contre-passation.
  9. Tester un manque de monnaie.
  10. Tester le réapprovisionnement sous contrôle superviseur.
  11. Tester une sortie de monnaie.
  12. Tester une collecte et un vidage de cassette.
  13. Vérifier chaque ticket technique.
  14. Comparer inventaire monnayeur et financier de caisse.
  15. Redémarrer le poste, le service et l’appareil.
  16. Retester un encaissement après redémarrage.
L’installation est validée lorsque chaque cycle se termine sans blocage, que les montants versés et rendus concordent, que les annulations restituent correctement les espèces et que tous les mouvements techniques sont tracés.

21. Diagnostic rapide

Le règlement Espèces n’ouvre pas le monnayeur
Vérifiez l’activation du périphérique, son type, le règlement Espèces, le logiciel constructeur, les services, le connecteur et la communication. Testez l’administration fabricant indépendamment de KWISATZ.
Le monnayeur accepte l’argent mais KWISATZ reste en attente
Contrôlez le retour du connecteur, la version de l’ActiveX ou de l’API, le service d’événements, le pare-feu et les journaux. Ne finalisez pas le ticket manuellement.
Le montant versé est affiché mais pas le montant rendu
Vérifiez la version du connecteur et les valeurs retournées par l’interface. Ce comportement a fait l’objet de correctifs historiques sur Glory et IMACASH.
Le monnayeur ne peut pas rendre une coupure
Vérifiez l’inventaire, les limites de stacker, les coupures activées et le fond de caisse. Réapprovisionnez par la procédure prévue, puis relancez un test sous superviseur.
Glory indique des pièces qui ne sont plus présentes
Lancez une Collecte de vérification depuis CashInfinity hors encaissement, laissez le cycle se terminer et contrôlez les compteurs. Escaladez vers Glory si l’incohérence persiste.
La fonction de collecte se ferme avant la fin
Ne cliquez pas sur Fermer tant que le monnayeur n’a pas confirmé la fin. Vérifiez que le prélèvement est créé dans KWISATZ. Mettez à jour si la version présente un ancien comportement de fermeture prématurée.
CashLogy fonctionne mais les fonctions de maintenance sont absentes
Configurez une touche 143 avec le paramètre -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
Vérifiez les répertoires d’échange, les droits, le service tiers, les fichiers bloqués et les retours. Ne déplacez pas manuellement un ancien fichier de réponse vers le dossier d’entrée.
Le monnayeur est inaccessible après déplacement sur un autre réseau
Vérifiez son IP fixe, le masque, la passerelle, le VLAN, le switch, les doublons d’IP et le pare-feu du poste. Comparez avec une caisse fonctionnelle.
Les périphériques disparaissent après une mise à jour Windows
Contrôlez d’abord Windows, les pilotes, les services et la fenêtre Périphériques et imprimantes. Redémarrez le poste puis revalidez la configuration KWISATZ seulement après stabilisation du système.
Un retrait d’espèces n’est pas retrouvé
Vérifiez si l’utilisateur a employé la sortie de monnaie logicielle ou une ouverture physique. Recherchez le ticket technique, le vendeur, le superviseur, la caisse et les journaux du constructeur.

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.