HandyCafe Docs
owner cashier it-admin

Depannage

Cette page regroupe les solutions aux problemes courants, organisees par categorie.


Problemes de connexion

Le client ne trouve pas le serveur

Symptomes : le client affiche "Recherche du serveur" ou "Aucun serveur trouve".

Solutions :

  1. Verifiez que le serveur HandyCafe est en cours d'execution sur le PC de gestion.
  2. Confirmez que les deux PC sont sur le meme sous-reseau (par exemple les deux en 192.168.1.x).
  3. Verifiez que le mDNS n'est pas bloque par votre commutateur ou routeur reseau.
  4. Essayez la connexion manuelle : saisissez l'adresse IP du serveur directement dans les parametres du client.
  5. Verifiez qu'aucun autre logiciel n'utilise le port TCP du serveur (par defaut : 5001).

Le client se connecte puis se deconnecte immediatement

Symptomes : le client affiche brievement "Connecte" puis revient a "Recherche".

Solutions :

  1. Verifiez que la cle de connexion correspond sur le serveur et le client. La cle est definie dans Parametres > Reseau sur le serveur.
  2. Verifiez la stabilite du reseau (pertes de paquets, problemes de cable).
  3. Assurez-vous que le serveur n'a pas atteint la limite de PC de sa licence.
  4. Consultez les journaux du serveur pour les messages d'echec d'authentification.

Le client apparait "Hors ligne" sur le serveur mais le PC est allume

Symptomes : le PC client est allume et l'application client fonctionne, mais le serveur l'affiche comme hors ligne.

Solutions :

  1. Sur le PC client, verifiez que HandyCafe Client est bien en cours d'execution (verifiez la zone de notification).
  2. Verifiez la connexion reseau du PC client (peut-il envoyer un ping au serveur ?).
  3. Verifiez les regles de pare-feu : les ports TCP 5001-5003 doivent etre ouverts sur le serveur et le client.
  4. Redemarrez HandyCafe Client sur le PC concerne.
  5. Si vous utilisez des VLAN, assurez-vous que les VLAN du serveur et du client peuvent communiquer.

Impossible de se connecter apres modification des parametres reseau

Symptomes : apres avoir change les ports ou la cle de connexion, les clients ne peuvent plus se connecter.

Solutions :

  1. Assurez-vous que les clients sont mis a jour avec les nouveaux numeros de port et la nouvelle cle de connexion.
  2. Redemarrez le serveur HandyCafe apres avoir modifie les parametres reseau.
  3. Mettez a jour les regles de pare-feu pour autoriser les nouveaux ports.
  4. Tous les clients doivent etre reconfigures avec les nouvelles valeurs.

Problemes de session

Impossible de terminer une session sur un client

Symptomes : le bouton Demarrer est desactive ou l'action de demarrage echoue avec une erreur.

Solutions :

  1. Verifiez le statut de la licence. En mode lecture seule, les nouvelles sessions ne peuvent pas demarrer.
  2. Verifiez que le statut du client est "Inactif". Les sessions ne peuvent demarrer que sur les clients inactifs.
  3. Verifiez les permissions du caissier. Le role doit disposer de la permission AUTH_CLIENT_LOGIN.
  4. Assurez-vous que la tarification est configuree (Parametres > Tarification doit avoir un tarif horaire valide).

Le chronomètre de session affiche une heure incorrecte

Symptomes : l'heure affichee ne correspond pas au temps reel ecoule.

Solutions :

  1. Verifiez les horloges systeme des PC serveur et client. Elles doivent etre synchronisees (utilisez NTP).
  2. Si la session a ete mise en pause, la duree de la pause n'est pas comptabilisee.
  3. Pour les sessions prepayees, le chronometre affiche le temps restant, pas le temps ecoule.

Le cout de la session semble incorrect

Symptomes : le montant facture ne correspond pas aux attentes.

Solutions :

  1. Verifiez la grille tarifaire. Si elle est activee, la session a pu traverser plusieurs creneaux tarifaires avec des multiplicateurs differents.
  2. Verifiez les parametres de tarification : tarif horaire de base, TVA, frais de demarrage, arrondi.
  3. Consultez les segments tarifaires de la session dans les details de la transaction pour un detail complet.
  4. Verifiez la commission et les frais fixes du mode de paiement.
  5. Pour les sessions prepayees, verifiez si le mode "Verrouillage a l'achat" ou "Grille en temps reel" est actif.

Impossible de reprendre une session en pause

Symptomes : l'action de reprise echoue ou n'est pas disponible.

Solutions :

  1. Verifiez que le PC client est toujours connecte au serveur.
  2. Verifiez que le statut du client affiche "En pause" (orange).
  3. Si le client s'est deconnecte pendant la pause, il devra peut-etre se reconnecter d'abord.

Problemes de paiement

Un mode de paiement est absent du menu deroulant

Symptomes : le mode de paiement attendu n'apparait pas lors de la cloture d'une session ou d'une commande.

Solutions :

  1. Verifiez que le mode de paiement existe dans Gestion > Modes de paiement.
  2. Verifiez que le mode de paiement est actif (non supprime ni desactive).
  3. Verifiez les permissions du caissier. La permission PAYMENT_MANAGE doit etre accordee pour voir tous les modes.

Le calcul de la commission semble incorrect

