Guide d'installation de la caisse

Manuel de la caisse version 0.10.10 · 19/11/2026 correspond à votre caisse

Ce guide explique, pas à pas, tout ce qu'il faut faire avant d'utiliser la caisse dans un café : ouvrir la caisse, l'installer comme application, brancher l'imprimante et le tiroir-caisse, puis tout vérifier. Il s'adresse aussi bien à un technicien qu'à un client qui s'installe seul. Une fois la caisse en service, les manuels du vendeur et du gérant (menu Dépannage) expliquent son utilisation.

1. Avant de commencer

Ce que vous recevez d'ETS Lejeune

  • L'adresse de votre caisse : https://caisses.etslejeune.be/ (c'est celle de cette page). Elle commence par https://.
  • Un accès gérant : votre adresse e-mail et un mot de passe provisoire, à changer à la première connexion. Ils vous arrivent par e-mail (vérifiez les courriers indésirables), avec le lien de connexion. Pas encore de caisse ? Sur la page de connexion, « Essai gratuit de 30 jours » : vous donnez le nom de l'établissement, votre e-mail et votre téléphone (obligatoire ; numéro de TVA et adresse sont facultatifs), vous cliquez sur le lien de confirmation reçu (valable 24 heures) et vous choisissez votre mot de passe. Une caisse d'essai jamais utilisée pendant 30 jours est suspendue.
  • Le dossier agent_impression (le « poste d'impression »), si vous imprimez des tickets.

Le matériel

  • Un PC Windows ou une tablette Android (10 pouces conseillés) pour la caisse, avec Chrome.
  • Une imprimante de tickets 80 mm compatible ESC/POS (par exemple Epson TM-T20), en réseau (Ethernet) ou en USB, avec son papier thermique.
  • Un tiroir-caisse branché sur l'imprimante (prise RJ11 à l'arrière), si le café en a un.
  • Un routeur avec accès internet. Rien à ouvrir ni à configurer dans le routeur : la caisse n'utilise que des connexions sortantes en HTTPS (port 443).
  • Un PC Windows qui reste allumé pendant le service pour le poste d'impression (cela peut être le PC de la caisse).
Vérifiez que la date et l'heure de chaque appareil sont exactes : sinon Chrome signale une erreur de certificat et refuse d'ouvrir la caisse.

2. Ouvrir la caisse dans Chrome

  1. Ouvrez Chrome sur l'appareil de caisse et tapez l'adresse : https://caisses.etslejeune.be/
  2. La page Connexion s'affiche. Saisissez l'adresse e-mail et le mot de passe provisoire reçus, puis « Se connecter ».
  3. La caisse vous demande de choisir un nouveau mot de passe : choisissez-en un solide (au moins 8 caractères, pas seulement des chiffres) et gardez-le en lieu sûr.
  4. Vous arrivez à l'accueil : Vente, Gestion, Programmation, Config, Dépannage.
Si Chrome affiche « Votre connexion n'est pas privée » : ne continuez pas. Vérifiez la date et l'heure de l'appareil, puis réessayez ; si le message persiste, appelez le support (coordonnées dans Dépannage ou fournies par ETS Lejeune).

3. L'installer comme application

La caisse s'installe comme une application : une icône « Caisse » sur l'écran d'accueil, ouverture en plein écran, sans barre d'adresse. C'est le même site, présenté comme une application.

Tablette ou téléphone Android

  1. Dans Chrome, connecté à la caisse, touchez le menu ⋮ en haut à droite.
  2. Touchez « Installer l'application » (ou « Ajouter à l'écran d'accueil »), puis confirmez.
  3. L'icône Caisse apparaît sur l'écran d'accueil : touchez-la pour ouvrir la caisse en plein écran.

PC Windows (Chrome ou Edge)

  1. Dans la barre d'adresse, touchez l'icône d'installation (un écran avec une flèche), ou menu ⋮ > Diffuser, enregistrer et partager > Installer la page en tant qu'application.
  2. Confirmez : la caisse s'ouvre dans sa propre fenêtre, avec une icône sur le bureau.
  • Si « Installer l'application » n'apparaît pas : l'adresse doit commencer par https://, sans avertissement de certificat, et la page doit être entièrement chargée (connectez-vous d'abord).
  • L'application nécessite internet : sans connexion elle affiche « Pas de connexion » avec un bouton « Réessayer ». Rien n'est perdu, les tickets sont sur le serveur.
  • Sur un iPad, « Partager > Sur l'écran d'accueil » existe mais n'a pas été validé : privilégiez Android ou Windows.

4. Régler l'établissement

