Monétique IP et TPE

Réponse directe

Conseil pour la configuration monétique

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 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. Principe de la monétique connectée

1. L’opérateur sélectionne un mode de règlement relié au TPE.
2. KWISATZ calcule le montant restant à régler.
3. La caisse envoie ce montant au terminal.
4. Le client présente sa carte ou son moyen de paiement compatible.
5. Le terminal traite la transaction dans son circuit monétique.
6. Le TPE renvoie un statut et, selon l’interface, des informations sur le montant réellement accepté.
7. KWISATZ crée la ligne de règlement uniquement après un retour positif exploitable.
8. Les reçus sont imprimés par le terminal ou par l’imprimante de caisse.

6. Choisir l’interface correcte

7. Vérifier les options de licence

8. Préparer le réseau IP

1. Connectez le TPE au réseau prévu par le mainteneur monétique.
2. Attribuez-lui une adresse stable ou une réservation DHCP.
3. Placez la caisse et le terminal sur des réseaux autorisés à communiquer.
4. Identifiez le port du protocole.
5. Autorisez uniquement les communications nécessaires entre la caisse et le terminal.
6. Faites tester la communication depuis la caisse avec un outil ou une procédure adaptée.
7. Évitez les doubles adresses IP.
8. Documentez le terminal, sa caisse, son adresse et son prestataire.

Syntaxe Concert V3 IP

192.168.1.11

Le port historique par défaut est alors 8888.

192.168.1.11:5000

La syntaxe IP:PORT permet de préciser un port différent sur les versions compatibles. Le nombre 5000 n’est qu’un exemple : utilisez le port fourni pour le terminal.

9. Configurer le TPE dans KWISATZ

Le chemin documenté est Démarrage > Périphériques utilisés > TPE ; l’intitulé exact peut varier selon la version.

10. Configurer le mode de règlement CB

Dans la fiche du mode de règlement utilisé pour les cartes :

1. Choisissez un code et un libellé explicites.
2. Cochez Connecter TPE.
3. Contrôlez le Total automatique, la saisie du montant et leur effet sur les paiements mixtes.
4. Contrôlez la catégorie du règlement et son apparition dans le décompte.
5. Ajoutez la touche au clavier tactile.
6. Testez les règlements partiels.
7. Utilisez un règlement TRD distinct lorsque l’interface le prévoit.

11. Effectuer un paiement

1. Saisissez les articles.
2. Appuyez sur Total ou utilisez le règlement avec total automatique.
3. Sélectionnez la carte bancaire.
4. Vérifiez le montant affiché dans la fenêtre TPE.
5. Le client effectue son paiement.
6. Attendez le statut définitif du terminal.
7. Vérifiez que le règlement enregistré correspond au montant accepté.
8. Remettez le reçu disponible selon la configuration.
9. Finalisez le ticket.

Paiement partiel

Lorsque le ticket a déjà reçu un autre règlement, seul le reste à payer doit être transmis. Testez également les cartes TRD, qui peuvent être limitées aux produits éligibles.

12. Imprimer les reçus client et commerçant

Concert V3 IP

Lorsque le type est Protocole Concert V3 (IP), l’option Impression des tickets depuis la caisse active les choix suivants :

Yavin sur anciennes versions

Certaines anciennes versions Yavin utilisaient des réglages de poste dans le fichier de configuration.

Pour le reçu client, la valeur 2 demande à chaque transaction si le client souhaite un exemplaire imprimé.

13. Remboursement et abandon de transaction

Remboursement CB

1. Retrouvez la vente et son justificatif.
2. Utilisez la fonction de retour ou remboursement prévue.
3. Vérifiez l’autorisation TPE — Remboursement du vendeur.
4. Si la protection globale est active, faites intervenir un superviseur.
5. Suivez la procédure exigée par le terminal et le prestataire.
6. Attendez la confirmation réelle du remboursement.
7. Contrôlez l’opération KWISATZ, le statut terminal et le reçu.

Abandon

Lorsqu’une transaction est abandonnée, KWISATZ peut proposer :

• quitter sans enregistrer la transaction dans le ticket ;
• enregistrer la transaction TPE dans le ticket puis quitter.

14. Titres-restaurant dématérialisés

Certaines interfaces détectent les cartes de titres-restaurant dématérialisés et peuvent utiliser le règlement associé dans les préférences de Vente directe.

Contrôles

• produits éligibles ;
• montant restant après les autres règlements ;
• montant réellement accepté par le terminal ;
• circuit monétique utilisé par la carte ;
• refus partiel ou total ;
• ventilation dans les statistiques et le décompte.

15. Paramètre interne TPE_ATTENTE_RETOUR

Ce paramètre interne historique est réservé au diagnostic et ne doit pas être modifié par l’utilisateur.

16. Sécurité et organisation