Symptomes : la commission deduite ne correspond pas au taux attendu.

Solutions :

  1. Verifiez le taux de commission du mode de paiement (en pourcentage) et les frais fixes.
  2. Formule de commission : commission = (montant facture * taux de commission / 100) + frais fixes.
  3. Verifiez si le caissier a applique un ajustement manuel au montant facture.

Problemes d'affichage du client

L'ecran d'inactivite du client est vide

Symptomes : l'ecran d'inactivite n'affiche rien au lieu du diaporama configure.

Solutions :

  1. Verifiez que l'ecran d'inactivite est active dans Parametres > Clients > Ecran d'inactivite.
  2. Verifiez qu'au moins un element multimedia (image ou video) a ete ajoute.
  3. Verifiez que les fichiers multimedia sont valides et non corrompus.
  4. Lancez une synchronisation pour envoyer les derniers parametres au client.

Le menu client n'affiche pas les applications

Symptomes : le lanceur d'applications est vide ou des categories sont manquantes.

Solutions :

  1. Verifiez que les applications et les categories sont configurees dans Parametres > Clients > Contenu.
  2. Verifiez que les categories et les applications ont la visibilite activee.
  3. Verifiez que le client a recu les dernieres donnees du menu (les modifications sont transmises automatiquement via TCP).
  4. Redemarrez le client si la synchronisation en temps reel ne s'est pas appliquee.

Le theme d'apparence du client n'est pas applique

Symptomes : le client affiche l'apparence par defaut au lieu du theme configure.

Solutions :

  1. Verifiez que les parametres de theme sont enregistres dans Parametres > Clients > Apparence.
  2. Lancez un envoi des parametres vers les clients.
  3. Redemarrez l'application client.

Problemes de bureau a distance

Le bureau a distance est lent ou saccade

Symptomes : le flux video est retarde, saccade ou a un faible taux de rafraichissement.

Solutions :

  1. Diminuez le debit binaire (essayez 1000 a 2000 kbps pour une utilisation LAN standard).
  2. Reduisez le parametre de FPS.
  3. Utilisez un cable Ethernet plutot que le Wi-Fi.
  4. Verifiez l'encombrement du reseau ou une utilisation elevee de la bande passante par d'autres applications.
  5. Assurez-vous que le port UDP 5004 n'est pas bloque ou limite en debit.

Le bureau a distance affiche un ecran noir

Symptomes : la fenetre de bureau a distance s'ouvre mais n'affiche que du noir.

Solutions :

  1. Verifiez que le client est en ligne et reactif (essayez d'abord de prendre une capture d'ecran).
  2. Verifiez que le port UDP 5004 est ouvert dans les deux sens.
  3. Le pilote graphique du client peut necessiter une mise a jour.
  4. Essayez de demander un rafraichissement de l'image cle.

Impossible de controler la souris ou le clavier a distance

Symptomes : vous pouvez voir l'ecran distant mais les clics et les frappes clavier n'ont aucun effet.

Solutions :

  1. Verifiez que le port de gestion a distance (TCP 5003) est ouvert.
  2. Verifiez que l'application client dispose des permissions systeme appropriees.
  3. Certains jeux en plein ecran peuvent bloquer les entrees a distance.

Problemes de licence

La licence affiche "offline_grace"

Symptomes : le statut de la licence affiche offline_grace avec un compte a rebours.

Solutions :

  1. Retablissez la connexion Internet sur le PC serveur.
  2. Verifiez la resolution DNS. Le serveur doit pouvoir atteindre le serveur de licences.
  3. Verifiez la presence d'un proxy ou d'un pare-feu bloquant les connexions HTTPS sortantes.
  4. Vous disposez de 72 heures pour retablir la connexion avant que le serveur ne se verrouille.

La licence affiche "over_limit"

Symptomes : plus de clients sont connectes que la licence ne l'autorise.

Solutions :

  1. Deconnectez les clients inactifs qui ne sont pas utilises.
  2. Verifiez le nombre actuel de clients par rapport a la limite de votre licence.
  3. Mettez a niveau votre licence pour une capacite PC superieure.
  4. Remarque : les consoles comptent dans la limite totale de PC.

La licence affiche "expirée" ou "révoquée"

Symptomes : le serveur passe en mode restreint.

Solutions :

  1. Verifiez la date d'expiration de votre licence.
  2. Renouvelez votre licence via le site web de HandyCafe.
  3. Pour les licences revoquees, contactez le support HandyCafe.

Problemes generaux

Les modifications de parametres ne sont pas sauvegardees

Symptomes : les modifications sont annulees apres avoir quitte la page des parametres.

Solutions :

  1. Assurez-vous de cliquer sur le bouton Enregistrer apres avoir effectue vos modifications.
  2. Verifiez les erreurs de validation (champs surlignants avec des messages d'erreur).
  3. Verifiez que vous disposez des permissions d'administrateur.

Des entrees sont manquantes dans les journaux d'audit

Symptomes : les actions attendues n'apparaissent pas dans la page Journaux.

Solutions :

  1. Verifiez les filtres de journaux. Assurez-vous que la categorie et la plage de dates correctes sont selectionnees.
  2. Verifiez que la permission LOG_DISPLAY_FULL est accordee (sinon seuls les journaux du jour sont affiches).
  3. Utilisez le champ de recherche textuel pour trouver l'action specifique.