Documentation fonctionnelle KWISATZ
Rapprocher les paiements TPE avec les tickets KWISATZ
Le rapprochement monétique compare les règlements carte enregistrés dans les tickets, les transactions et lots du TPE, puis les crédits bancaires. Chaque niveau doit être contrôlé séparément avant d’expliquer un écart.
Réponse directe
Conseil pour les paramètres et le diagnostic monétique
1. Nature des fonctions KWISATZ citées
Une fonction de consultation, de correction, financière, de périphérique ou de sélection n’a pas le même effet. Les fonctions citées ci-dessous restent limitées au comportement documenté.
| Fonction | Nature | Effet documenté et limite |
|---|---|---|
| 033 | Fonction sensible de caisse | Avec le paramètre -FF, elle doit être protégée et utilisée uniquement dans le cadre documenté. |
| 079 | Fonction financière | Décompte ; reste distinct du prélèvement, de la dépense diverse et de l’apport. |
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 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.
- Contrôler séparément la transaction réelle.
- le statut du terminal ;
- le lot du terminal ;
- la ligne de règlement enregistrée dans KWISATZ.
4. Protection des données
5. Les trois sources à rapprocher
| Source | Ce qu’elle prouve | Limite |
|---|---|---|
| KWISATZ | Règlement enregistré dans le ticket, avec date, caisse, vendeur et mode. | Ne prouve pas à lui seul que la transaction a été acquise par la banque. |
| TPE | Demande, acceptation ou échec de la transaction, puis constitution du lot de télécollecte. | Le lot peut couvrir plusieurs caisses, terminaux ou plages horaires selon l’installation. |
| Banque | Crédit effectivement porté au compte. | Le montant peut être net de commissions, regroupé ou décalé dans le temps. |
6. Fonctions KWISATZ documentées
| Fonction | Usage |
|---|---|
| 099 — Liste des règlements | Recherche détaillée à l’écran, ligne par ligne. |
| 102 — Journal des règlements | Édition avec modèle, critères de sélection et tri. |
| 097 — Liste des tickets | Recherche des tickets concernés pour contrôle du détail. |
| 079 — Décompte de caisse | Contrôle financier de la période de caisse, distinct du lot TPE. |
7. Filtres de la liste des règlements
| Filtre | Utilisation |
|---|---|
| Du / au | Période exacte à rapprocher. |
| Période prédéfinie | Utilisez une plage proposée par l’écran lorsqu’elle correspond au lot contrôlé. |
| N° centre | Sélectionnez le centre concerné ; la valeur neutre documentée est 0. |
| Numéro caisse | Sélectionnez la caisse concernée ; la valeur neutre documentée est 0. |
| Vendeur | Diagnostic d’un opérateur ou d’une caisse flottante. |
| Mode règlement | Code Carte bancaire Euro ou autre code carte réellement utilisé. |
| Filtre | Utilisez les critères supplémentaires uniquement s’ils sont maîtrisés et nécessaires. |
8. Préparer le rapprochement quotidien
- Notez la date commerciale de la journée.
- Identifiez chaque TPE et son numéro de terminal.
- Identifiez la caisse et le centre KWISATZ associés.
- Relevez le code règlement carte utilisé.
- Obtenez le relevé des transactions et le total du lot selon les outils fournis par le terminal ou le prestataire.
- Conservez le justificatif du lot.
- Extrayez les règlements KWISATZ sur le même périmètre.
9. Étape 1 — Total carte KWISATZ
- Ouvrez Rechercher un règlement.
- Renseignez la période.
- Filtrez le centre et la caisse.
- Sélectionnez le code règlement carte.
- Contrôlez les lignes et le total.
- Adaptez la présentation uniquement si les colonnes nécessaires sont disponibles.
- Imprimez ou prévisualisez le journal 102 pour conserver la pièce de contrôle.
10. Étape 2 — Total brut du TPE
Relevez sur le TPE ou le portail monétique :
- numéro de terminal ;
- date et heure de la transaction ;
- montant ;
- statut accepté, refusé ou annulé ;
- numéro de transaction ou référence disponible ;
- total du lot ;
- date et heure de télécollecte.
11. Comparer KWISATZ au TPE
Écart monétique brut = Total brut TPE − Total carte KWISATZ| Résultat | Interprétation initiale |
|---|---|
| 0,00 € | Le total carte enregistré correspond au total TPE du périmètre. |
| Positif | Le TPE contient davantage que KWISATZ : transaction absente, montant supérieur ou périmètre plus large. |
| Négatif | KWISATZ contient davantage que le TPE : règlement enregistré sans acquisition, lot incomplet ou mauvais périmètre. |
12. Étape 3 — Rapprocher le lot au crédit bancaire
Crédit bancaire attendu = Montant brut du lot − commissions et retenues identifiéesCette formule est un principe de rapprochement bancaire et non une fonction KWISATZ. Les frais, retenues, dates de valeur et regroupements dépendent du contrat conclu avec l’acquéreur.
- Comparez le numéro ou la date du lot.
- Contrôlez la date de valeur bancaire.
- Identifiez les commissions.
- Identifiez les remboursements ou rétrofacturations.
- Contrôlez les regroupements de plusieurs terminaux.
- Conservez le relevé ou bordereau acquéreur.
13. Tableau de rapprochement recommandé
| Date | Caisse | TPE | KWISATZ CB | Lot brut | Banque net | Écart / motif |
|---|---|---|---|---|---|---|
| Date de contrôle | 01 | TPE 01 | 1 250,00 € | 1 250,00 € | 1 240,25 € | 9,75 € de frais documentés. |
| Date de contrôle | 02 | TPE 02 | 630,00 € | 625,00 € | À contrôler | Écart brut de -5,00 €. |
14. Rapprochement ticket par ticket
Lorsque le total diffère, comparez chaque ligne à partir des informations disponibles.
- Triez les règlements KWISATZ par heure et montant.
- Triez les transactions TPE de la même manière.
- Rapprochez les montants uniques.
- Pour les montants répétés, utilisez l’heure, la caisse et les références disponibles.
- Ouvrez le ticket KWISATZ correspondant.
- Vérifiez les autres règlements du ticket.
- Conservez toute ligne non rapprochée dans une liste d’écarts.
15. Tickets multi-règlements
Dans un ticket espèces + carte, le TPE doit normalement recevoir uniquement le reste à payer par carte.
| Total ticket | Espèces | Carte attendue |
|---|---|---|
| 44,99 € | 40,00 € | 4,99 € |
16. Paramétrage du Total automatique
Dans le cas support documenté, le mode Espèces configuré avec Total automatique était une piste de diagnostic : le reste à payer pouvait ne pas avoir été rafraîchi avant l’appel du TPE.
- Faites relever le paramétrage du mode Espèces par un technicien KWISATZ.
- Sur une caisse de recette, faites désactiver temporairement Total automatique.
- Vérifiez la présence de 033 — Total ticket.
- Saisissez le montant espèces du scénario de test.
- Utilisez Total et contrôlez le reste affiché.
- Lancez ensuite le règlement carte du solde.
- Comparez le ticket, le justificatif TPE et le log.
17. Configurer et identifier le TPE
Dans la configuration des périphériques connectés, l’onglet TPE présente les réglages disponibles selon le protocole et la version installés.
- activation du périphérique ;
- type de connexion ou protocole ;
- port série ou adresse réseau lorsqu’ils sont proposés ;
- identifiants nécessaires au terminal ou au protocole ;
- options d’autorisation ou de protection disponibles ;
- Création d’un log par transaction pour le dépannage.
18. Activer les logs TPE
L’option « Création d’un log par transaction », prévue pour le dépannage, enregistre les échanges utiles au diagnostic entre KWISATZ et le TPE.
- Activez-la pendant le diagnostic.
- Reproduisez une transaction de faible montant maîtrisée.
- Notez l’heure exacte.
- Conservez le ticket KWISATZ et le ticket CB.
- Récupérez le fichier dans le dossier
LOG. - Désactivez la journalisation permanente si elle n’est plus utile.
19. Lire un log TPE
Le log sert à déterminer :
- le montant demandé par KWISATZ ;
- la présence ou l’absence de réponse ;
- le statut retourné ;
- le montant réellement confirmé lorsqu’il est fourni ;
- un abandon depuis la caisse ou depuis le terminal ;
- une trame mal formée.
20. Transaction acquise mais réponse absente
Le suivi de développement de novembre 2025 documente des transactions effectivement réalisées par le TPE sans réponse exploitable retournée à la caisse.
| TPE / Banque | KWISATZ | Risque |
|---|---|---|
| Transaction acceptée | Ticket sauvegardé avec un montant différent ou sans règlement attendu | Écart réel entre acquisition et caisse. |
| Pas de réponse TPE | Opérateur relance la carte | Double débit possible. |
21. Évolutions monétiques documentées en novembre 2025
- Logs incluant le code caisse.
- Distinction entre abandon depuis le TPE et abandon depuis la caisse.
- Rejet des réponses mal formées résiduelles.
- Événement d’erreur monétique
10602. - Récupération du montant réel dans certains scénarios TRD.
22. Écarts de dates courants
| Cause | Effet |
|---|---|
| Télécollecte après minuit | Transactions de la veille dans un lot daté du lendemain. |
| Week-end ou jour férié | Crédit bancaire reporté. |
| Lot manuel ou retardé | Plusieurs journées regroupées. |
| Heures caisse/TPE désynchronisées | Rapprochement par heure rendu difficile. |
23. Cartes, remboursements et annulations
- Distinguez vente, remboursement et annulation TPE.
- Conservez chaque justificatif.
- Vérifiez le signe du mouvement KWISATZ.
- Contrôlez le lot dans lequel l’opération est partie.
- Vérifiez le crédit ou débit bancaire correspondant.
24. Plusieurs TPE ou plusieurs caisses
Définissez une règle stable d’association.
| Architecture | Contrôle |
|---|---|
| Un TPE par caisse | Rapprochement direct caisse/terminal. |
| Un TPE partagé | Utiliser heures, montants et éventuellement vendeur ou centre. |
| Plusieurs TPE pour une caisse | Séparer les lots par identifiant terminal. |
| Monétique centralisée | Contrôler la règle de regroupement du prestataire. |
25. Personnaliser la liste de contrôle
- Ouvrez la liste des règlements.
- Ouvrez la configuration de la présentation disponible dans la version installée.
- Ajoutez les colonnes utiles lorsqu’elles sont proposées : date, heure, ticket, caisse, centre, vendeur, mode et montant.
- Activez les possibilités de tri et de filtre disponibles.
- Enregistrez puis contrôlez la présentation.
26. Corriger une erreur de règlement dans KWISATZ
La procédure dépend du paiement réel, de l’état du ticket, des droits et de la clôture de la période.
- Utilisez 156 pour corriger le mode ou la ventilation des règlements d’un ticket lorsque la procédure l’autorise.
- La correction rapide remplace un moyen par un autre ; la correction avancée demande de ressaisir l’ensemble des règlements.
- Utilisez 157 uniquement pour contre-passer l’ensemble de la vente lorsqu’une annulation totale est justifiée.
- Une correction KWISATZ ne rembourse pas automatiquement une transaction bancaire.
- Conservez le justificatif du paiement réel et le motif de la correction.
27. Journal d’écarts recommandé
| Donnée | Exemple |
|---|---|
| Ticket | 3509 du 31/10/2025. |
| Caisse / TPE | Caisse 02 / terminal 03. |
| KWISATZ | 49,64 € CB. |
| TPE / banque | 49,99 €. |
| Écart | 0,35 €. |
| Pièces | Ticket, justificatif CB, lot et log. |
| Cause | À confirmer par analyse de trame. |
| Action | Support monétique / développement. |
28. Checklist quotidienne
| Contrôle | Validation |
|---|---|
| Périmètre | Date, caisse, centre et terminal identifiés. |
| KWISATZ | Mode carte filtré et total archivé. |
| TPE | Transactions et lot brut disponibles. |
| Brut | KWISATZ = TPE ou écart expliqué. |
| Banque | Lot = crédit + frais/écarts documentés. |
| Remboursements | Signes et justificatifs contrôlés. |
| Anomalies | Tickets et logs conservés. |
| Correction | Aucune modification sans preuve. |
29. Actions à éviter
- Comparer directement le brut KWISATZ au net bancaire.
- Mélanger plusieurs TPE sans identifiant de terminal.
- Ignorer l’heure de télécollecte.
- Relancer une CB après absence de réponse sans vérifier le TPE.
- Corriger un ticket pour équilibrer sans justificatif.
- Laisser les logs actifs indéfiniment sans surveillance de l’espace disque.
- Conclure à un bug KWISATZ avant d’avoir lu le montant envoyé dans la trame.
- Conclure à un bug TPE lorsque KWISATZ a déjà transmis un mauvais montant.
30. Compatibilité documentée
| Fonction | Repère | Condition |
|---|---|---|
| Liste des règlements | Fonction 099 | Filtres période, centre, caisse, vendeur et mode. |
| Journal des règlements | Fonction 102 | Modèle, critères de sélection et tri. |
| Liste des tickets | Fonction 097 | Contrôle du détail du ticket. |
| Décompte de caisse | Fonction 079 | Contrôle financier distinct du lot TPE. |
| Total ticket | Fonction 033 | Test du reste à payer avant règlement carte. |
| Connexion TPE | Périphériques connectés | Protocole et matériel compatibles. |
| Log par transaction | Mode dépannage | Fichiers enregistrés dans le dossier LOG. |
| Correction règlements | Fonction 156 | Selon droits, état du ticket et clôture. |
| Contre-passation | Fonction 157 | Annulation complète de la vente. |
| Événement monétique | ID 10602 | Évolution documentée de novembre 2025, selon version. |
31. Diagnostic rapide
KWISATZ et le total TPE sont identiques, mais la banque est inférieure
Le TPE est supérieur à KWISATZ
KWISATZ est supérieur au TPE
Le client a été débité du total au lieu du solde
La caisse affiche Pas de réponse mais le client a un ticket CB
La date banque ne correspond pas à la date KWISATZ
Le log TPE n’existe pas
Le montant envoyé par KWISATZ est déjà faux
Le montant envoyé est correct mais la réponse TPE est différente
Plusieurs tickets ont le même montant
Un remboursement n’apparaît pas dans le même lot
La liste des règlements contient aussi des apports
32. Résultat attendu
33. Sources documentaires
- Manuel KWISATZ — Rechercher un règlement, filtres et liste des mouvements financiers.
- Fonctions de caisse — 099 Liste des règlements et 102 Journal des règlements.
- Manuel KWISATZ — Périphériques connectés, onglet TPE et Création d’un log par transaction.
- Suivi de développement — logs TPE, événements monétiques et cas d’écarts de montants.
- Base support — multi-règlement espèces + carte et piste Total automatique.
- Manuel KWISATZ — personnalisation des listes, tri et filtrage.