• association claire entre chaque caisse et son terminal ;
• adresse IP stable et inventaire à jour ;
• règlement manuel CB limité aux superviseurs ;
• remboursement protégé par accès superviseur ;
• abandon protégé par accès superviseur ;
• rapprochement selon la fréquence définie entre KWISATZ, le terminal, les lots et le compte acquéreur ;
• aucune donnée carte complète dans les journaux de support ;
• logs de dépannage désactivés après résolution ;
• mise à jour coordonnée de KWISATZ et du terminal ;
• procédure écrite pour les transactions incertaines.

17. Logs et mode dépannage

L’option de log par transaction trace les échanges nécessaires au diagnostic. Les anciens modes de debug produisaient des fichiers ASC dans le dossier TICKETS ; les révisions plus récentes documentent des fichiers LOG dans le dossier LOG.

Ancien mode historique :
YYYYMMDD_HHMMSS_LOG_TPE.ASC

Révisions plus récentes :
TPE_YYYYMMDD_HHMMSS_LOG_TPE.LOG

Les interfaces récentes peuvent enregistrer la trame envoyée et la trame reçue.

Informations à relever

• date et heure ;
• version KWISATZ ;
• type d’interface ;
• adresse et port, sans secret ;
• montant demandé ;
• montant accepté ;
• statut ou message d’erreur ;
• action de l’opérateur ;
• présence de la transaction dans le TPE et dans le ticket.

18. Recette avant mise en production

1. Identifier le partenaire, le protocole, la version et la licence.
2. Relever l’adresse, le port et les paramètres initiaux.
3. Tester la communication sans modifier le terminal au hasard.
4. Effectuer un paiement accepté de montant maîtrisé.
5. Effectuer un paiement refusé.
6. Tester le sans contact et la saisie du code selon le terminal.
7. Tester un paiement mixte et le reste à payer transmis.
8. Tester une acceptation partielle uniquement si l’interface la permet.
9. Tester une carte TRD lorsque ce circuit est utilisé.
10. Tester les reçus client et commerçant.
11. Tester un remboursement avec autorisation puis sans autorisation.
12. Tester l’abandon sans enregistrement.
13. Tester le scénario d’un paiement accepté mais d’un retour de communication incomplet.
14. Simuler une coupure sur une caisse pilote.
15. Vérifier qu’aucune relance ne crée un double débit.
16. Rapprocher le ticket, la transaction TPE et le lot.
17. Désactiver les logs après validation.

19. Diagnostic rapide

20. Procédure de secours

TPE indisponible

1. Vérifier le réseau et l’état du terminal.
2. Ne pas valider la CB manuellement sans preuve.
3. Proposer un autre moyen de paiement.
4. Contacter le mainteneur monétique si l’incident persiste.
5. Noter l’heure, le montant et le message.

Transaction incertaine

1. Conservez le ticket non finalisé lorsque la procédure le permet.
2. Consulter le journal du TPE.
3. Vérifier l’application du prestataire.
4. Comparer les dernières transactions par heure et montant.
5. Faites qualifier la situation par un responsable autorisé.
6. Documenter toute correction manuelle.

21. Actions à éviter

• choisir une interface différente pour contourner une licence ;
• laisser une adresse IP dynamique non réservée ;
• Repère de diagnostic : TPE_ATTENTE_RETOUR. 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.
• relancer une carte après timeout sans contrôler le débit ;
• enregistrer manuellement une CB sans justificatif ;
• laisser tous les vendeurs rembourser ou abandonner ;
• imprimer les reçus simultanément sur le TPE et la caisse sans besoin ;
• laisser les logs activés en permanence ;
• copier des paramètres INI historiques sans validation ;
• modifier le protocole du terminal sans le mainteneur.

22. Liste de contrôle

• Le partenaire et le protocole sont identifiés.
• La version KWISATZ est compatible.
• La licence requise est active.
• L’adresse IP est stable.
• Le port est confirmé.
• Le bon type est sélectionné dans l’onglet TPE.
• Le mode de règlement coche Connecter TPE.
• Le paramètre interne TPE_ATTENTE_RETOUR reste à 0.
• Les remboursements et abandons sont protégés.
• Le paiement partiel et les TRD sont testés.
• Les reçus client et commerçant sont configurés.
• Le sans contact est testé.
• La coupure réseau est testée.
• La fréquence de rapprochement est définie et appliquée.
• Les logs sont désactivés après dépannage.

23. Évolutions KWISATZ documentées

24. Sources documentaires

• MENUS_KWISATZ — Périphériques utilisés, onglet TPE et option Connecter TPE des règlements.
• WKW_Suivi_Développement — protections remboursement/abandon, Concert V3 IP et TPE_ATTENTE_RETOUR.
• WKW_Suivi_Développement — reçus, ports IP, partenaires et montant réellement accepté.
• Version 3.56 fournie — trame de dialogue PAX, TPE_ATTENTE_RETOUR et évolutions de logs.
• Tutoriels KWISATZ — réglages historiques d’impression Yavin.
• Base support téléphonique — diagnostic de protocole, version et logs TPE.