Guide
Fait partie de: Impression de tickets
Configurer l'imprimante Epson avec tickets et logo
Avec Epson Server Direct Print ou Star CloudPRNT, l'imprimante récupère elle-même ses tickets sur notre serveur en HTTPS – avec ID et mot de passe, sans redirection de port et sans PC au bar. Ce guide va de l'imprimante adaptée au premier ticket avec le logo de l'association. Il montre aussi le routage des bons de commande vers la cuisine et le bar, l'écran des commandes et quoi faire si cela ne fonctionne pas. Les imprimantes de tickets ESC/POS bon marché avec massicot se raccordent via un petit proxy d’impression – en USB ou en réseau, en conteneur Docker, par exemple sur un Raspberry Pi.
9 minutes de lecture
D'abord : ce qu'il faut savoir
- L'imprimante interroge notre serveur toutes les quelques secondes. Les tickets arrivent donc avec quelques secondes de décalage, selon l'intervalle réglé.
- L'adresse d'interrogation contient une clé secrète. Quiconque la connaît reçoit les tickets de cette imprimante. Ne la partagez pas ; en cas de doute, créez-en une nouvelle.
- La liste des modèles adaptés provient de la documentation d'Epson. Les anciens appareils TM-i et TM-DT prennent souvent aussi en charge Server Direct Print, mais seulement à partir d'une certaine version du firmware.
Ce qu'il vous faut
- Une imprimante de tickets Epson avec Server Direct Print et connexion réseau (LAN ou Wi-Fi), par exemple TM-m30III, TM-m30II-H/-NT/-S/-SL, TM-m50/TM-m50II, TM-T88VII, TM-T88VI, TM-L100, TM-H6000V, TM-T70II-DT2, TM-T88VI-DT2.
- Un accès Internet pour l'imprimante – un routeur ordinaire suffit, sans redirection de port.
- Du papier thermique de 80 ou 58 mm, adapté à l'imprimante. Les imprimantes à tickets et les écrans de commandes se configurent uniquement ici, pas dans l'espace admin de la WebApp ou de l'app.
- Un compte propriétaire ou administrateur de l'association dans l'Administration sous /admin.
Ajouter l'imprimante dans /admin
- Ouvrez /admin, choisissez la liste à gauche et allez dans « Exploitation » → « Imprimantes de tickets ».
- Cliquez sur « Ajouter une imprimante de tickets » et saisissez un nom, par exemple « Bar ».
- Sous « Liste », choisissez la liste (ou laissez vide pour toutes) et sous « Largeur du papier » 80 mm ou 58 mm.
- Sous « Qu'imprime cette imprimante ? », cochez ce qui sort automatiquement : « Tickets de caisse », « Ticket Z » et « Bons de commande » – détails dans la section « Routage d'impression » plus bas. Sans coche, l'imprimante n'imprime que les tests et les tickets choisis explicitement.
- Cliquez sur « Enregistrer ». La fenêtre reste ouverte et affiche l'adresse de relève, l'« ID (utilisateur) » et le mot de passe – le mot de passe uniquement maintenant : copiez-le avec « Copier le mot de passe ». « Nouvelle adresse » et « Nouveau mot de passe » invalident les anciens.
Configurer l'imprimante
- Trouvez l'adresse IP de l'imprimante : imprimante éteinte, maintenez le bouton d'avance (FEED) enfoncé et allumez-la – la feuille d'état indique l'adresse IP.
- Ouvrez http://adresse-IP dans le navigateur d'un ordinateur du même réseau – c'est l'interface web de l'imprimante (Web Config, sur les appareils plus anciens EpsonNet Config). Allez dans « Advanced Settings » → « Administrator Login » et connectez-vous : sur les modèles récents, le mot de passe est le numéro de série de l'imprimante (utilisateur, si demandé, « epson »). Les modèles TM-i et TM-DT suivent le même chemin.
- Mettez d'abord à jour les certificats racine de l'imprimante : notre serveur utilise un certificat Let's Encrypt (chaîne YR1 → ISRG Root YR → ISRG Root X1). Les anciennes listes de certificats de l'imprimante ne le connaissent pas – https:// échoue alors sans message et aucune requête ne nous parvient. Ouvrez « Advanced Settings » → « Network Security » → « Root Certificate Update » et cliquez sur « Update » ; l'imprimante télécharge la liste actuelle d'Epson. Sinon, importez sous « Network Security » → « CA Certificate » les fichiers PEM « ISRG Root X1 » et « ISRG Root YR » depuis letsencrypt.org/certificates.
- Ouvrez « TMI Settings » → « Server Direct Print » et réglez « Server Direct Print » (dans le manuel Epson « Use Server Direct Print ») sur « Enable ».
- Saisissez dans « URL » l'adresse copiée, dans « Interval » 5 secondes et dans les champs « ID » et « Password » l'utilisateur et le mot de passe de /admin. L'imprimante s'authentifie avec eux en HTTP Digest, comme le décrit le manuel Epson ; notre serveur accepte Digest et Basic. Sans identifiants corrects, il répond « 401 » et l'imprimante ne reçoit rien. Moins de 5 secondes n'apporte rien : notre serveur accepte au plus une requête toutes les 400 ms par imprimante.
- Cliquez sur « Apply », puis dans « TM-i Settings » (adresse /webconfig-i) sur « Apply & Restart » – c'est seulement alors que l'imprimante reprend Server Direct Print et redémarre. Déconnectez-vous ensuite avec « Administrator Logout » : tant que quelqu'un est connecté en administrateur, l'imprimante est en mode configuration et n'imprime rien.
- Dans /admin, cliquez sur « Impression test » dans la ligne de l'imprimante. Le ticket test arrive à la prochaine interrogation – donc en 5 secondes environ au plus – et la colonne « Statut » affiche « dernier contact » avec l'heure.
Alternative : imprimantes Star avec CloudPRNT
- Au lieu d'Epson, une imprimante Star avec CloudPRNT convient aussi, p. ex. TSP143IV, TSP100IV, mC-Print3 ou mC-Print2. Lors de l'ajout, choisissez « Star CloudPRNT (l’imprimante récupère les tickets) ».
- Ouvrez l'interface web de l'imprimante Star (adresse IP de l'autotest) et connectez-vous en administrateur.
- Activez CloudPRNT, saisissez dans « Server URL » l'adresse de /admin, 5 à 10 secondes comme intervalle d'interrogation et, pour l'authentification (Basic), l'utilisateur et le mot de passe de /admin.
- Enregistrez, redémarrez l'imprimante et cliquez sur « Impression test » dans /admin. Au premier contact, le serveur retient l'adresse MAC de l'imprimante ; un autre appareil avec la même adresse est refusé.
Imprimantes de tickets bon marché via le proxy d’impression (USB ou réseau)
- Au lieu d'une imprimante Epson ou Star avec fonction cloud, une imprimante de tickets ESC/POS bon marché convient aussi – en USB ou en réseau, par exemple Epson TM-T20, Xprinter, Munbyn ou Rongta. Il faut un massicot automatique : chaque ticket se termine par une coupe. Les imprimantes sans massicot (barre de découpe, beaucoup d'imprimantes mobiles 58 mm) ne sont pas prises en charge.
- Pour cela, un petit proxy d’impression tourne en conteneur Docker dans le réseau de l'association – sur un Raspberry Pi (y compris les anciens modèles à partir du Pi 2 ; le Pi 1 et le premier Pi Zero ne conviennent pas), un NAS ou un PC. Il se connecte de lui-même à notre serveur, sans redirection de port.
- Dans /admin, ouvrez « Exploitation » → « Imprimantes de tickets » → « Proxys d’impression », saisissez un nom et cliquez sur « Coupler un proxy ». Le jeton de l'appareil n'apparaît que maintenant. Si l'imprimante est reliée au proxy en USB, cochez « Imprimante en USB sur le proxy (/dev/usb/lp0) ». Copiez la commande de démarrage prête à l'emploi (docker run …) avec « Copier la commande ». Sinon, « docker compose » affiche la même configuration sous forme de docker-compose.yml : copiez-la avec « Copier le YAML », enregistrez-la dans un dossier et lancez-y « docker compose up -d ».
- Exécutez la commande sur le Raspberry Pi ou l'ordinateur. Au premier lancement, Docker télécharge lui-même l'image drinklist/print-proxy depuis Docker Hub (https://hub.docker.com/r/drinklist/print-proxy, pour amd64, arm64 et arm/v7). Le conteneur redémarre de lui-même après un redémarrage ou une coupure de courant ; peu après, le proxy apparaît « connecté » dans /admin. Astuce : avec l'option --test-print suivie de l'adresse IP de l'imprimante (ou /dev/usb/lp0), l'image imprime une page de test sans serveur – pour vérifier câble, adresse et massicot.
- Ajoutez ensuite l'imprimante : connexion « Proxy d’impression : imprimante ESC/POS bon marché en USB ou réseau (Docker, Raspberry Pi) », choisissez le proxy et, sous « Connexion au proxy », réseau (adresse IP de l'imprimante dans le réseau de l'association, port 9100) ou USB (/dev/usb/lp0). Cochez « L’imprimante a un massicot automatique », enregistrez et cliquez sur « Impression test ». Routage, réimpression et travaux fonctionnent comme pour toute autre imprimante.
- Si le proxy n'est pas connecté (courant, internet), les tickets attendent et sortent dès qu'il est de nouveau en ligne – ceux de plus de deux heures ne sont plus imprimés, une réimpression reste possible. La colonne « Statut » indique papier épuisé ou capot ouvert si l'imprimante le signale ; beaucoup d'imprimantes bon marché ne le font pas. « Nouveau jeton » invalide l'ancien, « Retirer » déconnecte définitivement le proxy.
Routage d'impression : les plats en cuisine, les boissons au bar
- Sous « Qu'imprime cette imprimante ? », chaque imprimante fixe ce qu'elle imprime automatiquement : « Tickets de caisse » après chaque vente au comptant, le « Ticket Z » à la clôture de la caisse et les « Bons de commande » pour les nouvelles commandes par QR. Plusieurs imprimantes peuvent imprimer la même chose, p. ex. les tickets au bar et au bureau.
- Cuisine : ajoutez l'imprimante « Cuisine », cochez « Bons de commande » et choisissez sous « Uniquement ces groupes de produits (catégories) » la catégorie de vos plats, p. ex. « Plats » – telle qu'elle figure sur les produits.
- Bar : pour l'imprimante « Bar », cochez « Tickets de caisse » et « Bons de commande » ainsi que « Tous les autres produits (catégorie sans imprimante dédiée) ». Sans catégorie et sans cette coche, une imprimante imprime chaque commande en entier.
- Une commande de 2 bières et 1 escalope donne alors deux bons : l'escalope en cuisine, les bières au bar – chacun avec numéro de commande, table ou poste, heure, client et notes. Les lignes sans imprimante correspondante ne sont pas imprimées. En option : « Prix sur le bon de commande » et « Imprimer les commandes annulées comme bon d'annulation ».
- Le bouton « Routage d'impression » affiche la vue d'ensemble : quel document, pour quelle liste et quel groupe de produits, sort sur quelle imprimante. Si aucune liste n'est choisie pour l'imprimante, « Pour la liste » dans la fenêtre de l'imprimante limite son routage à une liste.
Écran des commandes au lieu des bons : pour la cuisine et le bar
- Ouvrez « Exploitation » → « Écrans des commandes » et cliquez sur « Ajouter un écran des commandes ». Nom, p. ex. « Cuisine », puis comme pour l'imprimante « Uniquement ces groupes de produits (catégories) » ou « Tous les autres produits (catégorie sans imprimante dédiée) » – écrans et imprimantes suivent les mêmes règles.
- Ouvrez le lien ou le QR code sur la tablette ou la TV et choisissez « Sur l'écran d'accueil ». L'écran démarre alors comme une app, sans connexion, en plein écran, et reste allumé. Un toucher active le son des nouvelles commandes.
- Chaque commande en attente apparaît en grande tuile avec numéro, table ou poste, client, notes et uniquement les lignes de cet écran. Le temps défile et la tuile passe à l'orange après « Orange après (minutes) » et au rouge après « Rouge après (minutes) ».
- Touchez « En cours » pour prendre la commande (le bar la voit prise) et « Prêt » pour la retirer de cet écran – avec « Annuler » pendant 10 secondes. Servir et encaisser restent au bar. « Nouveau lien » invalide l'ancien, p. ex. si une tablette est perdue.
Logo pour tickets, PDF et affichage TV
- Dans /admin, ouvrez « Organisation » → « Données de base » et faites défiler jusqu'à la section « Logo ».
- Cliquez sur « Téléverser le logo » et choisissez une image JPG ou PNG de 2 Mo maximum. Elle est pivotée et réduite automatiquement.
- Choisissez où le logo apparaît : « Sur les tickets (imprimante), en haut au centre », « Sur l’affichage TV/projecteur, en haut à droite » et « Sur les PDF du club, en haut à droite (reçus, relevés, rapports) ».
- Conseil : l'imprimante n'imprime qu'en noir et blanc, le logo est donc converti en points. Un logo simple, aux contours nets et bien contrasté sur fond clair, rend le mieux sur un ticket.
Imprimer des tickets
- Un ticket comporte le logo, les lignes avec lettre de TVA, les remises et règles de prix, le total, le mode de paiement et la TVA par taux.
- « Journaux et comptes » → « Journal des paiements » : « Imprimer le ticket » dans la ligne d'un paiement envoie le ticket à l'imprimante choisie – sans choix, à la première imprimante avec « Tickets de caisse ». Le justificatif PDF reste disponible comme d'habitude.
- « Exploitation » → « Caisse & ticket Z » : « Imprimer le ticket Z » dans la ligne d'une session de caisse clôturée imprime le ticket Z sur papier.
- « Exploitation » → « Imprimantes de tickets » → « Travaux » : tous les travaux avec statut et erreur. « Réimprimer » imprime un ticket une nouvelle fois.
Si cela ne fonctionne pas
- La colonne « Statut » indique toujours « jamais interrogée » : l'adresse manque ou est erronée, Server Direct Print n'est pas activé ou l'imprimante n'accède pas à Internet. Vérifiez aussi la date et l'heure de l'imprimante – si elles sont fausses, la connexion HTTPS échoue. Si vous n'arrivez pas à vous connecter à l'interface web, réinitialisez l'imprimante aux réglages d'usine avec le bouton FEED comme le décrit le manuel Epson.
- Les travaux restent « en attente » ou « envoyé » : l'imprimante est-elle allumée, avec du papier et le capot fermé ? Elle récupère les travaux à l'interrogation suivante ; sans réponse ils sont renvoyés puis marqués en échec après plusieurs tentatives. Si /admin affiche pour l'imprimante « Merci de générer un nouveau mot de passe (nécessaire pour Epson) », le mot de passe date d'avant l'authentification Digest : générez-en un nouveau et saisissez-le dans l'imprimante.
- Erreur avec un message de l'imprimante : le plus souvent fin de papier ou capot ouvert. Corrigez et le travail est renvoyé automatiquement.
- Texte coupé ou trop étroit : la largeur de papier dans /admin doit correspondre au papier chargé (80 ou 58 mm).
- Accents ou caractères spéciaux erronés : vérifiez que le firmware de l'imprimante est à jour – les anciennes versions ne gèrent pas tous les jeux de caractères.
Epson : dépannage tiré de la pratique
- Aucune requête n'arrive au serveur alors que tout est saisi : le plus souvent, l'imprimante ne connaît pas le certificat Let's Encrypt de notre serveur (constaté avec une TM-m30III, firmware TM-i 01.39 et certificats racine 02.03). Lancez « Advanced Settings » → « Network Security » → « Root Certificate Update » → « Update » ou importez « ISRG Root X1 » et « ISRG Root YR » (letsencrypt.org/certificates) sous « Network Security » → « CA Certificate ». Ensuite « Apply & Restart » dans « TM-i Settings ».
- Les réglages modifiés restent sans effet : Server Direct Print ne reprend les modifications qu'après « Apply & Restart » dans « TM-i Settings » (/webconfig-i).
- L'imprimante sort un ticket « WebConfig Start » et rien d'autre : quelqu'un est connecté à l'interface web en administrateur et l'imprimante est en mode configuration. Déconnectez-vous toujours avec « Administrator Logout ».
- L'autotest imprime, mais rien ne sort depuis le réseau – même ePOS ou le port 9100 acceptent des données sans imprimer : la liaison interne entre la partie réseau et le mécanisme d'impression est bloquée. Débranchez l'alimentation pendant environ 30 secondes.
- Saisissez l'adresse avec https://, pas http:// : les requêtes en http:// sont redirigées, et Epson ne suit pas les redirections.
- Dans /admin, sous « Exploitation » → « Imprimantes de tickets », « Letzter Kontakt » (dernier contact) dans la fenêtre de l'imprimante affiche les dernières requêtes avec leur résultat ; ce diagnostic est en allemand. « Anmeldung angefordert (401 – bei Digest normal) » (connexion demandée) est normal pour la première requête. Avec « Digest-Anmeldung falsch (ID/Passwort prüfen) » (connexion Digest erronée), générez un nouveau mot de passe et saisissez-le dans l'imprimante. Si « seit dem letzten Serverstart kein Abruf angekommen » (aucune requête depuis le dernier démarrage du serveur) s'affiche, l'imprimante n'atteint pas notre serveur : vérifiez https://, certificats racine et réseau.
Vous êtes bloqué ?
Si un guide laisse une question en suspens ou si quelque chose diffère de la description, ouvrez un ticket : nous répondons dedans. Le support passe uniquement par les tickets, pas par e-mail.