Avant de vendre, le gérant prépare la caisse (le détail de chaque écran est dans le manuel du gérant, chapitre « Mise en route »). Dans l'ordre :

  1. Programmation > Taux de TVA : 21 %, 12 %, 6 % et 0 % existent déjà. Faites-les valider par le comptable.
  2. Familles puis Articles (prix TTC, TVA sur place et à emporter, imprimante de préparation Bar ou Cuisine). « Enregistrer et créer un autre » accélère la saisie.
  3. Plans de salle et Tables si le café vend en table (« Générer » crée une série de tables).
  4. Modes de paiement : Espèces, Bancontact, Carte existent déjà ; vérifiez que seul « Espèces » ouvre le tiroir et arrondit aux 5 centimes.
  5. Vendeurs : créez chaque personne avec son profil de droits (Programmation > Profils et droits pour régler ce que chaque profil peut faire). Donnez-vous un PIN avant d'activer le mode PIN.
  6. Config : en-tête et pied du ticket, coordonnées du support (groupe Dépannage), disposition de l'écran de vente, heure de changement de journée.

5. Brancher l'imprimante

Imprimante réseau (Ethernet)

  1. Mettez le papier thermique, branchez l'alimentation et reliez l'imprimante au routeur par un câble réseau. Allumez-la.
  2. Notez son adresse IP et son adresse MAC. Trois façons de les trouver :
    • l'auto-test de l'imprimante : éteindre, maintenir le bouton FEED, rallumer ; la feuille imprimée indique les réglages réseau (sur la plupart des modèles Ethernet) ;
    • la commande de l'agent (étape suivante) : python agent.py --imprimantes-reseau liste les imprimantes du réseau avec leur adresse IP et MAC ;
    • la liste des appareils connectés dans le routeur.
  3. Idéal : fixer l'adresse de l'imprimante (dans ses réglages réseau, page web de l'imprimante ou utilitaire du fabricant, voir sa notice), en choisissant une adresse hors de la plage que le routeur distribue. Sinon, réservez-lui une adresse dans le routeur.
  4. Même si l'adresse venait à changer, la caisse retrouve toute seule l'imprimante grâce à sa MAC (ligne mac de agent.ini) : c'est le filet de sécurité.

Imprimante USB

  1. Installez le pilote Windows de l'imprimante, puis branchez-la en USB au PC du poste d'impression.
  2. Le nom exact de l'imprimante s'obtient avec python agent.py --imprimantes : il va dans la ligne nom de agent.ini (type = windows).

6. Installer le poste d'impression

Le serveur ne peut pas atteindre l'imprimante du café : un petit programme, l'agent d'impression, tourne sur un PC du café, récupère les tickets sur la caisse et les envoie à l'imprimante. Il n'ouvre aucun port : il appelle la caisse comme le fait un navigateur.

  1. Dans la caisse (compte gérant) : Programmation > Poste d'impression, créez un poste (par exemple « Comptoir »). Le jeton s'affiche une seule fois : copiez-le.
  2. Sur le PC d'impression : installez Python 3.10 ou plus récent (python.org), en cochant « Add python.exe to PATH ».
  3. Copiez le dossier agent_impression dans C:\caisse-agent\. Copiez agent.ini.exemple en agent.ini et remplissez-le (tableau ci-dessous).
  4. Ouvrez PowerShell dans C:\caisse-agent et testez l'imprimante seule :
    python agent.py --tester
    Un ticket d'essai doit sortir, avec les accents et le symbole €.
  5. Lancez ensuite l'agent :
    python agent.py
    Dans la caisse, Programmation > Poste d'impression, le poste passe à « ● Connecté » (rechargez la page). Cliquez sur « Imprimer un ticket d'essai » (avec « Ouvrir aussi le tiroir-caisse ») : ce ticket-là passe par la caisse.
  6. Démarrage automatique : pour que l'agent se lance à l'ouverture de la session Windows, sans fenêtre :
    schtasks /Create /TN "Agent impression caisse" /SC ONLOGON /RL LIMITED /TR "pythonw.exe C:\caisse-agent\agent.py"
    Redémarrez le PC et vérifiez que le poste repasse « Connecté ».

Le fichier agent.ini, ligne par ligne

SectionLigneValeur
[serveur]urlL'adresse de la caisse, exactement comme dans le navigateur : https://caisses.etslejeune.be/ (sans « / » en trop, avec https://).
[serveur]jetonLe jeton copié à la création du poste (commence par cp_). Ne le partagez pas.
[serveur]intervalleSecondes entre deux interrogations de la caisse (3 par défaut ; 1 pour imprimer plus vite).
[imprimante]typereseau (Ethernet), windows (USB, imprimante installée dans Windows) ou fichier (essai sans imprimante).
[imprimante]nomImprimante USB seulement : le nom exact donné par python agent.py --imprimantes.
[imprimante]hoteImprimante réseau : son adresse IP (par exemple 192.168.1.50).
[imprimante]portImprimante réseau : 9100 (le port standard, à ne pas changer).
[imprimante]macImprimante réseau : son adresse MAC (par exemple 00:26:AB:12:34:56). Conseillé : l'agent retrouve l'imprimante par sa MAC si son adresse IP change.

Plus de détails (plusieurs imprimantes, bons de préparation sur un autre PC, dépannage de l'agent) : fichier README.md du dossier agent_impression.

7. Le tiroir-caisse

  1. Branchez le câble du tiroir dans la prise RJ11 (« DK ») à l'arrière de l'imprimante.
  2. Dans la caisse, Programmation > Poste d'impression : « Imprimer un ticket d'essai » en cochant « Ouvrir aussi le tiroir-caisse ».
  3. Si le tiroir ne s'ouvre pas : Config > Impression, changez la broche du tiroir (2 ou 5), puis refaites l'essai.

8. Vérifier avant l'ouverture

Avec le gérant, faites ces essais (puis annulez les tickets d'essai ou clôturez par un Z avant l'ouverture réelle) :

  • ☐ La caisse s'ouvre depuis l'icône Caisse, connexion et changement du mot de passe faits.
  • ☐ Vente directe : un article, paiement en espèces avec montant remis → le ticket sort, le tiroir s'ouvre, le « À rendre » est juste.
  • ☐ Arrondi : un total qui n'est pas multiple de 5 centimes affiche « Arrondi espèces » sur le ticket.
  • ☐ Table : ouvrir une table, ajouter des articles, touche Commande → les bons de préparation sortent (bar et cuisine), puis encaisser.
  • ☐ Compte client : créer un client, une commande « mise en compte », vérifier la fiche et l'historique, encaisser le règlement.
  • ☐ Ticket ON/OFF : en OFF, pas de ticket client mais le tiroir s'ouvre.
  • ☐ Vendeurs : chacun se connecte avec son profil (ou son PIN) et ne voit que ce que son profil permet.
  • ☐ Rapport X puis Clôture Z : les chiffres correspondent aux ventes d'essai.
  • ☐ Redémarrage du PC d'impression : le poste repasse « Connecté » tout seul.
  • ☐ Dépannage : les coordonnées du support et la version de la caisse sont renseignées.

9. Si ça ne marche pas

SymptômeCause probable et remède
La page ne s'ouvre pasPas d'internet, ou adresse mal tapée. Vérifiez le Wi-Fi, ouvrez un autre site, relisez https://caisses.etslejeune.be/.
« Votre connexion n'est pas privée »Date ou heure de l'appareil fausses : corrigez-les. Sinon, ne continuez pas : appelez le support.
« Installer l'application » n'apparaît pasAdresse sans https://, avertissement de certificat, ou page pas entièrement chargée. Connectez-vous d'abord, rechargez.
Mot de passe refuséMajuscules, ou mot de passe provisoire déjà changé. Demandez une réinitialisation au support.
Le poste reste « Hors ligne »L'agent ne tourne pas (python agent.py), ou url fausse dans agent.ini. Lisez agent.log : « Serveur injoignable » = adresse ou internet ; « Jeton refusé » = jeton mal copié ou poste désactivé (utilisez « Nouveau jeton »).
« Jeton refusé »Jeton copié incomplètement, ou créé dans une autre caisse que celle de l'url. Créez un nouveau jeton dans cette caisse.
Aucun ticket ne sort (imprimante réseau)Imprimante éteinte ou débranchée, ou adresse changée. Lancez python agent.py --imprimantes-reseau ; vérifiez hote et mac. Un message « Imprimante retrouvée à l'adresse … » dans agent.log montre que le repli par la MAC a fonctionné.
Aucun ticket ne sort (USB)Nom de l'imprimante inexact dans nom : python agent.py --imprimantes donne le nom exact.
Le € ou les accents sortent malDans Config > Impression > Écriture des montants sur les tickets, choisissez « € dessiné » (le symbole € est envoyé comme un petit dessin : il sort même si l'imprimante ne le connaît pas) puis faites un ticket d'essai ; sinon « EUR », qui convient à toutes les imprimantes. Si les accents sont mauvais, imprimante non ESC/POS : prévenez ETS Lejeune avec le modèle.
Le tiroir ne s'ouvre pasCâble RJ11 mal branché, ou broche à changer (2 ↔ 5) dans Config > Impression.
Pas de bouton « Envoyer par e-mail »Le serveur d'envoi n'est pas réglé (c'est ETS Lejeune qui le règle sur le serveur) ou l'option est décochée dans Config > E-mail. « E-mail non envoyé » : adresse mal tapée ou serveur de courrier indisponible, réessayez plus tard.
Un ticket sort plusieurs minutes plus tardL'agent était arrêté. Un ticket de plus de 30 minutes est abandonné, un ordre de tiroir de plus de 30 secondes : c'est voulu.

Le support : Accueil > Dépannage (téléphone, e-mail, horaires, version de la caisse à communiquer).